What it is
Instagram connects Instagram Direct (professional / business account) to your constructor bot through Meta. When someone writes to your Instagram account, Botconsole can answer with the published scenario and show the dialogue in Chats.
The current integration is MVP-oriented: text and basic media work best; advanced Instagram features (quick replies, carousels) are not fully wired in Botconsole yet.
Requirements
- A constructor bot in Botconsole
- An Instagram professional account linked to a Facebook Page
- A Meta app with Instagram Messaging
- Page ID and Page access token
Some plans may require a tariff that includes Meta channels.
How to connect
- Open Bots → your bot → Settings.
- Add connection → Instagram.
- Open Connection setup.
- Copy Webhook URL and Verify token into the Meta App webhooks if you manage the app.
- Paste:
- Facebook Page ID (required)
- Page access token (required)
- Instagram user ID (optional)
- App secret (recommended)
- Save credentials.
- From a test Instagram account, send a Direct message to your business profile — the scenario should reply.
Message types and limits
Available message types
| Type | Supported | Notes |
|---|---|---|
| Text | Yes | Main channel for scenarios |
| Image | Yes | Limited; prefer public URLs / simple media |
| Video | Yes | |
| Audio | Yes | |
| Voice, document, sticker | No | Not available for outbound in Botconsole yet |
| Location, contact | No | |
| Media album | No | |
| Poll, invoice | No |
Buttons
- Not available in Botconsole scenarios yet
- Instagram itself can show quick replies (up to about 13), but Botconsole does not send them from the constructor at the moment
- Build scenarios that work with text replies (and simple media)
Extra message options
| Option | Available |
|---|---|
| Message effects | No |
| Reply to message | No |
| Link preview toggle | No |
| Forward / forum | No |
| AI streaming | No |
| Edit / delete | No |
| Keyboards | No |
Limits
| Limit | Value |
|---|---|
| Text | up to 1 000 characters |
| Caption | up to 1 000 characters |
| Media | Instagram / Meta size rules (~25 MB class) |
Formatting
Messages are sent as plain text. Constructor Markdown (bold, links, etc.) is stripped or simplified — do not rely on rich formatting for Instagram.
Notes and limitations
Messaging window. Like other Meta channels, free-form replies usually require the user to have written recently (customer care window). Outside that, special approved message types may be required.
Prefer short, clear text. Long Telegram scenarios with many buttons will not behave the same on Instagram.
Use a business / creator Instagram account connected to a Facebook Page — personal accounts without Messaging API will not work.
After saving credentials, always test with a second Instagram account, not only the business profile itself.