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:

Kolom	Yang ditampilkan
Status	Cara leg berakhir (lihat Status)
From	Nomor pemanggil, caller ID yang ditampilkan perangkat Anda
To	Nomor yang dipanggil
Direction	Outbound untuk leg yang dilakukan perangkat Anda, inbound untuk leg yang masuk ke nomor Anda
Duration	Panjang total leg, dari saat Bird menerimanya hingga hangup
Started	Waktu Bird menerima leg

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:

Status	Yang terjadi
Ringing	Upaya panggilan aktif sedang menunggu jawaban; ini tidak mengonfirmasi bahwa tujuan berdering
In progress	Tujuan mengangkat, dan panggilan tersambung

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:

Tile	Yang dihitung
Legs	Catatan leg yang selesai dalam bulan tersebut, termasuk yang tidak dijawab dan yang ditolak
Total duration	Panjang penuh setiap leg dijumlahkan, dari saat Bird menerimanya hingga hangup
Billable time	Waktu terjawab setiap leg dijumlahkan

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:

Status	Yang terjadi
Answered	Tujuan mengangkat. Waktu yang dapat ditagih dihitung dari jawaban hingga hangup
No answer	Upaya habis waktu tanpa jawaban; ini tidak membuktikan bahwa telepon tujuan berdering
Rejected	Panggilan ditolak, bukan diteruskan
Failed	Panggilan dicoba tetapi tidak berhasil, dan `SIP response` adalah yang dikembalikan
Unknown	Hasilnya tidak dapat ditentukan, misalnya ketika tidak ada respons akhir yang diterima

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 selama 4 jam berstatus Answered, karena panggilan tersambung lalu berakhir saat mencapai batas. Waktu yang dapat ditagih dihitung sejak panggilan dijawab hingga Bird memutuskannya. Jika panggilan menjalankan urutan, linimasanya 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:

Field	Yang ditampilkan
Status	Hasil leg (lihat Status). Leg yang ditolak Bird juga menampilkan alasan dan tindakan yang perlu dilakukan
Respons SIP	Kode SIP akhir leg, misalnya `200` atau `486`. Leg yang ditolak Bird memiliki `503`, tanpa keterlibatan carrier
From / To	Kedua nomor, masing-masing dapat disalin
Inbound route	Pada panggilan masuk, rute yang dipilih untuk nomor tersebut, seperti trunk, forward, sequence, atau rejection. Berisi tautan ke nomor tersebut
Trunk	Trunk SIP tempat panggilan masuk, atau dikirim ke, berguna saat beberapa lokasi berbagi satu workspace
Started	Waktu Bird menerima leg
Answered	Waktu leg dijawab, atau Not answered
Ended	Waktu leg diputus
Leg ID	ID milik catatan koneksi itu sendiri (`vcl_…`). Gunakan bersama `GET /v1/voice/legs/{leg_id}` dan kutip ke dukungan.
Call ID	Digunakan bersama oleh setiap leg dari satu panggilan (`vcs_…`). Gunakan filter `call_id` untuk menemukan leg terkait. Panggilan yang diteruskan memiliki dua leg yang berbagi satu ID.
Billing	Waktu yang dapat ditagih, durasi total, dan biaya leg setelah dihitung tarifnya

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 disetel untuk menolak, atau ke nomor tanpa rute sendiri sementara rute default workspace adalah tolak, ditolak tanpa alasan sama sekali: panggilan tersebut tidak gagal di pemeriksaan mana pun dari sisi kami. Inbound route yang menunjukkan hal ini. Menerima panggilan membahas penolakan-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

