Log panggilan

Leg log di bawah Voice > Legs mencantumkan setiap koneksi yang dilakukan atau diterima workspace Anda, dimulai dari yang terbaru. Satu panggilan dapat berisi beberapa leg, misalnya koneksi masuk dan koneksi yang diteruskan. Setiap entri adalah catatan detail panggilan (CDR), termasuk koneksi yang tidak dijawab atau ditolak. Gunakan log ini untuk memeriksa durasi, respons SIP terakhir, dan biaya.

Bird menulis setiap catatan saat leg berakhir, sehingga setiap entri di log memiliki hasil akhir. Tab Live di sebelahnya menampilkan leg yang masih aktif.

Untuk interaksi lengkap, buka Voice > Calls. Sebuah call mengelompokkan leg dan peserta terkait. Simpan Call ID untuk korelasi dan Leg ID saat menyelidiki satu koneksi; keduanya mengidentifikasi catatan yang berbeda.

Daftar panggilan

Setiap baris adalah satu leg. Panggilan dengan beberapa leg memiliki beberapa baris:

Daftar ini dibagi halaman, 25 leg per halaman. Pilih baris mana pun untuk membuka catatan leg.

Panggilan langsung

Tab Live menampilkan leg yang aktif saat ini, beserta jumlahnya sehingga Anda dapat melihat berapa banyak yang aktif tanpa membukanya. Leg yang aktif memiliki salah satu dari dua status:

Kolomnya sama dengan leg log kecuali Elapsed, yang menggantikan Duration. Kolom ini menghitung dari saat dijawab untuk leg yang tersambung dan dari awal untuk leg yang berdering. Tab ini diperbarui setiap beberapa detik. Saat leg berakhir, leg berpindah ke leg log dengan hasil akhirnya.

Pencarian dan filter

Halaman ini diawali dengan pencarian nomor dan filternya. Keduanya dapat digabungkan: filter status ditambah rentang tanggal mempersempit hasil ke leg yang cocok dengan keduanya.

Cari berdasarkan nomor. Kotak pencarian mencocokkan nomor terhadap kedua sisi leg, sehingga satu kueri menemukan leg ke nomor tersebut dan leg dari nomor tersebut.

Direction. Filter ke leg outbound atau inbound.

Status. Filter ke salah satu dari answered, no answer, failed, rejected, atau unknown. Masing-masing didefinisikan di Status. Di tab Live, pilihannya adalah ringing dan in progress.

Date. Di log panggilan, pilih preset (24 jam, 7 hari, atau 30 hari terakhir) atau pilih rentang kustom di kalender.

Penggunaan bulan ini

Ringkasan bulanan berisi tiga tile untuk bulan kalender berjalan dalam UTC:

Selisih antara durasi total dan waktu yang dapat ditagih adalah waktu dering yang tidak dijawab. Leg yang tidak dijawab tidak memiliki waktu yang dapat ditagih.

Setiap tarif tujuan membulatkan waktu yang dapat ditagih ke increment penagihannya. Lihat Cost and billing untuk detail harga.

Tile ini mencakup seluruh bulan apa pun filter yang Anda terapkan pada daftar.

Status

Leg di log berakhir dengan salah satu hasil berikut:

Rejected mencakup dua jenis penolakan, dan alasan penolakan membedakannya. Bird menolak panggilan sebelum operator terlibat, dalam hal ini alasan menyebutkan pemeriksaan yang gagal, atau pihak tujuan menolaknya langsung, dalam hal ini SIP response berisi jawabannya dan tidak ada alasan. Panggilan masuk yang ditolak oleh nomor yang dituju juga berstatus Rejected tanpa alasan, karena tidak ada pemeriksaan yang gagal: Inbound route-nya menyebutkan konfigurasi nomor tersebut. Lihat Panggilan ditolak.

Panggilan yang mencapai batas durasi panggilan platform sebesar 3 jam berstatus Answered, karena panggilan tersambung lalu berakhir di batas tersebut. Waktu yang dapat ditagih dihitung dari jawaban hingga saat Bird memutusnya. Jika panggilan menjalankan sequence, timeline-nya menampilkan Time limit reached sebagai akhir leg.

Failed bukan penolakan. Artinya panggilan dicoba tetapi tidak berhasil: nomor sibuk berstatus Failed dengan respons operator 486, dan nomor yang tidak dialokasikan berstatus Failed dengan 404.

Jika Anda membaca nilai-nilai ini dari tooling Anda sendiri, cocokkan yang Anda tangani dan perlakukan yang lain sebagai status yang tidak Anda tangani, bukan sebagai error. Daftar ini juga memuat busy dan canceled, dicadangkan untuk panggilan masuk yang dikirim ke nomor Anda sendiri. Keduanya belum digunakan, dan kedua hasilnya dilaporkan sebagai failed saat ini.

