AI Bucket logo

AI Bucket Docs

Open AI Bucket
Open App

Generate an access token

AI Bucket uses the access token to call Instagram APIs (for example, to send replies). Token type and permissions determine what your bot can do.

What you should understand

  • Tokens are secrets: treat them like passwords and store them securely.
  • Scopes/permissions control access; missing permissions cause API errors.
  • Tokens can expire or be revoked; plan how you will rotate and update them.

Generate the token

AI Bucket needs an access token that can access your Instagram account and send/receive messaging events. Token creation can vary depending on whether you use a System User token or another flow.

  1. In Meta Business settings, create a System User (recommended for server-to-server usage).
  2. Generate a token for your Meta app with the Instagram messaging permissions required by your setup.
  3. Keep the token secure. If it expires, generate a new one and update it in AI Bucket.

Important

Paste the raw token only. Do not include a “Bearer ” prefix. If you paste “Bearer …”, Instagram API calls will fail.

Find the correct business_id

AI Bucket’s Instagram Bot requires a business_id (an Instagram account ID). This must match the account that will receive DMs and trigger webhook events.

  1. In Meta/Instagram settings, locate your Instagram Professional account details.
  2. Find the numeric Instagram account ID (sometimes called IG User ID / Instagram Business Account ID).
  3. Copy that ID and use it as business_id when creating the bot in AI Bucket.

Tip

If you are unsure which ID is correct, verify by sending a test DM and checking which bot receives webhook events. business_id must match the ID used in the webhook payload.

Finish setup in AI Bucket

  1. Open AI Bucket → Instagram Bots → Create Instagram Bot.
  2. Paste business_id and access_token, then optionally attach AI Knowledge Base and a system prompt.
  3. Send a test DM and confirm it appears in Omni-Chats and the bot can reply.

Common token issues

Access token errors

Confirm the token is valid, has required permissions, and is pasted without a “Bearer ” prefix. Regenerate and update the bot if needed.

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.

Next

Getting startedWebhook