Sign inGet Started

Pemecahan masalah Voice

Mulai dari log panggilan. Keberadaan catatan dan field-nya menentukan pemeriksaan mana yang perlu Anda ikuti.

Untuk panggilan yang dimulai melalui API, periksa terlebih dahulu respons Create Call dan riwayat eksekusi. Ikuti pemecahan masalah sequence untuk pratinjau, publikasi, jalur keypad, dan rute sequence masuk. Pemeriksaan koneksi di bawah ini mencakup panggilan melalui trunk SIP.

Jika Anda tidak melihat catatan panggilan sama sekali, periksa hal-hal berikut terlebih dahulu:

  1. Anda berada di workspace yang benar. Catatan panggilan dimiliki oleh workspace yang memegang nomor atau trunk tersebut. Beralihlah ke workspace itu, lalu buka Voice > Legs.
  2. Panggilan sampai ke Bird. Untuk panggilan masuk, operator pemanggil menentukan ke mana panggilan diarahkan, dan nomor yang diarahkan ke trunk tanpa gateway tersimpan menolak panggilan sebelum catatan dibuat. Untuk panggilan keluar, lihat Panggilan keluar tidak muncul di log panggilan: penerimaan yang ditolak tidak meninggalkan catatan.
  3. Filter tidak menyembunyikannya. Hapus filter status dan perluas rentang tanggal.

Panggilan keluar tidak muncul di log panggilan

Untuk panggilan yang dilakukan melalui trunk SIP, kegagalan penerimaan dapat terjadi sebelum catatan leg dibuat. Periksa penyebab umum berikut:

  • Trunk belum mengizinkan panggilan keluar. Trunk baru tidak membawa panggilan apa pun sampai Anda mengaktifkan panggilan keluar di halamannya, dan trunk tersebut menolak setiap percobaan sampai Anda melakukannya, apa pun kredensial yang disertakan panggilan.
  • Trunk belum memiliki cara untuk mengenali Anda. Trunk baru menolak setiap panggilan sampai Anda menambahkan rentang IP, kunci API yang diizinkan, atau kredensial sesi.
  • Panggilan berasal dari alamat di luar daftar IP yang diizinkan trunk. Di belakang NAT, bandingkan alamat publik router dengan daftar IP yang diizinkan trunk. Alamat privat sistem telepon tidak sampai ke Bird.
  • Tantangan kata sandi gagal. Pastikan username-nya adalah bird. Kata sandi harus berupa secret kunci API yang diizinkan atau kredensial sesi yang belum kedaluwarsa. Trunk juga harus menawarkan algoritma Digest yang digunakan sistem telepon Anda.
  • Panggilan ditujukan ke domain SIP yang tidak dikenali Bird. Perangkat Anda harus menempatkan domain SIP milik trunk di host Request-URI. Salin domain secara utuh dari halaman trunk, jangan merakitnya sendiri. Panggilan yang ditujukan ke nama host atau alamat Bird lain tidak sampai ke trunk Anda.

Respons yang diterima perangkat Anda menunjukkan pemeriksaan mana yang gagal. 407 Proxy Authentication Required berarti trunk meminta kata sandi; jika kredensial sesi aktif, trunk memintanya dari setiap pemanggil. 403 Forbidden berarti trunk tidak menerima panggilan: host Request-URI bukan domain SIP milik trunk Anda, panggilan keluar dinonaktifkan, alamat berada di luar daftar yang diizinkan, atau kata sandi tidak terverifikasi. 503 Auth Unavailable berarti Bird tidak dapat memeriksa panggilan, jadi coba lagi.

Untuk panggilan sequence, periksa terlebih dahulu apakah permintaan panggilan diterima dan apakah eksekusinya ada. Pratinjau simulator tidak melakukan panggilan. Pengujian nyata memerlukan draf tersimpan atau publikasi aktif, izin tulis pengelolaan dan panggilan Voice, caller ID yang memenuhi syarat, serta tujuan yang aktif. Panduan pembuat sequence menjelaskan pemeriksaan ini.

Panggilan ditolak dengan alasan penolakan

Bird menolak panggilan sebelum menghubungi carrier, dan alasannya menyebutkan pemeriksaan yang gagal. Buka panggilan tersebut dan gunakan tautan di panel penolakan ke pengaturan yang relevan. Panggilan yang ditolak mencantumkan setiap alasan beserta perbaikannya.

