Skip to main content
La prise de rendez-vous est le cas d’usage classique des agents vocaux : l’assistant vérifie les créneaux disponibles pendant l’appel, propose quelques options, puis réserve celui que l’appelant choisit. La plateforme prend en charge cela de deux manières, combinables librement :
  1. Calendar integrations — connectez une fois un fournisseur de planification externe (Acuity Scheduling, Cal.com, Calendly, eTermin, HighLevel), attribuez-le à un assistant, et celui-ci obtient automatiquement des outils de réservation pour chaque appel. Google Calendar et Outlook se connectent au même endroit, mais alimentent la synchronisation de calendrier du moteur intégré plutôt que la réservation en cours d’appel — voir la remarque sous le tableau.
  2. Le moteur de réservation intégré — définissez vos propres types d’événements avec une disponibilité hebdomadaire, et obtenez une page de réservation publique et intégrable à l’adresse /book/{workspace}/{slug}, des e-mails d’invitation ICS, ainsi qu’une intégration native sur laquelle vos assistants peuvent réserver. Aucun compte externe requis. Voir Calendrier intégré pour une vue d’ensemble complète.

​
Aperçu des fournisseurs

Google Calendar et Outlook sont des cibles de synchronisation, pas des fournisseurs de réservation en cours d’appel. Les connecter met leurs plages occupées et la création d’événements à disposition du moteur de réservation intégré ; les assistants ne peuvent pas encore les appeler directement pendant une conversation. Pour réserver sur ces calendriers en cours d’appel, placez devant eux un type d’événement Cal.com, Calendly, Acuity ou HighLevel, ou utilisez un type d’événement intégré avec la synchronisation de calendrier activée.
Mode lien Calendly : l’API de planification de Calendly nécessite un forfait Calendly payant. Si votre forfait ne permet pas la réservation directe, réglez le booking_mode de l’intégration sur link — l’assistant convient alors d’un horaire approximatif avec l’appelant et envoie un lien de planification à usage unique par SMS ou e-mail (link_channel) plutôt que de réserver directement. Les intégrations qui rencontrent cette restriction de forfait payant au moment de l’appel sont signalées avec le statut link_mode.

​
Connecter une intégration

Allez dans Booking → Integrations et choisissez une carte de fournisseur :
Collez votre clé API (Cal.com → Settings → Developer → API Keys) et choisissez le API endpoint : US (par défaut), EU, ou Custom pour une instance Cal.com auto-hébergée. Sélectionnez Load event types pour récupérer vos événements par nom et durée — inutile de copier un ID numérique depuis l’URL. L’intégration lit aussi automatiquement les questions de réservation personnalisées du type d’événement ; utilisez Refresh fields si vous les modifiez plus tard dans Cal.com. Fuseau horaire personnalisable en option — veillez à ce qu’il corresponde à celui du type d’événement Cal.com.
Chaque intégration est vérifiée avant d’être enregistrée. Des identifiants ou des réglages d’événement invalides sont rejetés avec un message d’erreur clair. Les valeurs secrètes ne sont plus jamais affichées après l’enregistrement. Supprimer la dernière intégration utilisant un compte Acuity révoque son jeton OAuth via le point de terminaison de déconnexion d’Acuity et supprime la connexion locale. Un compte inutilisé peut aussi être retiré avec Disconnect account dans l’éditeur Acuity ; les comptes partagés ne peuvent être déconnectés qu’une fois leurs intégrations restantes supprimées. Les intégrations existantes utilisant un jeton d’accès personnel restent opérationnelles, mais apparaissent comme Legacy connection — reconnect with Calendly. Se reconnecter les fait passer à OAuth et retire le PAT de l’intégration.

​
Attribution à un assistant

