> For the complete documentation index, see [llms.txt](https://help.sipgate.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.sipgate.de/ai-agents/anbindungen-and-integrationen/kalender.md).

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

{% step %}

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

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

{% 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.