Outils VoiceAgent : Cal.com - CloudTalk Help Center

Cet exemple montre comment configurer deux outils qui fonctionnent ensemble pour gérer la prise de rendez-vous via Cal.com. Le premier outil sert à récupérer les créneaux horaires disponibles, et le second à réserver un créneau sélectionné une fois que le client a confirmé.

Niveau d’utilisateur : Admin

Avant de commencer

Avant de commencer, assurez-vous de disposer :

d’un compte actif dans Cal.com et d’un accès administrateur à celui-ci
d’un abonnement actif Réceptionniste IA ou AI Specialist sur votre compte

Outil 1 : récupérer les créneaux horaires disponibles

Section	Champ	Valeur	Description
Général	Nom de l’outil	`get_free_slots`	Décrit ce que fait l’outil.
	Description	Lorsque le client demande les créneaux disponibles, utilisez cet outil pour obtenir la liste. La réponse contiendra les dates et heures en UTC.	Aide le LLM à décider quand appeler cet outil.
	Message d’attente de réponse	Je vérifie les disponibilités. Un instant, s’il vous plaît.	Message diffusé pendant le traitement de la requête de l’outil.
Définition de la requête	Méthode	`GET`	Méthode de la requête.
	URL	`https://api.cal.com/v2/slots?username=#{{userName}}&eventTypeSlug=#{{eventType}}&start=#{{startDate}}&end=#{{endDate}}`	URL du point de terminaison avec les paramètres.
En-têtes	cal-api-version	`2024-09-04`	Requis par Cal.com.
	Authorization	`Bearer cal_live_76*REDACTED*17`	Remplacez par votre clé API Cal.com.
Paramètres de chemin	username	Constante : `elise-marshall`	Votre nom d’utilisateur Cal.com. Vous le trouverez dans votre profil.
	eventType	Constante : `30min`	Slug figurant sur la page de détail de l’événement dans Cal.com. Utilisez un LLM Prompt si plusieurs types sont disponibles.
	startDate	Paramètre : `startDate`	Définit le début de la fenêtre de recherche. Doit être transmis comme variable du System Prompt.
	endDate	Paramètre : `endDate`	Définit la fin de la fenêtre de recherche. Également transmis via une variable du System Prompt.

Outil 2 : réserver le rendez-vous

Section	Champ	Valeur	Description
Général	Nom de l’outil	`book_meeting`	Nom descriptif de l’outil.
	Description	Cet outil réserve une réunion dans l’agenda une fois que le client a choisi un horaire.	Aide le LLM à comprendre quand utiliser l’outil.
	Message d’attente de réponse	Je planifie la réunion. Veuillez patienter.	Message diffusé pendant la réservation.
Définition de la requête	Méthode	`POST`	Méthode de la requête.
	URL	`https://api.cal.com/v2/bookings`	Point de terminaison pour réserver une réunion.
En-têtes	cal-api-version	`2024-08-13`	Tel que requis par Cal.com.
	Authorization	`Bearer cal_live_76*REDACTED*17`	Remplacez par votre clé API issue des paramètres API de Cal.com.
Paramètres du corps	username	Constante : `elise-marshall`	Votre nom d’utilisateur Cal.com.
	eventTypeSlug	Constante : `30min`	Type d’événement planifié.
	start	LLM Prompt : heure de début de la réservation au format ISO 8601 dans le fuseau horaire UTC, par ex. `2024-08-13T09:00:00Z`.	Extraite de la conversation.
	attendee.name	Paramètre : `name`	Transmis via le System Prompt.
	attendee.email	LLM Prompt : e-mail du client qui réserve la réunion.	Extrait dynamiquement.
	attendee.timezone	Constante ou LLM Prompt	À définir en fonction de votre flux de travail.

Besoin d’aide ou vous avez une question ? Contactez-nous simplement via notre Portail Support — nous sommes là pour vous.