caller_id_not_verified adalah alasan yang paling sering ditemui klien baru, biasanya karena klien menaruh digest username di tempat caller ID seharusnya: keduanya adalah field yang berbeda.

Panggilan gagal, bukan ditolak

Failed bukan penolakan. Panggilan dicoba dan tidak berhasil, dan SIP response memuat kode yang dikembalikan. 486 adalah nomor sibuk, 404 adalah nomor yang tidak teralokasi. Ini biasanya menunjuk ke nomor yang Anda hubungi, bukan ke konfigurasi Anda.

Panggilan yang ditolak Bird berstatus Rejected, bukan Failed, jadi filter log pada Rejected saat Anda mencari panggilan yang gagal melewati salah satu pemeriksaan Bird.

Panggilan ditolak tanpa alasan penolakan

Pada panggilan keluar, pihak penerima menolaknya langsung dan SIP response memuat kodenya.

Pada panggilan masuk, nomor yang dihubungi menolak panggilan tersebut, yang tidak melanggar pemeriksaan apa pun sehingga tidak menyebutkan alasan. Buka panggilan dan baca Inbound route: rute reject berarti nomor tersebut diatur untuk menolak, atau nomor tanpa rute sendiri sementara rute default workspace adalah reject. Menerima panggilan membahas setiap penolakan masuk berdasarkan rute dan alasannya.

Orang yang Anda hubungi melihat nomor yang berbeda

Panggilan memiliki catatan dan tidak ada alasan penolakan, sehingga lolos setiap pemeriksaan Bird. Masalahnya ada di hilir Bird: operator tujuan mengganti caller ID, atau menolak panggilan yang menampilkannya. Penyebab yang sama tampak sebagai nomor yang tersambung di satu negara tetapi tidak pernah tersambung di negara lain.

Verifikasi membuktikan Anda menguasai sebuah caller ID. Verifikasi tidak mewajibkan operator yang mengirimkan panggilan untuk menerimanya, dan operator menerapkan aturan nasional mereka sendiri terhadap nomor yang tidak diperoleh melalui Bird. Lihat penafian verifikasi dan pengiriman CLI untuk praktik yang terkait, termasuk persyaratan CLI dalam negeri, pemblokiran berbasis asal, dan daftar do-not-originate.

Untuk mengetahui jenis nomor yang Anda tampilkan, buka nomor tersebut di Voice > Numbers dan baca panel di bagian atas halamannya. Nomor yang Anda beli dari Bird menampilkan langganannya, begitu juga nomor yang Anda beli dan juga verifikasi. Hanya nomor yang Anda miliki di tempat lain yang menampilkan verifikasi saja. Langganan berarti nomor tersebut diperoleh melalui Bird, sehingga penafian tidak berlaku untuknya. Menampilkan nomor yang diperoleh melalui Bird adalah cara meningkatkan rasio pengiriman dan penyelesaian di tujuan yang menolak nomor yang hanya diverifikasi.

Panggilan masuk tidak pernah sampai ke sistem telepon Anda

Nomor menjawab panggilan, dan pengirimannya yang gagal. Periksa dalam urutan berikut:

  1. Baca Inbound route panggilan tersebut. Kolom ini menunjukkan trunk atau forward mana yang dituju nomor tersebut saat panggilan masuk. Rute reject berarti nomor tersebut memiliki rute sendiri yang disetel ke reject, atau tidak memiliki rute sendiri sementara rute default workspace disetel ke reject. Buka nomor tersebut untuk melihat yang mana: nomor yang disetel ke reject mengabaikan default. Nomor yang trunk-nya dihapus atau panggilan masuknya dinonaktifkan kembali ke rute default, dan rute default yang mengarah ke trunk tersebut kembali ke reject.
  2. Pastikan trunk dapat mengirimkan panggilan. Buka Inbound routing pada trunk. Gateway harus berada dalam sebuah grup, dan Default route (atau sebuah aturan) harus mengirim panggilan ke grup tersebut. Default route yang disetel ke Reject menolak setiap panggilan tanpa alasan penolakan, dan trunk tanpa gateway tersimpan menolak panggilan sebelum catatan dibuat. Perbaiki peringatan Calls never reach some gateways jika dashboard menampilkannya saat Anda menyimpan.
  3. Periksa alamat gateway. Bird menghubungi gateway dalam grup sesuai urutan yang ditetapkan grup dan menyerah jika tidak ada yang menjawab. Konfirmasi host URI SIP, port-nya, dan bahwa sistem telepon Anda menerima panggilan dari Bird di alamat tersebut.
  4. Untuk forward, pastikan target masih terverifikasi. Target forward diperiksa ulang pada setiap panggilan, sehingga caller ID yang Anda hapus akan menghentikan penerusan mulai saat itu.
  5. Periksa jawaban perangkat Anda. Panggilan yang sampai ke gateway Anda lalu ditolak di sana biasanya berstatus Failed (jawaban 6xx tampil sebagai Rejected), dan SIP response memuat kode dari perangkat Anda, misalnya 403 atau 412. Bird sudah mencoba panggilan tersebut, jadi perbaikannya ada di sisi Anda: pastikan SBC Anda menerima panggilan dari alamat signalling Bird dan format nomor yang dikirim gateway.

