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

> Dieses Beispiel zeigt, wie Sie zwei Tools einrichten, die zusammen die Terminplanung über Cal.com abwickeln.

<Note>
  Dieses Beispiel zeigt, wie Sie zwei Tools einrichten, die zusammen die Terminplanung über [Cal.com](https://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.
</Note>

**Benutzerebene:** Admin

***

<h2 id="h_6c37ea78bb">
  Bevor Sie beginnen
</h2>

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

<h3 id="h_7232ab609f">
  Tool 1: Verfügbare Zeitfenster abrufen
</h3>

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

<h3 id="h_667269c8a4">
  Tool 2: Termin buchen
</h3>

| **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`](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](https://app.cal.com/settings/developer/api-keys). |
| **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](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) — wir sind für Sie da.


## Related topics

- [Tools für VoiceAgent](/de/articles/11275049-tools-for-voiceagent.md)
- [Fähigkeit Terminbuchung für Voice Agents](/de/articles/15923950-appointment-booking-skill-for-voice-agents.md)
- [VoiceAgent-Szenarien & Leitplanken](/de/articles/14073408-voiceagent-scenarios-guardrails.md)


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