Datenabruf bei Anrufbeginn
Mit dem Datenabruf bei Anrufbeginn ruft Ihr AI Agent eine von Ihnen hinterlegte URL ab, sobald ein eingehender Anruf startet.
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
Hinweis: Der initiale Datenabruf ist für konkrete Informationen zum aktuellen Anruf gedacht. Er ersetzt keine allgemeine Wissensbasis und eignet sich nicht für umfangreiche Inhalte wie PDFs, Webseiten oder Dokumentationen. Für dauerhaftes Agenten-Wissen nutzen Sie den Datei-Upload im Bereich Wissen.
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.
Wichtig: Nutzen Sie keine öffentlich auffindbare URL. Aktuell erfolgt keine Authentifizierung zwischen sipgate und dem angebundenen Server. Andernfalls könnten unbefugte Dritte den Endpunkt verwenden und übermittelte Anruferdaten abrufen.
Beschränken Sie den Zugriff serverseitig auf folgende sipgate IP-Adressen:
217.116.118.254212.9.46.32
Nutzen Sie dafür zum Beispiel eine Allowlist. So stellt der Server sicher, dass Anfragen an den Endpunkt tatsächlich von sipgate kommen.
Hinweis: Die Antwort des Servers sollte ausschließlich Daten enthalten. Prompt-Anweisungen oder Verhaltensregeln sollten nicht über die Server-Antwort übergeben werden. Sie werden ignoriert oder nicht zuverlässig verarbeitet.
So richten Sie den Datenabruf ein
Öffnen Sie die Konfiguration Ihres AI Agents
Wechseln Sie zum Menüpunkt „Integrationen“
Suchen Sie den Abschnitt „Datenabruf bei Anrufbeginn“ und klicken Sie auf das Zahnrad-Symbol
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
Klicken Sie auf „Speichern“
Die konfigurierte URL erscheint anschließend direkt in der Benutzeroberfläche. Beim nächsten eingehenden Anruf werden die Inhalte automatisch abgerufen.
Welche Rückgabeformate unterstützt der Agent?
Der Agent kann Informationen aus Drittanwendungen nur verarbeiten, wenn sie in einem lesbaren Textformat zurückgegeben werden. PDF-Dateien, Webseiten oder andere Dateiformate kann der Agent nicht direkt auslesen.
Unterstützt werden: Plain Text, Markdown, JSON
Das gewünschte Rückgabeformat muss in der Anfrage an die Drittanwendung angegeben werden. Der angebundene Server muss die Antwort in diesem Format zurückgeben und den passenden Content-Type-Header setzen.
Beispiele:
Plain Text:
Content-Type: text/plainMarkdown:
Content-Type: text/markdownJSON:
Content-Type: application/json
Welche Parameter werden an den Server übergeben?
Der Agent kann beim initialen Datenabruf Informationen an den angebundenen Server übergeben, damit dort passende Daten zum aktuellen Anruf oder zu früheren Gesprächen gefunden werden können.
Folgende Parameter werden übergeben:
callerNumber
Die Rufnummer der anrufenden Person.
destinationNumber
Die Rufnummer, über die der Agent angerufen wurde. Wenn dem Agent mehrere Rufnummern zugewiesen sind, wird trotzdem nur die Rufnummer des aktuellen Anrufs übergeben.
sessionId
Die eindeutige ID des aktuellen Anrufs. Über diese ID kann der Server den Datenabruf eindeutig einem bestimmten Gespräch zuordnen. Die sessionId kann außerdem für Live-Anbindungen verwendet werden. So kann der Server denselben Anruf über mehrere Abfragen hinweg wiedererkennen, zum Beispiel zwischen dem initialen Datenabruf und späteren Live-Abfragen während des Gesprächs.
assistantId
Die interne ID des Agents. Diese ID ist eindeutig einem Agent zugeordnet und hilft dem Server, zwischen mehreren Agents zu unterscheiden.
Der angebundene Server muss diese Parameter verarbeiten können und die passenden Informationen im unterstützten Rückgabeformat bereitstellen.
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:
Öffnen Sie über das Zahnrad-Symbol erneut den Konfigurationsdialog.
Klicken Sie auf Datenabruf löschen.
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
Wie lange darf der Endpunkt für die Antwort brauchen?
So kurz wie möglich. Der Datenabruf erfolgt synchron zu Beginn des Anrufs. Lange Antwortzeiten können deshalb den Gesprächsstart verzögern.
Der Abruf startet bereits während des Klingelns und dauert in der Regel 2–5 Sekunden. Wenn nach 5 Sekunden keine Daten verfügbar sind, führt der Agent das Gespräch ohne diese Informationen fort.
Was passiert, wenn die 5 Sekunden überschritten werden?
Wenn der Endpunkt nicht innerhalb von 5 Sekunden antwortet, wird der Datenabruf abgebrochen. Der Agent startet das Gespräch dann ohne die angefragten Informationen. Das kann zum Beispiel passieren, wenn die angebundene Drittanwendung langsam antwortet. Im Transkript wird nicht vermerkt, ob der Datenabruf fehlgeschlagen ist.
Zuletzt aktualisiert