Melihat Hasil: Catatan Pengiriman dan Push CDR
Perbandingan dan praktik tiga jalur pengambilan hasil: catatan konsol, API kueri, dan push Webhook.
Hasil per panggilan suara dapat diambil melalui tiga jalur yang dapat dikombinasikan sesuai kebutuhan.
Prasyarat
- Pernah membuat tugas panggilan (lihat Melakukan Panggilan)
Perbandingan Tiga Jalur
| Jalur | Real-time | Skenario yang cocok |
|---|---|---|
| Catatan pengiriman Console | Dilihat manual | Penelusuran manual, inspeksi rutin |
| API Kueri | Tarik sesuai kebutuhan | Rekonsiliasi terjadwal, penyimpanan dan analisis |
| Push CDR (Webhook) | Push real-time | Alur bisnis yang digerakkan peristiwa |
Kombinasi yang disarankan: terima real-time via Webhook + API Kueri sebagai fallback rekonsiliasi.
Catatan Pengiriman Console
Lihat hasil per panggilan pada halaman Catatan Pengiriman di konsol voice; mendukung filter berdasarkan nomor penerima, hasil panggilan (berhasil/gagal), kode terminasi, nomor batch, negara, dan rentang waktu; detail memuat durasi percakapan dan pemutaran ulang rekaman.
Poin Penting API Kueri
- Jendela waktu wajib diisi (
startDate, formatyyyy-MM-dd HH:mm:ss); hanya 90 hari terakhir yang dapat dikueri taskIdadalahcallIdyang dikembalikan API pengiriman; dapat menunjuk satu tugas secara presisicountryCodewajib; mendukung filter berdasarkan nomor penerima, batch, dan template- Paginasi
page/size(≤100); batas 30 QPS (melebihi mengembalikan040001)
Poin Penting Push CDR
- Setelah panggilan mencapai status akhir, platform mengirim POST peristiwa ke alamat callback yang dikonfigurasi (
eventCode=cdr_status_push,eventIdsama dengancallId) - Receiver harus mengembalikan 2xx; versi saat ini tidak melakukan retry otomatis saat gagal, jaga kestabilan layanan Anda
- Tangani
eventIdsecara idempoten untuk menghindari duplikasi saat masuk basis data - Mendukung verifikasi tanda tangan HMAC-SHA256 opsional via
X-CALLBACK-ID; protokol dan contoh verifikasi lihat Push CDR
Interpretasi Field Hasil
| Field | Arti |
|---|---|
| callState | Status hasil panggilan (berhasil/gagal) |
| callDesc / callDescMsg | Kode terminasi dan keterangan teksnya (penyebab terputus) |
| answerTime | Waktu tersambung (kosong bila tidak tersambung) |
| recallCount | Jumlah panggil ulang yang telah dilakukan |
| recordUrl | Alamat rekaman (kosong bila tidak ada rekaman) |
| smsSendTime / smsStatus | Waktu kirim dan status SMS hang-up |
Nilai spesifik kode terminasi (callDesc) mengacu pada respons aktual; field yang sama pada catatan Console, API kueri, dan push memiliki semantik identik.
Saran Rekonsiliasi
- Gunakan
bulkId/callId+mobilesebagai kunci rekonsiliasi - Simpan data Webhook secara real-time; setiap hari (atau setiap jam) tarik dan bandingkan melalui API kueri per jendela waktu untuk melengkapi CDR yang hilang saat push
- Selisih antara
acceptedCount(jumlah yang diterima) dan jumlah CDR akhir digunakan untuk mendeteksi anomali
FAQ
Tidak menerima push Webhook?
Periksa berurutan: alamat callback telah dikonfigurasi di platform, layanan receiver dapat dijangkau dari internet publik, respons 2xx, dan apakah panggilan terkait sudah mencapai status akhir. Lokasi melihat konfigurasi lihat Menggunakan Konsol Voice.
Menerima push berkali-kali untuk panggilan yang sama?
Versi saat ini tidak me-retry push yang gagal, tetapi tetap disarankan menangani eventId (= callId) secara idempoten untuk mengantisipasi replay jaringan atau mekanisme retry pada versi mendatang.
API kueri tidak menemukan catatan?
Pastikan jendela waktu dalam 90 hari dan countryCode sesuai negara panggilan; untuk tugas yang baru diterima, tunggu sejenak sebelum mengueri (ada jeda waktu antara panggilan keluar dan penyimpanan data).
Sumber Terkait
Terakhir diperbarui pada