Kode Penyebab Panggilan Terputus (Hangup Cause Code)

Panduan OCA IVR Call: Kode Penyebab Panggilan Terputus (Hangup Cause Codes)

Hangup Cause Code. Kode ini sangat penting untuk proses debugging dan memahami alasan teknis mengapa sebuah panggilan berhasil atau gagal.

Dokumen ini merinci kode-kode standar ITU-T Q.850 yang paling umum, padanan SIP-nya, serta rekomendasi aksi dari tim OCA untuk setiap kondisi.

Di Mana Menemukan Hangup Cause Code?

Anda dapat menemukan informasi ini pada hasil export report IVR Broadcast Anda berupa hangupCauseMessage

• hangupCauseCode: Kode numerik standar ITU-T Q.850 (contoh: 16).

• hangupCauseMessage: Deskripsi dalam bentuk teks (contoh: NORMAL_CLEARING).

• sipErrorCode: Kode respons dari protokol SIP (contoh: 486).

---

Daftar Hangup Cause Codes

Berikut adalah daftar kode yang paling umum ditemui, dikelompokkan berdasarkan kategori masalah untuk mempermudah identifikasi.

1. Panggilan Berakhir Normal ✅

Cause Code (Q.850)	SIP Equiv.	Enum (Contoh)	Penjelasan & Rekomendasi Aksi (OCA)
16	-	NORMAL_CLEARING	Ini adalah kode sukses. Panggilan berakhir secara normal karena salah satu pihak (penelepon atau penerima) telah meminta untuk mengakhiri panggilan.
487	487	ORIGINATOR_CANCEL	Penelepon (sistem Anda) membatalkan panggilan sebelum penerima menjawab.

2. Masalah di Sisi Pengguna / Nomor Tujuan 👤

Kode ini mengindikasikan adanya masalah yang berasal dari nomor tujuan atau penerima panggilan.

Cause Code (Q.850)	SIP Equiv.	Enum (Contoh)	Penjelasan & Rekomendasi Aksi (OCA)
1	404	UNALLOCATED_NUMBER	Nomor tujuan tidak terdaftar atau tidak ada dalam jaringan telekomunikasi, meskipun formatnya valid.
17	486	USER_BUSY	Penerima sedang dalam panggilan lain dan tidak dapat menerima panggilan masuk.
18	408	NO_USER_RESPONSE	Panggilan masuk ke perangkat tujuan, namun tidak ada respons (baik mengangkat atau menolak) dalam rentang waktu yang ditentukan.
19	480	NO_ANSWER	Perangkat penerima berdering (user alerted), namun panggilan tidak diangkat hingga
21	603	CALL_REJECTED	Panggilan secara eksplisit ditolak oleh penerima, meskipun perangkatnya tidak sedang sibuk.
22	410	NUMBER_CHANGED	Nomor yang dituju sudah tidak digunakan lagi atau telah diganti.
27	502	DESTINATION_OUT_OF_ORDER	Perangkat tujuan tidak berfungsi dengan benar (misalnya mati, di luar jangkauan sinyal, atau mengalami kerusakan).
28	484	INVALID_NUMBER_FORMAT	Format nomor tujuan salah atau tidak lengkap.

3. Masalah Jaringan atau Operator 📡

Kode ini umumnya terkait dengan kondisi atau masalah di tingkat jaringan telekomunikasi.

Cause Code (Q.850)	SIP Equiv.	Enum (Contoh)	Penjelasan & Rekomendasi Aksi (OCA)
3	404	NO_ROUTE_DESTINATION	Jaringan tidak dapat menemukan rute ke nomor tujuan. Hal ini seringkali disebabkan nomor yang tidak valid atau masalah pada operator tujuan.
34	503	NORMAL_CIRCUIT_CONGESTION	Tidak ada sirkuit/kanal yang tersedia untuk menangani panggilan saat itu karena jaringan sedang padat.
38	502	NETWORK_OUT_OF_ORDER	Terjadi gangguan pada jaringan yang kemungkinan akan berlangsung lama.
41	503	NORMAL_TEMPORARY_FAILURE	Terjadi kegagalan sementara di jaringan yang sifatnya tidak berlangsung lama.
42	503	SWITCH_CONGESTION	Peralatan

4. Masalah Protokol, Konfigurasi, atau Layanan ⚙️

Kode ini bersifat lebih teknis dan seringkali terkait dengan kapabilitas atau konfigurasi.

Cause Code (Q.850)	SIP Equiv.	Enum (Contoh)	Penjelasan & Rekomendasi Aksi (OCA)
57	403	BEARERCAPABILITY_NOTAUTH	Anda meminta kapabilitas layanan (misalnya, jenis panggilan tertentu) yang tersedia namun akun Anda tidak memiliki otorisasi untuk menggunakannya.
65	488	BEARERCAPABILITY_NOTIMPL	Peralatan di sisi tujuan tidak mendukung kapabilitas panggilan yang Anda minta (misalnya,
88	488	INCOMPATIBLE_DESTINATION	Terdapat ketidakcocokan atribut (
102	504	RECOVERY_ON_TIMER_EXPIRE	Prosedur dihentikan karena
111	-	PROTOCOL_ERROR	Terjadi

Butuh Bantuan Lebih Lanjut?

Jika Anda menghadapi kode yang tidak tercantum di sini atau memerlukan bantuan investigasi lebih lanjut, jangan ragu untuk menghubungi Tim Support OCA.