KonfigurierenIntegrationen

Cal.com

Verbinden Sie Ihre ElevenLabs-Agenten mit der Terminplanung von Cal.com.

Überblick

Verbinden Sie Ihre ElevenLabs-KI-Agenten mit Cal.com, um Terminplanung und Kalenderbuchungen zu verwalten. Mit dieser Integration können Ihre Agenten Verfügbarkeiten prüfen, Termine buchen, Meetings absagen oder verschieben und bestehende Buchungen per natürlichem Gespräch abrufen.

Funktionen

FunktionUnterstützung
Zero Retention Mode (ZRM)Nicht unterstützt
Anhänge in ToolsNicht unterstützt — Tools verarbeiten nur Text

Einrichtung

Diese Integration verwendet zur Authentifizierung einen Cal.com API-Schlüssel (keine OAuth-App).

1

API-Schlüssel in Cal.com erstellen

Öffnen Sie in Ihrem Cal.com-Konto Settings > Developer > API Keys und klicken Sie auf New. Kopieren Sie den generierten Schlüssel sofort — er wird nicht erneut angezeigt.

2

Live-Schlüssel verwenden

Cal.com erstellt zwei Arten von Schlüsseln — Testschlüssel (beginnend mit cal_) und Live-Schlüssel (beginnend mit cal_live_). Verwenden Sie einen Live-Schlüssel, damit Ihr Agent auf echte Kalenderdaten zugreifen kann.

3

In ElevenLabs verbinden

Fügen Sie in der ElevenLabs-Integrationseinrichtung Ihren Cal.com API-Schlüssel in das Feld API Key ein.

Demo

Diese Demo verwendet ältere Webhook-Tools. Wenn Sie die native Cal.com-Integration verwenden, werden die Tools automatisch konfiguriert — eine manuelle Webhook-Einrichtung ist nicht erforderlich.

Cal.com-Integrationsdemo

So funktioniert es

Der Agent plant Meetings mithilfe von Tool-Aufrufen, die ihn durch den Buchungsprozess führen. Die folgenden Tabs zeigen eine Übersicht und den detaillierten System-Prompt.

1

Erstanfrage und Meetingdetails

Der Agent fragt nach dem Zweck des Meetings, dem bevorzugten Datum und der Uhrzeit sowie der Dauer, um Planungsinformationen zu erfassen.

2

Kalenderverfügbarkeit prüfen

Der Agent prüft die Kalenderverfügbarkeit, indem er:

  • das Tool get_available_slots verwendet, um freie Zeitfenster abzurufen.
  • prüft, ob die gewünschte Uhrzeit verfügbar ist.
  • Alternativen vorschlägt, wenn die gewünschte Uhrzeit nicht verfügbar ist.
  • die ausgewählte Uhrzeit mit dem Anrufer bestätigt.
3

Kontaktinformationen erfassen

Sobald eine Uhrzeit vereinbart wurde, führt der Agent Folgendes aus:

  • Erfasst und validiert den vollständigen Namen des Teilnehmers.
  • Prüft die Richtigkeit der E-Mail-Adresse.
  • Bestätigt die Zeitzoneninformationen.
  • Erfasst alle weiteren erforderlichen Felder für den Cal.com-Ereignistyp.
4

Meeting erstellen

Der Agent:

  • Ruft nach der Prüfung aller Informationen das Tool book_meeting auf.
  • Folgt der Struktur der Buchungsvorlage.
  • Bestätigt dem Teilnehmer die Erstellung des Meetings.
  • Informiert ihn darüber, dass er eine Kalendereinladung erhält.

Manuelle Webhook-Einrichtung

Wenn Sie die native Cal.com-Integration verwenden, werden Tools automatisch konfiguriert. Die folgenden Schritte gelten nur für die manuelle Webhook-Einrichtung.

1

Ihr Cal.com-Secret speichern

Speichern Sie Ihren API-Schlüssel sicher, bevor Sie authentifizierte Anfragen stellen. Erstellen Sie einen neuen Cal.com API-Schlüssel, falls Sie dies noch nicht getan haben.

Die Cal.com API erwartet den folgenden Authentifizierungsheader:

Cal request header structure
'Authorization': 'Bearer YOUR_API_KEY'

Speichern Sie den Schlüssel im Secret-Speicher des Agenten, damit er sicher und bei Anfragen zugänglich bleibt.

Um der erwarteten Authentifizierungsstruktur von Cal.com zu entsprechen, denken Sie daran, dem API-Schlüssel beim Erstellen des Secrets Bearer voranzustellen.

Tool-Secrets

2

Tools zum Agenten hinzufügen

Aktivieren Sie Kalenderbuchungen, indem Sie zwei Tools erstellen:

  1. get_available_slots: Wenn ein Nutzer fragt: “Ist Louis am Dienstag um 10:30 Uhr frei?”, verwendet der Agent den Cal.com-Endpunkt „Get available slots“, um freie Zeitfenster zu prüfen.

  2. book_meeting: Nachdem eine passende Uhrzeit gefunden wurde, bucht der Agent das Meeting über den Cal.com-Endpunkt „Create a booking“.

Navigieren Sie im Dashboard zum Bereich Tools und wählen Sie Add Tool. Wählen Sie Webhook als Tool-Typ und füllen Sie dann die folgenden Bereiche aus:

Metadaten, anhand derer der Agent bestimmt, wann das Tool aufgerufen werden soll:

FeldWert
Nameget_available_slots
BeschreibungDieses Tool prüft, ob ein bestimmtes Zeitfenster im Kalender verfügbar ist.
MethodeGET
URLhttps://api.cal.com/v2/slots

Metadaten, anhand derer der Agent bestimmt, wann das Tool aufgerufen werden soll:

FeldWert
Namebook_meeting
BeschreibungDieses Tool bucht ein Meeting im Kalender, sobald eine Uhrzeit vereinbart ist.
MethodePOST
URLhttps://api.cal.com/v2/bookings

Testen Sie den Agenten, indem Sie auf die Schaltfläche Test AI agent klicken. Passen Sie den System-Prompt bei Bedarf an.

3

Datum und Uhrzeit berücksichtigen

Standardmäßig kennt der Agent weder das aktuelle Datum noch die aktuelle Uhrzeit. Verwenden Sie einen der folgenden Ansätze:

  1. Tool zum Abrufen der Uhrzeit erstellen: Fügen Sie ein Tool hinzu, das das aktuelle Datum und die aktuelle Uhrzeit abruft.

  2. Overrides: Verwenden Sie die Funktion Overrides, um das aktuelle Datum und die aktuelle Uhrzeit zu Beginn jeder Unterhaltung in den System-Prompt einzufügen.

Sicherheitsaspekte

  • Verwenden Sie HTTPS-Endpunkte für alle Webhook-Aufrufe.
  • Speichern Sie vertrauliche Werte als Secrets im ElevenLabs Secrets Manager.
  • Validieren Sie, dass alle Autorisierungsheader dem erforderlichen Format entsprechen (Bearer YOUR_API_KEY).
  • Geben Sie Anrufern niemals Ereignistyp-IDs oder API-Details preis.