- Gli endpoint webhook ricevono
telephony.complete(chiamate telefoniche) oweb.complete(chiamate web e chiamate di test del microfono nel 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 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 fine
Formato della trascrizione
Ogni voce intranscripts corrisponde a un turno della conversazione. I ruoli sono
user (voce del chiamante), model (voce dell’agente e chiamate agli strumenti),
tool (risultati degli strumenti) e system (eventi della chiamata come i cambi
di lingua).
Per la cronologia dei turni completamente strutturata (con indicatori di interruzione,
ack-prompt 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 è in
history, non intranscripts(stesso schema dei turni mostrato sopra). - L’insieme dei 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 Builder vengono segnalate come
telephony.completenel percorso legacy (il sistema 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 non è pronta. Qualsiasi altra risposta (o l’assenza di un webhook legacy) consente al trasferimento di procedere. Le consegne dell’endpoint non vengono mai consultate per questo.
Gestore di esempio
Casi d’uso comuni
Integrazione CRM
Salva la trascrizione e l’URL della registrazione di ogni chiamata insieme ai tuoi
record cliente.
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 eseguile
con il tuo modello di valutazione.
Notifiche
Avvisa un membro del team umano in caso di trasferimento / errore.
Correlati
telephony.incoming / web.incoming
La controparte bloccante eseguita all’inizio della chiamata.
Catalogo degli eventi
Altri tipi di eventi a cui puoi iscriverti.
API della cronologia chiamate
Gli stessi dati accessibili tramite REST per backfill / replay.
