Ringkasan WhatsApp
Bird WhatsApp menggunakan platform dan kunci API yang sama dengan Bird Email dan Bird SMS. Kirim permintaan ke host regional untuk kunci API tersebut (https://us1.platform.bird.com atau https://eu1.platform.bird.com). Endpoint WhatsApp berada di /v1/whatsapp/….
Pengiriman yang dimulai oleh bisnis menggunakan template pesan yang telah disetujui. Kirim dari katalog terkelola Bird, yang tidak memerlukan nomor Anda sendiri dan mengirim dari pengirim yang dikelola Bird, atau hubungkan nomor Anda sendiri dan kirim template Anda sendiri dari nomor tersebut. Kontak dapat mengirim pesan ke nomor Anda sendiri, dan Bird mencatat pesan masuk tersebut bersama pesan keluar.
Cara pengiriman pesan bekerja
Kirim pesan WhatsApp menggunakan POST /v1/whatsapp/messages: satu penerima, satu template, serta tag dan metadata opsional. Kami memvalidasi permintaan dan mengembalikan 202 Accepted beserta ID pesan. Pembebanan biaya dan pengiriman berlangsung secara asinkron. API tidak memiliki endpoint batch, jadi kirim satu permintaan untuk setiap pesan.
Ada tiga hal yang mendasari API ini:
- Pengajuan pengiriman dan sampainya pesan merupakan tahap yang berbeda. Respons 202 berarti Bird telah menerima pesan untuk diproses. Perangkat penerima baru menerima pesan setelah pesan melewati WhatsApp hingga mencapai hasil akhir pengiriman. Konfirmasi bahwa pesan telah dibaca muncul sebagai waktu read_at dan peristiwa whatsapp.read; konfirmasi ini tidak mengubah status pesan.
- Setiap pesan yang dimulai oleh bisnis menggunakan template. Sertakan slug template, language jika diperlukan, dan nilai variabelnya. Pesan layanan berupa teks bebas atau media hanya dapat mencapai kontak dalam jendela 24 jam yang dibuka oleh pesan dari kontak tersebut, dan hanya jika dikirim dari nomor milik workspace Anda. Lihat Mengirim pesan WhatsApp.
- Kategori dan tujuan menentukan pengirim dan harga. Setiap template memiliki kategori authentication, utility, atau marketing. Template terkelola dikirim dari nomor Bird untuk kategorinya, sehingga tidak memiliki kolom from; pengiriman lainnya harus menyebutkan pengirimnya sendiri. Harga juga bergantung pada negara penerima. Biaya pesan dibebankan dalam dua tahap: biaya Bird saat Bird memproses pengiriman, dan bagian Meta saat pesan sampai ke penerima. Lihat Biaya dan penagihan.
Aplikasi WhatsApp di dashboard
Di dashboard, WhatsApp merupakan salah satu aplikasi kanal workspace. Halamannya meliputi:
| Halaman | Kegunaan |
|---|---|
| Pesan | Pesan masuk dan keluar, beserta konten, peristiwa, dan detail pengiriman setiap pesan |
| Metrik | Metrik pengiriman pesan keluar dan volume pesan masuk |
| Template | Template terkelola dan template Anda sendiri yang dapat dikirim: nama, bahasa, kategori, dan pratinjau hasil tampilannya |
| Nomor | Nomor pengirim yang dikelola Bird dan nomor Anda sendiri yang telah dihubungkan |
| Grup | Grup WhatsApp yang dikelola nomor bisnis Anda, beserta peserta dan tautan undangannya |
Pemantauan pesan
Bird mencatat linimasa untuk setiap pesan. Linimasa pesan keluar mencakup peristiwa penerimaan, pengiriman, pesan sampai, pesan dibaca, dan kegagalan. Linimasa pesan masuk mencatat kapan Bird menerima pesan.
- Membaca timeline: GET /v1/whatsapp/messages/{message_id}/events mengembalikan event pesan. Halaman Messages menampilkan timeline yang sama. Lihat event WhatsApp.
- Berlangganan peristiwa pengiriman pesan keluar: kirim peristiwa publik whatsapp.accepted, whatsapp.sent, whatsapp.delivered, whatsapp.read, whatsapp.failed, dan whatsapp.rejected ke endpoint webhook.
- Tinjau metrik agregat: halaman Metrik memiliki tab Keluar dan Masuk yang terpisah.
Penerimaan pesan
Bird menyimpan pesan masuk yang dikirim ke nomor milik workspace Anda dengan status received. Nomor yang dikelola Bird tidak menerima pesan untuk workspace Anda. Temukan pesan di halaman Pesan atau dengan GET /v1/whatsapp/messages?direction=inbound. Detail pesan menampilkan teks, media yang didukung, dokumen, lokasi, dan jenis konten yang tidak dapat ditampilkan oleh Bird. Media yang diterima tersedia selama 30 hari.
Tab Inbound di halaman Metrics menampilkan deret waktu Messages received dan rincian By phone number. Untuk menindaklanjuti setiap pesan masuk begitu tiba, gunakan event webhook whatsapp.received; lihat Webhook pesan masuk.
Sebagian penerima meminta Anda berhenti mengirim, dan balasan STOP adalah cara paling umum mereka melakukannya: Bird menyediakan daftar kata kunci bawaan, sehingga fitur ini langsung berfungsi pada nomor Anda tanpa pengaturan tambahan. Anda juga dapat mencatat penekanan yang dicakupkan ke satu akun bisnis, atau opt-out yang mencakup seluruh workspace. Bird memblokir pengiriman berikutnya ke alamat tersebut dalam kedua kasus. Lihat Opt-out dan kata kunci.
Langkah berikutnya
| Halaman | Pembahasan |
|---|---|
| Mengirim pesan WhatsApp | API pengiriman: penerima, template, komponen, tag, dan model asinkron |
| Pesan layanan | Sembilan jenis konten, jendela layanan, dan pengiriman media melalui URL |
| Penerimaan pesan | Pesan masuk, pengambilan media, dan webhook whatsapp.received |
| Template | Katalog template, kategori dan variabel, serta pengiriman berdasarkan slug |
| Log WhatsApp | Pesan masuk dan keluar, konten, status, dan linimasa peristiwa |
| Events | Timeline pesan dan riwayat reaksi melalui API |
| Webhooks | Webhook pengiriman, pesan masuk, reaksi, supresi, dan grup |
| Groups | Chat bersama dengan beberapa pelanggan, tautan undangan, dan batas grup |
| Mengirim ke grup | Mengalamatkan grup, persyaratannya, dan tanda terima per peserta |
| Menerima pesan grup | Peserta mana yang menulis pesan grup, dan cara membalasnya |
| Opt-out | Aturan kata kunci, preferensi penerima, dan daftar supresi |
| Metrik WhatsApp | Performa pengiriman keluar dan volume pesan masuk |
| Pembatasan laju permintaan | Kapasitas kebijakan organisasi, header respons, dan penanganan 429 |
Sumber daya terkait
Lanjutkan dengan dokumentasi, panduan, dan contoh untuk topik ini. Sumber daya tersedia dalam bahasa Inggris.
Tonton panduannyaConnecting WhatsApp to Bird: from buying a number to a live channelPahami konsepnyaWhat is the 24-hour customer service window on WhatsApp?Gunakan alatnyaWhatsApp message builderJelajahi kemampuannyaWhatsApp
Coba praktiknya dan dapatkan ringkasan implementasi