Jika nomor menggunakan Run a sequence, periksa sequence yang terikat dan entri panggilannya, bukan trunk. Pastikan ada publikasi aktif, entri yang menerima data kosong, dan apakah pemanggil adalah penguji draf. Tinjau hasil eksekusi sequence dan cabang kegagalannya. Mengubah draf tidak mengubah versi yang digunakan pemanggil biasa.

Telepon browser tidak berdering atau tidak bisa menelepon

Periksa terlebih dahulu status di bagian bawah telepon:

  1. Pilih Online agar Anda dihubungi. Ring group melewati anggota yang berstatus Offline, Busy, sedang dalam panggilan, atau Not accepting calls setelah tiga panggilan tak terjawab berturut-turut. Status Anda menjelaskan masing-masing status.
  2. Jadilah online untuk menelepon. Telepon yang berstatus Offline tidak dapat melakukan panggilan. Status Online, Busy, dan Not accepting calls dapat melakukannya.
  3. Alihkan panggilan ke browser ini. Di setiap workspace, Anda hanya dapat online di satu perangkat dan satu tab dalam satu waktu. Offline · Active on another device menawarkan Take over, dan Offline · Calls are handled in another tab menawarkan Use here.
  4. Periksa batas pengguna online. Offline · Limit of users online reached berarti jumlah pengguna online di organisasi Anda sudah mencapai batas yang diizinkan. Lihat Batas pengguna online.
  5. Aktifkan suara. Setelah halaman dimuat ulang, browser Anda mungkin memblokir nada dering sampai Anda berinteraksi dengan halaman. Menu status kemudian menawarkan Turn on sound.

Jika telepon sudah online tetapi panggilan tetap tidak berdering di perangkat Anda, baca Inbound route panggilan tersebut di log panggilan. Kolom ini menyebutkan ring group yang dihubungi panggilan, sehingga Anda dapat memastikan bahwa Anda adalah anggotanya dan bahwa nomor tersebut diarahkan ke grup itu.

Klien Anda menjawab MD5 dan tidak berhasil

Beberapa perangkat salah menangani tantangan yang diawali dengan SHA-256. Atur trunk ke MD5 saja.

Panggilan tersambung tetapi audio satu arah

Klien Anda berada di belakang NAT, dan medianya dikirim ke alamat privat. Aktifkan penanganan NAT atau STUN di klien.

Jika perangkat Anda dapat dijangkau tetapi audio masih gagal di satu arah, pastikan firewall Anda mengizinkan alamat media Bird pada port UDP 2500 hingga 32499.

Langkah selanjutnya

HalamanCakupan
Log panggilanSetiap field pada catatan panggilan, dan setiap alasan penolakan
Trunk SIPDaftar IP yang diizinkan, kunci, kredensial sesi, dan Digest
Pengaturan klien SIPPengaturan yang diminta setiap softphone dan PBX
Melakukan panggilanApa yang diharapkan Bird pada INVITE, dan bagaimana handshake berjalan
Menerima panggilanMengarahkan nomor ke trunk atau forward, dan apa yang dicatat
TeleponMenjadi online, status Anda, dan menjawab panggilan di browser

Lanjutkan dengan dokumentasi, panduan, dan contoh untuk topik ini.