Lewati ke konten
NUSAWAP Docs

Webhook

Webhook mengirim POST berisi JSON ke URL Anda setiap kali ada event di akun WhatsApp: pesan masuk, status baca, panggilan, dan lainnya.

Mengatur webhook

Section titled “Mengatur webhook”

Webhook diatur per akun WhatsApp, jadi setiap nomor bisa mengirim ke URL yang berbeda.

  1. Buka Perangkat, pilih akun, lalu buka bagian Webhook.
  2. Isi URL tujuan (disarankan https://).
  3. Pilih event yang ingin diterima. Lihat Katalog event.
  4. Isi HMAC key agar setiap request bisa diverifikasi.
  5. Atur kebijakan retry, atau biarkan default: 5 percobaan, jeda 2 detik, exponential.

Satu akun boleh punya lebih dari satu webhook. Event dikirim ke setiap webhook yang berlangganan event tersebut.

Bentuk request

Section titled “Bentuk request”
POST /webhook/nusawap HTTP/1.1
Content-Type: application/json
X-Kirimwa-Event: message.inbound
X-Kirimwa-Attempt: 1
X-Kirimwa-Signature: sha256=5d1f0c…
{
  "event": "message.inbound",
  "at": "2026-10-05T03:44:02.511Z",
  "device": {
    "id": "<id akun>",
    "name": "CS Utama",
    "sessionId": "cs-utama"
  },
  "data": { "...": "isi sesuai event" }
}
Header Keterangan
X-Kirimwa-Event Nama event, sama dengan event di body.
X-Kirimwa-Attempt Percobaan ke berapa; 1 untuk pengiriman pertama.
X-Kirimwa-Signature sha256=<hex>; hanya ada jika HMAC key diisi.

Membalas webhook

Section titled “Membalas webhook”
  • Balas dengan status 2xx dalam 10 detik. Selain itu dianggap gagal dan akan di-retry.
  • Proses yang berat sebaiknya dikerjakan di antrean Anda sendiri. Balas 200 dulu, baru proses.
  • Event bisa datang lebih dari sekali (misalnya karena retry). Pakai data.id pesan untuk mencegah duplikasi.