Gupshup WhatsApp API HSM Message: Setup & Best Practice

HSM (template message) memungkinkan pengiriman business-initiated yang compliant lewat layer Gupshup.
Patuhi persyaratan Meta/WhatsApp: opt-in eksplisit, template disetujui, dan kategori pesan sesuai.
Setup meliputi onboarding Gupshup, submit template, webhook, dan integrasi CRM dengan pencatatan opt-in.
Desain template ringkas, lokal, dan gunakan idempotency + throttling untuk stabilitas pengiriman.

Quick definitions — komponen & relasi

Apa itu Gupshup sebagai BSP dan perannya

Gupshup adalah WhatsApp Business Solution Provider (BSP) yang menyediakan console, API gateway, dan workflow untuk onboarding nomor, manajemen template, pengiriman pesan, serta webhook — lihat dokumentasi resmi Gupshup dan halaman produk Gupshup. Untuk perbandingan layer BSP dan API, lihat ringkasan pihak ketiga seperti artikel perbandingan Gupshup/Twilio.

Apa itu HSM / template message — kapan pakai vs session messages

HSM (template message) adalah pesan pra-disetujui yang diperuntukkan untuk pengiriman business-initiated (notifications). Session messages adalah pesan dua arah dalam jendela 24 jam setelah user menghubungi bisnis. Detail aturan template ada pada dokumentasi WhatsApp tentang message templates.

Perbedaan: WhatsApp Business API vs layer Gupshup

WhatsApp Business API (Meta) menentukan kebijakan, template approval, dan error codes; Gupshup menyediakan antarmuka operasional untuk submit template, mengirim HSM, dan menerima webhook — baca lebih lanjut di docs Gupshup.

Kebijakan (Policy & Compliance)

Persyaratan Meta/WhatsApp untuk HSM

Template harus disubmit dan disetujui, penerima harus memberikan opt-in eksplisit, dan isi harus sesuai kategori yang diajukan — lihat WhatsApp Business Policy dan panduan message templates Meta. Untuk referensi opt-in dan implementasi, lihat juga panduan pihak ketiga seperti artikel opt-in.

Proses review dan aturan Gupshup

Gupshup menyediakan workflow submit template di console — pastikan header/body/footer dan placeholders sesuai panduan saat submit (lihat panduan templates Gupshup). Jika waktu approval tidak tercantum, anggap variabilitas waktu review mungkin berbeda antar kasus (tanpa sumber tepercaya).

Promosi (promo whatsapp) memerlukan opt-in yang jelas dan audit trail; jangan gunakan template transaksional untuk promosi. Rujuk kebijakan Meta untuk kategori pesan dan contoh pelanggaran (WhatsApp Business Policy).

Privasi & data (konteks Indonesia)

Simpan timestamp opt-in, sumber consent (form, click-to-chat, QR), dan berikan mekanisme opt-out. Jika menyebut regulasi lokal spesifik, lakukan verifikasi terpisah (jika belum ada referensi hukum, tandai “(tanpa sumber tepercaya)”).

Alasan umum HSM ditolak & cara menghindarinya

Penyebab tipikal: kategori salah, copy terlalu promosi, placeholder salah format, atau bahasa tidak konsisten. Solusi: satu template = satu tujuan, copy ringkas, dan cek format placeholder sebelum submit.

Setup: Panduan langkah‑per‑langkah

Prasyarat

Pastikan bisnis sudah melakukan business verification di Meta — lihat panduan business verification, nomor eligible, dan display name sesuai.

Onboarding dengan Gupshup

Buat akun, map nomor ke console, dan pastikan akses/credential tersedia di team dev/ops — panduan onboarding tersedia di docs Gupshup.

Membuat & submit HSM templates di console Gupshup

Isi header/body/footer, pilih language, dan gunakan placeholder terkontrol. Ikuti panduan submit template Gupshup di halaman templates.

Webhooks & callbacks + security

Konfigurasikan delivery/read callbacks dan incoming message webhook; verifikasi signature/token dan batasi akses endpoint — lihat webhook docs Gupshup.

Auth & API keys — best practice

Simpan token di secrets manager, gunakan role-based access, dan rotasi kredensial secara berkala.

Sandbox/testing flow → produksi

Submit template → tes di staging dengan nomor internal → verifikasi webhook & opt-in records → roll out ke produksi.

Integrasi CRM / marketing stack

Simpan mapping wajib: phone, opt-in timestamp, opt-in source, template_id, campaign_id. Pastikan trigger campaign hanya ketika opt-in tercatat. Referensi integrasi CRM dan workflow: panduan integrasi CRM.

Operational patterns & praktik terbaik

Desain template HSM

Ringkas, lokal, dan tempatkan aksi utama di kalimat pertama. Gunakan variabel untuk nama, tanggal, order ID, dan tombol jika relevan.

Throttling, retry, idempotency

Antisipasi rate limits dan implementasikan exponential backoff serta idempotency key untuk menghindari duplicate sends — lihat error codes Meta sebagai referensi perilaku pengiriman.

