How to Test Facebook Messenger Webhooks

Facebook Messenger Platform webhooks deliver incoming messages, postbacks, and delivery receipts for chatbot integrations.

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. Facebook Messenger Webhook Events

Facebook Messenger can send the following webhook events to your endpoint:

2. Set Up a Test Endpoint with HookRay

Follow these steps to start receiving Facebook Messenger 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 Facebook Messenger 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 Facebook Messenger Webhook Payload

Here's an example of what a Facebook Messenger webhook payload looks like:

{
  "object": "page",
  "entry": [
    {
      "id": "PAGE_ID",
      "time": 1763589000,
      "messaging": [
        {
          "sender": {
            "id": "USER_ID"
          },
          "recipient": {
            "id": "PAGE_ID"
          },
          "timestamp": 1763589000,
          "message": {
            "mid": "mid.abc123",
            "text": "Hello, I have a question!"
          }
        }
      ]
    }
  ]
}

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 Facebook Messenger-specific fields highlighted automatically
• Check the Facebook Messenger webhook documentation for the complete event reference