Lewati ke konten utama
Kembali ke blog

Notifikasi WhatsApp Berbasis Event

Notifikasi WhatsApp berbasis event memisahkan status order, antrean, delivery log, retry, dan human handoff agar otomasi bisnis tetap akurat dan mudah diaudit.

3 menit baca
Notifikasi WhatsApp Berbasis Event

Notifikasi WhatsApp berbasis event mengirim pesan ketika perubahan bisnis benar-benar terjadi, seperti pembayaran diterima, pesanan diproses, atau paket diserahkan ke kurir. Pola ini lebih aman daripada mengirim pesan langsung dari halaman checkout karena status order, antrean pesan, dan status delivery dapat diaudit secara terpisah.

01

Jawaban singkat

Gunakan lima lapisan: sistem bisnis sebagai sumber status, event bus atau antrean sebagai penyangga, WhatsApp API sebagai kanal, delivery log untuk pelacakan, dan human handoff untuk kasus yang perlu keputusan staf. AI conversation flow boleh membantu klasifikasi pertanyaan dan mengambil data, tetapi tidak boleh menebak status order atau nomor resi.

Dokumentasi WhatsApp Business Platform menjelaskan pengiriman pesan dan penerimaan webhook sebagai bagian penting integrasi. Dokumentasi Twilio juga membedakan status pesan, seperti queued, sent, delivered, dan failed. Nama status bisa berbeda menurut provider, tetapi prinsip pemisahan tetap sama.

02

Mulai dari event yang stabil

Satu perubahan bisnis harus punya event ID yang stabil. Contoh: order-1842-payment-confirmed-v1. Worker memakai ID ini sebagai kunci idempotensi. Jika webhook diterima dua kali, worker memeriksa delivery log sebelum membuat pengiriman kedua.

Payload event cukup membawa data yang dibutuhkan. Gunakan order ID, jenis perubahan, waktu event, nomor pelanggan yang sudah dinormalisasi, dan versi template. Jangan menaruh token API, kredensial gateway, atau data pribadi berlebihan di payload log.

Pemisahan ini melengkapi webhook WhatsApp dengan idempotensi dan retry. Webhook mengakui event secepat mungkin, sedangkan pekerjaan berat berjalan di worker.

03

Pisahkan status order dan status pesan

Order dapat berstatus dikirim walau pesan WhatsApp masih berada di antrean. Sebaliknya, pesan dapat berstatus delivered ketika sistem bisnis belum memperbarui status order. Simpan kedua status pada tabel berbeda atau setidaknya pada kolom berbeda dengan relasi yang jelas.

Untuk order-status updates, ambil fakta dari sistem order setiap kali event dibuat. Jangan membiarkan model AI menyusun status dari percakapan lama. Jika nomor order tidak cocok, balas bahwa data belum ditemukan dan minta verifikasi, bukan membuat jawaban perkiraan.

Delivery log minimal mencatat event ID, provider message ID, waktu antre, waktu kirim, status terakhir, jumlah retry, dan error terklasifikasi. Log ini membantu tim menemukan apakah masalah berada di aplikasi, provider WhatsApp, nomor tujuan, atau template.

04

Retry perlu batas

Retry cocok untuk timeout, gangguan jaringan, dan error provider sementara. Retry tidak cocok untuk nomor tidak valid, template ditolak, kredensial salah, atau penerima yang memblokir kanal. Klasifikasikan error sebelum worker menjadwalkan percobaan berikutnya.

Pakai exponential backoff dan batas percobaan. Setelah batas tercapai, pindahkan event ke dead-letter queue. Operator dapat memeriksa kasus tersebut tanpa membuat loop pengiriman. Uji juga worker yang mati setelah provider menerima pesan tetapi sebelum aplikasi menyimpan respons. Idempotensi harus mencegah pengiriman ulang ketika event diproses kembali.

05

AI dan human handoff

AI WhatsApp cocok untuk pertanyaan status sederhana, klasifikasi intent, pengumpulan nomor order, dan ringkasan percakapan. AI harus berhenti ketika pelanggan meminta refund, mengubah alamat, melaporkan pembayaran tidak cocok, menyebut fraud, atau meminta staf.

Human handoff perlu membawa ringkasan intent, nomor order, data yang sudah diverifikasi, balasan terakhir, dan tindakan yang sudah dicoba. Pelanggan tidak boleh mengulang cerita dari awal. Mengukur WhatsApp automation dengan human handoff membahas metrik yang dapat dipakai untuk menilai respons, resolusi, dan kualitas eskalasi.

06

Managed atau open-source gateway

Managed WhatsApp gateway mengurangi beban provisioning, monitoring, pembaruan, dan pemulihan infrastruktur. Trade-off-nya berupa ketergantungan provider, batas konfigurasi, dan biaya berulang.

Gateway open source memberi kontrol deployment dan integrasi lebih besar. Tim harus mengurus uptime, keamanan credential, pembaruan library, antrean, rate limit, dan observability. Pilihan terbaik mengikuti kemampuan operasi, bukan tren teknologi.

Untuk bisnis yang ingin menghubungkan WhatsApp API, status order, dan notifikasi pengiriman, MauKirim dapat menjadi titik awal untuk memetakan alur komunikasi sebelum otomasi diperluas.

07

Checklist produksi

  • Buat event ID yang idempoten.
  • Pisahkan status order dari status delivery.
  • Simpan provider message ID dan error terklasifikasi.
  • Batasi retry dan gunakan dead-letter queue.
  • Uji webhook duplikat dan provider timeout.
  • Tetapkan pemicu human handoff.
  • Redaksi token dan data sensitif dari log.
08

Bacaan terkait

Mulai dari satu event berisiko rendah, misalnya pembayaran diterima atau paket dikirim. Ukur delivery, retry, dan handoff. Setelah data stabil, baru tambahkan AI conversation flow dan otomasi lain.

Bacaan terkait

Mulai dengan MauKirim

Chat masuk. Tim tinggal closing.

Buat akun untuk menyambungkan WhatsApp, Instagram, atau Facebook, lalu coba CRM dan API-nya.

Buat akun MauKirim