Template Pesan WhatsApp API: Istilah Kunci & Mekanisme Dijelaskan

Catatan Penting:

• 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 Template

Buka YCloud Console → WhatsApp Manager → Template → Template Baru

• The kategori memberi tahu WhatsApp apakah template tersebut termasuk Marketing, Utility, atau Authentication.
• The komponen mendefinisikan apa yang terkandung dalam template, seperti header, body, footer, tombol, variabel, atau media.

Anda dapat membuat hingga 100 template per WhatsApp Business Account 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 Spanyol

Nama template hanya dapat mencakup:

• Huruf kecil
• Karakter alfanumerik
• Garis bawah

• order_confirmation
• payment_reminder
• login_otp
• cart_recovery_offer

• Order Confirmation
• Payment-Reminder
• Login OTP!

Kategori

• Pemasaran
• Utilitas
• Autentikasi

• Pemasaran digunakan untuk promosi, penawaran, pembaruan produk, retargeting, dan keterlibatan kembali 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 singkat, biasanya digunakan untuk disclaimer atau konteks tambahan.
• Tombol — aksi yang dapat diklik seperti mengunjungi situs web, menelepon nomor, menyalin OTP, atau balasan cepat.

Bahasa

• en_US untuk Inggris
• hi untuk Hindi
• es untuk Spanyol
• pt_BR untuk 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 pengiriman nanti

Parameter Bernama

• Harus unik
• Gunakan huruf kecil dan garis bawah
• Dibungkus dalam 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 Parameter Posisional

Media

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

Tinjauan Template

Selama tinjauan, WhatsApp memeriksa hal-hal seperti:

• 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 Template

Nilai status template yang umum meliputi:

• Disetujui — template lolos peninjauan dan dapat digunakan.
• Tertunda — template masih dalam proses peninjauan.
• Ditolak — template tidak lolos peninjauan dan tidak dapat digunakan.
• Dijeda — template dihentikan sementara karena masalah kualitas.
• Dinonaktifkan — template 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.

Batas Template

• Batas pengiriman pesan — mengontrol berapa banyak pesan template yang dapat Anda kirim di luar jendela layanan pelanggan.
• Penyesuaian kecepatan 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 rendah.
• Pengarsipan template — mengarsipkan 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 Kedaluwarsa?

TTL dan Pembaruan Kategori

Rating Kualitas

Contoh Permintaan

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

Contoh Respons

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

Urutan Pengiriman Beberapa Pesan

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

• Alur OTP
• Proses 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 individu. Jika Anda mengedit komponen, seluruh set komponen akan diganti.
• Jika Anda menghapus template yang sudah 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
• OTPs
• Tindak lanjut dukungan
• Kampanye re-engagement

Bagaimana Mendapatkan YCloud?

Bagaimana Mendapatkan YCloud GRATIS?

Sebagai Penutup!