- Gli endpoint webhook ricevono
telephony.complete(chiamate telefoniche) oweb.complete(chiamate web e chiamate di test con microfono del builder) con il payload stabile documentato di seguito, unevent_idper ogni recapito, un timeout di 30 s e tentativi fino a 24 h. - Il webhook legacy a URL singolo riceve un unico tentativo sincrono (timeout di 10 s, nessun tentativo aggiuntivo) con un payload leggermente diverso — consulta Differenze del payload legacy.
Payload della richiesta (recapiti agli endpoint)
Motivi di termine
Formato della trascrizione
Ogni voce intranscripts corrisponde a un turno conversazionale. I ruoli sono
user (parlato del chiamante), model (parlato dell’agente e chiamate agli strumenti),
tool (risultati degli strumenti) e system (eventi della chiamata come cambi
di lingua).
Per la cronologia dei turni completamente strutturata (con indicatori di interruzione,
prompt di conferma e posizioni grezze), usa
GET /v1/calls/{call_id}/history.
Differenze del payload legacy
L’envelope webhook legacy a URL singolo è{"type": "telephony.complete" | "web.complete", "data": {…}}, senza
event_id, e il relativo data differisce dal payload dell’endpoint:
- L’array dei turni si trova in
history, non intranscripts(stesso schema dei turni riportato sopra). - L’insieme di campi è il report grezzo di fine chiamata e può includere campi interni aggiuntivi oltre a quelli della tabella sopra — considera i campi sconosciuti come informativi.
- Le chiamate web (
direction: "web") omettonofrom_number/to_numbere aggiungonoorigin_domain. - Le chiamate di test del microfono nel Builder vengono riportate come
telephony.completenel percorso legacy (il sistema dell’endpoint le mappa aweb.complete). - Coordinamento del trasferimento: quando una chiamata termina con un trasferimento, il
webhook legacy viene chiamato in modo sincrono e può rispondere
{"transfer_ready": false}per segnalare che la destinazione del passaggio di chiamata non è pronta. Qualsiasi altra risposta (o l’assenza di un webhook legacy) consente al trasferimento di procedere. Le consegne all’endpoint non vengono mai consultate per questo.
Gestore di esempio
Casi d’uso comuni
Integrazione CRM
Archivia la trascrizione e l’URL della registrazione di ogni chiamata insieme ai
record dei clienti.
Analisi
Invia le trascrizioni a una pipeline per la modellazione degli argomenti, l’estrazione
di segnali CSAT o il monitoraggio del tasso di trasferimento.
Revisione della qualità
Apri le chiamate in uno strumento QA per la revisione umana oppure elaborale con
il tuo modello di valutazione.
Notifiche
Avvisa un membro del team umano in caso di trasferimento o errore.
Correlati
telephony.incoming / web.incoming
La controparte bloccante che viene eseguita all’avvio della chiamata.
Catalogo eventi
Altri tipi di eventi a cui puoi iscriverti.
API cronologia chiamate
Gli stessi dati accessibili tramite REST per il riempimento storico o il replay.