> ## Documentation Index
> Fetch the complete documentation index at: https://help.cloudtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Outils VoiceAgent : Cal.com

> Cet exemple montre comment configurer deux outils qui fonctionnent ensemble pour gérer la prise de rendez-vous via Cal.com.

<Note>
  Cet exemple montre comment configurer deux outils qui fonctionnent ensemble pour gérer la prise de rendez-vous via [Cal.com](https://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é.
</Note>

**Niveau d'utilisateur :** Admin

***

<h2 id="h_6c37ea78bb">
  Avant de commencer
</h2>

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

<h3 id="h_7232ab609f">
  Outil 1 : récupérer les créneaux horaires disponibles
</h3>

| **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}}`](https://api.cal.com/v2/slots?username=\&eventTypeSlug=\&start=\&end=) | 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](https://app.cal.com/settings/my-account/profile). |
| | 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. |

<h3 id="h_667269c8a4">
  Outil 2 : réserver le rendez-vous
</h3>

| **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`](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](https://app.cal.com/settings/developer/api-keys). |
| **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](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) — nous sommes là pour vous.


## Related topics

- [Outils pour VoiceAgent](/fr/articles/11275049-tools-for-voiceagent.md)
- [Compétence Prise de rendez-vous pour les Voice Agents](/fr/articles/15923950-appointment-booking-skill-for-voice-agents.md)
- [Scénarios et garde-fous du VoiceAgent](/fr/articles/14073408-voiceagent-scenarios-guardrails.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.