Aller au contenu principal

Google Calendar

Ce module permet à votre bot d'interagir avec Google Calendar en créant des événements de manière dynamique pendant les interactions avec l'utilisateur.

Cas d'utilisation :

  • Créer des rappels dans votre calendrier Google.
  • Créer des réunions en utilisant des liens de réunion générés automatiquement.

Comment l'utiliser :

1. Ajouter une action Google Calendar​

Pour ajouter une action Google Calendar dans l'éditeur de Callbell, suivez ces étapes :

  1. Ouvrez le constructeur de flux et sélectionnez le point de votre conversation où vous souhaitez intégrer Google Calendar.
  2. Ajoutez une nouvelle action en cliquant sur le bouton Ajouter une action et en sélectionnant Google Calendar dans la liste des actions disponibles, dans la section "Logique".

2. Authentification à votre compte Google​

Cliquez sur le bouton "Connexion Google" et suivez les instructions.

astuce

Assurez-vous de sélectionner tous les droits. Le bot Callbell ne fonctionnera pas correctement si des autorisations sont manquantes.

Vous pouvez également rencontrer cet avertissement de Google :

C'est juste un avertissement temporaire. Dans ce cas, assurez-vous de continuer en cliquant sur "Avancé" puis sur "Continuer avec Callbell".

3. Configuration de l'action​

Vous devrez configurer l'intégration en remplissant les champs suivants :

Sélectionner un calendrier : Choisissez le calendrier Google avec lequel vous souhaitez interagir. Chaque compte Google peut avoir plusieurs calendriers ; celui qui porte une adresse e-mail est votre calendrier principal.

Sélectionner une action : Actuellement, créer un événement est la seule option disponible.

Résumé de l'événement : Le titre de l'événement tel qu'il apparaîtra dans le calendrier.

Mois de l'événement : Le mois dans lequel l'événement sera créé.

Jour de l'événement : Le jour où l'événement sera créé.

Heure de début de l'événement : L'heure à laquelle l'événement commencera. Le format d'heure requis est : HH:MM.

Durée de l'événement (en minutes) : La durée de l'événement en minutes.

Envoyer des mises à jour d'événement à : Les destinataires qui recevront des mises à jour sur l'événement. Les options sont : Aucun ou Tous.

Créer un lien de réunion : Option pour générer un lien vers une réunion virtuelle associée à l'événement.

astuce

Vous pouvez utiliser des variables pour remplir dynamiquement ces champs

4. Gérer le succès​

En cas de réponse réussie de l'API, le résultat indiquera l'état de création de l'événement : confirmé. Par défaut, cette valeur sera enregistrée en tant que Dernière réussite du webhook, mais vous pouvez configurer la variable que vous préférez. Si l'option Créer un lien de réunion est activée, l'URL de la réunion sera stockée dans la variable.

5. Gérer les erreurs​

En cas d'échec de l'API, vous pouvez stocker la réponse d'échec dans une variable dédiée pour une analyse ou des nouvelles tentatives ultérieures. Vous pouvez, par exemple, imaginer une logique qui vérifierait l'échec et réessayerait avec une action de "saut".

6. Exemple​

Voici un exemple de configuration de l'action et de son utilisation avec des variables.

  1. Dans cet exemple, nous avons créé 2 variables :

  1. Résumé, mois et durée ont été définis comme des valeurs fixes.

  2. Nous avons utilisé une combinaison d'actions pour récupérer dynamiquement le jour :

  1. Nous avons fait de même pour récupérer l'heure.

  2. Maintenant, c'est terminé, voici le résultat :

Meilleures pratiques :

  • Assurez-vous toujours que l'API Google est connectée et dispose des autorisations appropriées pour que le bot puisse accéder au calendrier.
  • Testez intégralement l'intégration pour gérer les éventuelles erreurs de l'API (par exemple, des problèmes d'accès au calendrier Google, des problèmes de format de date incorrect). Le simulateur de bot vous aidera dans ce domaine.