Ikhtisar nomor

Nomor telepon adalah asal pesan dan panggilan Anda. Bird menjual nomor di negara-negara yang dicakupnya, dan nomor yang dialokasikan ke workspace Anda dapat membawa SMS, MMS, atau suara tergantung pada apa yang didukung nomor tersebut. Halaman Numbers di dashboard menampilkan nomor-nomor yang dialokasikan untuk Anda, dan siklus hidup yang sama tersedia melalui API: cari yang tersedia untuk dibeli, pesan satu, lihat yang Anda miliki, dan lepaskan yang tidak lagi Anda butuhkan.

Setiap nomor yang dialokasikan untuk Anda memiliki kind, dan ini menentukan apa yang dapat Anda lakukan dengan nomor tersebut.

Nomor dedicated hanya milik workspace Anda. Anda membelinya, Anda dikenakan biaya bulanan, dan Anda dapat melepaskannya ketika sudah selesai. Inilah yang Anda dapatkan saat memesan nomor.

Nomor shared adalah short code pada infrastruktur yang dikelola Bird. Anda diberikan hak pakai alih-alih membelinya, sehingga tidak ada biaya bulanan tersendiri dan Anda tidak dapat melepaskannya. Mencoba melepaskannya akan gagal dengan E14002.

Dua field menjelaskan apa itu sebuah nomor, dan keduanya menjawab pertanyaan yang berbeda.

number_type adalah jenis fisik nomor: mobile, local, national, toll_free, atau short code. Ini menentukan bagaimana nomor berperilaku di jaringan dan, di beberapa negara, dokumen apa yang diperlukan.

capabilities adalah apa yang sebenarnya dapat dilakukan nomor: sms, mms, voice, atau kombinasinya. Nomor yang mencantumkan voice dapat membawa panggilan; yang tidak, tidak bisa. Filter pencarian berdasarkan capability saat Anda membutuhkan yang spesifik, dan periksa field ini sebelum Anda membangun sesuatu di atas nomor yang sudah Anda miliki.

Nomor yang sudah dialokasikan tidak selalu cukup untuk mengirim dari nomor tersebut. Beberapa negara tujuan juga mensyaratkan registrasi pengirim yang telah disetujui, yang merupakan persetujuan terpisah dari nomor itu sendiri.

status menunjukkan apakah nomor dapat membawa lalu lintas.

active berarti nomor dialokasikan untuk Anda dan dapat digunakan.

pending_ownership_registration berarti nomor tersebut dialokasikan kepada Anda dan ditagih, tetapi negara tujuan meminta dokumen kepemilikan yang belum disetujui. Field ownership menunjukkan apa yang masih belum selesai dan panggilan mana yang memajukannya. Sebagian besar nomor tidak pernah memasuki status ini, karena sebagian besar negara tidak meminta apa pun: ownership mereka adalah null.

released berarti nomor tidak lagi dialokasikan untuk Anda.

Memesan nomor membuat order, dan order itulah yang Anda lacak. Sebagian besar selesai dalam request dan langsung mengembalikan nomor. Yang harus menunggu operator akan kembali masih berjalan, dan Anda melakukan polling sampai mencapai completed atau failed.

Ini penting karena dua alasan. Nomor baru menjadi milik Anda setelah order-nya completed, jadi tidak ada yang boleh mengasumsikan nomor tersebut ada sebelumnya. Dan biaya setup yang sudah dikenakan tidak dikembalikan saat order gagal, itulah sebabnya pencarian dan pemesanan adalah panggilan terpisah: pencarian memberi tahu Anda apa yang tersedia sebelum Anda berkomitmen untuk membelinya.