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

{% hint style="info" %}
Aktuell unterstützt die Integration das Abrufen verfügbarer Termine sowie das direkte Buchen. Weitere Funktionen werden schrittweise ergänzt.
{% endhint %}

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

{% stepper %}
{% step %}
**Melden Sie sich unter** [**app.cal.com**](https://app.cal.com/) **an**
{% endstep %}

{% step %}
**Navigieren Sie zu Settings → Security → API Keys**
{% endstep %}

{% step %}
**Erstellen Sie einen neuen API-Key**
{% endstep %}

{% step %}
**Speichern Sie den Key sicher ab**
{% endstep %}
{% endstepper %}

{% 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

{% stepper %}
{% step %}

#### **Öffnen Sie Ihren AI-Agenten**

und navigieren Sie zum Reiter **Kalender**
{% endstep %}

{% step %}

#### **Klicken Sie auf "Hinzufügen"**

um den Einrichtungs-Dialog zu öffnen
{% endstep %}

{% step %}

#### **Geben Sie Ihren API-Key ein**

und klicken Sie auf **Weiter**
{% endstep %}

{% step %}

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

Siehe Tabelle
{% endstep %}

{% step %}

#### **Klicken Sie auf Speichern**

{% endstep %}
{% endstepper %}

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

{% hint style="info" %}
Im **Enterprise-Tarif** lassen sich auch komplexere Termin- und Prozesslogiken abbilden. [Mehr erfahren.](/ai-agents/tarife-and-kosten/enterprise-tarif-leistungen-und-einfuhrungsprozess.md)
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.sipgate.de/ai-agents/anbindungen-and-integrationen/kalender.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.