Access token (System User)
AI Bucket uses this token to call WhatsApp Cloud API (for example, to send replies). For production, generate it via a System User and assign the correct assets and permissions.
What you should understand
- For server-to-server integrations, a System User token is recommended over personal user tokens.
- The System User must be assigned the correct assets (your WABA / app) or API calls will fail.
- Permissions (scopes) control capabilities; missing permissions cause authentication/authorization errors.
- Tokens can expire or be revoked—plan rotation and update AI Bucket accordingly.
Generate the token via System User
Exact menus vary, but the required logic is the same: create a System User, assign assets, grant permissions, then generate an app token.
- In Meta Business Settings, create a System User (admin level is recommended for production).
- Assign the WhatsApp Business Account (WABA) to the System User as an asset.
- Ensure the System User has access to the Meta app that hosts the WhatsApp Cloud API configuration.
- Generate an access token for the app under the System User, selecting WhatsApp permissions.
- Copy the raw token and store it securely. You will paste it into AI Bucket.
Important
Paste the raw token only. Do not include a “Bearer ” prefix and do not share it in chat or screenshots.
Common required permissions
- whatsapp_business_management (manage WABA and phone number assets)
- whatsapp_business_messaging (send and manage messages via Cloud API)
- If you still get permission errors, verify the System User has the WABA assigned and the app is owned by the correct business.
Finish setup in AI Bucket
- Open AI Bucket → WhatsApp Bots → Create WhatsApp Bot.
- Paste business_id (WABA ID), phone_id (Phone Number ID), and access_token (System User token).
- Send a test message to the WhatsApp number and confirm the conversation appears in Omni-Chats and the bot can reply.
Common token issues
Token invalid / expired
Regenerate the token under the System User and update it in AI Bucket. Ensure you paste the raw token without a prefix.
Permission denied (missing assets)
Confirm the System User is assigned the correct WABA and that the app and WABA belong to the same business.