Batas karakter template WhatsApp
Dokumentasi komponen template Meta menetapkan batas tegas untuk setiap bagian template. Pengajuan yang melebihi batas ini gagal di API sebelum dilihat reviewer manusia, jadi sebaiknya Anda mengeceknya saat menulis.
Karakter dihitung sesuai yang Anda lihat: satu emoji atau satu huruf Arab dihitung satu karakter. Baris baru juga dihitung, dan karakter pemformatan ala Markdown seperti tanda bintang pada *tebal* termasuk dalam hitungan.
Sumber: Meta, Template components, https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/components (diperiksa Oktober 2026).
- Nama template: maksimal 512 karakter, hanya huruf kecil, angka, dan garis bawah.
- Header teks: maksimal 60 karakter dan paling banyak 1 variabel. Header media bisa berupa gambar, video, atau dokumen; header lokasi hanya diizinkan untuk utilitas dan marketing.
- Body: maksimal 1.024 karakter, wajib diisi, dengan variabel sebanyak yang Anda perlukan.
- Footer: maksimal 60 karakter, tanpa variabel.
- Tombol: maksimal 10 secara total, termasuk paling banyak 10 balasan cepat, 2 tombol URL, 1 tombol nomor telepon, dan 1 tombol salin kode. Label tombol dibatasi 25 karakter, URL 2.000, nomor telepon 20, dan kode salin 20.
Aturan variabel yang menyebabkan penolakan
Sebagian besar template ditolak karena placeholder-nya, bukan karena kata-katanya. Panduan review template Meta mencantumkan masalah variabel yang ditolak: parameter yang tidak berurutan, mengandung karakter khusus seperti #, $, atau %, kurung kurawal yang tidak sepasang, atau berada di awal maupun akhir pesan ("dangling parameters").
Meta juga menolak template dengan terlalu banyak variabel dibandingkan panjangnya. Meta tidak menerbitkan rasio pastinya, jadi tool ini memberi peringatan bila ada kurang dari tiga kata tetap per variabel. Reviewer juga sering menolak dua variabel yang berdampingan, seperti {{1}} {{2}}; gabungkan menjadi satu atau sisipkan kata di antaranya.
Setiap variabel memerlukan contoh nilai yang realistis saat pengajuan. Reviewer membaca contoh tersebut untuk memahami isi pesan sebenarnya, jadi "test" atau "xxx" mengundang penolakan.
Sumber: Meta, Template review, https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-review.
Template ditolak? Pahami alasan dari Meta
Buka tab "Ditolak? Tempel alasan dari Meta", lalu tempel alasan dari WhatsApp Manager, Business Support Home, email penolakan, atau webhook message_template_status_update. Tool ini mengenali kode alasan Meta, seperti INVALID_FORMAT, INCORRECT_CATEGORY, TAG_CONTENT_MISMATCH, PROMOTIONAL, SCAM, dan ABUSIVE_CONTENT, serta redaksi penyebab umum di panduan review template Meta, lalu menampilkan kemungkinan penyebab dan cara memperbaikinya.
Template yang ditolak dapat diedit dan diajukan ulang, atau Anda dapat mengajukan banding di WhatsApp Manager setelah menambahkan contoh nilai; Meta menyatakan banding diputuskan dalam 24 jam. Alasan NONE berarti template dijeda (paused), bukan ditolak.
Utilitas vs marketing vs autentikasi
Kategori menentukan persetujuan sekaligus harga. Template utilitas (utility) menindaklanjuti sesuatu yang dilakukan atau diminta pelanggan, seperti pesanan, reservasi, perubahan akun, atau notifikasi, dan harus bersifat non-promosi. Template autentikasi membawa kode sekali pakai dan menggunakan redaksi tetap dari Meta. Selain itu, termasuk pengingat keranjang, penawaran, dan ajakan kembali (re-engagement), masuk kategori marketing (pemasaran).
Pedoman kategorisasi Meta menyatakan bahwa template yang mencampur konten utilitas dan promosi dikategorikan sebagai marketing. Kode diskon, penawaran penjualan, upselling, pengingat keranjang, dan ajakan mengunduh aplikasi semuanya membuat template masuk ke marketing. Meta secara berkala memeriksa ulang template yang sudah disetujui dan memindahkan template utilitas yang tampak promosi ke kategori marketing, biasanya dengan pemberitahuan satu hari.
Pengecek ini memindai redaksi Anda dalam bahasa Inggris, Arab, Prancis, Spanyol, Jerman, dan Portugis untuk mencari istilah promosi, dan memberi peringatan sebelum Meta mengubah kategori template Anda. Hanya template autentikasi yang boleh mengirim kode sekali pakai, sehingga tool ini juga menandai redaksi OTP di kategori lain.
Sumber: Meta, Template categorization, https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-categorization.
Tombol: pengelompokan, URL dinamis, dan tampilan bagi pelanggan
Tombol balasan cepat dan tombol ajakan bertindak (call-to-action) harus dikelompokkan: semua balasan cepat sebelum tombol lain, atau semuanya sesudahnya. Balasan cepat yang terselip di antara dua tautan akan ditolak oleh API.
Tombol URL dapat membawa satu variabel, dan variabel itu harus berada di akhir URL, misalnya https://shop.example.com/orders/{{1}}. Lakukan percent-encoding pada nilai yang Anda kirim (spasi menjadi %20). Hindari pemendek tautan: pemendek menyembunyikan tujuan dan tampak seperti spam.
Jika template memiliki lebih dari tiga tombol, WhatsApp menampilkan dua dan menyembunyikan sisanya di balik "Lihat semua opsi" (See all options). Template dengan empat tombol atau lebih, atau balasan cepat yang dicampur dengan tombol lain, tidak dapat dilihat di klien desktop WhatsApp, jadi letakkan aksi terpenting di urutan pertama.
Dari pratinjau ke pengiriman skala besar
JSON yang diekspor mengikuti request body POST /<WABA_ID>/message_templates di WhatsApp Business Management API, termasuk contoh nilai. Untuk header media, unggah contoh dengan Resumable Upload API dan ganti handle placeholder.
Setelah disetujui, Anda mengirim template berdasarkan nama dan bahasa dengan nilai asli untuk setiap variabel. OmniChannels.ai mengelola template di berbagai WhatsApp Business Account, melacak status review dan kualitas, serta mengirim template yang disetujui melalui satu REST API, kampanye, atau kotak masuk bersama (shared inbox), dengan fallback SMS (kanal cadangan) saat WhatsApp tidak tersedia.
