> 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/datenabruf-bei-anrufbeginn.md).

# Datenabruf bei Anrufbeginn

### Wann ist das sinnvoll?

Der Datenabruf bei Anrufbeginn eignet sich für Inhalte, die sich häufig ändern oder pro Anruf unterschiedlich sind. Typische Anwendungsfälle:

* **Aktuelle Verfügbarkeiten** abfragen (z. B. freie Termine, Lagerbestände)
* **CRM-Daten** oder Kundenhistorie laden
* **Tagesaktuelle Anweisungen** (z. B. Sonderöffnungszeiten, Aktionen)
* **Vergangene Interaktionen** mit dem Anrufenden verfügbar machen

{% hint style="info" %}
**Hinweis:** Wir empfehlen, dieses Feature nicht als inhaltliche Grundlage für Ihren Agenten zu nutzen, da es sonst zu unvorhersehbarem Verhalten kommen kann. Der Datei-Upload im Bereich "Wissen" ist hierfür deutlich besser geeignet.
{% endhint %}

### Voraussetzungen

* Eine URL, die per HTTP oder HTTPS erreichbar ist (HTTPS empfohlen).
* Der Endpunkt sollte schnell antworten — der Abruf erfolgt beim Anrufbeginn.
* Die Antwort wird als Text in den Gesprächskontext eingebettet. Liefern Sie idealerweise gut strukturierte, kompakte Inhalte zurück.

{% hint style="warning" %}
**Wichtig:** Nutzen Sie keine öffentlich auffindbare URL – andernfalls könnten Dritte die übermittelten Anruferdaten abrufen.
{% endhint %}

### So richten Sie den Datenabruf ein

{% stepper %}
{% step %}
**Öffnen Sie die Konfiguration Ihres AI Agents**
{% endstep %}

{% step %}
**Wechseln Sie zum Menüpunkt „Integrationen“**
{% endstep %}

{% step %}
**Suchen Sie den Abschnitt „Datenabruf bei Anrufbeginn“ und klicken Sie auf das Zahnrad-Symbol**
{% endstep %}

{% step %}
**Geben Sie im Dialog „Datenabruf konfigurieren“ die gewünschte URL ein.**

Optional können Sie auch „Abruf erzwingen“ aktivieren, damit der Abruf zwingend erfolgreich sein muss, damit der Anruf überhaupt stattfinden kann
{% endstep %}

{% step %}
**Klicken Sie auf „Speichern“**
{% endstep %}
{% endstepper %}

Die konfigurierte URL erscheint anschließend direkt in der Benutzeroberfläche. Beim nächsten eingehenden Anruf werden die Inhalte automatisch abgerufen.

### Option: „Abruf erzwingen“

Mit der Checkbox **Abruf erzwingen** entscheiden Sie, wie strikt der Agent mit Fehlern bei diesem Abruf umgehen soll:

* **Deaktiviert** (Standard): Ist die URL nicht erreichbar, wird der Anruf trotzdem durchgestellt — einfach ohne den dynamischen Kontext.
* **Aktiviert:** Ist die URL nicht erreichbar, wird der Anruf abgelehnt. Wählen Sie diese Option nur, wenn der Kontext für den Anruf unverzichtbar ist (z. B. wenn ohne CRM-Daten kein sinnvolles Gespräch möglich ist).

### Datenabruf wieder entfernen

Soll der Datenabruf nicht mehr stattfinden:

1. Öffnen Sie über das Zahnrad-Symbol erneut den Konfigurationsdialog.
2. Klicken Sie auf **Datenabruf löschen**.
3. Bestätigen Sie im darauffolgenden Dialog mit **Endgültig löschen**.

Anschließend zeigt der Abschnitt wieder den Status **Inaktiv**. Bei kommenden Anrufen findet kein Datenabruf mehr statt.

### Häufige Fragen

<details>

<summary><strong>Wie lange darf der Endpunkt für die Antwort brauchen?</strong></summary>

So kurz wie möglich. Der Abruf läuft synchron beim Anrufbeginn — lange Antwortzeiten verzögern den Gesprächsstart.

</details>

<details>

<summary><strong>Was passiert, wenn ich die URL ändere?</strong></summary>

Beim nächsten eingehenden Anruf wird automatisch die neue URL abgerufen. Es gibt keinen Cache, der vorher geleert werden müsste.

</details>

<details>

<summary><strong>Funktioniert das mit beliebigen URLs?</strong></summary>

Die URL muss per HTTP oder HTTPS erreichbar sein und eine gültige Top-Level-Domain enthalten. Eingaben ohne Protokoll wie `meine-firma.de` werden beim Speichern automatisch um `https://` ergänzt.

</details>


---

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

```
GET https://help.sipgate.com/anbindungen-and-integrationen/datenabruf-bei-anrufbeginn.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.