Set up the webhook
The webhook is how Meta delivers inbound DM events to AI Bucket. If the webhook isn’t verified and subscribed, messages won’t arrive.
How webhooks work
- Callback URL is the endpoint Meta calls when events happen.
- Verify token is used during webhook verification (challenge) to confirm you own the endpoint.
- You must subscribe to the right fields/events for DMs to be delivered.
Get callback URL + verify token from AI Bucket
- Open AI Bucket → Instagram Bots.
- Click “Webhook info”.
- Copy the Webhook URL and Webhook Secret (this is your verify token).
Callback URL (Webhook URL)
Copy the full URL shown in the Webhook info dialog.
Verify token
Use the Webhook Secret value as the verify token.
AI Bucket verifies Meta’s webhook challenge using the webhook secret. If the verify token does not match, webhook verification will fail.
Configure Instagram webhooks in Meta
- In your Meta app, open Webhooks and select the Instagram topic (or Instagram Messaging webhook section).
- Paste the Callback URL and Verify Token from AI Bucket (see step 1).
- Click Verify and Save to complete the webhook challenge.
- Subscribe to the message-related fields/events so DMs trigger webhook delivery.
Common fields to subscribe (depends on your Meta setup)
- Messages / messaging events (DM events)
- Message deliveries / read receipts (optional)
- Postbacks / quick replies (optional)
Common webhook issues
Webhook verification fails (verify token)
Make sure Meta’s verify token exactly equals the Webhook Secret shown in AI Bucket’s Webhook info dialog.
No messages arrive
Confirm you subscribed to the correct Instagram webhook fields/events, the callback URL is correct (domain + path), and your IG account is properly connected to the Meta app.
Works in testing but not in production
Check Meta app mode (development/live), app review requirements, and whether the connected IG account is allowed under the current mode.