Skip to main content
Un evento di completamento viene attivato al termine di ogni chiamata: telefonia in entrata, telefonia in uscita, chiamata web o chiamata di test (sessione microfono del builder). È non bloccante: rispondi con un qualsiasi codice 2xx. L’evento viene recapitato tramite entrambi i percorsi:

Payload della richiesta (recapiti agli endpoint)

Motivi di termine

Formato della trascrizione

Ogni voce in transcripts 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 in transcripts (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") omettono from_number / to_number e aggiungono origin_domain.
  • Le chiamate di test del microfono nel Builder vengono riportate come telephony.complete nel percorso legacy (il sistema dell’endpoint le mappa a web.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.