Opt‑in capture terbaik

Gunakan checkbox jelas di web, click-to-chat, QR code, atau lead ads dengan copy persetujuan — contoh teknik dan automasi: lead capture & automation. Simpan bukti untuk audit.

Use‑case implementasi — contoh operasional

Reminder automation (appointment/payment/delivery)

Flow singkat: lead → opt-in → schedule HSM → kirim → jika reply, masuk session flow. Contoh automasi dan sheet integration: automasi reminder.

Contoh template:
Body: Hi {{1}}, ini pengingat janji Anda pada {{2}} jam {{3}}. Reply YES untuk konfirmasi atau RESCHEDULE. (sertakan STOP untuk opt‑out)

Kirim hanya ke penerima dengan opt-in promo. Contoh safe copy:
Body: Hi {{1}}, terima kasih sudah mendaftar. Nikmati {{2}} untuk {{3}} minggu ini. Reply INFO atau STOP.

Lead capture whatsapp

Click-to-chat → welcome HSM → tindak lanjut sales. Contoh automasi lead: n8n + Meta Ads automation.

Contoh template:
Body: Terima kasih {{1}}. Kami menerima permintaan Anda tentang {{2}}. Balas 1 untuk Pricing, 2 untuk Demo.

Technical examples & snippets

Contoh API call minimal (Gupshup)

POST ke endpoint send seperti pada dokumentasi Gupshup: send-message docs.

{
  "channel":"whatsapp",
  "recipient":"62812xxxxxxx",
  "templateName":"appointment_reminder_v1",
  "language":"en",
  "variables":["Alya","22 May 202X","14:00"],
  "type":"template"
}

Pseudocode webhook handler

Tangani event delivery/read/incoming → update CRM status dan trigger session flow bila pengguna membalas.

Troubleshooting & common pitfalls (singkat)

Template ditolak: cek kategori, bahasa, placeholder. (Lihat Meta templates docs.)
Delivery gagal: nomor tidak terdaftar, user block, atau rate limit (error codes: Meta error codes).
Opt‑out: hapus segera dari list promo; simpan timestamp dan source.

Compliance checklist — quick actionable list

Business verified (Meta)
Nomor terdaftar & eligible
Template disetujui
Opt‑in tercatat + timestamp + source
Bahasa sesuai template approval
Opt‑out mechanism aktif
Webhook & monitoring aktif

Sample HSM templates (siap pakai)

Reminder (appointment): Hi {{1}}, janji Anda pada {{2}} jam {{3}}. Reply YES atau RESCHEDULE.
Promo (consent‑first): Hi {{1}}, dapatkan {{2}} untuk {{3}}. Reply INFO atau STOP.
Lead confirmation: Terima kasih {{1}}. Kami akan hubungi segera tentang {{2}}. Reply 1 Pricing / 2 Demo.

FAQ singkat

Q: Boleh kirim promo tanpa opt‑in?: A: Tidak; promo memerlukan opt‑in eksplisit sesuai kebijakan WhatsApp. Lihat WhatsApp Business Policy.
Q: Berapa lama approval template?: A: Waktu review bervariasi; cek status di console Gupshup (templates console) — jika tidak tercantum, anggap variabel (tanpa sumber tepercaya).
Q: Bisa pakai HSM untuk follow-up sales 1-on-1?: A: HSM ideal untuk notifikasi dan broadcast berizin; untuk percakapan 1-on-1 setelah user membalas, gunakan session messages dalam jendela 24 jam. Pastikan opt-in dan kategori pesan sesuai.
Q: Bagaimana sebaiknya menyimpan bukti opt-in?: A: Simpan timestamp, sumber consent (form, click-to-chat, QR, lead ad id), dan salinan snapshot consent. Integrasikan field ini ke CRM untuk audit trail.
Q: Apa konsekuensi jika melanggar kebijakan pesan?: A: Potensi rejection template, pembatasan pengiriman, atau suspension nomor/business oleh Meta; selesaikan isu lewat review dan perbaiki proses opt-in/komunikasi.

Appendix & Resources

Penutup & CTA

Butuh audit teknis atau setup HSM di Gupshup? Hubungi InReality Solutions untuk technical audit atau implementasi terkelola. Kami menggabungkan keahlian Agentic AI dan otomasi proses bisnis untuk integrasi CRM, orkestrasi campaign, dan monitoring end-to-end — membantu tim Anda mengurangi friction operasional dan menjaga kepatuhan. Demo / konsultasi: /layanan/otomasi-ai — studi kasus: /studi-kasus/messaging-whatsapp.

Ringkasan manfaat: Implementasi HSM yang tepat lewat Gupshup memberi jalur komunikasi yang compliant, dapat diskalakan, dan terukur untuk promo, reminder, dan lead capture — sambil menjaga pengalaman penerima dan audit readiness.

Gupshup Whatsapp API HSM Message: Kebijakan, Setup, dan Praktik Terbaik untuk Promo, Reminder, dan Lead Capture