Variabel Template WhatsApp: {{1}} vs Parameter Bernama

{
  "type": "BODY",
  "text": "Hi {{1}}! Your order {{2}} ships on {{3}}.",
  "example": { "body_text": [["Layla", "OM-4821", "12 November"]] }
}

{
  "type": "BODY",
  "text": "Hi {{first_name}}! Your order {{order_number}} ships on {{ship_date}}.",
  "example": {
    "body_text_named_params": [
      { "param_name": "first_name", "example": "Layla" },
      { "param_name": "order_number", "example": "OM-4821" },
      { "param_name": "ship_date", "example": "12 November" }
    ]
  }
}

Bagaimana cara mengirim parameter dalam panggilan API?

Anda mengirim nama template, bahasa, dan array components berisi nilainya. Berikut bentuk untuk template posisional:

{
  "messaging_product": "whatsapp",
  "to": "971500000000",
  "type": "template",
  "template": {
    "name": "order_shipped",
    "language": { "code": "en" },
    "components": [
      { "type": "body", "parameters": [
        { "type": "text", "text": "Layla" },
        { "type": "text", "text": "OM-4821" },
        { "type": "text", "text": "12 November" }
      ] }
    ]
  }
}

Untuk template bernama, setiap entri juga membawa parameter_name, yang harus cocok dengan placeholder:

{ "type": "text", "parameter_name": "order_number", "text": "OM-4821" }

Bagaimana parameter media pada header bekerja?

Header media tidak memiliki variabel teks. Saat pembuatan, header berisi handle aset contoh dari alur unggah Meta, dan contoh itu ditinjau bersama template. Saat pengiriman, Anda memberikan asetnya, misalnya gambar lewat ID media:

{ "type": "header", "parameters": [ { "type": "image", "image": { "id": "1558081531584829" } } ] }

ID di atas adalah contoh dari dokumentasi Meta, bukan aset sungguhan.

Bagaimana bentuknya lewat API OmniChannels.ai?

Endpoint sendbulk kami menerima template sebagai field form, sesuai dokumentasi WhatsApp API:

Contoh kasus: template pesanan dikirim

"Souq Rafiq" (fiktif), peritel di Uni Emirat Arab, ingin mengirim pembaruan pengiriman dengan gambar produk dan tombol pelacakan.

1. Tulis template agar tidak diawali maupun diakhiri variabel: "Hi {{1}}, your order {{2}} has shipped and should arrive on {{3}}. Tap the button to follow it."
2. Tambahkan header berupa gambar, footer berupa teks biasa, dan tombol URL https://shop.example/track/{{1}} dengan contoh seperti OM-4821.
3. Ajukan dengan contoh yang realistis untuk setiap variabel, lalu tunggu status persetujuan.
4. Kirim dengan tiga nilai isi pesan, akhiran pelacakan, dan, jika Anda menggantinya, gambar header.

curl -X POST https://api.broadnet.me/whatsapp/message/sendbulk \
  -H "Authorization: Bearer $BROADNET_TOKEN" \
  -F batchId=0 \
  -F campaignName=order-shipped \
  -F destinationNo=971500000000 \
  -F messageType=TEMPLATE \
  -F templateName=order_shipped \
  -F templateLanguage=en \
  -F bodyTemplateVariables=Layla \
  -F buttonsTemplateVariable=OM-4821

Cuplikan ini menunjukkan nama field untuk satu nilai. Untuk beberapa variabel isi pesan per penerima, gunakan unggahan personalisasi alih-alih mengulang perintah. Konfirmasikan encoding dengan tim kami untuk kampanye pertama Anda.

Bagaimana cara mempersonalisasi template dari CSV?

Gunakan satu baris per penerima dan satu kolom per variabel, lalu unggah dalam pengiriman personalisasi.

1. Taruh nomor penerima dalam format internasional di kolom pertama. Lihat format nomor telepon E.164.
2. Tambahkan satu kolom per variabel, dan konfirmasikan tata letak kolom dengan tim kami untuk kampanye pertama.
3. Bersihkan data lebih dulu: pangkas spasi, perbaiki kapitalisasi, pakai satu format tanggal, dan hapus nilai kosong, karena variabel kosong menghasilkan pesan rusak atau pengiriman gagal.
4. Pratinjau beberapa baris dan kirim ke nomor Anda sendiri lebih dulu.

Langkah pembersihan data dibahas di kirim SMS massal dari Excel atau CSV; langkah itu berlaku sama untuk WhatsApp.

Bagaimana memilih antara posisional dan bernama?

Putuskan berdasarkan berapa banyak orang yang akan menyentuh template dan berapa banyak variabelnya.

1. Satu atau dua variabel, satu pemilik: posisional cukup dan merupakan default.
2. Tiga variabel atau lebih, atau beberapa tim mengedit template: pakai bernama, agar setiap placeholder menjelaskan dirinya sendiri.
3. Teks yang sama dalam beberapa bahasa: pertahankan nama atau nomor yang sama di semua versi, agar satu rutinitas pengiriman dapat mengisi setiap bahasa.
4. Selalu catat kolom sumber mana yang mengisi variabel mana, agar perubahan template di kemudian hari tidak menggeser data.

Sebelum mengajukan, bacakan pesan jadi dengan nilai contohnya. Jika terdengar tidak wajar, peninjau dan pelanggan akan merasakan hal yang sama.

Apa kesalahan yang umum terjadi?

• Diawali atau diakhiri variabel, yang dicantumkan Meta sebagai alasan penolakan.
• Melewatkan nomor atau memakai nomor yang sama di luar urutan pada template posisional.
• Contoh placeholder seperti "test" yang tidak memberi tahu apa pun kepada peninjau.
• Karakter khusus seperti #, $, atau % di dalam variabel.
• Urutan salah saat pengiriman pada template posisional, yang menaruh data yang benar di tempat yang salah.
• parameter_name tidak cocok pada template bernama.
• Memakai variabel untuk menyembunyikan tujuan sebenarnya dari pesan. Template yang kategorinya tidak sesuai dengan isinya dapat ditolak atau dikategorikan ulang; lihat panduan kategori.
• Batasan: panduan ini melaporkan apa yang dinyatakan dokumentasi Meta saat penulisan. Keputusan peninjauan ada di tangan Meta dan aturan berubah, jadi periksa halaman yang ditautkan.

Bagaimana OmniChannels.ai membantu

BroadNet adalah Meta Business Solution Provider resmi. Di OmniChannels.ai Anda dapat membuat template WhatsApp dengan variabel, media, dan tombol, melihat pratinjaunya, dan memantau status persetujuan, lalu mengirimnya dengan nilai personalisasi lewat API atau dari unggahan Excel atau CSV dalam kampanye. Penyaringan duplikat dan laporan pengiriman sudah termasuk. Lihat halaman WhatsApp Business API dan platform kampanye.