API ReferenceChannels

WhatsApp Message Webhook

View as Markdown

Receives WhatsApp Cloud API message events for the channel. Payload shape is defined by Meta. Signature verification via x-hub-signature-256 is used when the channel has an App Secret configured; otherwise the webhook relies on URL secrecy and/or an api_key query parameter.

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 and the webhook URL does not include an api_key.

Request

WhatsApp Cloud API webhook payload (entry + changes).

Response

Event acknowledged

Errors

403
Forbidden Error
500
Internal Server Error
503
Service Unavailable Error