Template Pesan WhatsApp API: Istilah Kunci dan Mekanisme Dijelaskan

• Template adalah aset Akun WhatsApp Business API yang digunakan bisnis untuk mengirim pesan template terstruktur melalui WhatsApp API.
• Pesan template adalah satu-satunya jenis pesan yang dapat dikirim ke pengguna WhatsApp di luar jendela layanan pelanggan.
• Template umumnya digunakan untuk pesan massal, pesan kampanye, peringatan, pengingat, OTP, dan tindak lanjut ketika tidak ada jendela layanan pelanggan yang aktif.

Pembuatan

Buka YCloud Console → WhatsApp Manager → Template → Template Baru

• The kategori memberitahu WhatsApp apakah templat tersebut bersifat Pemasaran, Utilitas, atau Otentikasi.
• The komponen mendefinisikan apa yang terkandung dalam templat, seperti header, body, footer, tombol, variabel, atau media.

Anda dapat membuat hingga 100 templat per Akun WhatsApp Bisnis per jam.

Sintaks API Umum

curl 'https://graph.facebook.com/v23.0/<WHATSAPP_BUSINESS_ACCOUNT_ID>/message_templates' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Content-Type: application/json' \
-d '
{
  "name": "<NAME>",
  "category": "<CATEGORY>",
  "language": "<LANGUAGE>",
  "parameter_format": "<PARAMETER_FORMAT>",
  "components": [<COMPONENTS>]
}'

Nama

• order_update untuk Bahasa Inggris
• order_update untuk Hindi
• order_update untuk Bahasa Spanyol

• Huruf kecil
• Karakter Alfanumerik
• Garis bawah

• order_confirmation
• payment_reminder
• login_otp
• cart_recovery_offer

• Order Confirmation
• Payment-Reminder
• Login OTP!

Kategori

• Marketing
• Utilitas
• Autentikasi

• Pemasaran digunakan untuk promosi, penawaran, pembaruan produk, retargeting, dan keterlibatan ulang pelanggan.
• Utilitas digunakan untuk pembaruan non-promosi seperti konfirmasi pesanan, pengingat pembayaran, pemberitahuan pengiriman, pembaruan akun, dan tindak lanjut dukungan.
• Autentikasi digunakan untuk OTP, kode login, pemulihan akun, dan verifikasi identitas.

Read this One-Stop Guide to WhatsApp API Message Template Categories to know about WhatsApp API Message Template in detail.

• Persetujuan template
• Pembatasan pesan
• Harga
• Tinjauan kategori
• Kategorisasi ulang oleh WhatsApp di masa depan

Komponen

• Header — teks, gambar, video, dokumen, atau lokasi yang ditampilkan di bagian atas pesan.
• Body — teks pesan utama. Di sinilah sebagian besar variabel dan detail spesifik pelanggan digunakan.
• Footer — teks pendukung, biasanya digunakan untuk disclaimer atau konteks tambahan.
• Tombol — aksi yang dapat diklik seperti mengunjungi situs web, menelpon nomor, menyalin OTP, atau balasan cepat.

Bahasa

• en_US untuk bahasa Inggris
• hi untuk bahasa Hindi
• es untuk bahasa Spanyol
• pt_BR untuk bahasa Portugis Brasil

• order_update dalam bahasa Inggris
• order_update dalam bahasa Hindi
• order_update dalam bahasa Spanyol

Format Parameter

• Di sini, {{first_name}} dan {{order_number}} adalah parameter.

• Pilih format parameter: Bernama atau Posisional
• Tambahkan nilai contoh untuk setiap parameter
• Berikan nilai sebenarnya di payload pesan yang dikirim nanti

Parameter Bernama

• Harus unik
• Gunakan huruf kecil dan underscore
• Dibungkus dengan kurung kurawal ganda
• Nilai dapat dikirim dalam urutan apa pun karena setiap parameter memiliki nama

Thank you, {{first_name}}! Your order number is {{order_number}}.

[
  {
    "type": "text",
    "parameter_name": "first_name",
    "text": "Jessica"
  },
  {
    "type": "text",
    "parameter_name": "order_number",
    "text": "SKBUP2-4CPIG9"
  }
]

Parameter Posisional

• Harus dimulai dari {{1}}
• Harus mengikuti urutan yang sama dengan teks template
• Nilai harus dikirim dalam urutan yang sama

