Google Calendar

Disponibilité de la fonctionnalité#

Google Calendar n'est pas encore disponible pour tous. Tant qu'il n'est pas activé, Agent → Actions → Google Calendar affiche « bientôt disponible » et la connexion est impossible ; aucun paramètre de l'agent ne permet de l'activer. Cal.com reste une option distincte.

Connecter un agenda#

Lorsque l'intégration est activée, ouvrez le panneau Google Calendar et choisissez Connecter. Connectez-vous à Google et vérifiez les autorisations demandées pour les événements de l'agenda et les disponibilités (libre/occupé). Cette connexion est distincte de la connexion à Make Agent Fast. Le serveur stocke le jeton d'actualisation de manière chiffrée ; ni le tableau de bord ni l'agent ne le reçoivent.

Les scopes demandés sont calendar.events, calendar.freebusy, ainsi que les scopes non sensibles openid et email. Le callback exige une adresse e-mail vérifiée et la stocke chiffrée afin de faire correspondre primary au même ID d'agenda que son écriture explicite par adresse e-mail. Aucun scope de profil n'est demandé. Les connexions plus anciennes, sans adresse e-mail vérifiée, doivent être déconnectées puis reconnectées avant toute réservation.

Un agent utilise un seul fournisseur d'agenda à la fois. Déconnectez le fournisseur existant avant d'en changer. Choisissez l'ID de l'agenda (primary pour l'agenda principal du compte connecté) et son fuseau horaire IANA, par exemple Asia/Seoul. Un agenda partagé doit être accessible avec les autorisations du compte connecté. La déconnexion révoque l'accès accordé à Google et supprime la connexion ; elle n'annule pas les événements existants.

Définir les horaires de travail#

Les nouvelles connexions n'ont aucun horaire de travail : aucun créneau n'est proposé tant que vous n'en avez pas ajouté. Ajoutez des plages d'ouverture et de fermeture pour chaque jour de travail. Un jour vide est considéré comme fermé ; plusieurs plages sans chevauchement permettent de prévoir une pause déjeuner. Les horaires sont interprétés dans le fuseau horaire sélectionné. Les paramètres sont enregistrés automatiquement.

La disponibilité correspond aux horaires de travail, moins les plages occupées de l'agenda sélectionné, la marge, le préavis minimum et l'horizon. Définissez les horaires dans le fuseau horaire prévu pour l'agenda et vérifiez les changements d'heure été/hiver le cas échéant. L'absence de créneaux peut signifier des horaires de fermeture ou des plages occupées, plutôt qu'une erreur de connexion.

De la disponibilité à la réservation#

L'agent utilise le même flux find_slots et book_slot que Cal.com : il propose jusqu'à huit créneaux disponibles, recueille le nom et l'adresse e-mail ainsi qu'une note facultative, revérifie le créneau choisi, puis affiche une carte de confirmation. Les propositions et les offres expirent au bout de 15 minutes ; aucune des deux ne bloque le créneau. Seul l'appui du client sur le bouton autorise la réservation. Un « oui » prononcé pendant un appel en direct ne peut pas la déclencher.

Après confirmation, Google reçoit un événement dont l'ID déterministe est lié à l'exécution de l'action, et envoie les invitations aux participants. Un événement confirmé et validé produit un reçu finalisé ; les événements provisoires restent en attente. Si un créneau est déjà pris, demandez de nouveaux horaires et faites confirmer à nouveau. En cas de résultat réseau incertain, la vérification s'effectue avec le même ID d'événement ; ne considérez pas un délai d'attente dépassé comme une réussite et ne créez pas aveuglément une autre réservation. Toute modification de la configuration invalide les offres et propositions précédentes.

Pour être averti lorsqu'un créneau se libère, utilisez une surveillance avec consentement. Avant toute utilisation par des clients, vérifiez une vraie réservation et son invitation dans Google, testez un créneau déjà pris, puis contrôlez la déconnexion et la reconnexion ainsi que le canal de messagerie prévu.