VoiceAgent-Tools: Cal.com - CloudTalk Help Center

Dieses Beispiel zeigt, wie Sie zwei Tools einrichten, die zusammen die Terminplanung über Cal.com abwickeln. Ein Tool dient dazu, verfügbare Zeitfenster abzurufen, das andere dazu, eine ausgewählte Zeit zu buchen, sobald der Kunde bestätigt.

Benutzerebene: Admin

Bevor Sie beginnen

Stellen Sie vorab sicher, dass Sie Folgendes haben:

ein aktives Konto bei Cal.com und Admin-Zugriff darauf
ein aktives Abonnement für AI Receptionist oder AI Specialist in Ihrem Konto

Tool 1: Verfügbare Zeitfenster abrufen

Bereich	Feld	Wert	Beschreibung
Allgemein	Tool-Name	`get_free_slots`	Beschreibt, was das Tool tut.
	Beschreibung	Wenn der Kunde nach verfügbaren Terminen fragt, verwenden Sie dieses Tool, um die Liste abzurufen. Die Antwort enthält Datum und Uhrzeit in UTC.	Hilft dem LLM zu entscheiden, wann dieses Tool aufgerufen wird.
	Nachricht bei ausstehender Antwort	Ich prüfe die Verfügbarkeit. Einen Moment bitte.	Nachricht, die abgespielt wird, während die Tool-Anfrage verarbeitet wird.
Anfragedefinition	Methode	`GET`	Anfragemethode.
	URL	`https://api.cal.com/v2/slots?username=#{{userName}}&eventTypeSlug=#{{eventType}}&start=#{{startDate}}&end=#{{endDate}}`	Endpunkt-URL mit Parametern.
Headers	cal-api-version	`2024-09-04`	Von Cal.com vorausgesetzt.
	Authorization	`Bearer cal_live_76*REDACTED*17`	Ersetzen Sie dies durch Ihren Cal.com-API-Schlüssel.
Pfad-Parameter	username	Konstante: `elise-marshall`	Ihr Cal.com-Benutzername. Zu finden in Ihrem Profil.
	eventType	Konstante: `30min`	Slug von der Detailseite des Events in Cal.com. Verwenden Sie LLM-Prompt, wenn mehrere Typen verfügbar sind.
	startDate	Parameter: `startDate`	Legt den Beginn des Suchzeitraums fest. Sollte als System-Prompt-Variable übergeben werden.
	endDate	Parameter: `endDate`	Legt das Ende des Suchzeitraums fest. Wird ebenfalls über eine System-Prompt-Variable übergeben.

Tool 2: Termin buchen

Bereich	Feld	Wert	Beschreibung
Allgemein	Tool-Name	`book_meeting`	Aussagekräftiger Tool-Name.
	Beschreibung	Dieses Tool bucht einen Termin im Kalender, nachdem der Kunde eine Uhrzeit ausgewählt hat.	Hilft dem LLM zu verstehen, wann das Tool zu verwenden ist.
	Nachricht bei ausstehender Antwort	Ich buche den Termin jetzt. Bitte warten Sie einen Moment.	Nachricht, die abgespielt wird, während die Buchung läuft.
Anfragedefinition	Methode	`POST`	Anfragemethode.
	URL	`https://api.cal.com/v2/bookings`	Endpunkt zum Buchen eines Termins.
Headers	cal-api-version	`2024-08-13`	Wie von Cal.com gefordert.
	Authorization	`Bearer cal_live_76*REDACTED*17`	Ersetzen Sie dies durch Ihren API-Schlüssel aus den Cal.com-API-Einstellungen.
Body-Parameter	username	Konstante: `elise-marshall`	Ihr Cal.com-Benutzername.
	eventTypeSlug	Konstante: `30min`	Art des Events, das geplant wird.
	start	LLM-Prompt: Die Startzeit der Buchung im ISO-8601-Format in der Zeitzone UTC, z. B. `2024-08-13T09:00:00Z`.	Wird aus dem Gespräch extrahiert.
	attendee.name	Parameter: `name`	Wird über den System-Prompt übergeben.
	attendee.email	LLM-Prompt: E-Mail-Adresse des Kunden, der den Termin bucht.	Wird dynamisch extrahiert.
	attendee.timezone	Konstante oder LLM-Prompt	Legen Sie dies passend zu Ihrem Workflow fest.

Brauchen Sie Hilfe oder haben Sie eine Frage? Melden Sie sich einfach über unser Support-Portal — wir sind für Sie da.