Skip to main content
Un eveniment de finalizare se declanșează după încheierea fiecărui apel — telefonie de intrare, telefonie de ieșire, apel web sau apel de test (sesiune cu microfonul în builder). Este neblocant: răspundeți cu orice cod 2xx. Evenimentul este livrat pe ambele căi:

Payloadul cererii (livrări către endpointuri)

Motive de încheiere

Formatul transcrierii

Fiecare intrare din transcripts reprezintă o intervenție conversațională. Rolurile sunt user (discursul apelantului), model (discursul agentului și apelurile de instrumente), tool (rezultatele instrumentelor) și system (evenimente ale apelului, cum ar fi schimbările de limbă).
Pentru istoricul complet structurat al intervențiilor (cu marcatori de întrerupere, prompturi de confirmare și poziții brute), utilizați GET /v1/calls/{call_id}/history.

Diferențe ale încărcăturii utile legacy

Plicul webhook legacy cu un singur URL este {"type": "telephony.complete" | "web.complete", "data": {…}}, fără event_id, iar data diferă de încărcătura utilă a endpointului:
  • Matricea de intervenții se află în history, nu în transcripts (aceeași schemă de intervenție ca mai sus).
  • Setul de câmpuri este raportul brut de final de apel și poate include câmpuri interne suplimentare, dincolo de tabelul de mai sus — tratați câmpurile necunoscute ca informaționale.
  • Apelurile web (direction: "web") omit from_number / to_number și adaugă origin_domain.
  • Apelurile de testare a microfonului din Builder sunt raportate ca telephony.complete pe ruta legacy (sistemul endpointului le mapează la web.complete).
  • Coordonarea transferului: când un apel se încheie printr-un transfer, webhookul legacy este apelat sincron și poate răspunde cu {"transfer_ready": false} pentru a semnala că ținta transferului nu este pregătită. Orice alt răspuns (sau absența unui webhook legacy) permite continuarea transferului. Livrările către endpoint nu sunt niciodată consultate pentru aceasta.

Exemplu de handler


Cazuri de utilizare frecvente

Integrare CRM

Salvați transcrierea și URL-ul înregistrării fiecărui apel alături de evidențele clienților dumneavoastră.

Analiză

Transmiteți transcrierile către un pipeline pentru modelarea subiectelor, extragerea semnalelor CSAT sau monitorizarea ratei de transfer.

Revizuirea calității

Deschideți apelurile într-un instrument QA pentru revizuire umană sau procesați-le prin propriul model de evaluare.

Notificări

Notificați un coleg uman la transfer / eșec.

Resurse asociate

telephony.incoming / web.incoming

Echivalentul blocant care rulează la începutul apelului.

Catalog de evenimente

Alte tipuri de evenimente la care vă puteți abona.

API pentru istoricul apelurilor

Aceleași date sunt accesibile prin REST pentru completare / reluare.