ConfigurationIntégrations

Cal.com

Connectez vos agents ElevenLabs à la planification Cal.com.

Vue d’ensemble

Connectez vos agents IA ElevenLabs à Cal.com pour gérer la planification et les réservations de calendrier. Cette intégration permet à vos agents de vérifier les disponibilités, de réserver des rendez-vous, d’annuler ou de replanifier des réunions, et de rechercher des réservations existantes par le biais d’une conversation naturelle.

Fonctionnalités

FonctionnalitéPrise en charge
Mode zéro rétention (ZRM)Non pris en charge
Pièces jointes dans les outilsNon prises en charge, les outils utilisent uniquement du texte

Configuration

Cette intégration utilise une clé API Cal.com pour l’authentification, et non une application OAuth.

1

Générer une clé API dans Cal.com

Dans votre compte Cal.com, accédez à Settings > Developer > API Keys, puis cliquez sur New. Copiez immédiatement la clé générée, elle ne sera plus affichée.

2

Utiliser une clé de production

Cal.com génère deux types de clés, des clés de test commençant par cal_ et des clés de production commençant par cal_live_. Utilisez une clé de production pour permettre à votre agent d’accéder aux données réelles du calendrier.

3

Connecter dans ElevenLabs

Dans la configuration de l’intégration ElevenLabs, collez votre clé API Cal.com dans le champ API Key.

Démo

Cette démo utilise des outils webhook hérités. Si vous utilisez l’intégration Cal.com native, les outils sont configurés automatiquement, aucune configuration manuelle des webhooks n’est nécessaire.

Démo de l’intégration Cal.com

Fonctionnement

L’agent planifie les réunions en utilisant des appels d’outils pour suivre les étapes du processus de réservation. Les onglets ci-dessous présentent un résumé général et le prompt système détaillé.

1

Demande initiale et détails de la réunion

L’agent demande l’objet de la réunion, la date et l’heure souhaitées, ainsi que sa durée afin de recueillir les informations de planification.

2

Vérifier les disponibilités du calendrier

L’agent vérifie les disponibilités du calendrier en :

  • utilisant l’outil get_available_slots pour récupérer les créneaux disponibles.
  • vérifiant si l’horaire demandé est disponible.
  • proposant des alternatives si l’horaire demandé n’est pas disponible.
  • confirmant le créneau sélectionné avec l’appelant.
3

Collecter les coordonnées

Une fois l’horaire convenu, l’agent :

  • recueille et valide le nom complet du participant.
  • vérifie l’exactitude de l’adresse email.
  • confirme le fuseau horaire.
  • recueille tous les champs supplémentaires requis pour le type d’événement Cal.com.
4

Créer la réunion

L’agent :

  • appelle l’outil book_meeting après avoir vérifié toutes les informations.
  • suit la structure du modèle de réservation.
  • confirme la création de la réunion au participant.
  • l’informe qu’il recevra une invitation de calendrier.

Configuration manuelle des webhooks

Si vous utilisez l’intégration Cal.com native, les outils sont configurés automatiquement. Les étapes ci-dessous s’appliquent uniquement à la configuration manuelle des webhooks.

1

Stocker votre secret Cal.com

Stockez votre clé API de manière sécurisée avant d’effectuer des requêtes authentifiées. Générez une nouvelle clé API Cal.com si ce n’est pas déjà fait.

L’API Cal.com attend l’en-tête d’authentification suivant :

Structure de l’en-tête de requête Cal
'Authorization': 'Bearer YOUR_API_KEY'

Stockez la clé dans le stockage des secrets de l’agent pour la sécuriser tout en la rendant accessible lors des requêtes.

Pour respecter la structure d’authentification attendue par Cal.com, n’oubliez pas d’ajouter Bearer avant la clé API lors de la création du secret.

Secrets des outils

2

Ajouter des outils à l’agent

Activez les réservations de calendrier en créant deux outils :

  1. get_available_slots : Lorsqu’un utilisateur demande « Louis est-il disponible mardi à 10 h 30 ? », l’agent utilise le point de terminaison « Get available slots » de Cal.com pour vérifier les créneaux disponibles.

  2. book_meeting : Après avoir identifié un créneau adapté, l’agent réserve la réunion via le point de terminaison « Create a booking » de Cal.com.

Accédez à la section Tools du Dashboard et sélectionnez Add Tool. Choisissez Webhook comme type d’outil, puis renseignez les sections suivantes :

Métadonnées utilisées par l’agent pour déterminer quand l’outil doit être appelé :

ChampValeur
Nomget_available_slots
DescriptionCet outil vérifie si un créneau donné est disponible dans le calendrier.
MéthodeGET
URLhttps://api.cal.com/v2/slots

Métadonnées utilisées par l’agent pour déterminer quand l’outil doit être appelé :

ChampValeur
Nombook_meeting
DescriptionCet outil réserve une réunion dans le calendrier une fois l’horaire convenu.
MéthodePOST
URLhttps://api.cal.com/v2/bookings

Testez l’agent en appuyant sur le bouton Test AI agent. Ajustez le prompt système si nécessaire.

3

Ajouter la prise en compte de la date et de l’heure

Par défaut, l’agent ne connaît ni la date ni l’heure actuelles. Utilisez l’une des approches suivantes :

  1. Créer un outil de récupération de l’heure : ajoutez un outil qui récupère la date et l’heure actuelles.

  2. Overrides : utilisez la fonctionnalité overrides pour injecter la date et l’heure actuelles dans le prompt système au début de chaque conversation.

Considérations de sécurité

  • Utilisez des points de terminaison HTTPS pour tous les appels webhook.
  • Stockez les valeurs sensibles sous forme de secrets avec le gestionnaire de secrets ElevenLabs.
  • Vérifiez que tous les en-têtes d’autorisation respectent le format requis (Bearer YOUR_API_KEY).
  • N’exposez jamais les ID de types d’événements ni les détails de l’API aux appelants.

Liens utiles