04 — Intégrations

1. Objectif métier

Activer les intégrations qui augmentent directement la valeur opérationnelle:

agenda (Google Calendar) pour sécuriser la gestion de rendez-vous,
widget web pour capter les conversations depuis le site.

Objectif concret:

éviter les doubles saisies,
réduire les oublis de suivi,
garder une traçabilité claire entre le site, les conversations et l’équipe.

2. Qui utilise ce module (admin/operator)

admin: connecte, sécurise, maintient les intégrations (activation, clés, restrictions).
operator: exploite les résultats (rendez-vous visibles, leads entrants, suivi conversationnel).

3. Prérequis

Avant d’activer les intégrations:

canal WhatsApp déjà stable,
organisation configurée (fuseau, horaires de base),
compte Google disponible (si agenda),
domaine web disponible (si widget),
responsable sécurité désigné.

Préparer côté gouvernance:

convention de nommage des clés (ex: Production, Staging),
liste des domaines autorisés,
procédure de rotation/révocation des clés.

4. Procédure pas-à-pas (orientée actions produit)

Connecter Google Calendar.

Lancer l’autorisation compte Google.
Vérifier que le compte attendu est bien lié.

Activer explicitement la synchronisation agenda.

Sans activation explicite, les rendez-vous ne sont pas publiés/maintenus dans l’agenda.

Valider le comportement agenda sur 3 cas.

Créer un rendez-vous test.
Replanifier ce rendez-vous.
Annuler ce rendez-vous.
Vérifier que les 3 actions se reflètent côté agenda.

Créer une clé widget.

Donner un nom clair (environnement + usage).
Enregistrer la clé immédiatement dans un coffre d’équipe.
Rappel: la clé complète n’est montrée qu’au moment de création.

Restreindre les origines autorisées.

Ajouter uniquement les domaines qui doivent réellement utiliser le widget.
Éviter les domaines génériques ou temporaires non maîtrisés.

Activer le widget sur le site.

Ouvrir une session de test depuis le site.
Envoyer un message.
Vérifier que la conversation apparaît côté inbox.

Mettre en place le suivi d’usage des clés.

Vérifier régulièrement date de dernière utilisation.
Désactiver immédiatement les clés inutilisées.

Préparer la continuité d’exploitation.

Définir qui intervient en cas d’échec d’intégration.
Prévoir une procédure de bascule temporaire en manuel.

5. Scénarios concrets (minimum 2)

Scénario A (Services + agenda):
- un rendez-vous est créé,
- l’équipe le replanifie,
- l’agenda suit automatiquement,
- aucun double travail opérateur.
Scénario B (E-commerce + widget):
- lead capté sur site via widget,
- conversation visible instantanément dans inbox,
- opérateur prend en charge et conclut.
Scénario C (incident sécurité clé widget):
- suspicion de fuite,
- désactivation immédiate de la clé,
- création nouvelle clé,
- reprise contrôlée sur domaines autorisés.

6. Erreurs fréquentes et résolution

Problème: rendez-vous non visibles dans l’agenda externe.
Résolution: vérifier que la synchronisation agenda est bien activée.
Problème: widget ne fonctionne que sur certains pages/domaines.
Résolution: vérifier la liste des origines autorisées et corriger les domaines.
Problème: perte de la clé widget juste après création.
Résolution: créer une nouvelle clé et révoquer l’ancienne; la clé complète n’est pas récupérable après création.
Problème: intégration agenda indisponible ponctuellement.
Résolution: maintenir le flux métier dans la plateforme, puis vérifier la reprise de synchro.

7. Bonnes pratiques et limites

Utiliser des clés séparées par environnement (prod/staging).
Restreindre strictement les origines widget.
Faire un test de non-régression après chaque changement de clé.
Faire une revue mensuelle des intégrations actives.

Limites:

une clé exposée compromet immédiatement le widget,
une synchro agenda désactivée peut passer inaperçue sans contrôle régulier,
la connexion d’un mauvais compte Google crée des incohérences de planning.

8. Référence rapide (champs/statuts/modes)

Points de contrôle Google Calendar:

compte connecté,
synchronisation active/inactive,
création / replanification / annulation répercutées.

Points de contrôle Widget:

clé active/inactive,
nom de clé explicite,
origines autorisées à jour,
dernière utilisation suivie.

Checklist hebdomadaire intégrations:

test rendez-vous,
test widget depuis site,
revue clés actives,
revue domaines autorisés.