Alasan	Yang terjadi	Tindakan yang perlu dilakukan
`source_not_allowed`	Panggilan masuk dari alamat yang tidak tercakup dalam daftar IP yang diizinkan pada trunk	Tambahkan alamat yang digunakan sistem telepon Anda untuk mengirim panggilan ke trunk
`caller_id_not_verified`	Nomor dalam header `From` bukan nomor Bird yang memenuhi syarat maupun ID penelepon eksternal yang telah diverifikasi di workspace ini	Gunakan nomor Bird yang memenuhi syarat, atau verifikasi nomor eksternal
`destination_not_enabled`	Panggilan ke negara tersebut dinonaktifkan untuk workspace Anda	Aktifkan negara tersebut di Tujuan
`insufficient_balance`	Saldo dompet Anda tidak cukup untuk panggilan tersebut, sehingga Bird menolaknya sejak awal	Isi ulang saldo, atau aktifkan isi ulang otomatis agar saldo rendah tidak mengganggu panggilan
`daily_spend_exceeded`	Panggilan tersebut akan melampaui batas pengeluaran voice harian workspace Anda atau, untuk panggilan keluar, batas pengeluaran untuk negara yang dituju	Tunggu hingga batas direset pada awal hari berikutnya dalam UTC, atau naikkan batas di Voice > Spend limit, atau batas untuk negara tersebut di Voice > Destinations, hingga batas maksimum organisasi Anda
`concurrent_calls_exceeded`	Jumlah panggilan Anda yang sedang berlangsung sudah mencapai batas yang diizinkan akun Anda	Tunggu hingga satu panggilan berakhir, atau tingkatkan paket Voice Anda di Billing and payments untuk mendapatkan batas yang lebih tinggi
`calls_per_second_exceeded`	Anda melakukan panggilan baru lebih cepat daripada yang diizinkan akun Anda	Kurangi laju panggilan Anda, lalu coba lagi. Percobaan ulang yang langsung dilakukan akan mendapat respons yang sama. Paket Voice yang lebih tinggi menaikkan batas per detik
`number_ownership_not_verified`	Anda telah membeli nomor ini, tetapi negara yang menerbitkannya belum menerima dokumen yang membuktikan kepemilikan Anda	Lengkapi persyaratan pada field `ownership` nomor tersebut, lalu lakukan panggilan lagi

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:

Alasan	Yang terjadi
`routing_not_configured`	Routing workspace Anda masih dalam proses pemasangan, hal ini wajar selagi pengaturan voice baru sedang diselesaikan
`no_route_found`	Routing sudah terpasang, tetapi tidak mencakup nomor yang Anda hubungi. Hubungi dukungan dengan menyertakan leg ID untuk memeriksa rute
`destination_blocked`	Konfigurasi routing Bird memblokir panggilan ke tujuan tersebut
`call_not_permitted`	Bird tidak dapat menyelesaikan panggilan untuk akun Anda, sehingga menolak panggilan tersebut alih-alih meneruskannya dengan ketentuan yang tidak diketahui

Cara membaca penolakan

Baca status dan alasan penolakan bersamaan:

Rejected dengan alasan penolakan. Bird menolak panggilan, dan alasannya menunjukkan pemeriksaan yang gagal. SIP response berisi 503 yang diterima sistem telepon Anda. Terapkan solusi terkait akun atau perutean yang sesuai dengan alasan tersebut. Pada panggilan keluar, 503 tersebut memuat header X-BIRD-CALL-ID dengan Leg ID catatan itu, sehingga Anda dapat menghubungkan penolakan dengan catatannya tanpa mencocokkan waktu dan nomor.
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 pada tab Leg log mengekspor catatan yang cocok dengan filter Anda di seluruh halaman, hingga 10.000 leg. Pilihan yang lebih besar menghasilkan kesalahan tanpa file; persempit rentang tanggal atau filter Anda dan ekspor setiap pilihan secara terpisah. File ini memuat durasi dan waktu yang dapat ditagih, tetapi tidak memiliki kolom biaya. Tinjau tagihan di Penggunaan, pengeluaran, dan invoice.
Baca catatan melalui API. GET /v1/voice/legs dan GET /v1/voice/legs/{leg_id} membaca setiap leg secara individual (GET /v1/voice/calls dan GET /v1/voice/calls/{call_id} mendukung pembacaan panggilan yang dikelompokkan, yang digunakan oleh dashboard dan CLI). Semuanya memerlukan kunci API dengan cakupan voice pada tingkat read. Periksa referensi API untuk mengetahui operasi yang dipublikasikan bagi sumber daya Voice lainnya beserta cakupan yang diperlukan.
Baca catatan dari terminal. Bird CLI menyediakan bird voice calls list, bird voice calls get, bird voice legs list, bird voice legs get, dan bird voice stats. Server MCP menyediakan operasi pembacaan yang sama bagi 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

Halaman	Yang dibahas
Voice events	Tiga event panggilan, payload-nya, dan cara mengonsumsinya
Placing calls	Apa yang diharapkan Bird pada `INVITE`, dan cara panggilan dihitung tarifnya
Receiving calls	Mengarahkan nomor ke trunk atau forward, dan apa yang dicatat
Trunk SIP	Daftar IP yang diizinkan, kunci API yang diizinkan, dan pengaturan Digest
Voice destinations	Mengaktifkan negara, dan arti ketersediaan
Errors	Respons kesalahan API dan field pemulihannya

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

Dapatkan ringkasan implementasi

Sumber daya terkait