# Kalender

Verbinden Sie einen Cal.com-Kalender mit Ihrem AI-Agenten. So kann der Agent verfügbare Termine prüfen und Buchungen für Ihre Anrufer vornehmen. Aktuell unterstützt die Integration das Abrufen verfügbarer Termine und 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 bei Cal.com an** unter [app.cal.com](https://app.cal.com/)
2. **Navigieren Sie zu Settings > Security > API Keys**
3. **Erstellen Sie einen neuen API-Key** und kopieren Sie ihn sofort — er wird nur einmal angezeigt
4. **Speichern Sie den Key sicher ab** — Sie benötigen ihn im nächsten Schritt

{% hint style="warning" %}
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.
{% endhint %}

## 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 ggf. weitere IDs aus (siehe Tabelle)
5. **Klicken Sie auf Speichern**

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

{% hint style="info" %}
Die Team-ID und Organisation-ID finden Sie in der URL, wenn Sie das jeweilige Team oder die Organisation in Cal.com öffnen.
{% endhint %}

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

{% hint style="info" %}
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.
{% endhint %}

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

* Ihr API-Key wird automatisch 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
* Ohne aktives Playbook steht die Terminbuchung nicht zur Verfügung.