Kalender

Verbinden Sie einen Cal.com-Kalender mit Ihrem AI-Agenten. So kann der Agent freie Termine prüfen und Buchungen direkt für Ihre Anrufer vornehmen.

Aktuell unterstützt die Integration das Abrufen verfügbarer Termine sowie das direkte Buchen. Weitere Funktionen werden schrittweise ergänzt.

Voraussetzungen

• Ein Cal.com-Account (kostenlos oder kostenpflichtig)
• Mindestens ein konfigurierter Event-Typ in Cal.com
• Einen API-Key aus Ihrem Cal.com-Account

Cal.com API-Key erstellen

1

Melden Sie sich unter app.cal.com an

2

Navigieren Sie zu Settings → Security → API Keys

3

Erstellen Sie einen neuen API-Key

4

Speichern Sie den Key sicher ab

API-Keys sind standardmäßig 30 Tage gültig. In den Cal.com-Einstellungen können Sie die Gültigkeit anpassen oder einen unbegrenzt gültigen Key erstellen.

Kalenderintegration in sipgate einrichten

1

Öffnen Sie Ihren AI-Agenten

und navigieren Sie zum Reiter Kalender

2

Klicken Sie auf "Hinzufügen"

um den Einrichtungs-Dialog zu öffnen

3

Geben Sie Ihren API-Key ein

und klicken Sie auf Weiter

4

Wählen Sie den passenden Modus, die API-Region und, falls nötig, weitere IDS

Siehe Tabelle

5

Klicken Sie auf Speichern

6

Stellen Sie sicher, dass kein Playbook für Terminwünsche konfiguriert ist

Ein Playbook für Terminwünsche kann mit aktiver Cal.com-Integration zu unerwartetem Verhalten führen.

Konfigurationsfelder

Feld	Erforderlich	Beschreibung
API-Token	Ja	Ihr Cal.com API-Key (beginnt mit cal_ oder cal_live_)
Modus	Ja	Bestimmt, auf welchen Kalender zugegriffen wird (siehe unten)
API-Region	Ja	US oder EU — je nachdem wo Ihr Cal.com-Account gehostet ist
Organisation-ID	Nur bei Modus "Organisation"	Die ID Ihrer Cal.com-Organisation
Team-ID	Nur bei Modus "Team", optional bei "Organisation"	Die ID Ihres Cal.com-Teams

Modus wählen

Modus	Beschreibung
Persönlich	Zugriff auf Ihren persönlichen Cal.com-Kalender
Team	Zugriff auf einen Team-Kalender — erfordert eine Team-ID
Organisation	Zugriff auf Organisationsebene — erfordert eine Organisation-ID, Team-ID ist optional

Die Team-ID und Organisation-ID finden Sie in der URL, wenn Sie das jeweilige Team oder die Organisation in Cal.com öffnen.

API-Region

Region	URL	Verwendung
US (Global)	api.cal.com	Standard für Cal.com-Accounts
EU	api.cal.eu	Für Cal.com-Accounts die in der EU gehostet werden (DSGVO-konform)

Wenn Sie sich unsicher sind welche Region die richtige ist, prüfen Sie die URL in Ihrem Browser wenn Sie bei Cal.com eingeloggt sind. Nutzen Sie cal.eu, wählen Sie die EU-Region.

Konfiguration bearbeiten

Nach der Einrichtung können Sie jederzeit den Modus, die API-Region und den API-Token separat über die Bearbeiten-Buttons anpassen.

Gut zu wissen

• Bei aktiver Cal.com-Integration sollte kein Playbook für Terminwünsche konfiguriert sein.
• Hinterlegen Sie in den Kundenfragen keine Einträge zu Terminen oder Terminbuchungen. Das kann den Buchungsprozess stören, weil der Agent das Anliegen dann möglicherweise als Wissensfrage behandelt statt die Kalender-Integration zu nutzen.
• Ihr API-Key wird verschlüsselt gespeichert.
• Der AI-Agent prüft bei jedem Anruf die Verfügbarkeit in Ihrem Cal.com-Kalender.
• Änderungen an der Konfiguration werden sofort wirksam.
• Wenn Sie die Integration löschen, kann der Agent keine Termine mehr prüfen oder buchen.

Im Enterprise-Tarif lassen sich auch komplexere Termin- und Prozesslogiken abbilden. Mehr erfahren.