Skip to main content
Ein Abschlussereignis wird ausgelöst, nachdem jeder Anruf endet — eingehende Telefonie, ausgehende Telefonie, Webanruf oder Testanruf (Builder-Mikrofonsitzung). Es ist nicht blockierend: Antworten Sie mit einem beliebigen 2xx-Status. Das Ereignis wird über beide Pfade zugestellt:

Anfrage-Nutzlast (Endpunktzustellungen)

Endgründe

Transkriptformat

Jeder Eintrag in transcripts ist ein Gesprächszug. Die Rollen sind user (Sprache des Anrufers), model (Sprache des Agenten und Tool-Aufrufe), tool (Tool-Ergebnisse) und system (Anrufereignisse wie Sprachwechsel).
Verwenden Sie für den vollständig strukturierten Zugverlauf (mit Unterbrechungsmarkierungen, Bestätigungsaufforderungen und Rohpositionen) GET /v1/calls/{call_id}/history.

Unterschiede bei Legacy-Payloads

Der Legacy-Webhook-Umschlag mit einzelner URL lautet {"type": "telephony.complete" | "web.complete", "data": {…}} und enthält keine event_id. Seine data unterscheidet sich von der Endpoint-Payload:
  • Das Zug-Array befindet sich unter history, nicht unter transcripts (dasselbe Zug-Schema wie oben).
  • Die Feldmenge entspricht dem unverarbeiteten Bericht zum Anrufende und kann zusätzliche interne Felder enthalten, die über die obige Tabelle hinausgehen — behandeln Sie unbekannte Felder als informativ.
  • Web-Anrufe (direction: "web") lassen from_number / to_number weg und fügen origin_domain hinzu.
  • Builder-Mikrofontest-Anrufe werden im Legacy-Pfad als telephony.complete gemeldet (das Endpoint-System ordnet sie web.complete zu).
  • Transferkoordination: Wenn ein Anruf während eines Transfers endet, wird der Legacy-Webhook synchron aufgerufen und kann mit {"transfer_ready": false} antworten, um zu signalisieren, dass das Übergabeziel noch nicht bereit ist. Jede andere Antwort (oder kein Legacy-Webhook) lässt den Transfer fortfahren. Endpoint-Zustellungen werden hierfür niemals abgefragt.

Beispiel-Handler


Häufige Anwendungsfälle

CRM-Integration

Speichern Sie das Transkript und die Aufzeichnungs-URL jedes Anrufs zusammen mit Ihren Kundendaten.

Analysen

Streamen Sie Transkripte an eine Pipeline für Themenmodellierung, Extraktion von CSAT-Signalen oder Überwachung der Transferrate.

Qualitätsprüfung

Öffnen Sie Anrufe in einem QA-Tool zur menschlichen Prüfung oder führen Sie sie durch Ihr eigenes Bewertungsmodell aus.

Benachrichtigungen

Benachrichtigen Sie bei einer Weiterleitung oder einem Fehler ein menschliches Teammitglied.

Verwandte Inhalte

telephony.incoming / web.incoming

Das blockierende Gegenstück, das beim Anrufstart ausgeführt wird.

Ereigniskatalog

Weitere Ereignistypen, die Sie abonnieren können.

Anrufverlauf-API

Dieselben Daten sind über REST für Backfill und Wiederholung verfügbar.