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 qualsiasi codice 2xx. L’evento viene recapitato tramite entrambi i percorsi:

Payload della richiesta (recapiti agli endpoint)

Motivi di fine

Formato della trascrizione

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