Tous les guides d'intégration

Google Calendar

Synchronisation bi-directionnelle et gestion des conflits d'agenda.

Plan Pro 8 min de lecture

A. À quoi sert cette intégration

Dayshift lit votre agenda Google pour ne jamais proposer un créneau déjà occupé, et y écrit chaque nouveau rendez-vous. La synchronisation va dans les deux sens : un événement créé directement dans Google Agenda bloque aussitôt le créneau correspondant sur votre page de réservation.

B. Prérequis et sécurité

Le jeton de rafraîchissement délivré par Google est chiffré au repos (Fernet, AES-128-CBC + HMAC-SHA256) avant d'être stocké, avec versionnage des clés pour permettre une rotation sans interruption. Il n'est jamais exposé à votre navigateur.

C. Configuration pas à pas

Les cinq étapes ci-dessous couvrent l'intégration Google Calendar de bout en bout : connexion, correspondance des données, déclencheurs, validation, puis gestion des échecs.

  1. Connexion OAuth2 — Paramètres → Intégrations & API → Google Calendar → Connecter. Vous êtes redirigé vers l'écran de consentement Google ; l'autorisation accordée revient sur Dayshift et le badge passe au vert.
  2. Correspondance des données — le titre de l'événement reprend la prestation réservée, la description le nom et les coordonnées du client, et la durée celle configurée pour cette prestation. Aucun réglage n'est nécessaire.
  3. Déclencheurs — un canal de notification (watch channel) est créé automatiquement à la connexion. Google prévient Dayshift à chaque modification de votre agenda, sans interrogation périodique.
  4. Validation — créez un événement de test dans Google Agenda, puis rechargez votre page de réservation : le créneau correspondant doit avoir disparu des disponibilités.
  5. Gestion des erreurs — le canal de notification expire au bout de sept jours ; un renouvellement automatique quotidien le recrée avant échéance. Si votre autorisation Google est révoquée, la connexion se signale d'elle-même et il suffit de la relancer.

D. Ressource vidéo complémentaire

Ressource externe pour comprendre le fonctionnement de Google Calendar. Les étapes propres à Dayshift restent celles décrites ci-dessus.

« How To GET Google Calendar API Key » — vidéo publiée sur YouTube par un tiers.

E. FAQ technique et dépannage

« Ce compte Google n'a pas Google Agenda activé »

L'autorisation a réussi mais le compte n'a jamais activé le service Agenda — fréquent sur les comptes Google créés à partir d'une adresse professionnelle. Ouvrez une fois calendar.google.com avec ce compte, ou faites activer le service Agenda par l'administrateur de votre espace Workspace, puis relancez la connexion.

Mes disponibilités ne tiennent pas compte d'un événement récent

Vérifiez que l'événement se trouve sur l'agenda principal du compte connecté : les agendas secondaires et ceux partagés par des tiers ne sont pas lus. Un événement marqué « disponible » plutôt que « occupé » est également ignoré, par conception.

La synchronisation temps réel a cessé

Un canal expiré est normalement renouvelé chaque jour. Si le problème persiste, déconnectez puis reconnectez l'intégration : un canal neuf est créé immédiatement.