Ouvrez les paramètres de l’assistant et cochez les intégrations qu’il doit utiliser (ou appelez PUT /api/v1/assistants/{id}/integrations). Chaque intégration attribuée ajoute ses propres outils de réservation à chaque appel : Chaque intégration reçoit check_availability et book_appointment. Les outils de gestion ne sont ajoutés que lorsque le fournisseur les prend en charge : Calendly (recherche et annulation), Acuity (recherche, annulation et replanification, selon les bascules que vous avez définies), et le moteur intégré, qui ajoute un ensemble commun à tout l’espace de travail identifiant l’appelant d’abord par son numéro de téléphone, puis, à défaut, par e-mail et nom complet. Les calendriers Cal.com, eTermin et HighLevel n’offrent actuellement que la disponibilité et la réservation — l’assistant peut lire les créneaux et réserver, mais pas rechercher, annuler ou déplacer un rendez-vous existant pendant un appel. Si plusieurs intégrations sont attribuées, le nom de l’intégration est ajouté en suffixe au nom de l’outil (par exemple check_availability_sales). Les créneaux sont toujours annoncés dans le fuseau horaire de l’assistant — configurez-le dans les paramètres de l’assistant.
Les réservations Calendly ne peuvent pas être replanifiées via son API — un appelant qui souhaite un autre horaire obtient à la place un nouveau cancel_appointment suivi d’un book_appointment, ou replanifie via le lien présent dans son e-mail de confirmation Calendly.
Indiquez à l’assistant quand réserver dans son prompt, par exemple : « Avant de proposer un horaire, appelle check_availability. Une fois que l’appelant confirme un créneau, appelle book_appointment avec son nom et son e-mail. »

​
Limitation par le forfait

Votre forfait doit inclure Calendar integrations. Si ce n’est pas le cas, vous ne pouvez pas créer d’intégrations.

​
Dépannage

Vérifiez que la clé est toujours active dans Cal.com et que vous avez collé une clé de production (les clés de production Cal.com commencent par cal_live_), puis sélectionnez à nouveau Load event types. Si vous obtenez une erreur d’authentification au lieu d’une liste vide, vous avez probablement choisi le mauvais point de terminaison API — un compte Cal.com EU a besoin du point de terminaison EU (ou Custom pour une instance auto-hébergée), pas du point de terminaison US par défaut.
book_appointment a besoin d’une adresse e-mail valide, car Cal.com refuse une réservation sans elle. Les adresses dictées à l’oral (« anna arobase example point com ») et les trémas allemands sont convertis automatiquement avant l’envoi de la requête, donc la plupart des adresses dictées fonctionnent ; si ce que l’assistant a entendu reste inutilisable, il est invité à redemander plutôt qu’à réserver quand même. Indiquez-lui dans le prompt de collecter et de confirmer l’e-mail avant de réserver, et de réutiliser une adresse déjà disponible comme variable d’appel plutôt que de la redemander deux fois.
Le seul lieu configuré pour ce type d’événement dans Calendly est un lien de visioconférence (Google Meet, Zoom, Teams), et l’agent vocal ne peut pas générer de lien de réunion. Dans Calendly, modifiez le type d’événement et ajoutez Custom ou Phone Call → Inbound call comme lieu — Custom est le choix le plus sûr et fonctionne dans tous les cas. Si le type d’événement se retrouve avec plusieurs lieux, choisissez le bon sous Meeting location dans l’intégration.
Dans une organisation Calendly, les comptes admin et owner voient les types d’événements de tous les membres, y compris les événements Round Robin et Collective ; un compte membre standard ne voit que les siens.
Un test Web Call s’exécute sans numéro de téléphone, donc tout ce que le flux de réservation déduit du numéro de l’appelant (envoi d’un lien de planification par SMS, recherche d’un rendez-vous par téléphone) ne peut pas fonctionner de la même façon. Utilisez Test → Call dans l’en-tête de l’assistant pour un test réaliste : l’assistant compose un numéro que vous saisissez, ou vous composez vous-même son numéro entrant.
Toujours bloqué ? Contactez le support en indiquant le nom de l’intégration, l’erreur affichée dans l’éditeur d’assistant, et une transcription de l’appel dont la réservation a échoué.

​
API & MCP

Tout ce qui précède est disponible dans l’API REST publique et sous forme d’outils MCP à l’adresse https://<your-domain>/mcp : Les types d’événements, les connexions et les enregistrements de réservation du moteur intégré sont traités dans Calendrier intégré.