Lompat ke konten utama
StableTerakhir diperbarui: 9 Okt 2026, 09.28

Template Pesan WhatsApp

Template pesan WhatsApp merupakan fondasi untuk mengirim notifikasi inisiatif bisnis (business-initiated) via WhatsApp API Resmi. Melalui modul ini, Anda dapat merancang, menyimpan, dan mengelola daftar format pesan baku yang secara otomatis akan diinjeksi dengan variabel pesanan, nama pelanggan, hingga tagihan pembayaran sebelum diteruskan kepada pelanggan.

Stable

1. Ikhtisar & Nilai Bisnis

Pengelolaan template secara mandiri memastikan platform menyesuaikan ragam gaya bahasa bisnis tanpa batasan hardcode. Nilai inti fitur manajemen ini:

  • Pemformatan Konsisten: Setiap notifikasi otomatis seperti tagihan, konfirmasi pembayaran, hingga laporan harian selalu mempertahankan format baku yang bersih dan terstruktur.
  • Dukungan Variabel Dinamis: Pesan (body) template mampu menampung variabel penanda, memberikan impresi pesanan atau penagihan yang personal dan komprehensif.
  • Minimalisasi Duplikasi: Alih-alih merakit ulang kata per kata setiap mengirim notifikasi broadcast, admin hanya perlu memanggil ID template dan memberikan nilai isian dinamisnya.
  • Mencegah Eror Ketik (Typo): Kesalahan agen pelanggan atau admin saat menghubungi kembali konsumen tereduksi drastis ketika menggunakan pesan template yang telah divalidasi dan disimpan. Risiko seperti kesalahan nominal penagihan atau salah menyebut nama bisa dihindari.
Validasi Wajib Nama Template

Sistem perlindungan validasi di tingkat basis data akan secara ketat memblokir pembuatan dua buah template dengan nama identik (DUPLICATE_NAME). Aturan pendaftaran ketat ini mencegah insiden pengiriman laporan salah konteks akibat duplikasi. Selain itu, parameter persetujuan (approval) langsung di API Meta WhatsApp tidak dikelola pada basis data lokal platform, namun dikendalikan sepenuhnya melalui webhook eksternal.

2. Alur Visual & Antarmuka

Menu ini diakses untuk memusatkan segala jenis penyimpanan cetakan awal dari teks pesan WhatsApp, kampanye siaran (broadcast), dan notifikasi transaksional:

Tabel daftar template pesan siaran WhatsApp di dasbor DagangBot
Daftar template siaran WhatsApp terpusat dengan filter status pengiriman dan manajemen variabel pesan.

3. Panduan Langkah-demi-Langkah

