# 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**](https://bird.com/dashboard/w/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.

## Nomor dedicated dan shared

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`](/docs/api/errors/E14002).

## Apa yang dapat dibawa nomor

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 nomor yang dialokasikan

`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.

## Pemesanan bersifat asinkron

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.

## Langkah selanjutnya

- [Beli dan lepaskan nomor](/docs/guides/numbers/buying-numbers) memandu siklus hidup lengkap melalui API.
- [Referensi API Numbers](/docs/api/reference/list-available-numbers) mendokumentasikan setiap operasi dan field.
- [Idempotency](/docs/guides/idempotency) menjelaskan cara membuat pemesanan ulang yang aman.

## Related resources

- [What is a virtual phone number (VMN)?](/explained/numbers/what-is-a-virtual-phone-number) (answer)
- [SMS numbers](/sms-api/features/numbers) (product)
- [Number types](/docs/guides/numbers/number-types) (docs)

[Get an implementation brief](/learn/workspace?topic=phone-numbers)