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:

WhatsApp Studio mengirim ke satu penerima dalam satu waktu. Dashboard tidak memiliki kampanye audiens WhatsApp atau fitur pengiriman siaran. Untuk mengirim template yang telah disetujui ke audiens yang telah memberikan persetujuan, ikuti panduan kampanye dan kirim satu permintaan API untuk setiap penerima dari aplikasi Anda.

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 linimasa: GET /v1/whatsapp/messages/{message_id}/events mengembalikan peristiwa pesan. Halaman Messages menampilkan linimasa yang sama. Lihat peristiwa 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 Metrics memiliki tab Outbound dan Inbound 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 Messages 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 peristiwa 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 supresi yang berlaku untuk satu akun bisnis, atau opt-out yang mencakup seluruh workspace. Dalam kedua kasus, Bird memblokir pengiriman berikutnya ke alamat tersebut. Lihat Opt-out dan kata kunci.

Langkah berikutnya

• Mengirim pesan WhatsApp: kirim pesan template atau pesan layanan melalui API
• Menghubungkan nomor Anda sendiri: siapkan nomor untuk mengirim dan menerima pesan dengan merek Anda
• Template: jelajahi template dan temukan variabel yang diperlukan untuk mengirimnya
• Menerima pesan WhatsApp: baca pesan masuk dan ambil media
• Webhook: berlangganan pesan masuk dan pembaruan pengiriman