Memeriksa panggilan

Membuka leg menampilkan apa yang dicatat Bird tentang koneksi tersebut:

Inbound route muncul pada panggilan masuk dan mencatat rute yang dipilih. Rute trunk pada panggilan yang ditolak berarti panggilan tidak mencapai jawaban yang berfungsi. Receiving calls menjelaskan rute-rute tersebut dan apa yang dicatat masing-masing.

Panggilan ditolak

Panggilan yang ditolak tidak diteruskan, dan dua hal berbeda menghasilkan status ini.

Bird menolaknya sebelum operator terlibat. Sebelum melakukan panggilan keluar, Bird memeriksa caller ID, tujuan, batas akun, dan saldo wallet, lalu menolak panggilan yang gagal salah satunya. Sistem telepon Anda menerima SIP 503, sementara catatan panggilan yang terautentikasi menyimpan alasan spesifiknya. Ini mencegah pemanggil yang tidak terautentikasi mengetahui detail akun. Buka panggilan untuk melihat penyebab dan tautan ke pengaturan terkait.

Nomor yang dituju menolak panggilan. Panggilan masuk ke nomor yang dikonfigurasikan untuk menolak, atau ke nomor yang belum diarahkan ke mana pun, ditolak tanpa alasan sama sekali: tidak ada pemeriksaan yang gagal. Inbound route yang menjelaskannya. Receiving calls membahas penolakan tersebut.

Alasan di bawah adalah jenis pertama. Alasan ini berlaku untuk panggilan masuk maupun keluar, karena batas akun dan wallet diperiksa dalam kedua arah.

Alasan yang dapat Anda perbaiki

Dialer kampanye dapat terkena calls_per_second_exceeded meskipun jauh dari batas panggilan bersamaan, jadi periksa mana dari keduanya yang Anda terima sebelum mengubah apa pun.

Alasan yang diselesaikan Bird untuk Anda

Alasan-alasan ini ada di sisi Bird. Hubungi dukungan dan sertakan Leg ID dari catatan tersebut:

Cara membaca penolakan

Baca status dan alasan penolakan bersamaan:

• Rejected dengan alasan penolakan. Bird menolak panggilan, dan alasannya mengidentifikasi pemeriksaan yang gagal. SIP response adalah 503 yang diterima sistem telepon Anda. Ikuti resolusi akun atau routing dari alasan tersebut.
• Rejected tanpa alasan penolakan. Pada panggilan keluar, pihak tujuan menolaknya langsung dan SIP response berisi kodenya. Pada panggilan masuk, nomor yang dituju menolak panggilan, dan Inbound route menunjukkan konfigurasi nomor tersebut.
• Failed. Panggilan dicoba tetapi tidak berhasil, dan SIP response berisi kode yang dikembalikan. 486 berarti sibuk, sedangkan 404 berarti nomor tidak dialokasikan. Ini biasanya menunjuk pada nomor tersebut, bukan pada konfigurasi Anda.

Panggilan yang sama sekali tidak dapat diterima Bird ditolak sebelum catatan dibuat, sehingga tidak pernah muncul di log. Voice troubleshooting membahas panggilan tersebut.

Mengambil catatan

Empat cara untuk bekerja dengan catatan ini di luar dashboard:

• Ekspor CSV. Download CSV di tab Leg log mengekspor catatan yang cocok dengan filter Anda saat ini di semua halaman, hingga 10.000 leg. Pilihan yang lebih besar mengembalikan error tanpa file; persempit rentang tanggal atau filter Anda dan ekspor setiap pilihan secara terpisah. Gunakan untuk rekonsiliasi dan pelaporan ad-hoc.
• Baca melalui API. GET /v1/voice/legs mengembalikan daftar yang difilter, dan GET /v1/voice/legs/{leg_id} mengembalikan satu catatan. Keduanya memerlukan kunci API dengan cakupan voice di level read. Periksa referensi API untuk operasi yang dipublikasikan bagi resource Voice lain beserta cakupan yang diperlukan.
• Baca dari terminal. Bird CLI menyediakan bird voice legs list, bird voice legs get, dan bird voice stats. Server MCP mengekspos pembacaan yang sama kepada agen.
• Berlangganan event. voice_call.initiated, voice_call.answered, dan voice_call.ended dikirim ke endpoint Anda saat panggilan terjadi, sehingga sistem Anda tetap terkini tanpa polling. Lihat Voice events.

Langkah selanjutnya