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.
Stable1. 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.
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:

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
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/templatesuntuk 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
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
Langkah 3: Mengisi Atribut Dasar & Kategorisasi
- 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. - Kategori (Category): Tetapkan jenis pesan yang mewakili fungsi komunikasi (misalnya: Marketing, Utility, atau Authentication). Parameter ini krusial untuk struktur data
WhatsAppTemplatepada pangkalan data.
- Nama Template (Name): Tentukan julukan operasional unik, misal
- 4
Langkah 4: Merancang Konten Pesan (Header, Body, Footer)
- Header (Opsional): Ketikkan teks judul atau sapaan pendek yang akan muncul tercetak tebal di bagian teratas.
- 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 internalExtractVariablesakan mengekstrak setiap pola{{var}}menggunakan regular expression\{\{([a-zA-Z0-9_]+)\}\}dan memastikan tidak ada variabel duplikat yang tersimpan. - 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
Langkah 5: Publikasi dan Penyimpanan
Klik Simpan Template. Platform secara otonom menjalankan
strings.TrimSpaceuntuk membersihkan spasi berlebih pada kolomNamedanBody. Jika berhasil, daftar template akan diperbarui. Transaksi penyimpanan ini dijaga ketat di dalam fungsiWithTenantTxsehingga dijamin keamanannya agar tidak tertukar dengan tenant lain. - 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 (memanggilDELETE /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).
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:
- Ekstraksi Reguler Expression: Sewaktu metode
CreateTemplateatauUpdateTemplatedipanggil, mesin secara otomatis meluncurkanExtractVariables(body). Mesin membaca seluruh teks yang dipasok pengguna, mencari blok seperti{{nama}}, membuang penanda ganda, lalu menyimpannya sebagai larikvariablesdalam format JSON. - 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
bodytemplate. - 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.
7. Referensi Terkait
Persiapkan kanal resmi platform pesan dari rujukan fungsionalitas lain seputar interaksi konsumen.