Untuk menambahkan atau memutakhirkan format komunikasi WA Anda, ikuti langkah-langkah di bawah ini. Pembuatan template ini secara langsung akan diproses oleh antarmuka sistem WATemplateService dan disimpan ke pangkalan data tenant Anda.

  1. 1

    Langkah 1: Akses Menu Template WA

    Pilih Pengaturan Pesan > Template WhatsApp di panel admin platform. Di laman utama, sistem menembakkan panggilan ke GET /api/v1/wa/templates untuk menyusun daftar layout pesan yang telah Anda ciptakan. Data yang ditarik mencakup ID, nama template, kategori, serta daftar variabel dinamis yang pernah terekstrak otomatis.

  2. 2

    Langkah 2: Memulai Pembuatan (Create)

    Pilih tombol Buat Template Baru (+). Laman editor teks akan memuat formulir pembuatan yang mengirim parameter ke rute POST /api/v1/wa/templates.

  3. 3

    Langkah 3: Mengisi Atribut Dasar & Kategorisasi

    1. Nama Template (Name): Tentukan julukan operasional unik, misal invoice_pelanggan_baru. Penamaan ini tidak boleh mengandung spasi (disarankan menggunakan underscore) dan sistem akan memblokir nama ganda.
    2. Kategori (Category): Tetapkan jenis pesan yang mewakili fungsi komunikasi (misalnya: Marketing, Utility, atau Authentication). Parameter ini krusial untuk struktur data WhatsAppTemplate pada pangkalan data.
  4. 4
    1. Header (Opsional): Ketikkan teks judul atau sapaan pendek yang akan muncul tercetak tebal di bagian teratas.
    2. Isi Pesan (Body): Ketik konten teks pesan seutuhnya. Bagian ini wajib diisi. Untuk menyisipkan variabel dinamis, gunakan kurung kurawal ganda dengan karakter alfanumerik atau garis bawah (contoh: Halo {{nama_pelanggan}}, total tagihan Anda adalah {{total_harga}}). Fungsi internal ExtractVariables akan mengekstrak setiap pola {{var}} menggunakan regular expression \{\{([a-zA-Z0-9_]+)\}\} dan memastikan tidak ada variabel duplikat yang tersimpan.
    3. Footer (Opsional): Tambahkan teks catatan kaki berukuran kecil (seperti nama toko resmi, semboyan, atau sekadar penafian layanan) yang akan muncul secara statis di bawah tombol interaktif atau teks utama pesan.
  5. 5

    Langkah 5: Publikasi dan Penyimpanan

    Klik Simpan Template. Platform secara otonom menjalankan strings.TrimSpace untuk membersihkan spasi berlebih pada kolom Name dan Body. Jika berhasil, daftar template akan diperbarui. Transaksi penyimpanan ini dijaga ketat di dalam fungsi WithTenantTx sehingga dijamin keamanannya agar tidak tertukar dengan tenant lain.

  6. 6

    Langkah 6: Modifikasi Tersimpan (Update / Delete)

    Jika ada kesalahan kalimat, klik ikon edit pada baris data tabel (yang akan memanggil antarmuka PUT /api/v1/wa/templates/{id}) untuk memperbarui isi pesan maupun penyesuaian penempatan variabel secara langsung. Perubahan ini akan segera aktif pada peluncuran pesan berikutnya tanpa butuh waktu jeda sinkronisasi. Anda juga bisa mengklik ikon tempat sampah (memanggil DELETE /api/v1/wa/templates/{id}) untuk memusnahkan konfigurasi kerangka template lama yang tak lagi relevan secara permanen demi menjaga kerapian daftar pustaka tenant Anda.

4. Parameter & Spesifikasi Teknis

Atribut permohonan modifikasi tabel di tingkat REST API mewajibkan parameter minimum untuk menekan kecacatan pesan (blank message).

Kolom Input (Payload) Tipe Spesifikasi & Validasi Logika
name String (Wajib) Identifier unik di ranah tenant Anda. Terdapat penolakan ErrTemplateNameDuplicate otomatis yang memunculkan respons HTTP 409 Conflict bila duplikat ditemukan. Sistem juga melakukan trim space otomatis.
category String (Wajib) Mengelompokkan jenis pesan. Penting untuk pemilahan internal bot, tersimpan di kolom category tabel whatsapp_templates.
header String (Opsional) Teks utama tambahan di atas body. Disimpan dalam kolom basis data dengan proteksi parameter COALESCE(header, '').
body String (Wajib) Muatan teks utama. Sistem menolak nilai kosong atau sekadar spasi, merespons HTTP 400 Bad Request VALIDATION_ERROR (berdasarkan ralat ErrInvalidTemplateBody).
footer String (Opsional) Teks pelengkap di bawah tubuh utama pesan.
id String Target identitas template untuk modifikasi atau penghapusan URL dinamis (/{id}). Wajib valid dan menjadi milik merchant_id yang aktif.

Alur Ekstraksi Variabel & Rendering (Internal Backend)

Untuk memastikan template berfungsi dengan variabel pelanggan yang sesungguhnya tanpa perlu pengetikan manual berulang, sistem mengandalkan dua siklus internal utama:

  1. Ekstraksi Reguler Expression: Sewaktu metode CreateTemplate atau UpdateTemplate dipanggil, mesin secara otomatis meluncurkan ExtractVariables(body). Mesin membaca seluruh teks yang dipasok pengguna, mencari blok seperti {{nama}}, membuang penanda ganda, lalu menyimpannya sebagai larik variables dalam format JSON.
  2. Substitusi Pesan Final: Saat notifikasi siap dilontarkan oleh platform, sistem memanggil fungsi RenderTemplate(tmpl, vars). Teks body baku akan direkatkan (replace) satu per satu menyesuaikan pasangan kunci-nilai (contoh: mengganti {{nama}} dengan "Andi"), sebelum pesan secara final dikirim ke API WhatsApp eksternal.

