---
title: Cal.com
description: >-
  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.

:::tip[Quand l'utiliser]
Prise de rendez-vous lorsque l'agenda se trouve déjà dans Cal.com : consultations,
démonstrations, visites sur site. Pour tout autre agenda, placez la réservation derrière un
[Live Webhook](/fr/build/tools/live-webhook) ou une [intégration](/fr/operate/integrations/overview).
:::

![Le formulaire Cal.com.](/media/build/cal-com-form.webp)

## 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](/fr/build/tools/overview#les-champs-communs-à-tous-les-tools) :

| 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](/fr/operate/call-details).

## 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).

## Voir aussi

- [Présentation des outils](/fr/build/tools/overview)
- [Live Webhook](/fr/build/tools/live-webhook)
- [Présentation des intégrations](/fr/operate/integrations/overview)