- Webhook-Endpunkte empfangen
telephony.complete(Telefonanrufe) oderweb.complete(Webanrufe und Builder-Mikrofon-Testanrufe) mit der unten dokumentierten stabilen Nutzlast, einerevent_idpro Zustellung, einem 30-s-Timeout und Wiederholungsversuchen für bis zu 24 Std.. - Der Legacy-Single-URL-Webhook erhält einen synchronen Versuch (10-s-Timeout, keine Wiederholungsversuche) mit einer leicht abweichenden Nutzlast — siehe Unterschiede bei Legacy-Nutzlasten.
Anfrage-Nutzlast (Endpunktzustellungen)
Endgründe
Transkriptformat
Jeder Eintrag intranscripts 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 untertranscripts(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") lassenfrom_number/to_numberweg und fügenorigin_domainhinzu. - Builder-Mikrofontest-Anrufe werden im Legacy-Pfad als
telephony.completegemeldet (das Endpoint-System ordnet sieweb.completezu). - 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.