Skip to navigation

WhatsApp Message Webhook

View as Markdown

Receives WhatsApp Cloud API message events for the channel. Payload shape is defined by Meta. An api_key query parameter or x-api-key header is required. Signature verification via x-hub-signature-256 is also required when the channel has an App Secret configured.

Path parameters

idstringRequired
The channel id

Headers

x-hub-signature-256stringOptional

Meta sha256=<hex> HMAC of the raw body keyed with the WhatsApp App Secret. Required when the channel has an App Secret configured.

Request

WhatsApp Cloud API webhook payload (entry + changes).

Response

Event acknowledged

Errors

403
Forbidden Error
500
Internal Server Error
503
Service Unavailable Error