Webhook
Webhooks are how WhatsApp delivers inbound message events to AI Bucket. You must verify the callback URL and subscribe to events, otherwise messages will not arrive.
How webhooks work
- Callback URL is the endpoint WhatsApp calls when events happen.
- Verify token (verify secret) is used during webhook verification to confirm you own the endpoint.
- After verification, you must subscribe to relevant events/fields for message delivery.
Get callback URL + verify token from AI Bucket
- Open AI Bucket → WhatsApp Bots.
- Click “Webhook information” to view the webhook URL and secret.
- Use the URL as Callback URL and the secret as Verify Token in Meta configuration.
Callback URL
AI Bucket → WhatsApp Bots → Webhook information
Verify token
AI Bucket → WhatsApp Bots → Webhook secret
Callback URL must include the full domain + path. Verify token must match exactly (case/spacing).
Configure WhatsApp webhooks in Meta
- Open Meta Developers → your app → WhatsApp → Configuration (Webhooks).
- Paste Callback URL and Verify Token, then complete the verification step.
- Subscribe the webhook to message events for your phone number.
- Send a test message and confirm AI Bucket receives it (Omni-Chats).
Recommended subscriptions
- messages (inbound messages)
- message status updates (delivery/read receipts, optional)
- other events you need for your use case (optional)
Common webhook issues
Webhook verification fails (verify token)
Make sure the verify token exactly equals the Webhook Secret shown in AI Bucket.
No messages arrive
Confirm the callback URL is correct (domain + path), webhook is subscribed to messages, and the phone number is verified/connected.