Cal.com
Réserve un rendez-vous dans votre agenda Cal.com pendant la conversation, avec une clé API et un type d'événement. D'où vient chaque valeur.
Cal.com planifie un rendez-vous avec l’appelant. L’agent convient d’un horaire au cours de la conversation, puis le réserve sur un type d’événement Cal.com via votre clé API.
Avant de commencer
- Un compte Cal.com avec un type d’événement correspondant au rendez-vous que l’agent réservera (la durée, les disponibilités et le lieu s’y définissent, et non ici).
- Une clé API issue des paramètres de Cal.com, et l’identifiant numérique du type d’événement.
Configuration
Ouvrez Tools (Outils) sous Build (Créer), choisissez Add tool (Ajouter un outil), puis Cal.com. Après les champs communs à tous les outils :
| Champ | Type | Valeur par défaut | Remarques |
|---|---|---|---|
| Tool Title (Titre de l’outil) | Texte | Schedule Meeting |
Son identifiant, schedule_meeting, s’affiche sous le champ. |
| Description | Texte | Schedule a meeting with the caller using Cal.com |
Précisez ce que l’agent doit obtenir au préalable : after confirming the caller's name, email and preferred time. |
| AI Response (Réponse de l’IA) | Texte | Let me schedule a meeting for you. |
|
| Cal.com API Key (Clé API Cal.com) | Mot de passe | vide | Obligatoire. Doit se composer de cal_live_ suivi de 32 lettres ou chiffres. Stockée avec l’agent. |
| Event Type ID (Identifiant du type d’événement) | Nombre | vide | Obligatoire. L’identifiant numérique du type d’événement à réserver. |
Les deux champs Cal.com portent la mention Required to schedule meetings on your calendar (Obligatoire pour planifier des rendez-vous dans votre agenda). Choisissez Add Tool (Ajouter l’outil), puis Save (Enregistrer) l’agent.
Comportement et limites
- Un outil réserve un seul type d’événement. Pour plusieurs durées de rendez-vous ou plusieurs hôtes, ajoutez un outil par type d’événement, avec des noms et des descriptions distincts.
- Les disponibilités sont celles de Cal.com. L’agent propose ce que le type d’événement autorise ; assurez-vous que ses disponibilités sont définies avant de tester.
- La réservation est enregistrée comme un appel d’outil sur la page de l’appel. Voir Détails de l’appel.
Dépannage
- Le formulaire refuse la clé API. Elle doit se composer de
cal_live_suivi de 32 lettres ou chiffres ; copiez-la de nouveau depuis Cal.com, sans espaces. - Rien n’est réservé. La clé API ou l’identifiant du type d’événement est incorrect, ou la clé appartient à un compte qui n’a pas accès à ce type d’événement. Vérifiez les deux dans Cal.com.
- L’agent réserve sans demander d’adresse e-mail. Ajoutez cette exigence dans Description et dans Tasks (Tâches).