Nomor telepon WhatsApp
Pesan WhatsApp dikirim dari salah satu dari dua jenis nomor: nomor yang dioperasikan Bird atas nama Anda, atau nomor milik workspace Anda sendiri. Jenis yang Anda miliki menentukan apa yang bisa Anda kirim dan apakah pengiriman mencantumkan pengirimnya.
Halaman Numbers mencantumkan keduanya. Field from di respons pengiriman dan log pesan mengidentifikasi nomor yang digunakan oleh pesan tertentu.
Nomor yang dikelola Bird
Nomor milik Bird sendiri tidak perlu penyiapan, dan membawa template yang sudah disetujui dengan slug yang diawali bird_. Bird memilih nomor berdasarkan kategori template dan wilayah Anda: template authentication menggunakan nomor autentikasi khusus, template utility menggunakan nomor notifikasi. Pengiriman dengan template terkelola karena itu tidak memiliki field from, dan mengisinya akan ditolak.
Nomor-nomor ini menggunakan infrastruktur pengiriman yang dikelola Bird, sehingga pengirim yang dilihat penerima adalah milik Bird, bukan milik Anda, dan konten bebas tidak bisa dikirim melalui nomor tersebut. Nomor ini ditandai Bird-managed di kolom WABA.
Nomor milik Anda sendiri
Menghubungkan nomor milik Anda sendiri membuka kemampuan mengirim atas nama brand Anda: template Anda sendiri, dan konten bebas di dalam jendela layanan pelanggan yang terbuka. Setiap pengiriman dari nomor ini mencantumkan nomor tersebut di from.
Anda menghubungkannya dari halaman Numbers, di popup Embedded Signup Meta. Ada dua cara, dan perbedaannya terletak pada siapa yang membaca kode verifikasi yang dikirim Meta ke nomor tersebut:
- Saya punya nomor sendiri. Anda menerima kode Meta melalui SMS atau panggilan suara dan mengetikkannya sendiri ke jendela Embedded Signup. Pilih jalur migrasi yang didukung atau jalur koeksistensi Business app yang memenuhi syarat sebelum mengubah registrasi yang ada, dan atur Phone registration PIN hanya jika nomor tersebut sudah memilikinya di WhatsApp.
- Nomor yang dipegang workspace Anda di Bird. Pilih dari daftar Number. Bird menerima kode dan menyelesaikan verifikasi Meta untuk Anda, sehingga nomor tersebut tiba dalam status pre-verified dan Anda cukup memilihnya di jendela Embedded Signup.
Verifikasi pada nomor yang dipegang Bird
Memilih nomor yang dipegang memulai verifikasi sebelum popup Embedded Signup terbuka. Bird meminta Meta mengirim SMS ke nomor tersebut, lalu membaca kode atas nama Anda.
Proses ini biasanya memakan waktu kurang dari satu menit. Anda tidak perlu menunggu di dialog: Continue in background menutup dialog dan baris di halaman Numbers melacak progres yang sama.
Setelah kode terbaca, nomor terverifikasi di Meta dan menunggu Anda menyelesaikan proses di Embedded Signup. Finish setting up membuka popup Meta, tempat Anda memilih nomor dan akun bisnis yang akan dituju.
Arti status nomor
Sebuah nomor melewati beberapa status sebelum bisa mengirim, dan kolom Status menunjukkan status yang sedang berlaku:
| Status | Artinya |
|---|---|
| Preparing | Bird sedang menyelesaikan verifikasi Meta untuk nomor yang dipegang workspace Anda. |
| Pre-verified | Bird telah menyelesaikan verifikasi Meta. Selesaikan penyiapan nomor di Embedded Signup. |
| Pending | Embedded Signup selesai dan Bird sedang mendaftarkan nomor ke Meta. |
| Connected | Nomor siap mengirim. |
| Failed | Penyiapan berhenti. Baris tersebut mencantumkan alasannya. |
Kedua jalur bisa gagal di tengah proses, saat verifikasi Meta atau di popup. Cara pemulihannya bergantung pada alasan yang tercantum di baris tersebut.
Jika baris bertuliskan verification_code_not_received atau verification_rate_limited, buka nomor tersebut dan pilih Try again alih-alih memutuskannya. Mengapa pre-verifikasi gagal, dan kapan harus mencoba lagi menjelaskan kapan tombol tersebut tersedia dan apa yang harus dilakukan jika percobaan ulang juga gagal.
Untuk alasan lainnya, putuskan nomor tersebut dari aksi baris lalu hubungkan kembali: baris yang gagal tetap mengklaim nomor tersebut, sehingga percobaan kedua tanpa menghapusnya akan ditolak.
Bisakah saya mengirim WhatsApp tanpa membeli nomor telepon? membahas pilihan tersebut.
Apa yang ditampilkan nomor yang terhubung
Halaman nomor menampilkan apa yang WhatsApp izinkan untuk dilakukan nomor tersebut, ditambah bagian Activity yang mencakup riwayat pengirimannya.
Quality rating, Messaging limit, dan Send rate adalah angka dari WhatsApp, bukan dari Bird. Messaging limit adalah jumlah percakapan yang diinisiasi bisnis yang diizinkan WhatsApp dalam 24 jam, dan batas ini naik seiring nomor mengirim dengan baik. Quality rating bertuliskan Not rated sampai WhatsApp memiliki cukup riwayat pengiriman untuk menilainya.
Tab Business profile berisi informasi yang dilihat penerima tentang Anda di WhatsApp: nama tampilan, deskripsi, alamat, dan foto profil.
Akun bisnis di balik nomor
Setiap nomor yang terhubung dimiliki oleh WhatsApp Business Account, dan kolom WABA menautkannya. Lembar informasinya melaporkan tinjauan Meta atas bisnis itu sendiri, bukan atas nomornya.
Status-status ini menentukan apa yang bisa dilakukan akun. Business verification secara khusus menentukan template autentikasi: bisnis yang belum terverifikasi tidak bisa membuatnya. Marketing Messages API bertuliskan Onboarded setelah Meta menerima akun tersebut. Pengiriman marketing tidak menunggu status ini. Onboarding menentukan optimalisasi pengiriman Meta, dan header gif, yang gagal di WhatsApp pada akun yang belum di-onboard. Sebuah workspace bisa memiliki beberapa akun bisnis, masing-masing dengan beberapa nomor. Baca keputusan untuk akun yang memiliki pengirim yang dimaksud; akun yang terhubung memiliki workspace dan pemilik regional tertentu.
Bird membaca data ini dari Meta secara terjadwal, bukan terus-menerus, sehingga Last read from WhatsApp menunjukkan tanggal keputusan di atasnya.
Membaca nomor Anda dari API
Semua yang ditampilkan dashboard di atas dapat dibaca melalui API dan dari SDK. Pembacaan ini memerlukan kunci API dengan akses baca whatsapp_management.
GET /v1/whatsapp/numbers mengembalikan pengirim Anda sebagai halaman kursor. Masing-masing membawa status yang dilaporkan WhatsApp, sehingga ini adalah panggilan yang memberi tahu Anda nilai from apa saja yang bisa digunakan pengiriman.
GET /v1/whatsapp/numbers/{id} membaca satu nomor, dengan quality rating, messaging limit, dan level throughput yang sama seperti yang ditampilkan halaman detail. GET /v1/whatsapp/numbers/{id}/profile membaca profil bisnis di balik tab Business profile, termasuk description, address, dan websites.
GET /v1/whatsapp/numbers/{id}/events mengembalikan riwayat bagaimana nomor mencapai statusnya saat ini, terbaru lebih dulu: kapan ditambahkan, setiap perubahan status, dan setiap keputusan messaging-limit, quality-rating, serta display-name. Setiap event membawa type, summary, dan created_at. type adalah open enum, jadi perlakukan nilai yang tidak Anda kenali sebagai tipe event baru, bukan error.
GET /v1/whatsapp/business-accounts dan GET /v1/whatsapp/business-accounts/{id} membaca status akun yang dijelaskan halaman ini di atas: account_review_status, business_verification_status, dan marketing_messages_onboarding_status. Sebuah nomor melaporkan akunnya di field waba miliknya sendiri, yang berisi account ID Meta, bukan ID Bird.
Dua detail yang perlu diketahui sebelum Anda membuat integrasi yang menggunakan operasi pembacaan ini. meta_synced_at menunjukkan waktu pembacaan field yang dilaporkan WhatsApp, sesuai dengan Last read from WhatsApp di dashboard, dan tidak ada pada nomor yang dioperasikan Bird atas nama Anda. Nomor yang sedang dalam proses signup dapat dibaca: status melaporkan preparing dan awaiting_signup, next menunjukkan apa yang harus dilakukan terhadap status tersebut, dan finish_setup_url membawa tautan untuk menyelesaikannya, sehingga Anda bisa memantau penyiapan dan memberikan langkah terakhir kepada seseorang. Satu field yang tidak disertakan adalah meta_preverified_id, id milik WhatsApp sendiri untuk nomor yang sedang kami siapkan, yang tetap berada di dashboard.
Menghubungkan, mengganti nama, dan memutuskan nomor bukan bagian dari API publik atau SDK. Fitur-fitur ini tersedia di dashboard dan di CLI (bird whatsapp numbers create|update|delete dan bird whatsapp numbers profile update). Hanya satu langkah yang terikat browser: koneksi baru diselesaikan di layar persetujuan Meta sendiri, itulah mengapa create memberikan Anda finish_setup_url alih-alih menyelesaikannya sendiri.
Pesan masuk
Pesan masuk diterima workspace Anda hanya pada nomor milik Anda sendiri. Bird mencatatnya di log WhatsApp, dan tab Inbound di halaman Metrics melaporkan volume pesan diterima per nomor. Setiap pesan masuk juga membuka jendela 24 jam yang dibutuhkan konten bebas. Nomor yang dikelola Bird tidak menerima pesan untuk workspace Anda.
Langkah selanjutnya
- Mengirim pesan WhatsApp: permintaan API untuk mengirim pesan dari nomor-nomor ini, dan kapan from diperlukan
- Template WhatsApp: katalog terkelola dan template milik Anda sendiri
- Jendela layanan pelanggan WhatsApp: kapan konten bebas bisa dikirimkan
- Log WhatsApp: lihat nomor mana yang digunakan untuk mengirim pesan
- Menghubungkan WhatsApp ke Bird: dari membeli nomor hingga channel aktif: video yang memandu jalur yang sama di dashboard
for await (const number of bird.whatsapp.numbers.list({ limit: 25 })) {
console.log(number.id, number.phone_number, number.status);
}for number in client.whatsapp.numbers.list(limit=25):
print(number.id, number.phone_number, number.status)for number, err := range client.Whatsapp.Numbers.List(ctx, bird.WhatsappNumbersListParams{Limit: 25}) {
if err != nil {
log.Fatal(err)
}
fmt.Println(number.Id, number.PhoneNumber, number.Status)
}foreach ($bird->whatsapp->numbers->list() as $number) {
echo $number->getId(), ' ', $number->getPhoneNumber(), ' ', $number->getStatus(), PHP_EOL;
}curl -sS "https://us1.platform.bird.com/v1/whatsapp/numbers?limit=25" \
-H "Authorization: Bearer $BIRD_API_KEY"Sumber daya terkait
Lanjutkan dengan dokumentasi, panduan, dan contoh untuk topik ini. Sumber daya tersedia dalam bahasa Inggris.