Hi {{1}}! Your order number is {{2}}. Thank you.

[
  {
    "type": "text",
    "text": "Jessica"
  },
  {
    "type": "text",
    "text": "SKBUP2-4CPIG9"
  }
]

Parameter Bernama vs Posisional

Media

• Gambar produk
• Banner penawaran
• Invoice PDF
• Dokumen tiket atau pemesanan
• Pratinjau video

Tinjauan Template

• Apakah kategori yang dipilih sudah benar
• Apakah pesan mengikuti panduan template
• Apakah variabel dan contohnya jelas
• Apakah konten sesuai dengan kasus penggunaan bisnis
• Apakah media, tombol, dan komponen valid

Know How WhatsApp Assigns a Category During Template Creation

Status Templat

• Disetujui — templat lolos peninjauan dan dapat digunakan.
• Tertunda — templat masih dalam proses peninjauan.
• Ditolak — templat tidak lolos peninjauan dan tidak dapat digunakan.
• Dijeda — templat dihentikan sementara karena masalah kualitas.
• Dinonaktifkan — templat tidak dapat digunakan lagi.

Contoh Permintaan

curl 'https://graph.facebook.com/<API_VERSION>/<TEMPLATE_ID>?fields=status' \
-H 'Authorization: Bearer <ACCESS_TOKEN>'

Contoh Respons

{
  "status": "APPROVED",
  "id": "1259544702043867"
}

WhatsApp Manager

Selanjutnya, mari kita lihat batasan template dan berapa banyak WhatsApp API Message Template yang dapat dibuat bisnis Anda.

Batasan Template

• Batasan pengiriman pesan — mengontrol berapa banyak pesan template yang dapat Anda kirim di luar jendela layanan pelanggan.
• Kecepatan pengiriman template — memperlambat pengiriman sehingga pengguna WhatsApp dapat memberikan umpan balik sebelum template diperluas lebih lanjut.
• Penjeda template — menghentikan sementara template yang menerima umpan balik buruk atau keterlibatan yang rendah.
• Penyimpanan template — menyimpan dan menghapus template yang tidak aktif selama 12 bulan atau lebih. Template yang diarsipkan akan dihapus setelah 28 hari kecuali dipulihkan.
• Batas template pemasaran per pengguna — membatasi berapa banyak pesan template pemasaran yang dapat diterima pengguna WhatsApp dari bisnis.

Time-to-Live

"message_send_ttl_seconds": 900

"message_send_ttl_seconds": -1

Apa yang Terjadi Saat TTL Berakhir?

TTL dan Pembaruan Kategori

Peringkat Kualitas

Contoh Permintaan

curl 'https://graph.facebook.com/v25.0/<TEMPLATE_ID>?fields=quality_score' \
-H 'Authorization: Bearer <ACCESS_TOKEN>'

Contoh Respon

{
  "quality_score": {
    "score": "GREEN",
    "date": 1758754645
  },
  "id": "1387372356726668"
}

Urutan Pengiriman Beberapa Pesan

1. Pesanan dikonfirmasi
2. Pembayaran diterima
3. Pengiriman dijadwalkan

• Alur OTP
• Perjalanan pembayaran
• Pembaruan pesanan
• Onboarding langkah demi langkah
• Kampanye multi-pesan
• Otomatisasi dukungan pelanggan

Manajemen Template

• Hanya Disetujui, Ditolak, atau Dijeda template yang dapat diedit.
• Template yang disetujui dapat diedit hingga 10 kali dalam 30 hari atau sekali dalam 24 jam.
• Anda tidak dapat mengedit komponen individual. Jika Anda mengedit komponen, seluruh set komponen akan diganti.
• Jika Anda menghapus template yang telah disetujui, Anda tidak dapat membuat template lain dengan nama yang sama selama 30 hari.
• Template yang tidak aktif selama 12 bulan atau lebih dapat diarsipkan dan dijadwalkan untuk dihapus setelah 28 hari.

Buat Template WhatsApp API Lebih Cepat dengan YCloud AI

• Promosi
• Pembaruan pesanan
• Pengingat pembayaran
• OTP
• Tindak lanjut dukungan
• Kampanye pengaktifan kembali

Bagaimana Mendapatkan YCloud?

Bagaimana Mendapatkan YCloud secara GRATIS?

Penutup!