Zum Hauptinhalt springen
Aktivieren Sie Ihren KI-Assistenten, um nahtlos Meetings und Termine mit Cal.com-Integration zu planen. Diese leistungsstarke Funktion ermöglicht es Ihrer KI, Verfügbarkeit zu überprüfen und Meetings direkt während Anrufen zu buchen.

​
Voraussetzungen

Vor der Einrichtung der Cal.com-Integration benötigen Sie:
  • Ein Cal.com-Konto (Cal.com US, Cal.com EU oder self-hosted Cal.com)
  • Einen konfigurierten Ereignistyp in Cal.com
  • Einen API-Schlüssel von Cal.com

​
Einrichtung

​
1. API-Schlüssel erstellen

  1. Melden Sie sich bei Cal.com an
  2. Gehen Sie zu Einstellungen → Developer → API Keys
  3. Erstellen Sie einen neuen API-Schlüssel und kopieren Sie ihn

​
2. Region auswählen

Cal.com bietet verschiedene API-Regionen. Wählen Sie die passende für Ihr Cal.com-Konto:
RegionAPI-Endpunkt
US (Standard)api.cal.com
EUapi.cal.eu
BenutzerdefiniertIhr self-hosted Cal.com-Endpunkt
Wählen Sie Ihre Region im Cal.com-Konfigurationspanel aus, bevor Sie eine Verbindung herstellen. Falls unsicher, ist der US-Endpunkt der Standard.

​
3. Cal.com verbinden

  1. In Ihren Assistenten-Einstellungen → Tools Tab → Terminplanung
  2. Wählen Sie Cal.com als Kalendertyp
  3. Wählen Sie Ihre API-Region
  4. Fügen Sie Ihren API-Schlüssel ein
  5. Wählen Sie ein Event aus dem Dropdown

​
4. Event synchronisieren

Klicken Sie auf “Sync Event”, um Buchungsfelder automatisch zu konfigurieren.
Die Synchronisierung liest automatisch die benutzerdefinierten Felder Ihres Event-Typs und konfiguriert sie für den KI-Assistenten. Name, E-Mail und Telefon werden als erforderlich gesetzt. Alle anderen benutzerdefinierten Buchungsfelder werden automatisch importiert.

​
Event-Typen

​
Persönliche Events

Wählen Sie aus Ihren persönlichen Event-Typen (z.B. 15-Minuten-Kennenlerngespräch, 30-Minuten-Beratung).

​
Team Events

Sie können auch Team Event-Typen buchen. Wenn Ihr API-Schlüssel Zugriff auf Team-Kalender hat, erscheinen Team-Events im Event-Dropdown separat von persönlichen Events.
Team Events sind nützlich, wenn Sie möchten, dass die KI Meetings bucht, die basierend auf Verfügbarkeit an Ihre Teammitglieder verteilt werden.

​
Dynamische Buchungsfelder

Wenn Sie ein Event synchronisieren, liest das System automatisch alle benutzerdefinierten Buchungsfelder, die für diesen Event-Typ in Cal.com konfiguriert sind. Das bedeutet:
  • Keine manuelle Feldkonfiguration — Felder werden direkt von Ihrem Cal.com Event-Typ abgerufen
  • Benutzerdefinierte Felder unterstützt — alle benutzerdefinierten Felder, die Sie Ihrem Cal.com Event-Typ hinzufügen, sind automatisch verfügbar
  • Auto-Aktualisierung bei Sync — klicken Sie erneut auf “Sync Event”, wenn Sie die Buchungsfelder Ihres Cal.com Events ändern

​
Mehrere Kalender

Klicken Sie auf ”+” neben Terminplanung, um weitere Kalender hinzuzufügen (z.B. 15-Min, 30-Min Meetings).

​
E-Mail-Einrichtung

Damit Kalendereinladungen funktionieren:
  1. Definieren Sie email in den Eingabevariablen des Assistenten
  2. Übergeben Sie die Kunden-E-Mail beim Erstellen von Leads
Die Telefonnummer wird nach der Synchronisierung automatisch eingefügt.

​
Verfügbarkeit für mehrere Tage abrufen

Um Ihrem KI-Assistenten zu ermöglichen, verfügbare Zeitslots über mehrere Tage abzurufen, müssen Sie eine benutzerdefinierte Mid-Call-Aktion erstellen, die die Cal.com Slots-API aufruft.
1

