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

# VoiceAgent-tools: Cal.com

> Dit voorbeeld laat zien hoe u twee tools instelt die samen afspraken inplannen via Cal.com.

<Note>
  Dit voorbeeld laat zien hoe u twee tools instelt die samen afspraken inplannen via [Cal.com](https://cal.com/). De ene tool **haalt beschikbare tijdslots op**, de andere **boekt een gekozen tijdstip** zodra de klant bevestigt.
</Note>

**Gebruikersniveau:** Admin

***

<h2 id="h_6c37ea78bb">
  Voordat u begint
</h2>

Zorg dat u het volgende hebt voordat u begint:

* een actief account in Cal.com en beheerderstoegang daartoe

* een actief AI-receptionist- of AI Specialist-abonnement op uw account

<h3 id="h_7232ab609f">
  Tool 1: beschikbare tijdslots ophalen
</h3>

| **Sectie** | **Veld** | **Waarde** | **Beschrijving** |
| - | - | - | - |
| **Algemeen** | Toolnaam | `get_free_slots` | Geeft aan wat de tool doet. |
| | Beschrijving | Gebruik deze tool om de lijst op te halen wanneer de klant naar beschikbare tijdslots vraagt. Het antwoord bevat data en tijden in UTC. | Helpt het LLM te bepalen wanneer het deze tool moet aanroepen. |
| | Bericht tijdens wachten op antwoord | Ik controleer even de beschikbaarheid. Een moment geduld alstublieft. | Bericht dat wordt afgespeeld terwijl de aanvraag van de tool wordt verwerkt. |
| **Aanvraagdefinitie** | Methode | `GET` | Methode van de aanvraag. |
| | 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=) | Endpoint-URL met parameters. |
| **Headers** | cal-api-version | `2024-09-04` | Vereist door Cal.com. |
| | Authorization | `Bearer cal_live_76***REDACTED***17` | Vervang dit door uw API-sleutel van Cal.com. |
| **Pad-parameters** | username | Constante: `elise-marshall` | Uw gebruikersnaam in Cal.com. U vindt deze in [uw profiel](https://app.cal.com/settings/my-account/profile). |
| | eventType | Constante: `30min` | Slug van de detailpagina van het event in Cal.com. Gebruik LLM Prompt als er meerdere typen beschikbaar zijn. |
| | startDate | Parameter: `startDate` | Bepaalt het begin van het zoekvenster. Geef dit door als variabele in de System Prompt. |
| | endDate | Parameter: `endDate` | Bepaalt het einde van het zoekvenster. Wordt ook doorgegeven via een variabele in de System Prompt. |

<h3 id="h_667269c8a4">
  Tool 2: de afspraak boeken
</h3>

| **Sectie** | **Veld** | **Waarde** | **Beschrijving** |
| - | - | - | - |
| **Algemeen** | Toolnaam | `book_meeting` | Beschrijvende naam van de tool. |
| | Beschrijving | Deze tool boekt een afspraak in de agenda nadat de klant een tijdstip heeft gekozen. | Helpt het LLM te begrijpen wanneer het de tool moet gebruiken. |
| | Bericht tijdens wachten op antwoord | Ik plan de afspraak nu in. Een moment geduld. | Bericht dat wordt afgespeeld terwijl de boeking wordt verwerkt. |
| **Aanvraagdefinitie** | Methode | `POST` | Methode van de aanvraag. |
| | URL | [`https://api.cal.com/v2/bookings`](https://api.cal.com/v2/bookings) | Endpoint voor het boeken van een afspraak. |
| **Headers** | cal-api-version | `2024-08-13` | Zoals vereist door Cal.com. |
| | Authorization | `Bearer cal_live_76***REDACTED***17` | Vervang dit door uw API-sleutel uit de [API-instellingen van Cal.com](https://app.cal.com/settings/developer/api-keys). |
| **Body-parameters** | username | Constante: `elise-marshall` | Uw gebruikersnaam in Cal.com. |
| | eventTypeSlug | Constante: `30min` | Type event dat wordt ingepland. |
| | start | LLM Prompt: de starttijd van de boeking in ISO 8601-formaat in de UTC-tijdzone, bijv. `2024-08-13T09:00:00Z`. | Wordt uit het gesprek gehaald. |
| | attendee.name | Parameter: `name` | Wordt doorgegeven via de System Prompt. |
| | attendee.email | LLM Prompt: e-mailadres van de klant die de afspraak boekt. | Wordt dynamisch opgehaald. |
| | attendee.timezone | Constante of LLM Prompt | Stel dit in op basis van uw workflow. |

***

*Hulp nodig of hebt u een vraag?* Neem gerust contact met ons op via ons [Supportportaal](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) — we staan voor u klaar.


## Related topics

- [Tools voor VoiceAgent](/nl/articles/11275049-tools-for-voiceagent.md)
- [Vaardigheid Afspraak boeken voor Voice Agents](/nl/articles/15923950-appointment-booking-skill-for-voice-agents.md)
- [Scenario's & Guardrails voor VoiceAgents](/nl/articles/14073408-voiceagent-scenarios-guardrails.md)


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