kirem.coDokumentasi API
Dokumentasi/Templates/Manajemen Templat Pesan
Templates

Manajemen Templat Pesan

Ringkasan Teknis (TL;DR)

Membuat, menghapus, dan mengambil daftar templat pesan WhatsApp via API /v1/templates.

#templates#create#delete#list

Tentang Templat Pesan (Message Templates)

WhatsApp mewajibkan penggunaan Templat Pesan (Message Templates) yang telah disetujui oleh Meta jika bisnis ingin mengirimkan pesan di luar jendela interaksi 24 jam (pembicaraan yang diinisiasi oleh bisnis).

Halaman ini membahas konsep dasar templat pesan, kegunaan, komponen penyusun, serta tips & trik agar templat Anda cepat disetujui oleh Meta.


💡 Apa itu Templat Pesan?

Templat pesan adalah format pesan terstruktur yang telah didaftarkan dan disetujui terlebih dahulu oleh Meta. Format ini menggunakan variabel dinamis (seperti nama, nomor pesanan, atau nominal) untuk mengirimkan pesan yang dipersonalisasi ke banyak pelanggan sekaligus secara massal (broadcast).

Jika pelanggan tidak mengirim pesan ke nomor WhatsApp bisnis Anda dalam 24 jam terakhir, Anda hanya dapat mengirimkan pesan menggunakan templat. Di dalam jendela 24 jam tersebut (ketika pelanggan membalas pesan Anda), Anda bebas mengirimkan pesan jenis apa pun (Free-form Messages).


🚀 Mengapa Menggunakan Templat Pesan?

  1. Memulai Percakapan (Out-of-Session Messaging): Merupakan satu-satunya cara legal dan resmi untuk mengirimkan pesan pembuka kepada pelanggan.
  2. Keamanan & Kepatuhan: Menjamin pesan yang Anda kirimkan mematuhi Kebijakan Perdagangan dan Bisnis WhatsApp, sehingga meminimalisir risiko nomor diblokir (banned).
  3. Pesan Interaktif & Rich Media: Mendukung elemen dinamis seperti gambar, dokumen PDF, video, tombol sekali klik (Quick Reply), dan tautan khusus (Call to Action).
  4. Personalisasi Massal: Anda dapat menyisipkan variabel seperti {{1}} (Nama), {{2}} (Nomor Resi), dll., yang akan diganti secara otomatis sesuai dengan data pelanggan saat dikirimkan.

🏷️ Kategori Templat yang Didukung

Meta membagi templat ke dalam 3 kategori utama. Pemilihan kategori yang tepat sangat memengaruhi keberhasilan proses peninjauan (approval):

1. MARKETING (Pemasaran)

Kategori yang paling fleksibel untuk promosi, penawaran produk, informasi diskon, rekomendasi produk, undangan acara, atau pesan apa pun yang berisi ajakan untuk membeli/berinteraksi kembali.

  • Contoh: Promo cuci gudang, ucapan selamat hari raya dengan kode diskon, tindak lanjut keranjang belanja kosong.

2. UTILITY (Utilitas)

Pesan yang memicu tindakan spesifik atau konfirmasi transaksi yang sedang berlangsung. Pesan ini harus langsung berkaitan dengan transaksi aktif pengguna.

  • Contoh: Konfirmasi pembayaran, pengiriman resi pelacakan, pengingat janji temu, tagihan bulanan, atau pembaruan status akun.

3. AUTHENTICATION (Autentikasi)

Kategori khusus untuk memverifikasi identitas pengguna menggunakan kode sandi sekali pakai (OTP - One-Time Password). Kategori ini memiliki aturan keamanan yang sangat ketat dari Meta dan biasanya menyertakan tombol aksi cepat seperti salin kode (copy code) atau autofill sekali tap (one-tap autofill).


🧱 Struktur dan Komponen Templat

Templat pesan WhatsApp terdiri dari beberapa bagian utama:

