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

# Kalender

Verbinden Sie einen Cal.com-Kalender mit Ihrem Agent. So prüft Ihr Agent freie Termine und bucht direkt für Ihre Anrufenden.

{% hint style="info" %}
**Hinweis:** Aktuell unterstützt die Integration das Abrufen verfügbarer Termine sowie das direkte Buchen. Weitere Funktionen kommen schrittweise dazu.
{% endhint %}

### Voraussetzungen

* ein Cal.com-Account, kostenlos oder kostenpflichtig
* mindestens ein konfigurierter Event-Typ in Cal.com
* ein 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="info" %}
**Hinweis:** API-Keys sind standardmäßig 30 Tage gültig. In den Cal.com-Einstellungen passen Sie die Gültigkeit an oder erstellen einen unbegrenzt gültigen Key.
{% endhint %}

### Kalenderintegration einrichten

{% stepper %}
{% step %}
Öffnen Sie Ihren Agent 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.
{% endstep %}

{% step %}
Klicken Sie auf Speichern.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
**Wichtig:** Stellen Sie sicher, dass kein Playbook für Terminwünsche aktiv ist, weder ein eigenes noch eines aus der Bibliothek. Sonst behandelt Ihr Agent das Anliegen möglicherweise über das Playbook und startet keine Terminbuchung.
{% endhint %}

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

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

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

## 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: Schauen Sie in die Adresszeile Ihres Browsers, während Sie bei Cal.com eingeloggt sind. Lautet die Adresse `app.cal.eu`, wählen Sie die EU-Region. Lautet sie `app.cal.com`, wählen Sie US (Global).
{% 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. Änderungen werden sofort wirksam.

### Gut zu wissen

* Hinterlegen Sie in den Kundenfragen keine Einträge zu Terminen oder Terminbuchungen. Sonst behandelt Ihr Agent das Anliegen möglicherweise als Wissensfrage, statt die Kalender-Integration zu nutzen.
* Ihr API-Key wird verschlüsselt gespeichert.
* Ihr Agent prüft bei jedem Anruf die Verfügbarkeit in Ihrem Cal.com-Kalender.
* Wenn Sie die Integration löschen, kann Ihr Agent keine Termine mehr prüfen oder buchen.

{% hint style="info" %}
Im **Enterprise-Tarif** lassen sich auch komplexere Termin- und Prozesslogiken abbilden. [Mehr erfahren.](/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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.sipgate.com/anbindungen-and-integrationen/kalender.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.