Aller au contenu

Intégration Cal.com

Connectez Cal.com et votre agent IA réserve des rendez-vous dans le chat

Collez une clé API Cal.com, choisissez un type d'événement, et votre agent intoCHAT affiche de vrais créneaux libres sous sa réponse. Le visiteur en choisit un, saisit son nom et son e-mail, et la réservation est créée dans Cal.com, qui envoie sa confirmation habituelle.

Créer votre agent gratuitement Voir la documentation

Dernière mise à jour:

Comment intoCHAT et Cal.com fonctionnent ensemble

intoCHAT communique avec l'API de Cal.com (version 2, sur api.cal.com) à l'aide d'une clé API de votre compte Cal.com. Avec cette clé, il fait trois choses et rien d'autre : il liste vos types d'événements pour que vous en choisissiez un, il lit les créneaux libres de ce type d'événement, et il crée une réservation quand un visiteur confirme un créneau. Vos règles de disponibilité, vos temps tampons et vos calendriers connectés restent dans Cal.com, d'où viennent les créneaux libres. Le modèle d'IA n'invente jamais d'horaire. C'est l'agent qui décide quand afficher le sélecteur de créneaux, guidé par un court texte que vous rédigez : When to offer booking. Quand la conversation s'y prête, par exemple si un visiteur demande une démo ou veut savoir quand quelqu'un est disponible, il affiche les créneaux libres sous sa réponse. Il n'écrit pas les horaires dans son texte et ne demande ni nom ni e-mail dans le chat : le visiteur les saisit dans le sélecteur. Juste avant la réservation, intoCHAT demande de nouveau à Cal.com si le créneau est toujours libre. Si quelqu'un d'autre l'a pris entre-temps, le visiteur est invité à en choisir un autre, et rien n'est réservé deux fois. Si votre type d'événement exige que vous confirmiez les réservations, la confirmation dans le chat commence par « Demandé : » au lieu de « Réservé : » et indique que le rendez-vous doit encore être confirmé. Cette page porte sur la connexion à Cal.com elle-même : mise en place, ce qui est synchronisé et les limites. Pour voir à quoi ressemble la réservation dans le chat côté visiteur, et comment l'utiliser en vente et en support, consultez la page de la fonctionnalité de prise de rendez-vous.

Connecter Cal.com à votre agent intoCHAT

  1. Créez une clé API dans Cal.com

    Dans Cal.com, ouvrez Settings, Developer, API keys et créez une clé. Elle commence par cal_. Il vous faut aussi au moins un type d'événement, par exemple un appel découverte de 30 minutes.

  2. Ouvrez la carte Booking

    Dans intoCHAT, ouvrez votre agent et allez dans l'onglet Actions. La carte Booking se trouve sous vos actions et formulaires. Sous Calendar, choisissez Cal.com.

  3. Collez la clé et cliquez sur Connect

    Collez-la dans le champ Cal.com API key. intoCHAT vérifie la clé en chargeant vos types d'événements, l'enregistre chiffrée et n'affiche ensuite que cal_… et ses quatre derniers caractères.

  4. Choisissez le type d'événement à réserver

    Chaque type d'événement affiche son titre et sa durée. Un type marqué « (hidden in Cal.com) » est masqué sur votre page de réservation publique, mais les visiteurs peuvent quand même le réserver depuis le chat.

  5. Indiquez quand proposer la réservation, puis enregistrez

    Remplissez si vous le souhaitez When to offer booking, jusqu'à 1 000 caractères, lu par l'agent et jamais montré aux visiteurs. Cliquez sur Save : la réservation est active dès l'enregistrement.

  6. Réservez un rendez-vous de test

    Demandez un rendez-vous dans le Playground et réservez un créneau. Les réservations du Playground sont réelles : elles créent le rendez-vous dans Cal.com et déclenchent ses e-mails, annulez donc ensuite les réservations de test dans Cal.com.

When to offer booking, si vous laissez le champ vide

When the visitor wants to book a meeting, call, demo or appointment, or asks when the team is available.

Le champ affiche ce texte par défaut en anglais. Rédigez le vôtre pour être plus précis, par exemple seulement une fois que le visiteur a indiqué le produit qui l'intéresse.

