Sign inGet Started

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);

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:

Contoh kode
{ "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 gif atau tombol copy_code ditolak di luar kategori marketing. Keduanya adalah komponen khusus marketing; mendeklarasikan salah satunya pada template utility akan gagal.
  • Jumlah parameter pada pengiriman components dengan template buatan sendiri tidak diperiksa sebelum dikenai biaya. Jika Anda mengirim jumlah parameter yang salah di components pada template buatan Anda, pesan diterima dan dikenai biaya, lalu ditolak oleh Meta. Pengiriman parameters yang 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. from harus berada di akun yang sama dengan template; jika tidak, pengiriman gagal 422 E15023 WhatsAppSenderWABAMismatch.

Langkah berikutnya