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; selidiki registrasinya jika Anda sudah memilikinya |
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 mengubah sesuatu?
Ya. Pemeriksaan mengirim kandidat ke WhatsApp. Meta dapat membuat entri sementara di bawah akun bisnis Bird.
Pemeriksaan tidak menghubungkan nomor ke workspace Anda atau mereservasinya untuk pembelian. Periksa hanya kandidat yang ingin Anda beli, karena memindai seluruh daftar dapat meninggalkan entri sementara untuk nomor yang tidak digunakan.
Gunakan kembali Idempotency-Key saat mengulang 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.
Bagaimana jika saya sudah memiliki nomor tersebut?
Gunakan hasilnya untuk menyelidiki kesiapan koneksi, bukan untuk membuat keputusan pembelian.
Penyiapan nomor sendiri Bird tidak dapat menghubungkan nomor selama registrasi aplikasi konsumer atau WhatsApp Business-nya masih aktif. Selesaikan registrasi tersebut dengan pemilik akun sebelum mencoba menghubungkan nomor.
Nomor yang lolos tetap harus menyelesaikan alur koneksi. Pastikan statusnya 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.
Perlakukan precheck sebagai operasi tulis.
Precheck mengirim nomor ke WhatsApp dan dapat membuat entri sementara. Precheck tidak mereservasi atau menghubungkan nomor tersebut.
Gunakan kembali kunci coba lagi untuk pemeriksaan yang sama.
Replay idempotensi mengembalikan jawaban yang tersimpan. Jawaban itu mendeskripsikan pemeriksaan sebelumnya, bukan jaminan ketersediaan terbaru.