- Endpoint webhook menerima
telephony.complete(panggilan telepon) atauweb.complete(panggilan web dan panggilan uji mikrofon builder) dengan payload stabil yang didokumentasikan di bawah,event_idper pengiriman, batas waktu 30 dtk, dan percobaan ulang hingga 24 jam. - Webhook URL tunggal lama menerima satu percobaan sinkron (batas waktu 10 dtk, tanpa percobaan ulang) dengan payload yang sedikit berbeda — lihat Perbedaan payload lama.
Payload permintaan (pengiriman endpoint)
Alasan berakhir
Format transkrip
Setiap entri dalamtranscripts adalah satu giliran percakapan. Perannya adalah
user (ucapan penelepon), model (ucapan agen dan pemanggilan tool),
tool (hasil tool), dan system (peristiwa panggilan seperti perpindahan
bahasa).
Untuk riwayat giliran yang sepenuhnya terstruktur (dengan penanda interupsi,
ack-prompt, dan posisi mentah), gunakan
GET /v1/calls/{call_id}/history.
Perbedaan payload legacy
Envelope webhook URL tunggal legacy adalah{"type": "telephony.complete" | "web.complete", "data": {…}} tanpa
event_id, dan data-nya berbeda dari payload endpoint:
- Array giliran berada di bawah
history, bukantranscripts(schema giliran sama seperti di atas). - Kumpulan kolomnya adalah laporan mentah akhir panggilan dan dapat mencakup kolom internal tambahan di luar tabel di atas — perlakukan kolom yang tidak dikenal sebagai informasi.
- Panggilan web (
direction: "web") tidak menyertakanfrom_number/to_numberdan menambahkanorigin_domain. - Panggilan uji mikrofon Builder dilaporkan sebagai
telephony.completepada jalur legacy (sistem endpoint memetakannya keweb.complete). - Koordinasi transfer: saat panggilan berakhir dalam transfer, webhook
legacy dipanggil secara sinkron dan dapat menjawab
{"transfer_ready": false}untuk menandakan target serah terima belum siap. Respons lain apa pun (atau tanpa webhook legacy) memungkinkan transfer dilanjutkan. Pengiriman endpoint tidak pernah digunakan untuk ini.
Contoh handler
Kasus penggunaan umum
Integrasi CRM
Simpan transkrip + URL rekaman setiap panggilan bersama catatan
pelanggan Anda.
Analitik
Alirkan transkrip ke pipeline untuk pemodelan topik, ekstraksi sinyal CSAT,
atau pemantauan tingkat transfer.
Tinjauan kualitas
Buka panggilan di alat QA untuk ditinjau manusia, atau jalankan melalui
model evaluasi Anda sendiri.
Notifikasi
Picu notifikasi kepada rekan tim manusia saat transfer / kegagalan.
Terkait
telephony.incoming / web.incoming
Versi pemblokiran yang berjalan saat panggilan dimulai.
Katalog event
Jenis event lain yang dapat Anda langgani.
API riwayat panggilan
Data yang sama dapat diakses melalui REST untuk backfill / replay.