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:
- Hubungkan WhatsApp Business Account dan nomor milik Anda sendiri. Lihat Pengaturan nomor telepon.
- Buat template pemasaran lalu ajukan untuk ditinjau. Lihat Panduan template untuk mengetahui template yang lolos.
- Kirim dari nomor yang berada di WhatsApp Business Account yang sama dengan template.
fromwajib ada pada pengiriman pemasaran, dan pengirim dari akun lain ditolak422E15023WhatsAppSenderWABAMismatchsebelum 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);msg = client.whatsapp.send(
to="+16505551234",
from_="+13125550101",
template="summer_sale",
language="en",
parameters={
"header_url": "https://cdn.example.com/banners/summer.png",
"first_name": "Pablo",
"code": "SUMMER25",
},
)
print(msg.id, msg.status)package main
import (
"context"
"fmt"
"log"
"os"
bird "github.com/messagebird/bird-sdk-go"
"github.com/messagebird/bird-sdk-go/option"
)
func main() {
client, err := bird.NewClient(option.WithAPIKey(os.Getenv("BIRD_API_KEY")))
if err != nil {
log.Fatal(err)
}
msg, err := client.Whatsapp.Send(context.Background(), bird.WhatsappSendParams{
To: "+16505551234",
From: "+13125550101",
Template: "summer_sale",
Language: "en",
Parameters: map[string]any{
"header_url": "https://cdn.example.com/banners/summer.png",
"first_name": "Pablo",
"code": "SUMMER25",
},
})
if err != nil {
log.Fatal(err)
}
fmt.Println(msg.Id, *msg.Status)
}$message = $bird->whatsapp->send(
to: '+16505551234',
from: '+13125550101',
template: 'summer_sale',
language: 'en',
parameters: [
'header_url' => 'https://cdn.example.com/banners/summer.png',
'first_name' => 'Pablo',
'code' => 'SUMMER25',
],
);
echo $message->getId(), ' ', $message->getStatus();bird whatsapp send \
--from +13125550101 \
--language en \
--parameters '{"code":"SUMMER25","first_name":"Pablo","header_url":"https://cdn.example.com/banners/summer.png"}' \
--template summer_sale \
--to +16505551234curl -X POST "https://us1.platform.bird.com/v1/whatsapp/messages" \
-H "Authorization: Bearer $BIRD_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"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"
}
}
}'- Variabel body diberi nama, sama seperti template utility, sehingga
first_namemenjadi 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, maupungif. Hilangkan kunci ini untuk mengirim contoh yang disetujui dalam template. Template yang diimpor dari Meta tidak memiliki contoh tersebut, sehingga memerlukanheader_url. Marketing adalah satu-satunya kategori yang menerima header GIF animasi. - Media dan akhiran url bernomor pada kartu carousel menggunakan kunci bernomor:
header_url_1danbutton_url_1untuk kartu pertama,header_url_2untuk 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 menggunakancomponents, dengan nilai padacards, 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.
131049adalah jeda pengiriman, bukan batas laju yang Anda konfigurasi, dan mencoba lagi justru memperburuknya. Meta melaporkan131049baik 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 sebagairate_limited.131050berarti 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.132015dan132016menandakan template dijeda, bukan masalah pada penerima.132015adalah jeda karena kualitas rendah.132016adalah 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.
fromharus berada di akun yang sama dengan template, jika tidak pengiriman gagal422E15023WhatsAppSenderWABAMismatch.
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
Sumber daya terkait
Lanjutkan dengan dokumentasi, panduan, dan contoh untuk topik ini.