+-------------------------------------------------------+
| HEADER (Opsional: Teks, Gambar, Video, Dokumen)       |
+-------------------------------------------------------+
| BODY (Wajib: Teks utama + Variabel {{1}}, {{2}})      |
+-------------------------------------------------------+
| FOOTER (Opsional: Teks disclaimer / Tombol Berhenti)  |
+-------------------------------------------------------+
| BUTTONS (Opsional: Quick Reply atau Call to Action)   |
+-------------------------------------------------------+
  • Header: Elemen visual pertama yang dilihat pelanggan. Bisa berupa teks tebal (bold), gambar promo (JPEG/PNG), dokumen transaksi (PDF), atau video pendek (MP4).
  • Body: Bagian inti pesan Anda. Maksimal berisi 1024 karakter dan mendukung format teks tebal (*teks*), miring (_teks_), coret (~teks~), dan monospace (`teks`). Anda wajib memberikan contoh (sample value) untuk setiap variabel {{x}} saat mengajukan templat.
  • Footer: Teks kecil abu-abu di bagian bawah pesan. Sangat direkomendasikan untuk menempatkan pesan penolakan / berhenti berlangganan (misal: "Kirim STOP untuk berhenti").
  • Buttons: Tombol interaktif untuk meningkatkan konversi:
    • Quick Reply: Tombol balasan cepat (maksimal 3 tombol) untuk interaksi langsung (misal: "Ya, saya tertarik", "Hubungi Agen").
    • Call to Action (CTA): Tombol yang mengarahkan pengguna ke tautan URL luar atau memicu panggilan telepon langsung ke nomor tertentu.

💡 Tips & Trik Agar Templat Cepat Disetujui Meta

Proses persetujuan (review) oleh AI Meta biasanya memakan waktu beberapa menit hingga maksimal 24 jam. Agar terhindar dari penolakan (rejection), ikuti praktik terbaik berikut:

  1. Gunakan Nama Templat yang Jelas & Konsisten

    • Nama hanya boleh berisi huruf kecil (lowercase), angka, dan garis bawah (underscore).
    • Benar: konfirmasi_pesanan_toko, promo_gajian_juni
    • Salah: Promo-Gajian-Juni, OTP!!, pesan1
  2. Sesuaikan Isi Pesan dengan Kategori

    • Jangan menyisipkan elemen promosi atau diskon dalam templat kategori UTILITY. Jika Meta mendeteksi kata-kata promosi di templat utilitas, templat tersebut akan langsung ditolak.
    • Jika ragu, selalu daftarkan templat sebagai MARKETING.
  3. Sediakan Contoh Variabel (Parameter Samples)

    • Kirem secara otomatis meminta sampel variabel saat pendaftaran. Contoh variabel membantu sistem review Meta memahami konteks pesan Anda.
    • Contoh: Jika body bertuliskan "Halo {{1}}, paket Anda dikirim hari ini", berikan sampel {{1}} = "Budi".
  4. Hindari Link Shortener yang Mencurigakan

    • Jangan gunakan penyingkat tautan umum seperti Bitly, TinyURL, atau Rebrandly. Meta sering menolak templat dengan link ini karena dianggap berisiko tinggi spam/phishing.
    • Gunakan domain bisnis asli Anda (misal: tokoanda.com/promo).
  5. Wajib Sediakan Opsi Berhenti Berlangganan (Opt-Out)

    • Sangat disarankan menyertakan opsi berhenti berlangganan pada pesan promosi (MARKETING), baik di footer ("Kirim STOP untuk berhenti") maupun sebagai tombol Quick Reply ("Berhenti Berlangganan"). Hal ini mengurangi peluang pelanggan menandai nomor Anda sebagai spam.
  6. Periksa Ejaan dan Tata Bahasa

    • Pastikan tidak ada kesalahan ketik (typo) yang mencolok atau tata bahasa yang sangat membingungkan. Meta dapat mendeteksi kesalahan bahasa ini secara otomatis.

🚥 Memahami Status Templat

Setelah Anda membuat templat melalui API Kirem, templat akan memiliki salah satu dari status berikut:

  • PENDING: Templat sedang ditinjau oleh Meta. Biasanya selesai dalam 1-10 menit.
  • APPROVED: Disetujui oleh Meta. Templat sudah siap digunakan untuk mengirimkan pesan ke pelanggan Anda.
  • REJECTED: Ditolak oleh Meta. Anda harus memeriksa pesan kesalahan, melakukan penyesuaian isi, dan mendaftarkannya kembali dengan nama baru atau mengajukan banding (appeal).
  • PAUSED: Dihentikan sementara oleh Meta karena tingkat keluhan/blokir pengguna sangat tinggi terhadap isi pesan tersebut. Kualitas templat turun ke level Low. Status ini biasanya pulih secara otomatis setelah jendela waktu tertentu jika kualitas nomor membaik.
  • DISABLED: Dinonaktifkan secara permanen karena kualitas yang terus memburuk setelah berulang kali masuk ke status PAUSED. Anda tidak dapat menggunakan templat ini lagi.

Butuh bantuan integrasi lanjutan?

Hubungi tim developer Kirem melalui tiket bantuan.

Buka Tiket Bantuan