Aturan template WhatsApp: arti setiap pemeriksaan dan cara memperbaikinya
Setiap pemeriksaan yang dijalankan OmniBrand pada template WhatsApp sebelum dilihat Meta, berdasarkan kodenya (VAR_EDGE, BUTTON_GROUPING, EDIT_LIMIT...): artinya, mengapa Meta mempedulikannya, dan cara memperbaikinya.
Sebelum template WhatsApp dikirim ke Meta untuk ditinjau, OmniBrand memeriksanya berdasarkan aturan yang dipublikasikan Meta. Pemeriksaan yang sama berjalan di browser Anda saat Anda menulis dan sekali lagi di server kami saat Anda menekan Ajukan untuk ditinjau, sehingga template yang pasti ditolak Meta tidak pernah keluar dari OmniBrand. Setiap pemeriksaan memiliki kode; halaman ini menjelaskan semuanya.
Cara membaca pemeriksaan
- Wajib diperbaiki: Meta akan menolak template. Di pembuat template, Ajukan untuk ditinjau tetap nonaktif sampai masalahnya diperbaiki; panel Pemeriksaan mencantumkannya di bawah Wajib diperbaiki, dengan tombol Perbaiki jika OmniBrand dapat memperbaikinya untuk Anda. Jika server masih menemukan masalah saat Anda mengajukan, pembuat template menampilkan "Meta akan menolak template ini, sehingga tidak ada yang dikirim. Perbaiki hal-hal berikut dan coba lagi:".
- Kemungkinan ditolak: alasan umum penolakan atau perubahan kategori. Anda tetap dapat mengajukan.
- Tips: hanya saran.
- Pemeriksaan yang ditandai *panduan OmniBrand* adalah patokan kami sendiri jika Meta tidak mempublikasikan angka; pemeriksaan ini tidak pernah berstatus Wajib diperbaiki.
- Siapa yang dapat mengajukan: anggota dengan tugas Kelola template WhatsApp (secara default Owner, Admin, dan Editor; lihat Peran dan tugas).
Jika Meta sendiri menolak
Jika Meta tetap menolak, pembuat template menampilkan "Meta menolak template:" dengan kata-kata Meta sendiri dan, jika Meta mengirim nomor kesalahan yang kami kenali, aturan yang sesuai di bawah ini: 2388299 adalah VAR_EDGE, 2388293 adalah VAR_DENSITY, 2388019 adalah TEMPLATE_QUOTA, 2388039 adalah EDIT_WHILE_PENDING, 2388040 adalah BODY_MAX, 2388047 adalah HEADER_NO_MARKDOWN, 2388072 adalah VAR_SYNTAX, 2388073 adalah FOOTER_NO_VARS dan 2388024 adalah NAME_TAKEN_LANG. Tidak ada yang berubah di Meta: template baru tetap berada di pembuat template sebagai Draf (perbaiki teksnya dan tekan Ajukan untuk ditinjau lagi), dan template yang sudah diajukan mempertahankan statusnya (perbaiki dan tekan Simpan perubahan lagi).
NAME_FORMAT (wajib diperbaiki)
Nama hanya boleh menggunakan huruf kecil bahasa Inggris, angka, dan garis bawah, maksimal 512 karakter, mis. eid_offer_2026. Ganti spasi dengan garis bawah dan huruf kapital dengan huruf kecil.
NAME_TAKEN_LANG (wajib diperbaiki)
WhatsApp Business Account ini sudah memiliki template dengan nama ini dalam bahasa ini. Pilih nama lain, atau tambahkan bahasa berbeda ke template yang sudah ada.
NAME_RECENTLY_DELETED (kemungkinan ditolak)
Template dengan nama ini dihapus kurang dari 30 hari yang lalu. Meta memblokir nama template disetujui yang telah dihapus selama 30 hari, jadi pilih nama baru atau tunggu.
LANGUAGE_CODE (wajib diperbaiki)
Kode bahasa bukan kode yang diterima WhatsApp. Gunakan kode Meta: en, en_US, en_GB, ar, ar_EG, ar_AE, dan seterusnya. Bahasa Portugis harus pt_BR atau pt_PT.
LANGUAGE_SCRIPT_MISMATCH (kemungkinan ditolak, panduan OmniBrand)
Teks tidak tampak seperti bahasa yang dipilih: template bahasa Arab yang teksnya sebagian besar bukan bahasa Arab, atau template bahasa Inggris yang sebagian besar ditulis dalam bahasa Arab. Ubah bahasanya atau terjemahkan teksnya. Meta tidak pernah menerjemahkan; tulis setiap bahasa secara terpisah.
CATEGORY_ADVICE (kemungkinan ditolak, panduan OmniBrand)
Template Utilitas atau Autentikasi berisi kata-kata promosi (penawaran, diskon, obral, عرض، خصم...) atau tombol promosi. Meta menyetujui template seperti itu sebagai Pemasaran, yang dikenai harga pemasaran dan hanya boleh dikirim ke orang yang menyetujui pemasaran. Hapus promosinya atau pilih Pemasaran.
AUTH_SHAPE (wajib diperbaiki)
Template Autentikasi memiliki bentuk tetap yang ditentukan Meta: isi pesannya "{{1}} adalah kode verifikasi Anda.", ada satu tombol kata sandi sekali pakai (Salin kode, Isi otomatis sekali ketuk atau Tanpa ketukan), tanpa header, footer, media, tautan, atau emoji, dan masa berlaku kode 1 hingga 90 menit. Tombol sekali ketuk dan tanpa ketuk memerlukan nama paket dan hash tanda tangan aplikasi Android Anda. Tanpa ketuk juga mengharuskan Anda menerima ketentuan tanpa ketuk Meta (kotak centang di bawah Tombol di pembuat template).
BODY_REQUIRED (wajib diperbaiki)
Setiap template memerlukan teks isi pesan.
BODY_MAX (wajib diperbaiki)
Isi pesan lebih panjang dari yang diizinkan Meta: 1.024 karakter (600 untuk penawaran waktu terbatas). Persingkat.
HEADER_TEXT_REQUIRED (wajib diperbaiki)
Anda memilih header teks tetapi membiarkannya kosong. Ketik header, atau pilih tanpa header.
HEADER_TEXT_MAX (wajib diperbaiki)
Header teks maksimal 60 karakter.
HEADER_ONE_VAR (wajib diperbaiki)
Header teks hanya dapat memuat satu variabel.
HEADER_NO_MARKDOWN (wajib diperbaiki)
Header harus berupa teks biasa: tanpa karakter pemformatan (* _ ~ `), tanpa baris baru, dan tanpa emoji.
HEADER_MEDIA_SAMPLE (wajib diperbaiki)
Header gambar, video, atau dokumen memerlukan file contoh yang digunakan Meta untuk meninjau template. Yang diterima: gambar JPEG atau PNG hingga 5 MB, video MP4 hingga 16 MB, dokumen PDF hingga 100 MB. OmniBrand memeriksa file itu sendiri, bukan namanya. Template yang dibuat di WhatsApp Manager memerlukan contoh baru sebelum dapat diedit di sini.
HEADER_LOCATION_CATEGORY (wajib diperbaiki)
Header lokasi hanya diizinkan pada template Pemasaran dan Utilitas.
FOOTER_MAX (wajib diperbaiki)
Footer maksimal 60 karakter.
FOOTER_NO_VARS (wajib diperbaiki)
Footer tidak boleh berisi variabel.
VAR_SYNTAX (wajib diperbaiki)
Sebuah variabel ditulis dengan salah. Variabel bernomor ditulis {{1}}, {{2}}; variabel bernama {{first_name}} (huruf kecil, angka, dan garis bawah). Kurung kurawal harus berpasangan, dan satu template menggunakan nomor atau nama, tidak pernah keduanya.
VAR_SEQUENTIAL (wajib diperbaiki)
Variabel bernomor harus dimulai dari {{1}} dan berurutan 1, 2, 3 tanpa celah, sesuai urutan kemunculan pertamanya.
VAR_EDGE (wajib diperbaiki)
Teks diawali atau diakhiri dengan variabel (kesalahan Meta 2388299). Tambahkan kata sebelum variabel pertama dan setelah variabel terakhir, mis. "Halo {{1}}, pesanan Anda sudah siap." alih-alih "{{1}}, pesanan Anda sudah siap".
VAR_ADJACENT (wajib diperbaiki)
Dua variabel bersebelahan dengan hanya spasi atau tanda baca di antaranya. Sisipkan kata di antara keduanya.
VAR_DENSITY (kemungkinan ditolak, panduan OmniBrand)
Terlalu banyak variabel untuk panjang teks (kesalahan Meta 2388293). Meta tidak mempublikasikan rasio pastinya; kami memperingatkan jika teks tetap kurang dari 3 kata per variabel, atau jika variabel lebih dari 30% jumlah kata. Tambahkan teks atau kurangi variabel.
VAR_EXAMPLE (wajib diperbaiki)
Setiap variabel memerlukan nilai contoh yang realistis, yang dibaca oleh peninjau Meta. Contoh tidak boleh kosong, berisi baris baru, tab, atau 4 spasi berturut-turut, berupa variabel lain, atau berupa pengganti seperti "test", "x" atau "name". Gunakan nilai yang tampak nyata seperti "Sara" atau "A-1042".
BUTTON_COUNTS (wajib diperbaiki)
Terlalu banyak tombol: maksimal 10 secara total, 10 balasan cepat, 2 tombol situs web, 1 tombol telepon, 1 tombol salin kode (dan masing-masing satu tombol Flow, katalog, daftar produk, dan panggilan WhatsApp). Tombol kata sandi sekali pakai hanya untuk template autentikasi.
BUTTON_TEXT (wajib diperbaiki)
Setiap tombol memerlukan label 1 hingga 25 karakter, tanpa variabel, dan tidak boleh ada dua tombol dengan label yang sama.
BUTTON_GROUPING (wajib diperbaiki)
Tombol balasan cepat harus berkelompok, tidak diselingi tombol situs web atau telepon. Pindahkan agar saling bersebelahan.
URL_FORMAT (wajib diperbaiki)
Tombol situs web memerlukan tautan https:// lengkap dengan panjang maksimal 2.000 karakter. Tautan boleh diakhiri dengan satu variabel, ditulis {{1}}, misalnya https://example.com/order/{{1}}, dan variabel tersebut memerlukan contoh (seperti nomor pesanan) tanpa spasi. Enkode spasi dan karakter non-Inggris (%20).
URL_SHORTENER (kemungkinan ditolak, panduan OmniBrand)
Tautan menggunakan pemendek tautan (bit.ly, tinyurl, t.co...). Peninjau sering menolaknya; gunakan tautan di domain Anda sendiri.
PHONE_FORMAT (wajib diperbaiki)
Tombol telepon memerlukan nomor dalam format internasional dengan kode negaranya, mis. +966500000000, maksimal 20 karakter.
BUTTONS_DESKTOP (tips)
Jika ada lebih dari 3 tombol, WhatsApp menampilkan 2 dan menempatkan sisanya di bawah "Lihat semua opsi". Jika ada 4 tombol atau lebih, atau balasan cepat dicampur dengan tombol lain, WhatsApp desktop sama sekali tidak menampilkan template tersebut.
CAROUSEL_SHAPE (wajib diperbaiki)
Carousel hanya untuk Pemasaran dan memiliki 2 hingga 10 kartu. Setiap kartu memiliki gambar atau video (semuanya berjenis sama), maksimal 2 tombol dengan jenis dan urutan yang sama di setiap kartu, dan teks kartu maksimal 160 karakter (di semua kartu atau tidak sama sekali). Tidak ada header atau footer di atas kartu.
LTO_SHAPE (wajib diperbaiki)
Penawaran waktu terbatas hanya untuk Pemasaran: judul penawaran maksimal 16 karakter tanpa variabel, header gambar atau video, isi pesan maksimal 600 karakter, tanpa footer, tombol salin kode di urutan pertama (kode maksimal 15 karakter) dan maksimal satu tombol situs web setelahnya.
COUPON_SHAPE (wajib diperbaiki)
Template kupon memiliki tepat satu tombol salin kode dengan kode contoh 1 hingga 20 karakter tanpa spasi.
CATALOG_SHAPE (wajib diperbaiki)
Template katalog memiliki tepat satu tombol Lihat katalog, tanpa tombol lain dan tanpa header (WhatsApp menampilkan gambar produk).
MPM_SHAPE (wajib diperbaiki)
Template daftar produk memerlukan header teks dan tepat satu tombol Lihat item. Bagian-bagian yang Anda cantumkan di bawah Produk di pembuat template harus sesuai dengan yang dapat ditampilkan WhatsApp: maksimal 10 bagian dan 30 produk secara keseluruhan, setiap bagian dengan judul hingga 24 karakter dan setidaknya satu ID produk.
FLOW_SHAPE (wajib diperbaiki)
Template Flow memerlukan tepat satu tombol Flow yang menyebutkan satu Flow, serta layar yang dibukanya saat bernavigasi.
CONTENT_SENSITIVE_ID (kemungkinan ditolak, panduan OmniBrand)
Teks tampaknya meminta nomor kartu, rekening, IBAN, atau nomor identitas nasional secara lengkap. Meta menolak hal ini; meminta 4 digit terakhir diperbolehkan.
CONTENT_THREAT (kemungkinan ditolak, panduan OmniBrand)
Susunan kata dapat terbaca sebagai ancaman atau mempermalukan ("peringatan terakhir", "tindakan hukum"). Meta menolak template yang kasar atau mengancam. Ubah kalimatnya dengan sopan.
CONTENT_PROHIBITED (kemungkinan ditolak, panduan OmniBrand)
Teks menyebutkan sesuatu yang tidak diizinkan oleh Kebijakan Bisnis WhatsApp di pasar Teluk: alkohol, tembakau, perjudian, kencan, mata uang kripto, atau pinjaman. Hapus bagian tersebut.
DUPLICATE (kemungkinan ditolak)
Template lain di WhatsApp Business Account ini memiliki teks yang sama. Meta menolak duplikat; ubah susunan katanya atau gunakan template yang sudah ada.
EMOJI_DENSE (kemungkinan ditolak, panduan OmniBrand)
Lebih dari 10 emoji dalam pesan, atau 3 atau lebih dengan lebih dari satu emoji per 8 kata. Kurangi jumlahnya.
MARKETING_OPT_OUT (tips)
Template Pemasaran sebaiknya memberi orang cara untuk berhenti: tambahkan balasan cepat "Hentikan promosi" dan footer seperti "Balas STOP untuk berhenti berlangganan".
TEMPLATE_QUOTA (wajib diperbaiki)
WhatsApp Business Account telah mencapai batas template Meta: 250 template untuk bisnis yang belum diverifikasi, 6.000 untuk bisnis terverifikasi dengan nama tampilan yang disetujui (setiap bahasa dihitung). Hapus template yang tidak lagi Anda gunakan.
EDIT_LIMIT (wajib diperbaiki)
Hanya template yang disetujui, ditolak, atau dijeda yang dapat diedit. Template yang disetujui dapat diedit sekali dalam 24 jam dan maksimal 10 kali dalam 30 hari; template yang ditolak dan dijeda tidak memiliki batas. Pesan menyebutkan berapa jam yang tersisa. Mengubah hanya pengaturan OmniBrand sendiri (asal nilai variabel, nilai cadangannya) tidak dihitung sebagai pengeditan dan selalu diizinkan.
EDIT_CATEGORY_LOCKED (wajib diperbaiki)
Kategori template yang disetujui tidak dapat diubah. Buat template baru dalam kategori lain sebagai gantinya.
EDIT_WHILE_PENDING (wajib diperbaiki)
Template sedang ditinjau (PENDING atau IN_APPEAL) dan tidak dapat diedit sampai Meta memutuskan (kesalahan Meta 2388039).
MESSAGE_TTL (wajib diperbaiki)
Meta tidak menerima Masa berlaku pesan yang dipilih untuk kategori ini. Yang diizinkan: Autentikasi 30 detik hingga 15 menit, atau 30 hari; Utilitas 30 detik hingga 12 jam, atau 30 hari; Pemasaran 12 jam hingga 30 hari; selalu dalam detik bulat. Perbaiki mengembalikan kolom ke default Meta. Mengganti kategori ke kategori yang tidak menerima periode tersebut akan menghapusnya dengan sendirinya.
MESSAGE_TTL_ADVICE (kemungkinan ditolak)
Pesan autentikasi dapat tiba setelah kodenya kedaluwarsa: Masa berlaku pesan (atau default Meta 10 menit) lebih lama dari masa berlaku kode yang ditetapkan di bawah Sebutkan kapan kode kedaluwarsa (Menit). Meta menyarankan masa berlaku yang tidak lebih lama dari masa berlaku kode; Perbaiki menyamakan masa berlaku pesan dengan masa berlaku kode.
MESSAGE_TTL_ROUTE (tips)
Meta menerapkan masa berlaku template pemasaran pada pesan yang dikirim dengan Pengiriman yang dioptimalkan (Marketing Messages API). Pesan pemasaran yang dikirim melalui Cloud API biasa terus dicoba ulang hingga 30 hari.
Terkait
Referensi resmi
Diperiksa terhadap produk pada 24 Sep 2026