Receiving messages

Get incoming WhatsApp messages delivered to your server.

Register a webhook URL in Settings → API & webhooks. Whenever a customer messages your WhatsApp number, we send a POST request to your URL with the payload below. Each request is signed with your whsec_ secret in the X-BigRadar-Signatureheader so you can verify it's genuinely from us.

Payload

POST → your webhook URL

{
  "id": "evt_...",
  "event": "message.received",
  "createdAt": "2026-06-25T10:00:00Z",
  "data": {
    "conversationId": "a1b2c3d4-...",
    "contact": { "phone": "919876543210", "name": "Mohit" },
    "message": {
      "type": "text",
      "text": "Hi there",
      "waMessageId": "wamid....",
      "timestamp": "1719312000"
    }
  }
}

Signature header

Headers

X-BigRadar-Signature: t=1719312000,v1=9f3a7c21e8b4...

Verify by computing HMAC_SHA256(secret, t.rawBody) and comparing it to the v1 value.