Webhook WhatsApp: Terima Pesan Masuk Real-time ke Sistem

Mengirim pesan WhatsApp hanya setengah cerita. Untuk membangun otomasi nyata, sistem Anda harus tahu saat pelanggan membalas. Webhook mengirim setiap pesan masuk ke endpoint Anda secara real-time. Ini cara menyetelnya dengan andal dan aman.

Apa itu webhook dan kenapa penting

Webhook adalah URL di sisi Anda yang dipanggil platform setiap kali ada peristiwa, seperti pesan masuk. Alih-alih sistem Anda terus menerus bertanya apakah ada pesan baru, platform yang mengabari Anda begitu pesan tiba. Hasilnya real-time, hemat sumber daya, dan jadi fondasi otomasi seperti chatbot dan integrasi CRM.

Langkah 1: Daftarkan endpoint

Siapkan endpoint HTTPS publik yang menerima request POST, lalu daftarkan URL-nya di dashboard. Pastikan endpoint membalas cepat dengan status 200; proses pekerjaan berat secara asinkron agar platform tidak menganggap pengiriman gagal.

Langkah 2: Verifikasi payload

Karena endpoint Anda publik, siapa pun bisa mengiriminya data. Verifikasi setiap permintaan agar Anda hanya memproses peristiwa yang benar-benar berasal dari platform. Periksa tanda tangan atau token rahasia sebelum mempercayai isi payload.

{
  "event": "message.inbound",
  "from": "6281234567890",
  "type": "text",
  "text": "Apakah produk ini ready stock?",
  "timestamp": "2026-06-22T08:15:30Z",
  "messageId": "wamid.HBgM..."
}

Langkah 3: Tangani retry dengan idempoten

Jika endpoint Anda lambat atau sempat down, platform akan mencoba ulang pengiriman. Artinya peristiwa yang sama bisa datang lebih dari sekali. Gunakan messageId sebagai kunci idempoten agar pesan yang sama tidak diproses ganda.

Bangun penerima yang tahan banting

• Balas 200 secepatnya, proses berat di antrean belakang.
• Simpan messageId untuk menolak duplikat.
• Catat payload mentah untuk audit dan debugging.
• Pantau kegagalan; circuit breaker mencegah pengiriman membanjir saat endpoint down.

Hubungkan ke CRM atau aplikasi Anda

Setelah pesan masuk diverifikasi dan dideduplikasi, arahkan ke tujuan yang tepat: buat tiket di CRM, picu balasan chatbot, perbarui status pesanan, atau kirim notifikasi ke tim. Webhook adalah jembatan yang menyatukan WhatsApp dengan seluruh sistem Anda.