Mid-Call-Aktion erstellen

  1. Navigieren Sie zu Ihren Assistenten-Einstellungen und erstellen Sie eine neue Mid-Call-Aktion
  2. Konfigurieren Sie das Tool mit folgenden Details:
    • Endpoint: https://api.cal.com/v2/slots?eventTypeId=YOUR_EVENT_ID&timeZone=YOUR_TIMEZONE
    • Methode: GET
    • Headers: Fügen Sie den Header cal-api-version mit dem Wert 2024-09-04 hinzu
Mid-Call-Aktion Konfiguration für Cal.com Slots API
Die eventTypeId in der Endpoint-URL ist ein Beispiel. Ersetzen Sie sie durch Ihre tatsächliche Event-Typ-ID von Cal.com.
2

Event-Typ-ID ermitteln

  1. Gehen Sie zu Cal.com und navigieren Sie zu Ihrem Event
  2. Klicken Sie auf das Event, das Sie verwenden möchten
  3. Schauen Sie in die URL in Ihrem Browser — die Event-ID ist die Zahl in der URL
  4. Kopieren Sie diese ID und ersetzen Sie YOUR_EVENT_ID in der Endpoint-URL
3

Zeitzone festlegen

Ersetzen Sie YOUR_TIMEZONE in der Endpoint-URL mit Ihrer Zeitzone im Format Kontinent/Stadt (z.B. europe/berlin, america/new_york, asia/tokyo).
4

Tool-Parameter hinzufügen

Konfigurieren Sie folgende Parameter für Ihr Tool:
  • start (String): Startdatum für die Kalenderabfrage, z.B. 2025-11-10
  • end (String): Enddatum für die Kalenderabfrage, z.B. 2025-11-17
Diese Parameter ermöglichen es der KI, den Datumsbereich dynamisch anzugeben.
5

Tool dem Assistenten zuweisen

  1. Öffnen Sie Ihre Assistenten-Einstellungen
  2. Navigieren Sie zum Tab “Prompt & Tools” (zweiter Tab)
  3. Im Bereich “Custom mid call tools” klicken Sie auf ”+ Create tool” oder wählen Sie Ihr erstelltes Tool
  4. Fügen Sie das Tool Ihrem Assistenten hinzu
Benutzerdefiniertes Tool im Prompt & Tools Bereich zuweisen
6

System-Prompt aktualisieren

Fügen Sie in Ihrem System-Prompt eine Anweisung hinzu, die der KI sagt, wann und wie sie dieses Tool verwenden soll:
Perform a function call using get_calendar_slots to retrieve true available time slots across multiple days.
Dies stellt sicher, dass die KI das Tool nutzt, wenn Kunden nach Verfügbarkeit über mehrere Tage fragen.
Stellen Sie sicher, dass der Tool-Name mit dem übereinstimmt, was Sie in Ihrem System-Prompt referenzieren. Wenn Sie Ihr Tool get_calendar_slots genannt haben, verwenden Sie genau diesen Namen in den Prompt-Anweisungen.

​
Abwärtskompatibilität

Wenn Sie bereits eine Cal.com-Integration konfiguriert haben, funktionieren Ihre bestehenden Einstellungen weiterhin ohne Änderungen. Die Region ist standardmäßig auf US gesetzt, und bestehende Feldkonfigurationen bleiben erhalten. Optional können Sie erneut synchronisieren, um dynamische Buchungsfelder zu nutzen.

​
Fehlerbehebung

Ungültiger API-Schlüssel: Überprüfen Sie, ob er in den Cal.com-Einstellungen aktiv ist und das Präfix cal_live_ enthält Synchronisierung fehlgeschlagen: Klicken Sie auf “Troubleshoot”, um Felder zurückzusetzen Keine Einladungen gesendet: Stellen Sie sicher, dass die email-Variable definiert und mit Leads übergeben wird Feldfehler: Verwenden Sie “Troubleshoot” zum Zurücksetzen. Nur Name, E-Mail, Telefon sollten erforderlich sein. Falsche Region: Bei Authentifizierungsfehlern überprüfen Sie, ob die richtige Region ausgewählt ist (EU-Konten müssen den EU-Endpunkt verwenden).
Für detaillierte Fehlerbehebung siehe Cal.com Probleme.

​
Testen

  1. Führen Sie einen Testanruf durch und bitten Sie um einen Termin
  2. Überprüfen Sie, dass die Buchung in Cal.com erscheint
  3. Prüfen Sie, dass die Kalendereinladungs-E-Mail empfangen wurde
Passende Seiten: What Is AI Assistant und Prompt And Tools und Assistant Best Practices.