# Instagram

## 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

1. Open **Bots** → your bot → **Settings**.
2. **Add connection** → **Instagram**.
3. Open **Connection setup**.
4. Copy **Webhook URL** and **Verify token** into the Meta App webhooks if you manage the app.
5. Paste:
   - **Facebook Page ID** (required)
   - **Page access token** (required)
   - **Instagram user ID** (optional)
   - **App secret** (recommended)
6. **Save credentials**.
7. 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.
