Template utilitas WhatsApp
Template utilitas menindaklanjuti sesuatu yang sudah dilakukan penerima: pesanan, pembayaran, pemesanan, atau proses masuk. Katalog Bird menyediakan delapan template utilitas, termasuk bird_signin_alert dan bird_delivery_update. Tentukan kategori sebuah slug dari daftar template, bukan dari namanya: bird_signin_alert terdengar seperti template autentikasi, padahal termasuk utilitas.
Sebelum Anda mengirim
Pilih template katalog terkelola atau buat template utilitas di akun bisnis Anda yang terhubung.
Mengirim template katalog yang disediakan Bird tidak memerlukan verifikasi dari Anda, sama seperti autentikasi. Membuat template utilitas sendiri juga tidak memerlukannya: berbeda dengan autentikasi, syarat verifikasi bisnis Meta tidak pernah berlaku untuk utilitas, sehingga Anda dapat membuat dan mengedit template utilitas di workspace yang belum diverifikasi. Lihat verifikasi bisnis WhatsApp untuk mengetahui apa yang dibuka oleh verifikasi di tempat lain.
to dapat berupa nomor telepon E.164 atau ID pengguna dengan cakupan bisnis. Template utilitas tidak memiliki tombol OTP, sehingga tidak memerlukan penerima berupa nomor telepon seperti yang diwajibkan autentikasi.
Setiap template utilitas katalog terkelola hanya terdaftar dalam en, dengan on_missing_language: fail. Jika Anda meminta bahasa yang tidak tersedia di katalog, pengiriman akan gagal, bukan beralih ke bahasa Inggris atau bahasa lain.
Mengirim template utilitas
POST /v1/whatsapp/messages dengan objek template yang menyebutkan slug katalog:
const msg = await bird.whatsapp.send({
to: "+16505551234",
template: {
slug: "bird_order_confirmation",
language: "en",
parameters: { ref: "A1B2C3D4", amount: "USD 49.99" },
},
});
console.log(msg.id, msg.status);msg = client.whatsapp.send(
to="+16505551234",
template="bird_order_confirmation",
language="en",
parameters={"ref": "A1B2C3D4", "amount": "USD 49.99"},
)
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",
Template: "bird_order_confirmation",
Language: "en",
Parameters: map[string]any{"ref": "A1B2C3D4", "amount": "USD 49.99"},
})
if err != nil {
log.Fatal(err)
}
fmt.Println(msg.Id, *msg.Status)
}$message = $bird->whatsapp->send(
to: '+16505551234',
template: 'bird_order_confirmation',
language: 'en',
parameters: ['ref' => 'A1B2C3D4', 'amount' => 'USD 49.99'],
);
echo $message->getId(), ' ', $message->getStatus();bird whatsapp send \
--language en \
--parameters '{"amount":"USD 49.99","ref":"A1B2C3D4"}' \
--template bird_order_confirmation \
--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",
"template": {
"slug": "bird_order_confirmation",
"language": "en",
"parameters": {
"ref": "A1B2C3D4",
"amount": "USD 49.99"
}
}
}'Seperti template terkelola lainnya, hilangkan from: Bird memilih nomor pengirim berdasarkan kategori dan wilayah, dan jika Anda mengisinya, hasilnya 422 E15018 WhatsAppSenderNotAllowed. Membuat lalu mengirim template utilitas Anda sendiri berjalan sama seperti pengiriman template buatan sendiri lainnya; lihat Mengirim dengan template untuk ketentuan umumnya.
Mengisi variabel
Variabel utility bersifat bernama, sehingga masing-masing menjadi kunci tersendiri di parameters, misalnya ref dan amount. Tombol URL dengan sufiks bernomor {{1}} justru memakai kunci button_url. Sufiks bernama memakai namanya sendiri. Pengiriman membawa nilai mentahnya, bukan alamat lengkap:
{ "parameters": { "ref": "A1B2C3D4", "button_url": "A-4192" } }Pengiriman components justru menyebutkan setiap parameter body, dan urutan parameter bernama di dalam array tidak memiliki arti. Untuk aturan umum tentang komponen, sub_type, dan cara components pada pengiriman dicocokkan dengan placeholder yang dideklarasikan template, lihat Mengirim dengan template dan Komponen dan parameter.
Biaya
Template utility yang dikirim di dalam jendela layanan pelanggan yang terbuka mendapatkan tarif gratis Meta hingga 30 September 2026; mulai 1 Oktober 2026, Meta mengenakan biaya untuknya seperti template utility lainnya (perubahan harga Oktober 2026). Biaya keluar Bird dikenakan saat pesan diproses, sebelum dikirimkan ke Meta. Callback delivered atau read yang datang kemudian menentukan apakah biaya Meta berlaku. Periksa kedua komponen biaya tersebut saat memperkirakan totalnya.
Lihat Biaya dan penagihan untuk mengetahui kapan pengiriman dikenai biaya, dan Harga WhatsApp untuk tarifnya.
Hal yang perlu diperhatikan
- Meta dapat mengubah kategori template utility menjadi marketing atas inisiatifnya sendiri, dan pesan tetap terkirim dengan harga baru yang lebih tinggi. Sejak April 2025, bisnis yang sudah pernah diperingatkan Meta karena salah kategori tidak mendapat pemberitahuan sebelumnya sama sekali; perubahan langsung berlaku. Jangan sertakan bahasa promosi, penawaran, atau upsell dalam teks template utility, karena hal itulah yang memicu perubahan kategori. Lihat Pedoman template untuk mengetahui apa yang dianggap promosi.
- Header
gifatau tombolcopy_codeditolak di luar kategori marketing. Keduanya adalah komponen khusus marketing; mendeklarasikan salah satunya pada template utility akan gagal. - Jumlah parameter pada pengiriman
componentsdengan template buatan sendiri tidak diperiksa sebelum dikenai biaya. Jika Anda mengirim jumlah parameter yang salah dicomponentspada template buatan Anda, pesan diterima dan dikenai biaya, lalu ditolak oleh Meta. Pengirimanparametersyang tidak menyertakan kunci wajib ditolak sebelum biaya apa pun dikenakan, dan pengiriman template katalog terkelola tidak memiliki celah ini. - Pengirim pada WhatsApp Business Account yang salah ditolak sebelum biaya apa pun dikenakan.
fromharus berada di akun yang sama dengan template; jika tidak, pengiriman gagal422E15023WhatsAppSenderWABAMismatch.
Langkah berikutnya
- Template WhatsApp: menelusuri katalog dan kontrak umum untuk pengiriman dengan template
- Template autentikasi: kode verifikasi sekali pakai dan syarat verifikasi untuk membuatnya
- Template pemasaran: pengiriman promosi dan akun yang Anda perlukan untuk membuatnya
Sumber daya terkait
Lanjutkan dengan dokumentasi, panduan, dan contoh untuk topik ini.