{{ __('Add a') }} {{ __('webhook') }} endpoint

01 {{ __('Endpoint') }} {{ __('required') }}

{{ __('Webhook URL') }} *

{{ __("Must be HTTPS. We'll POST a signed JSON payload to this URL.") }}

{{ __('Internal name') }} (optional)

02 {{ __('Events to subscribe') }} {{ __('at least one') }}

0 selected

{{ __("Fired once a message lands on the recipient's device.") }}

{{ __('Recipient opened the message — both ticks turned blue.') }}

{{ __('Inbound message from a contact — text, media, location.') }}

{{ __("Send didn't reach WhatsApp — payload includes failure reason.") }}

{{ __('A contact agreed to receive messages from your business.') }}

{{ __('Contact replied STOP or blocked — stop messaging immediately.') }}

{{ __('All recipients in a scheduled blast have been processed.') }}

{{ __('A template was approved, rejected, or paused by Meta.') }}

03 {{ __('Security') }} {{ __('recommended') }}

{{ __('Verify each request via') }} {{ __('X-WaDesk-Signature: t=...,v1=...') }} using HMAC-SHA256.

{{ __('Custom headers') }} (optional)

04 {{ __('Retry policy') }} {{ __('defaults are sane') }}

{{ __('We mark a delivery successful on any 2xx response. 4xx and 5xx will be retried per the policy above.') }}

05 {{ __('Status') }}

{{ __('Endpoint will start receiving the events you selected as soon as you save.') }}

{
 "id": "evt_01HRJX2Y9C3T8",
 "type": "message.delivered",
 "created": 1714122488,
 "data": {
 "message_id": "wamid.HBgL...8c4321",
 "to": "+919876543210",
 "device": "+919876500000",
 "delivered_at": "2026-04-26T18:32:08Z",
 "template": "spring_promo_v3",
 "campaign": "Spring promo / VIP"
 }
}

{{ __('Name') }}: —
{{ __('URL') }}: —
{{ __('Events') }}: 0
{{ __('Method') }}: {{ __('POST') }}
{{ __('Retries') }}: 3 · exponential
{{ __('Timeout') }}: 10 s

{{ __('Every request includes') }} {{ __('X-WaDesk-Signature') }}. Compute HMAC-SHA256 with your secret over the raw body — discard requests that don't match.