Webhook callback URL

Each Callduck channel exposes a unique webhook URL. Pasting the right one into Meta is what connects inbound messages and delivery receipts to the correct workspace.

The exact URL format

{YOUR_DOMAIN}/api/webhooks/whatsapp/{channelId}

• {YOUR_DOMAIN} — your deployed Callduck domain (must be HTTPS and publicly reachable)
• {channelId} — the ID of the WhatsApp channel, shown in Channels → WhatsApp

Example: https://app.example.com/api/webhooks/whatsapp/ckabc123

Where to paste it in Meta

1. Open your app → WhatsApp → Configuration.
2. Under Webhook, click Edit.
3. Callback URL → paste the URL above.
4. Verify token → the same secret set in Callduck (see Verify token).
5. Save — Meta runs the verification handshake immediately.

Which fields to subscribe

In the same Configuration panel, under Webhook fields → Manage, subscribe at minimum:

• messages — inbound messages and delivery/read status
• message_template_status_update — template approval/rejection changes

Health endpoint

{YOUR_DOMAIN}/api/webhooks/health

This returns a small JSON { ok, provider, time } and does no database work — point uptime monitors here to confirm the webhook surface is reachable.

> One callback URL per channel. If you run multiple numbers, each channel has its own {channelId} and its own URL.