Log panggilan
Log panggilan di bawah Voice > Calls mencantumkan setiap panggilan yang dilakukan workspace Anda dan setiap panggilan yang masuk ke salah satu nomornya, terbaru lebih dulu. Setiap entri adalah catatan detail panggilan (CDR), termasuk panggilan yang tersambung, berdering tanpa jawaban, atau ditolak. Gunakan untuk memeriksa durasi, respons SIP akhir, dan biaya.
Bird menulis setiap catatan saat panggilan berakhir, sehingga setiap panggilan dalam log memiliki hasil akhir. Tab Live di sampingnya menampilkan panggilan yang masih berlangsung.
Daftar panggilan
Setiap baris adalah satu panggilan:
| Kolom | Yang ditampilkan |
|---|---|
| Status | Cara panggilan berakhir (lihat Status) |
| From | Nomor pemanggil, caller ID yang ditampilkan perangkat Anda |
| To | Nomor yang dipanggil |
| Direction | Outbound untuk panggilan yang dilakukan perangkat Anda, inbound untuk panggilan yang masuk ke nomor Anda |
| Duration | Panjang total panggilan, dari saat Bird menerimanya hingga hangup |
| Started | Kapan Bird menerima panggilan |
Daftar ini dipaginasi, 25 panggilan per halaman. Pilih baris mana pun untuk membuka panggilan tersebut.
Panggilan langsung
Tab Live mencantumkan panggilan yang sedang berlangsung sekarang, dan menampilkan jumlah sehingga Anda dapat melihat berapa banyak yang berlangsung tanpa membukanya. Panggilan langsung memiliki salah satu dari dua status:
| Status | Yang terjadi |
|---|---|
| Ringing | Panggilan mencapai tujuannya, yang belum mengangkat |
| In progress | Tujuan mengangkat, dan panggilan tersambung |
Kolom-kolomnya sama dengan log panggilan kecuali Elapsed, yang menggantikan Duration. Elapsed menghitung dari saat dijawab untuk panggilan tersambung dan dari awal untuk panggilan yang berdering. Tab ini diperbarui setiap beberapa detik. Saat panggilan berakhir, panggilan berpindah ke log panggilan dengan hasil akhirnya.
Pencarian dan filter
Halaman ini diawali dengan pencarian nomor dan filternya. Keduanya digabungkan: filter status ditambah rentang tanggal mempersempit ke panggilan yang cocok dengan keduanya.
Cari berdasarkan nomor. Kotak pencarian mencocokkan nomor dengan kedua sisi panggilan, sehingga satu kueri menemukan panggilan ke nomor tersebut dan panggilan dari nomor tersebut.
Direction. Filter ke panggilan 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 |
|---|---|
| Calls | Catatan panggilan selesai dalam bulan tersebut, termasuk yang tidak dijawab dan ditolak |
| Total duration | Panjang penuh setiap panggilan dijumlahkan, dari saat Bird menerimanya hingga hangup |
| Billable time | Waktu terjawab setiap panggilan dijumlahkan |
Selisih antara total duration dan billable time adalah waktu dering yang tidak dijawab. Panggilan yang tidak dijawab tidak memiliki billable time.
Setiap tarif tujuan membulatkan billable time ke increment penagihannya. Lihat Cost and billing untuk detail harga.
Tile ini mencakup seluruh bulan apa pun filter yang Anda terapkan pada daftar.
Status
Panggilan dalam log berakhir dengan salah satu hasil berikut:
| Status | Yang terjadi |
|---|---|
| Answered | Tujuan mengangkat. Billable time dihitung dari jawaban hingga hangup |
| No answer | Panggilan berdering di tujuannya dan tidak dijawab sebelum waktu habis |
| 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 apa yang dikonfigurasikan pada nomor tersebut. Lihat Panggilan ditolak.
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 panggilan menampilkan apa yang dicatat Bird tentangnya:
| Field | Yang ditampilkan |
|---|---|
| Status | Hasil panggilan (lihat Status). Panggilan yang ditolak Bird juga menampilkan alasan dan tindakan yang perlu dilakukan |
| Respons SIP | Kode SIP akhir panggilan, misalnya 200 atau 486. Panggilan yang ditolak Bird memuat 503, tanpa operator yang terlibat |
| From / To | Kedua nomor, masing-masing dapat disalin |
| Inbound route | Pada panggilan masuk, apa yang dikonfigurasikan pada nomor yang dituju: kirim ke trunk, forward, atau tolak. Berisi tautan ke nomor tersebut |
| Trunk | Trunk SIP tempat panggilan masuk, atau dikirim ke, berguna saat beberapa lokasi berbagi satu workspace |
| Started | Kapan Bird menerima panggilan |
| Answered | Kapan panggilan dijawab, atau Not answered |
| Ended | Kapan panggilan diputus |
| Call ID | ID catatan itu sendiri (vcl_…). Kutip ini ke dukungan, dan gunakan untuk mencocokkan dengan log Anda sendiri |
| Session ID | Digunakan bersama oleh setiap leg satu panggilan (vcs_…), sehingga catatan terkait dapat dikelompokkan. Panggilan yang di-forward memiliki dua leg yang berbagi satu session ID |
| Billing | Billable time, total duration, dan biaya panggilan setelah dihitung tarifnya |
Inbound route hanya muncul pada panggilan masuk, dan menunjukkan apa yang dikonfigurasikan pada nomor tersebut, bukan bahwa konfigurasi itu berhasil: rute trunk pada panggilan yang ditolak berarti nomor diarahkan ke trunk yang tidak menerima panggilan tersebut. Receiving calls membahas tiga jawaban 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
| Alasan | Yang terjadi | Yang harus dilakukan |
|---|---|---|
| source_not_allowed | Panggilan datang dari alamat yang tidak tercakup dalam daftar IP yang diizinkan trunk | Tambahkan alamat asal sistem telepon Anda ke trunk |
| caller_id_not_verified | Nomor di header From bukan caller ID terverifikasi untuk workspace ini | Verifikasi nomor tersebut, atau gunakan nomor yang sudah terverifikasi |
| destination_not_enabled | Panggilan ke negara tersebut dinonaktifkan untuk workspace Anda | Aktifkan negara tersebut di Destinations |
| insufficient_balance | Wallet Anda tidak mencukupi untuk panggilan ini, sehingga Bird menolaknya langsung | Isi ulang, atau aktifkan pengisian otomatis agar saldo rendah tidak mengganggu panggilan |
| daily_spend_exceeded | Panggilan ini akan melampaui batas pengeluaran suara harian organisasi Anda | Tunggu batas direset pada awal hari UTC berikutnya, atau minta Bird untuk menaikkannya |
| concurrent_calls_exceeded | Anda memiliki panggilan berlangsung sebanyak yang diizinkan akun Anda | Tunggu panggilan berakhir, atau hubungi dukungan untuk menaikkan batas |
| calls_per_second_exceeded | Anda melakukan panggilan baru lebih cepat dari yang diizinkan akun Anda | Kurangi kecepatan dial, lalu coba lagi. Langsung mencoba lagi akan mendapat jawaban yang sama |
| number_ownership_not_verified | Anda membeli nomor ini, tetapi negara penerbitnya belum menerima dokumen yang membuktikan kepemilikan Anda | Lengkapi apa yang diminta 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 ini ada di sisi Bird. Hubungi dukungan dan sebutkan Call ID dari catatan tersebut:
| Alasan | Yang terjadi |
|---|---|
| routing_not_configured | Routing workspace Anda masih dalam proses pemasangan, yang wajar terjadi saat penyiapan voice baru sedang diselesaikan |
| no_route_found | Routing sudah terpasang, tetapi tidak mencakup nomor yang Anda panggil. Hubungi dukungan dengan call 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 daripada melakukannya dengan ketentuan yang tidak diketahui |
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 Call log mengekspor setiap catatan yang cocok dengan filter Anda saat ini di semua halaman. Gunakan untuk rekonsiliasi dan pelaporan ad-hoc.
- Baca melalui API. GET /v1/voice/calls mengembalikan daftar yang difilter, dan GET /v1/voice/calls/{call_id} mengembalikan satu catatan. Keduanya memerlukan kunci API dengan scope voice di level read. Pengaturan trunk, caller ID, dan tujuan bukan bagian dari API publik.
- Baca dari terminal. Bird CLI menyediakan bird voice list, bird voice get, dan bird voice stats. Server MCP mengekspos pembacaan yang sama ke 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 menggunakannya |
| 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 |
Sumber daya terkait
Lanjutkan dengan dokumentasi, panduan, dan contoh untuk topik ini. Sumber daya tersedia dalam bahasa Inggris.