Sign inGet Started

Template pemasaran WhatsApp

Template pemasaran memuat konten promosi, seperti penawaran, pengumuman produk, atau kupon. Sebelum mengirim, siapkan konten yang sudah disetujui, izin dari penerima, serta cara yang jelas untuk menangani balasan dan permintaan berhenti berlangganan.

WhatsApp Studio mengirim ke satu penerima dalam satu waktu. Broadcast mengirim template pemasaran ke seluruh audiens dari dashboard. Lihat WhatsApp Studio dan kampanye pemasaran untuk merencanakan kampanye.

Sebelum mengirim

Katalog terkelola Bird sama sekali tidak menyediakan template pemasaran, sehingga pengiriman pemasaran selalu menggunakan template yang dibuat oleh workspace Anda, di WhatsApp Business Account milik Anda sendiri:

  1. Hubungkan WhatsApp Business Account dan nomor milik Anda sendiri. Lihat Pengaturan nomor telepon.
  2. Buat template pemasaran lalu ajukan untuk ditinjau. Lihat Panduan template untuk mengetahui template yang lolos.
  3. Kirim dari nomor yang berada di WhatsApp Business Account yang sama dengan template. from wajib ada pada pengiriman pemasaran, dan pengirim dari akun lain ditolak 422 E15023 WhatsAppSenderWABAMismatch sebelum ada biaya yang ditagih.

Mengirim template pemasaran

POST /v1/whatsapp/messages dengan from yang sudah diatur dan objek template yang menyebutkan slug milik Anda sendiri:

const msg = await bird.whatsapp.send({
  to: "+16505551234",
  from: "+13125550101",
  template: {
    slug: "summer_sale",
    language: "en",
    parameters: {
      header_url: "https://cdn.example.com/banners/summer.png",
      first_name: "Pablo",
      code: "SUMMER25",
    },
  },
});
console.log(msg.id, msg.status);
  • Variabel body diberi nama, sama seperti template utility, sehingga first_name menjadi kuncinya sendiri.
  • Kode tombol kupon dimasukkan ke code, seperti contoh di atas. Tidak ada kunci kupon terpisah.
  • Header media menggunakan header_url, baik berupa gambar, video, maupun gif. Hilangkan kunci ini untuk mengirim contoh yang disetujui dalam template. Template yang diimpor dari Meta tidak memiliki contoh tersebut, sehingga memerlukan header_url. Marketing adalah satu-satunya kategori yang menerima header GIF animasi.
  • Media dan akhiran url bernomor pada kartu carousel menggunakan kunci bernomor: header_url_1 dan button_url_1 untuk kartu pertama, header_url_2 untuk kartu kedua, dan seterusnya. Beri nama variabel di dalam kartu. Nama yang dipakai di dua kartu adalah satu kunci, sehingga kedua kartu mendapat nilai yang sama. Carousel yang setiap kartunya memberi nomor pada {{1}} hanya menggunakan components, dengan nilai pada cards, dan pengiriman tersebut harus menyertakan jumlah kartu yang persis sama dengan saat template disetujui.

Bird secara otomatis merutekan setiap pengiriman marketing ke Marketing Messages API milik Meta; Anda tidak perlu mendaftar dan tidak ada pengaturan per pengiriman. Status onboarding akun bisnis pada API tersebut menentukan optimasi dari Meta, bukan pengiriman itu sendiri. Pengecualiannya adalah header gif dan template harga maksimum, yang memerlukan akun yang sudah onboarding. Lihat Template marketing untuk status akun, hal yang dibuka oleh onboarding, dan negara tempat marketing dibatasi.

Opt-out

Saat Bird menerima peristiwa penghentian pesan marketing yang valid dari Meta, sistem mencatat preferensi penerima untuk akun bisnis tersebut. Preferensi ini terpisah dari supresi untuk semua pesan. Periksa kedua catatan sebelum mengirim. Kegagalan pengiriman bisa tiba sebelum peristiwa preferensi yang terkait. Dalam kasus itu, hormati pilihan penerima dan selidiki riwayat tersebut, jangan coba lagi. Lihat Preferensi untuk cara mencatat dan membaca catatan ini.

Biaya

Gunakan tarif marketing yang dipublikasikan untuk tujuan dan mata uang, atau tetapkan harga maksimum agar biaya pengiriman Meta yang bervariasi tidak melebihi batas Anda. Bird mengenakan biaya keluarnya sebelum pengajuan; hasil terkirim atau dibaca yang dapat ditagih bisa menambahkan biaya Meta. Lihat Biaya dan penagihan dan Harga WhatsApp.

Hal yang perlu diperhatikan

  • Kategori dari Meta menentukan harga. Meta dapat mengklasifikasikan ulang konten promosi sebagai marketing setelah disetujui. Periksa kategori terkini setiap bahasa sebelum mengirim; pengiriman dengan harga maksimum mewajibkan kategori marketing. Lihat proses peninjauan kategori Meta jika Anda tidak setuju dengan klasifikasinya.
  • 131049 adalah jeda pengiriman, bukan batas laju yang Anda konfigurasi, dan mencoba lagi justru memperburuknya. Meta melaporkan 131049 baik untuk jeda menyeluruh di AS maupun untuk batas marketing per pengguna, dan panduan Meta sendiri adalah menunggu sekitar satu hari sebelum mengirim ulang. Mengirim ulang lebih cepat dapat membuat akun tidak tersedia bagi penerima tersebut lebih lama dan menurunkan tingkat pengiriman Anda. Bird melaporkan kegagalan ini sebagai rate_limited.
  • 131050 berarti penerima telah menonaktifkan "Offers and announcements", dan pesan ini tidak boleh dicoba lagi. Meta menerima pengiriman tersebut, lalu menolak menyampaikannya. Tanggapan yang benar adalah melalui jalur preferensi pesan, bukan pengiriman ulang: supresi penerima itu sendiri, atau tunggu hingga penerima mengaktifkan kembali pengiriman. Bird mengetahui hal itu melalui mekanisme preferensi yang sama dengan yang melaporkan penghentian tersebut. Lihat Preferences.
  • 132015 dan 132016 menandakan template dijeda, bukan masalah pada penerima. 132015 adalah jeda karena kualitas rendah. 132016 adalah penonaktifan permanen setelah jeda berulang, dan satu-satunya solusinya adalah template baru dengan konten berbeda. Periksa status bahasa itu sendiri, bukan status template, karena bahasa yang dijeda langsung berhenti mengirim.
  • Pengirim pada WhatsApp Business Account yang salah ditolak sebelum ada biaya apa pun. from harus berada di akun yang sama dengan template, jika tidak pengiriman gagal 422 E15023 WhatsAppSenderWABAMismatch.

Langkah berikutnya

  • Template WhatsApp: menjelajahi katalog dan kontrak bersama untuk mengirim berdasarkan template
  • Template pemasaran: Marketing Messages API, status onboarding, dan negara tempat pemasaran dibatasi
  • Preferensi: mencatat dan membaca pernyataan penerima
  • Template utilitas: pembaruan pesanan, pengingat janji temu, dan pemberitahuan akun