Caller ID

Caller ID adalah nomor yang dapat ditampilkan workspace Anda pada panggilan keluar. Bird memeriksa header SIP From pada setiap panggilan terhadap nomor Bird yang dapat ditampilkan workspace ini dan nomor eksternal yang telah diverifikasi di workspace ini. Panggilan yang menampilkan nomor yang tidak memenuhi syarat akan ditolak.

Kelola caller ID di Voice > Nomor, yang mencantumkan setiap nomor yang dapat digunakan workspace Anda untuk voice. Nomor yang Anda beli dari kami dan nomor yang Anda verifikasi muncul dalam daftar yang sama, satu baris per nomor. Nomor yang termasuk keduanya hanya muncul sekali. Nomor yang Anda beli dari kami langsung siap ditampilkan begitu Anda memilikinya, tanpa panggilan verifikasi: kepemilikan itu sendiri adalah buktinya. Prosedur di bawah ini untuk nomor yang Anda miliki di tempat lain.

Setiap baris menampilkan nama, nomor dan negaranya, Penyedia, arah panggilan yang didukung, dan kegunaannya. Nomor yang menunggu kode menampilkan Sedang diverifikasi; nomor dengan kode kedaluwarsa atau kesempatan mencoba yang habis menampilkan Gagal. Setiap halaman memuat hingga 25 nomor. Pilih baris untuk membuka halaman nomor tersebut.

Mendaftarkan nomor

1. Pilih Tambahkan nomor > Verifikasi nomor yang Anda miliki.
2. Masukkan nomor dalam format E.164: diawali +, kode negara, dan nomor nasional. Satu nomor hanya dapat didaftarkan sekali dalam workspace Anda.
3. Simpan. Panggilan verifikasi langsung dilakukan ke nomor tersebut.
4. Angkat panggilan dan dengarkan kode enam digit.
5. Masukkan kode di dashboard. Anda memiliki lima percobaan, dan kode yang diterima mengubah status menjadi Terverifikasi.

Verifikasi caller ID tidak membebankan biaya ke workspace Anda untuk panggilan verifikasi. Pendaftaran tetap memerlukan izin Voice management dan persetujuan akun untuk mendaftarkan nomor terverifikasi. Beri nama nomor setelahnya di halaman nomor tersebut. Lihat Memberi nama nomor.

Setelah verifikasi, periksa negara yang ingin Anda hubungi di Voice > Tujuan. Verifikasi mencoba mengaktifkan negara dari nomor terverifikasi tersebut, tetapi negara yang tidak tersedia atau pembaruan pengaturan yang gagal dapat membuatnya tetap nonaktif. Caller ID terverifikasi dan destinasi yang aktif adalah dua persyaratan terpisah.

Daftarkan dan verifikasi melalui API

Daftarkan nomor untuk memulai panggilan verifikasinya, lalu kirim kode untuk ID yang dikembalikan pendaftaran tersebut. Lihat daftar caller ID Anda untuk menemukan nomor yang didaftarkan di dashboard. Anda juga dapat mengganti nama atau menghapus caller ID. Pembacaan memerlukan voice_management:read; pendaftaran, verifikasi, penggantian nama, dan penghapusan memerlukan voice_management:write. Referensi API menyertakan contoh SDK, baris perintah Bird, dan MCP.

Jika panggilan verifikasi pertama tidak dapat dimulai, mengirim kode dapat memulai panggilan lain ke nomor yang terdaftar. Organisasi Anda tetap harus memenuhi persyaratan pendaftaran. Jika kode kedaluwarsa atau kesempatan mencoba habis, hapus caller ID dan daftarkan nomor tersebut lagi. Langkah ini memulai panggilan verifikasi baru; lalu kirim kode baru untuk ID yang dikembalikan pendaftaran itu. Jika kode diterima tetapi aktivasi mengembalikan 412 atau 503, kepemilikan tetap terbukti dan caller ID terbaca verified dengan outbound_enabled: false. 412 berarti verifikasi identitas belum lengkap, yang Anda selesaikan di dasbor, atau ada tinjauan atau penolakan kelayakan yang memerlukan dukungan. 503 berarti penilaian kelayakan masih tertunda atau tidak tersedia, jadi coba lagi nanti. Setelah teratasi, kirim permintaan verifikasi kosong ke ID yang sama; jangan hapus dan daftarkan ulang.

Setelah verifikasi, periksa tujuan Voice Anda dan aktifkan negara nomor tersebut jika didukung dan diperlukan. Verifikasi mencoba mengaktifkannya, tetapi verifikasi caller ID yang berhasil dapat tetap membiarkan tujuan nonaktif dan panggilan keluar ke negara tersebut terblokir.

