Operator bisa menawarkan nomor untuk dijual meskipun WhatsApp tidak akan menerimanya. Memeriksa kandidat sebelum memesan menghindari biaya untuk nomor yang tidak dapat Anda hubungkan melalui alur penyiapan yang dimaksud.
Bagaimana cara menjalankan precheck nomor Bird?
Gunakan bird whatsapp numbers precheck dengan nomor kandidat sebelum membelinya.
bird whatsapp numbers precheck +31612345678Masukkan nomor dalam format internasional dengan + di depan dan kode negara. Permintaan API membawanya dalam phone_number. Anda tidak perlu sudah memiliki nomor tersebut.
Endpoint-nya adalah POST /v1/whatsapp/numbers/precheck. Gunakan CLI yang sudah masuk atau grant MCP dengan whatsapp_management:write, sesuai ketentuan referensi perintah.
| Flag | Yang dapat Anda periksa |
|---|---|
--example | Body permintaan tanpa kredensial |
--dry-run | Permintaan yang sudah diresolvasi tanpa mengirimnya |
--response-schema | Field respons |
Klien MCP memanggil operasi yang sama melalui whatsapp_numbers_precheck.
Apa arti available dan unavailable?
available berarti pemeriksaan tidak menemukan hambatan untuk menghubungkan nomor pada saat itu. unavailable berarti WhatsApp menolaknya.
| Hasil | Tindakan untuk kandidat pembelian |
|---|---|
available | Lanjutkan pemeriksaan pembelian; hasilnya tidak mereservasi nomor |
unavailable | Lewati kandidat itu dan pilih nomor lain |
Nomor unavailable mungkin sudah terdaftar di WhatsApp atau merupakan nomor yang tidak dapat dilayani WhatsApp. Hasilnya tidak membedakan alasan-alasan tersebut, jadi jangan menyimpulkan salah satunya hanya dari hasil pemeriksaan.
Kegagalan permintaan berbeda dari hasil unavailable. Tangani error API yang dikembalikan sebelum menganggap kandidat tidak sesuai.
Apakah pemeriksaan ini mereservasi nomor?
Tidak. Pemeriksaan tidak menghubungkan nomor ke workspace Anda atau mereservasinya untuk pembelian. Orang lain dapat mengambil nomor available sebelum Anda memesannya.
Periksa kandidat yang ingin Anda beli, jangan memindai seluruh daftar.
Gunakan kembali Idempotency-Key saat mencoba lagi pemeriksaan yang sama. Selama jendela respons tiga jam Bird, kunci yang sama mengembalikan jawaban tersimpan alih-alih meminta WhatsApp lagi.
Header respons Idempotency-Replay mengidentifikasi replay tersebut. Setelah jendela respons berakhir, kunci yang sama dapat memicu pemeriksaan baru.
Di mana posisi pemeriksaan ini dalam proses pembelian nomor?
Periksa ketersediaan operator dan penerimaan WhatsApp sebelum menempatkan pesanan nomor.
- Cari dengan
bird numbers available list --country-code US. - Periksa ulang kandidat terpilih dengan
bird numbers available get. - Jalankan precheck WhatsApp pada kandidat tersebut.
- Pesan hanya setelah
available, menggunakanbird numbers orders create.
404 dari pemeriksaan ulang ketersediaan operator berarti Anda perlu kandidat lain. Selesaikan verifikasi organisasi yang diperlukan di dashboard sebelum memesan.
Pesanan pending tetap memerlukan operator untuk menyelesaikan provisioning. Tunggu hingga pesanan selesai sebelum mengandalkan nomor tersebut.
Bisakah saya memeriksa nomor yang sudah saya miliki?
Tidak. Precheck ditujukan untuk nomor yang ingin Anda beli dari Bird. Precheck tidak ditujukan untuk nomor yang sudah Anda miliki, juga tidak untuk nomor coexistence. Hubungkan nomor yang sudah Anda miliki melalui penyiapan nomor sendiri Bird.
Penyiapan tersebut tidak dapat menghubungkan nomor selama registrasi WhatsApp pribadinya masih aktif. Nomor di aplikasi WhatsApp Business terhubung melalui coexistence. Pastikan status nomor mencapai Connected sebelum menggunakannya sebagai pengirim bermerek Anda.
Pengirim yang dikelola Bird adalah opsi terpisah untuk template autentikasi dan utilitas terkelola. Pengirim ini tidak mengirim konten bebas Anda atau menerima balasan pelanggan ke workspace Anda.
Singkatnya
Periksa sebelum membeli.
Pencarian nomor tidak menjamin kompatibilitas WhatsApp. Jalankan precheck pada kandidat yang ingin Anda beli.
Tafsirkan unavailable tanpa mengarang alasan.
Nomor tersebut mungkin sudah terdaftar atau tidak didukung. Hasilnya tidak membedakan kedua kasus itu.
Jangan anggap jawaban sebagai reservasi.
Pemeriksaan tidak mereservasi atau menghubungkan nomor tersebut. Pesan nomor selagi jawabannya masih baru.
Gunakan kembali kunci coba lagi untuk pemeriksaan yang sama.
Replay idempotensi mengembalikan jawaban yang tersimpan. Jawaban itu mendeskripsikan pemeriksaan sebelumnya, bukan jaminan ketersediaan terbaru.