Sign inGet started

Template marketing WhatsApp

Template marketing membawa konten promosi, seperti penawaran, pengumuman produk, atau kupon. Siapkan konten yang sudah disetujui, izin penerima, dan cara yang jelas untuk menangani balasan dan opt-out sebelum mengirim.

Sebelum Anda mengirim

Katalog terkelola Bird tidak menyimpan template marketing sama sekali, jadi pengiriman marketing selalu menggunakan template yang dibuat workspace Anda, pada WhatsApp Business Account milik Anda sendiri:
  1. Hubungkan WhatsApp Business Account dan nomor milik Anda sendiri. Lihat Penyiapan nomor telepon.
  2. Buat template dengan kategori marketing dan ajukan untuk ditinjau. Lihat Panduan template untuk mengetahui apa yang lolos.
  3. Kirim dari nomor pada WhatsApp Business Account yang sama dengan template. from wajib pada pengiriman marketing, dan pengirim dari akun berbeda ditolak 422 E15023 WhatsAppSenderWABAMismatch sebelum ada biaya yang dikenakan.

Mengirim template marketing

POST /v1/whatsapp/messages dengan from disetel dan objek template yang menyebutkan slug Anda sendiri:
const msg = await bird.whatsapp.send({
  to: "+16505551234",
  from: "+13125550101",
  template: {
    slug: "summer_sale",
    language: "en",
    components: [
      {
        type: "header",
        parameters: [{ type: "image", url: "https://cdn.example.com/banners/summer.png" }],
      },
      { type: "body", parameters: [{ type: "text", name: "first_name", text: "Pablo" }] },
      { type: "button", parameters: [{ type: "text", text: "SUMMER25" }] },
    ],
  },
});
console.log(msg.id, msg.status);
  • Parameter body diberi nama, sama seperti utility. Setiap parameter membawa name, dan urutan dalam array tidak bermakna.
  • Kode tombol kupon adalah parameter text biasa, seperti parameter pada tombol di atas. Tidak ada tipe parameter kode kupon terpisah.
  • Header gif menggunakan parameter gif, bukan video atau image. Marketing adalah satu-satunya kategori yang menerima header GIF animasi.
  • Nilai carousel ditempatkan pada cards, bukan parameters, dan pengiriman harus menyertakan jumlah kartu yang persis sama dengan yang disetujui pada template.
Bird merutekan setiap pengiriman marketing ke Marketing Messages API Meta secara otomatis; Anda tidak perlu memilih ikut dan tidak ada pengaturan untuk memilihnya pada tiap pengiriman. Status onboarding akun bisnis dengan API tersebut menentukan optimisasi Meta, bukan pengiriman itu sendiri, dengan satu pengecualian: header gif memerlukan akun yang sudah di-onboard atau pengiriman gagal di WhatsApp. Lihat Template marketing untuk status akun, apa yang dibuka oleh onboarding, dan di mana marketing dibatasi berdasarkan negara.

Opt-out

Ketika Bird menerima event marketing-stop yang valid dari Meta, sistem mencatat preferensi penerima untuk akun bisnis tersebut. Preferensi ini terpisah dari pemblokiran pengiriman semua jenis pesan. Periksa kedua catatan sebelum mengirim. Kegagalan pengiriman dapat tiba sebelum event preferensi yang berkaitan; pertahankan pilihan penerima dan selidiki riwayat tersebut alih-alih mencoba lagi. Lihat Opt-out untuk mencatat dan membaca catatan ini.

Biaya

Gunakan tarif marketing yang dipublikasikan untuk tujuan dan mata uang yang berlaku. Bird mengenakan biaya keluar sebelum pesan diteruskan ke Meta; hasil pesan tersampaikan atau dibaca yang dapat ditagih dapat menambahkan biaya Meta. Lihat Biaya dan penagihan dan Harga WhatsApp.

Hal yang perlu diperhatikan

  • Meta mengkategorikan ulang ke marketing, tidak pernah keluar dari marketing, dan itu berarti perubahan harga. Template yang Meta anggap bersifat promosi menjadi marketing apa pun kategori yang Anda ajukan, dan kiriman tetap terkirim dengan harga baru yang lebih tinggi. Tidak ada opt-out dan tidak ada cara mengedit kembali kategorinya; solusinya adalah template baru.
  • 131049 adalah jeda pengiriman, bukan pembatasan laju permintaan yang Anda konfigurasi, dan mencoba lagi memperburuknya. Meta melaporkan 131049 baik untuk jeda menyeluruh di AS maupun untuk batas marketing per pengguna, dan panduan Meta sendiri adalah menunggu kurang lebih satu hari sebelum mengirim ulang. Mengirim ulang lebih cepat dapat membuat akun tidak tersedia bagi penerima tersebut lebih lama dan mengacaukan rasio pengiriman Anda. Bird melaporkan kegagalan ini sebagai rate_limited.
  • 131050 berarti penerima mematikan "Offers and announcements", dan tidak boleh dicoba lagi. Meta menerima kiriman lalu menolak mengirimkannya. Respons yang benar adalah jalur preferensi pesan, bukan kirim ulang: terapkan pemblokiran pengiriman ke penerima tersebut, atau tunggu mereka mengaktifkan kembali pengiriman, yang Bird ketahui melalui mekanisme preferensi yang sama yang melaporkan penghentian. Lihat Opt-out.
  • 132015 dan 132016 adalah penangguhan template, bukan masalah penerima. 132015 adalah penangguhan karena kualitas rendah; 132016 adalah penonaktifan permanen setelah penangguhan berulang, dan satu-satunya solusinya adalah template baru dengan konten berbeda. Periksa status bahasa itu sendiri, bukan status template, karena bahasa yang ditangguhkan langsung berhenti mengirim.
  • Pengirim pada WhatsApp Business Account yang salah ditolak sebelum ada biaya. from harus berada pada akun yang sama dengan template, atau pengiriman gagal 422 E15023 WhatsAppSenderWABAMismatch.

Langkah selanjutnya

  • Template WhatsApp: menelusuri katalog dan ketentuan umum pengiriman menggunakan template
  • Template marketing: Marketing Messages API, status onboarding, dan di mana marketing dibatasi
  • Opt-out: mencatat dan membaca supresi dan preferensi
  • Template utility: pembaruan pesanan, pengingat janji temu, dan pemberitahuan akun