Ce qui est synchronisé entre intoCHAT et Cal.com

  • Des créneaux libres lus en direct

    Les créneaux viennent de Cal.com à chaque ouverture du sélecteur : jusqu'à 5 jours avec des créneaux libres et jusqu'à 8 horaires par jour, 7 jours à l'avance par défaut, ou les jours demandés par le visiteur, jusqu'à un an à l'avance.

  • Des réservations créées dans Cal.com

    Un créneau confirmé devient une réservation Cal.com avec le nom, l'e-mail et le fuseau horaire du visiteur. Cal.com envoie ses e-mails et invitations de calendrier habituels ; intoCHAT n'envoie aucun e-mail de son côté.

  • Le fuseau horaire du visiteur

    Les créneaux s'affichent dans le fuseau horaire du navigateur du visiteur, par exemple « Heures pour le fuseau Europe/Berlin », et sont écrits comme son navigateur écrit dates et heures.

  • Une liste des réservations dans intoCHAT

    La carte Bookings de l'onglet Leads liste chaque rendez-vous réservé depuis le chat, avec le nom, l'e-mail et le fuseau horaire du visiteur et un lien vers la conversation.

  • Webhook et alerte Slack

    Abonnez un webhook à Meeting booked pour recevoir booking.created avec le provider calcom et l'identifiant de la réservation Cal.com, ou cochez Booked meeting dans Slack alerts.

  • Une clé réservée aux réservations

    La clé est enregistrée chiffrée et n'est plus jamais affichée. intoCHAT s'en sert pour lire les types d'événements et les créneaux libres et pour créer des réservations, rien d'autre dans Cal.com.

Questions fréquentes

Quelle offre intoCHAT faut-il pour Cal.com ?

N'importe laquelle, y compris Free : la réservation avec Cal.com n'est liée à aucune offre intoCHAT payante. Réserver un créneau ne consomme pas de message ; la réponse qui affiche les créneaux compte comme n'importe quelle autre réponse. Les procédures, à partir de Starter, peuvent aussi demander à l'agent de proposer la réservation après quelques questions de qualification.

Une annulation dans Cal.com apparaît-elle dans intoCHAT ?

Non. Rien n'est synchronisé en retour depuis Cal.com. Si un rendez-vous y est déplacé ou annulé, la liste des réservations et la conversation affichent toujours la réservation d'origine, et aucun webhook n'est envoyé. Les visiteurs annulent ou déplacent via les e-mails de Cal.com, pas dans le chat.

Puis-je connecter une instance Cal.com auto-hébergée ?

Pas pour l'instant. intoCHAT se connecte à l'API hébergée de Cal.com sur api.cal.com : la clé API doit donc provenir d'un compte sur ce service.

Un agent peut-il proposer plusieurs types d'événements ?

Non. Chaque agent réserve un seul type d'événement d'un seul calendrier à la fois. Utilisez Change event type sur la carte Booking pour en changer. Pour proposer une démo commerciale et un appel de support, créez deux agents, chacun avec son propre type d'événement.

Et si Cal.com refuse ma clé ?

La carte indique « Cal.com didn't accept this API key. » Vérifiez que vous avez copié toute la clé et qu'elle n'a pas expiré ni été supprimée dans Cal.com. Si votre compte n'a encore aucun type d'événement, créez-en un et cliquez de nouveau sur Connect. Vous pouvez vérifier des clés jusqu'à 10 fois en 10 minutes.

Que se passe-t-il si le créneau vient d'être pris ?

intoCHAT interroge de nouveau Cal.com juste avant la réservation. Si le créneau n'est plus libre, le visiteur voit « Ce créneau vient d'être réservé. Veuillez en choisir un autre. » et ce créneau disparaît de la liste.

Une réservation est-elle aussi enregistrée comme lead ?

Non. Une réservation a sa propre liste, son propre webhook (booking.created) et sa propre alerte Slack. Le nom et l'e-mail saisis dans le sélecteur ne créent pas de lead et n'envoient pas d'alerte lead, et les réservations ne sont pas comptées dans Outcomes sur le tableau de bord.

Comment suspendre la réservation sans perdre la configuration ?

Utilisez l'interrupteur On / Off dans l'en-tête de la carte Booking. Disconnect arrête la réservation et supprime la clé enregistrée ; les rendez-vous déjà réservés restent dans Cal.com et dans la liste des réservations. Un agent dupliqué ne reprend pas la connexion Cal.com : reconnectez-la dans la copie.

Voyez-le répondre à partir de votre site

Collez l’adresse de votre site et discutez avec un agent créé à partir de vos pages. Cela prend environ une minute.

Créer votre agent gratuitement

Offre gratuite, sans carte bancaire.