webhooks.xyz

Examples / Messaging and communication / WhatsApp Business (Meta)

WhatsApp Business (Meta) webhooks

Incoming WhatsApp messages, delivery and read receipts, template status changes.

Events

  • messages
  • message_template_status_update
  • account_update

Signature

Header X-Hub-Signature-256: 'sha256=' + HMAC-SHA256 of the raw body with the Meta app secret, hex encoded. The same scheme applies to Facebook and Instagram webhooks.

✓ A bin checks WhatsApp Business (Meta) signatures: add the webhook secret under Signature verification (GitHub).

Check a WhatsApp Business (Meta) signature with the free tool (use the GitHub preset).

Retries

Meta retries with backoff for up to 7 days if it does not get a 200.

See a retry schedule in the calculator.

Sample request from WhatsApp Business (Meta)illustrative, shortened
Content-Typeapplication/jsonX-Hub-Signature-256sha256=7d38cdd6…
{
  "object": "whatsapp_business_account",
  "entry": [ {
    "id": "102290129340398",
    "changes": [ {
      "field": "messages",
      "value": {
        "messaging_product": "whatsapp",
        "metadata": { "display_phone_number": "15550783881", "phone_number_id": "106540352242922" },
        "messages": [ { "from": "919876543210", "id": "wamid.HBgL…", "timestamp": "1759924800", "type": "text", "text": { "body": "Order ORD-20481 shipped?" } } ]
      }
    } ]
  } ]
}

Receive WhatsApp Business (Meta) webhooks with webhooks.xyz

Create a bin. Paste its URL into WhatsApp Business (Meta). Each request shows at once with its headers and body. Add your secret, and each request gets a verified or failed mark. Add your server as a destination, and deliveries retry when it is down. Request an invite.

More in messaging and communication: Discord, Slack, Telegram Bot API, Twilio.