Contoh Kasus (Use Case) Rendering Variabel

Sebagai contoh, Anda membuat template dengan nama konfirmasi_pesanan_2026, kategori Utility, dan dengan isi Body berikut:

"Halo {{nama_pelanggan}}, pesanan Anda dengan nomor {{nomor_invoice}} sejumlah {{total_tagihan}} telah kami terima dan akan segera diproses. Terima kasih telah berbelanja di toko kami."

Ketika sistem WATemplateService mengolah penyimpanan, fungsi ekstraksi akan mencatat larik ["nama_pelanggan", "nomor_invoice", "total_tagihan"]. Saat chatbot atau modul lain (seperti Broadcast atau Sales Closing) memicu pengiriman, mereka hanya perlu mengirimkan payload pasangan nilai (misalnya {"nama_pelanggan": "Budi", "nomor_invoice": "INV-100", "total_tagihan": "Rp500.000"}). Fungsi RenderTemplate akan memetakan nilai-nilai ini tepat pada posisi kurung kurawal ganda sehingga notifikasi final yang diterima pelanggan di WhatsApp terbaca sangat personal dan akurat.

5. Relasi & Integrasi

Keberadaan template pesan ini menyuplai berbagai lini automasi bot yang digerakkan pada aplikasi.

  • Otomasi Sales Closing: Pengambilan alur keranjang belanja di WhatsApp ditutup manis lewat pengiriman nota (invoice) terpadu dari sistem template.
  • Broadcast WhatsApp: Alih-alih mengetik secara lepas, peluncuran masif promosi promosi produk ditarik mutlak dari parameter body template.
  • Pusat Notifikasi Tenant: Laporan notifikasi juga bisa mengadopsi model push update untuk pesan masuk kritis sebagai ganti pemakaian layanan notifikasi murni antarmuka.

6. Pemecahan Masalah (Troubleshooting)

Kegagalan penciptaan template WA sering terikat dengan kaidah unik tabel penyimpanan yang tak boleh bertubrukan.

Gejala Penyebab Utama (Root Cause) Solusi Pemulihan
HTTP 409 Conflict (DUPLICATE_NAME) "Template dengan nama tersebut sudah ada" Judul / Name dari draf pembuatan identik dengan entri lama, meski spasi berlebih sudah dihapus platform (trim space). Variasikan julukan di bidang Nama Template dengan prefiks edisi, misal nota_v2 atau promo_agustus_23.
HTTP 400 Bad Request (VALIDATION_ERROR) Kolom body atau name tak terisi atau sekadar berisi spasi ganda. Validasi API mencatat ralat ErrInvalidTemplateBody. Bersihkan bagian awal baris dan isi dengan teks sah. Sistem tidak menoleransi templat kosong tanpa body.
HTTP 404 Not Found "Template tidak ditemukan" saat mengedit ID Template pada struktur URL /{id} meleset, atau baris tersebut sudah dihapus oleh admin lain dari tenant Anda (ErrWATemplateNotFound). Segarkan muatan tabel (F5), pastikan entri data masih terpampang di daftar, lalu ulangi modifikasi dari data terbaru.
HTTP 401 Unauthorized "Missing tenant context" Sesi akses otorisasi tidak menyertakan konteks identitas merchant_id yang ditangkap middleware sistem. Log out lalu masuk kembali; token otorisasi atau identitas tenant Anda di platform telah usang.
Variabel Dinamis Tidak Berfungsi / Tak Terganti Anda menggunakan format penulisan variabel dengan spasi di dalam kurung kurawal, misalnya {{ nama pelanggan }}. Gunakan standar alfanumerik bersambung underscore tanpa spasi: {{nama_pelanggan}}. Mesin ExtractVariables hanya mengurai pola alfanumerik.

7. Referensi Terkait

Persiapkan kanal resmi platform pesan dari rujukan fungsionalitas lain seputar interaksi konsumen.

content/docs/features/wa-templates.mdx
Terakhir diperbarui: 9 Okt 2026, 09.28

Dokumentasi teknis DagangBot