Daten & API Calls

Im Reiter Daten & API Calls verbindest du den Agenten mit deinen eigenen Systemen. Er hat vier Unterreiter: Datenextraktion, Live-API-Aufrufe, Nach-Anruf-API-Anfrage und, in den Tarifen Business Plus und Enterprise, API Experten Modus.

Datenextraktion

Hier legst du fest, welche Angaben der Agent aus dem Gespräch herausziehen soll, etwa Name, E-Mail oder Kundennummer. Die Werte stehen danach in der Zusammenfassung, in Follow-up-SMS und in API-Aufrufen zur Verfügung.

Klicke unter Variablenextraktion auf Variable hinzufügen.
Trage den Variablennamen ein, etwa name oder kundennummer, ohne Leerzeichen und Umlaute.
Beschreibe unter Beschreibung, welche Information gemeint ist, zum Beispiel “Vor- und Nachname des Anrufers”. Der Agent fragt danach, wenn der Anrufer die Angabe nicht von selbst macht.

Über Zu JSON wechseln bearbeitest du dasselbe als Schema, etwa um andere Typen als Text zu verwenden.

Die Rufnummer des Anrufers wird immer erfasst, dafür brauchst du keine Variable. Über Optionen einfügen im Reiter Grundinformationen kannst du die Variablen auch im Prompt erwähnen, nötig ist das nicht.

Unterreiter Datenextraktion mit den Variablen name und anliegen und ihrer Beschreibung

Live-API-Aufrufe

Mit Zustand auf Aktiviert darf der Agent während des Gesprächs eigene HTTP-Endpunkte aufrufen, etwa um einen Bestellstatus abzufragen. Bis zu fünf Endpunkte sind möglich, jeder mit:

Feld	Bedeutung
Methode	GET, POST, PUT oder DELETE.
API-Name	Daran erkennt der Agent, wofür der Aufruf da ist. Wähle einen sprechenden Namen wie “Bestellstatus abfragen”.
URL	Die Adresse des Endpunkts.
Header	Zum Beispiel `Authorization: Bearer …` für die Anmeldung und `Content-Type: application/json`. Einen eigenen Anmeldemechanismus gibt es nicht, alles läuft über Header.
Anfrage-Body	Bei POST, PUT und DELETE. Über Variable einfügen setzt du Platzhalter wie `{{ caller_number }}` oder deine extrahierten Variablen ein.

Der Agent entscheidet anhand des API-Namens und deines Prompts selbst, wann er einen Endpunkt aufruft. Die Antwort bekommt er als Text und nutzt sie im Gespräch. Antwortet dein Endpunkt nicht innerhalb von 30 Sekunden, gilt der Aufruf als fehlgeschlagen.

Nach-Anruf-API-Anfrage

Funktioniert wie die Live-API-Aufrufe, läuft aber einmal nach jedem beendeten Gespräch, zusätzlich mit der Methode PATCH. Damit übergibst du Gesprächsdaten an dein CRM oder Ticketsystem.

Im Anfrage-Body stehen zusätzlich die Variablen {{ started_at }}, {{ ended_at }} und {{ conversation_summary }} zur Verfügung, dazu {{ duration }} in Sekunden, {{ conversation_id }} und alle extrahierten Variablen. Es wird nur gesendet, was du in den Body schreibst, einen festen Datensatz gibt es nicht.

Beispiel für einen Body:

{
  "anrufer": "{{ caller_number }}",
  "name": "{{ name }}",
  "beginn": "{{ started_at }}",
  "dauer_sekunden": "{{ duration }}",
  "zusammenfassung": "{{ conversation_summary }}"
}

Die Zusammenfassung wird vor dem Aufruf erzeugt, auch wenn du unter Nach dem Anruf keine Zusammenfassung bestellt hast. Schlägt ein Aufruf fehl, wird er nicht wiederholt.

Unterreiter Nach-Anruf-API-Anfrage mit einem POST-Endpunkt und einem JSON-Body mit den Variablen caller_number, name und conversation_summary

API Experten Modus

Der vierte Unterreiter ist ein eigenes Thema: API-Expertenmodus.