VoiceAgent-tools: Cal.com - CloudTalk Help Center

Dit voorbeeld laat zien hoe u twee tools instelt die samen afspraken inplannen via Cal.com. De ene tool haalt beschikbare tijdslots op, de andere boekt een gekozen tijdstip zodra de klant bevestigt.

Gebruikersniveau: Admin

Voordat u begint

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

Tool 1: beschikbare tijdslots ophalen

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}}`	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.
	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.

Tool 2: de afspraak boeken

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`	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.
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 — we staan voor u klaar.