How to Test WhatsApp Business Webhooks

WhatsApp Business Platform webhooks deliver inbound messages, message status updates, and account notifications via the Cloud API.

Looking for the broader picture? See the 7 best webhook testing tools (2026), or if you're already on Webhook.site, the 60-second migration to HookRay.

1. WhatsApp Business Webhook Events

WhatsApp Business can send the following webhook events to your endpoint:

2. Set Up a Test Endpoint with HookRay

Follow these steps to start receiving WhatsApp Business webhooks for testing:

1. Go to HookRay and click "Start Testing — Free" to get your unique webhook URL.
2. Copy the URL (e.g., https://h.hookray.com/abc123).
3. In your WhatsApp Business dashboard, navigate to the webhook settings and paste the HookRay URL as your endpoint.
4. Select the events you want to receive (see list above).
5. Trigger a test event — HookRay will show the incoming webhook in real-time.

3. Sample WhatsApp Business Webhook Payload

Here's an example of what a WhatsApp Business webhook payload looks like:

{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "WHATSAPP_BUSINESS_ACCOUNT_ID",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "messages": [
              {
                "from": "15551234567",
                "id": "wamid.abc123xyz",
                "timestamp": "1763588700",
                "text": {
                  "body": "I need help with my order"
                },
                "type": "text"
              }
            ]
          },
          "field": "messages"
        }
      ]
    }
  ]
}

4. Frequently Asked Questions

5. Next Steps

• Use HookRay's webhook replay feature to re-send captured webhooks while building your handler
• Enable smart parsing (Pro plan) to see WhatsApp Business-specific fields highlighted automatically
• Check the WhatsApp Business webhook documentation for the complete event reference