Sign inGet started

Template utility WhatsApp

Template utility menindaklanjuti sesuatu yang sudah dilakukan penerima: pesanan, pembayaran, reservasi, atau proses masuk. Katalog Bird menyediakan delapan template, termasuk bird_signin_alert dan bird_delivery_update. Ambil kategori slug dari daftar template, bukan dari namanya: bird_signin_alert terlihat seperti template authentication padahal bukan, itu utility.

Sebelum Anda mengirim

Pilih template dari katalog terkelola atau buat sendiri di akun bisnis Anda yang terhubung.
Mengirim template katalog bawaan Bird tidak memerlukan verifikasi dari Anda, sama seperti authentication. Membuat template utility Anda sendiri juga tidak memerlukannya: tidak seperti authentication, persyaratan verifikasi bisnis Meta tidak pernah berlaku untuk utility, jadi Anda dapat membuat dan mengedit template utility di workspace yang belum diverifikasi. Lihat Verifikasi bisnis WhatsApp untuk mengetahui apa saja yang dibuka oleh verifikasi di tempat lain.
to dapat berupa nomor telepon E.164 atau ID pengguna cakupan bisnis. Template utility tidak membawa tombol OTP, jadi tidak memerlukan penerima khusus nomor telepon seperti authentication.
Setiap template utility katalog terkelola didaftarkan hanya dalam en, dengan on_missing_language: fail. Meminta bahasa yang tidak tersedia di katalog akan menggagalkan pengiriman, bukan beralih ke bahasa Inggris atau bahasa lain.

Mengirim template utility

POST /v1/whatsapp/messages dengan objek template yang menentukan slug katalog:
const msg = await bird.whatsapp.send({
  to: "+16505551234",
  template: {
    slug: "bird_order_confirmation",
    language: "en",
    components: [
      {
        type: "body",
        parameters: [
          { type: "text", name: "ref", text: "A1B2C3D4" },
          { type: "text", name: "amount", text: "USD 49.99" },
        ],
      },
    ],
  },
});
console.log(msg.id, msg.status);
Seperti template terkelola lainnya, jangan sertakan from: Bird memilih nomor pengirim berdasarkan kategori dan wilayah, dan mengisinya akan mengembalikan 422 E15018 WhatsAppSenderNotAllowed. Pembuatan dan pengiriman template utility sendiri mengikuti mekanisme yang sama dengan pengiriman template buatan sendiri lainnya; lihat Mengirim dengan template untuk kontrak umumnya.

Mengisi variabel

Parameter utility bersifat bernama, kebalikan dari kode posisional tunggal milik authentication. Setiap parameter membawa name, dan urutan parameter bernama di dalam array tidak memiliki arti. Kirim satu entri components untuk setiap blok yang benar-benar memiliki placeholder; body tanpa variabel tidak memerlukan entri components sama sekali.
Tombol URL adalah satu-satunya pengecualian: variabelnya selalu posisional {{1}}, dan pengiriman membawa nilai mentah, bukan alamat lengkap:
Contoh kode
{ "type": "button", "parameters": [{ "type": "text", "text": "A-4192" }] }
Untuk aturan bersama tentang komponen, sub_type, dan bagaimana components pengiriman disejajarkan dengan placeholder yang dideklarasikan template, lihat Mengirim dengan template dan Komponen dan parameter.

Biaya

Template utilitas yang tersampaikan ke penerima dalam jendela layanan pelanggan yang masih terbuka dapat memenuhi syarat tarif gratis Meta. Biaya pengiriman Bird dikenakan saat pemrosesan pesan, sebelum pesan diteruskan ke Meta. Callback pesan tersampaikan atau dibaca yang datang kemudian menentukan apakah biaya Meta berlaku. Periksa kedua komponen saat memperkirakan total biaya.
Lihat Biaya dan penagihan untuk kapan pengiriman dikenakan biaya, dan Harga WhatsApp untuk tarifnya.

Hal yang perlu diperhatikan

  • Meta dapat mengkategorikan ulang template utility menjadi marketing atas inisiatifnya sendiri, dan pesan tetap terkirim dengan harga baru yang lebih tinggi. Bisnis yang sudah pernah diperingatkan Meta karena kesalahan kategorisasi tidak mendapat pemberitahuan terlebih dahulu sejak April 2025; perubahan langsung berlaku. Jauhkan bahasa promosi, penawaran, atau upsell dari teks template utility Anda, karena itulah yang memicu perpindahan tersebut. Lihat Panduan template untuk mengetahui apa yang dianggap promosi.
  • Header gif atau tombol copy_code ditolak di luar marketing. Keduanya adalah komponen khusus marketing; mendeklarasikan salah satunya pada template utility akan gagal.
  • Pengiriman dengan template buatan sendiri tidak diperiksa jumlah parameternya sebelum dikenakan biaya. Kirim jumlah parameter yang salah pada template buatan Anda sendiri dan permintaan pengiriman diterima serta dikenakan biaya, lalu ditolak oleh Meta. Pengiriman katalog terkelola tidak memiliki celah ini.
  • Pengirim di WhatsApp Business Account yang salah ditolak sebelum biaya apa pun. from harus berada di akun yang sama dengan template; jika tidak, pengiriman gagal 422 E15023 WhatsAppSenderWABAMismatch.

Langkah selanjutnya