- Endpointurile webhook primesc
telephony.complete(apeluri telefonice) sauweb.complete(apeluri web și apeluri de test cu microfonul în builder) cu payloadul stabil documentat mai jos, unevent_idpentru fiecare livrare, un timeout de 30 s și reîncercări timp de până la 24 h. - Webhookul moștenit cu un singur URL primește o singură încercare sincronă (timeout de 10 s, fără reîncercări) cu un payload ușor diferit — consultați Diferențe ale payloadului moștenit.
Payloadul cererii (livrări către endpointuri)
Motive de încheiere
Formatul transcrierii
Fiecare intrare dintranscripts 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 întranscripts(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") omitfrom_number/to_numberși adaugăorigin_domain. - Apelurile de testare a microfonului din Builder sunt raportate ca
telephony.completepe ruta legacy (sistemul endpointului le mapează laweb.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.