Satu verifikasi pada satu waktu

Pendaftaran dapat mengembalikan E21036 ketika penyedia verifikasi sudah memiliki tantangan untuk nomor tersebut yang dimiliki workspace atau tujuan lain. Tunggu verifikasi tersebut selesai atau kedaluwarsa, lalu daftarkan nomor itu kembali. Bukti yang diperoleh untuk workspace lain tidak memverifikasi nomor di workspace Anda.

Penolakan yang sama berlaku untuk nomor yang sedang sibuk karena alasan lain: kode login atau verifikasi Trust Hub yang sedang berlangsung ke nomor tersebut. Jika tidak ada workspace lain yang memverifikasi nomor itu, biasanya itulah penyebabnya, dan waktu tunggunya sama.

Verifikasi yang sudah selesai di tempat lain tidak memblokir Anda: nomor yang sama dapat menjadi caller ID terverifikasi di lebih dari satu workspace, dan masing-masing membuktikannya secara terpisah.

Status

Dapatkan kode baru mendaftarkan ulang nomor dan meneleponnya dengan kode baru. Jika panggilan pertama tidak pernah tiba dan nomor masih pending, hapus caller ID tersebut lalu tambahkan kembali nomornya.

Jika Anda membaca nilai-nilai ini dari tooling Anda sendiri, cocokkan yang Anda tangani dan perlakukan nilai lainnya sebagai status yang tidak Anda tangani, bukan sebagai error.

Disclaimer verifikasi dan pengiriman CLI

Bird melakukan verifikasi CLI (Calling Line Identification) untuk mengonfirmasi bahwa A-number valid dan diotorisasi untuk digunakan sebelum panggilan keluar dapat dilakukan dari platform. Verifikasi ini memastikan nomor tersebut sah dan berada di bawah kendali pelanggan.

Namun, verifikasi tidak menjamin pengiriman CLI secara end-to-end atau koneksi panggilan jika CLI bukan nomor yang diperoleh melalui Bird. Operator hilir dan operator internasional menerapkan regulasi nasional dan kebijakan lalu lintas mereka sendiri, yang berada di luar kendali Bird. Hal ini dapat mencakup:

• Kerangka anti-spoofing dan autentikasi caller ID (misalnya STIR/SHAKEN di AS, pedoman CLI Ofcom di Inggris)
• Persyaratan agar CLI merupakan nomor terdaftar secara lokal atau nomor dalam negeri
• Penyaringan spam dan penipuan yang diterapkan oleh operator terminasi
• Pembatasan pada kategori lalu lintas tertentu, seperti perjudian, promosi keuangan, penagihan utang, atau pesan politik
• Pemblokiran panggilan internasional yang menampilkan CLI domestik (pembatasan "origin-based")
• Daftar do-not-originate dan pemblokiran yang diwajibkan regulator

Karena alasan-alasan ini, Bird dapat memverifikasi CLI tetapi tidak dapat menjamin bahwa (1) CLI akan dipertahankan dan ditampilkan kepada pihak yang dipanggil, atau (2) panggilan akan terhubung melalui trunk domestik atau mitra dan operator internasional Tier 1. Untuk memaksimalkan pengiriman CLI dan tingkat keberhasilan panggilan, kami merekomendasikan penggunaan nomor yang diperoleh melalui Bird, yang disediakan dan dirutekan sesuai dengan persyaratan regulasi lokal.

Memberi nama nomor

Nama melabeli nomor di dashboard dan di daftar Panggil dari pada dialer. Nama tidak dikirim bersama panggilan.

Pilih nomor di daftar Nomor untuk membuka halamannya, lalu atur Nama dan simpan. Biarkan kolom kosong untuk menampilkan nomor saja. Pemberian nama berfungsi pada status apa pun dan tidak mengubah nomor atau verifikasinya.

Memverifikasi nomor yang tidak dapat Anda angkat

Seseorang harus mengangkat panggilan verifikasi dan mendengarkan kodenya. Jika nomor tersebut biasanya mengarah ke sistem tanpa operator, rutekan sementara ke telepon yang dapat Anda angkat, lalu kembalikan. Hubungi dukungan jika nomor tersebut tidak dapat menerima panggilan.

Menghapus caller ID

Gunakan Hapus caller ID pada baris nomor tersebut. Menghapus verifikasi menghilangkan bukti tersebut untuk panggilan baru. Nomor yang dimiliki workspace Anda melalui Bird dapat tetap memenuhi syarat melalui alokasinya; nomor eksternal yang kehilangan buktinya ditolak dengan caller_id_not_verified. Panggilan yang sedang berlangsung tetap dilanjutkan, dan catatan panggilan yang ada tidak berubah.

Langkah berikutnya