Receive messages with webhooks

Webhooks push events to your server in real time: inbound messages from customers, and status updates (sent, delivered, read) for messages you sent. You host an endpoint that accepts POST requests, and the platform calls it on each event.

Inbound message payload

When a customer messages you, your endpoint receives a JSON body with the sender and the message content.

{
  "object": "whatsapp_business_account",
  "entry": [{
    "changes": [{
      "value": {
        "messaging_product": "whatsapp",
        "messages": [{
          "from": "919867800451",
          "id": "wamid.HBgL...",
          "type": "text",
          "text": { "body": "Hi, is this available?" }
        }]
      }
    }]
  }]
}

Status update payload

For messages you sent, status events tell you when they were delivered or read, keyed by the message ID (WAMID) from the send response.

Prefer no code? The automation builder catches inbound events without you hosting anything. See the webhook trigger guide.