# Instagram

> Connect your Quickchat AI Agent to Instagram. Link an Instagram Professional account and your AI Agent replies to Instagram DMs automatically.

This guide shows how to connect your **Quickchat AI Agent** to **Instagram**. Once an Instagram Professional account is connected, your AI Agent replies to the DMs that account receives, and every conversation appears in your [Quickchat AI Inbox](https://app.quickchat.ai).

For an overview of what the Instagram channel does and what it costs, see [AI Agent for Instagram DMs](https://quickchat.ai/instagram).

If you get stuck, jump to [Troubleshooting & FAQs](#troubleshooting--faqs) or [contact us](https://quickchat.ai/contact).

## Optional example checks

- [Compare deployment methods][public-lab-deployment-fit-get]. Check your declared channels, website access and required features against Quickchat AI setup options. This does not inspect your website or account.

- [Compare replies per credit budget][public-lab-credit-capacity-get]. Calculate the maximum whole AI replies for each supported model from a supplied credit budget. This does not check your balance or model eligibility.

## Step 0 - Prerequisites

- An **Instagram Professional account** (Business or Creator). Personal accounts cannot receive messages from an app, so the connection will not work on one. You can switch an existing account to Professional in the Instagram app.
- **Access and manage messages** left switched on when Instagram asks for permission. Without it your AI Agent cannot reply to DMs.
- **Sign in as that account** when you connect. Instagram authorizes whichever account your browser is already signed into, and it does not offer an account picker.

:::caution
An Instagram account connects to **one AI Agent** at a time. Inbound DMs resolve to exactly one Agent, so two Agents on the same account would take each other's conversations.
:::

## Step 1 - Connect your Instagram account

1. Open the [Quickchat AI App](https://app.quickchat.ai) and go to **External Apps**.
2. Click **Instagram**, then click **Connect to Instagram**.
3. An Instagram window opens. Sign in if prompted, and make sure you are signed in as the professional account you want to use.
4. Review the permissions and leave **Access and manage messages** switched on.
5. Confirm. Instagram shows **Instagram connected!**, the window closes, and the panel fills in your **@username** and a **Connected since** date.

That's it. **Your AI Agent is now live on Instagram DMs!** 🎉

### If the login window does not open

Some browsers block the pop-up, and mobile Safari blocks it by default. When that happens the panel shows *"Your browser blocked the Instagram login window"* and offers **Continue in this tab**. Click it and the same sign-in runs in the current tab. Quickchat brings you back to the app when Instagram is done.

### If you are signed in as the wrong account

Instagram connects whichever account your browser is already signed into. If that turns out to be a personal account, Instagram shows a generic error before Quickchat ever sees the attempt. To avoid that, click **Sign in as a different account** under the Connect button before you connect. That sends you through Instagram's sign-in again so you can pick the professional account.

## Step 2 - Enable the bot

Use the **Enable Instagram** toggle to switch the integration on or off without disconnecting the account. When it's on, your AI Agent replies to incoming DMs; when it's off, the account stays connected but the Agent stops replying.

## Try it out

Send a DM to your connected account from a different Instagram account. Your AI Agent replies, and the conversation appears in your [Quickchat AI Inbox](https://app.quickchat.ai) with the sender's Instagram name, where you can read the full transcript and take over from the AI at any time.

Until the first DM arrives the panel shows a **Waiting for your first DM** note. That is not an error, it just means nothing has come in yet.

## What your AI Agent can receive

Your AI Agent reads:

- **Text messages.**
- **Photos**, which it can use as visual context when answering questions.
- **Videos and files**, which it is told arrived and can refer to by name. Their contents are not analyzed.
- **Voice notes**, which are transcribed to text before the Agent reads them. If a voice note cannot be transcribed, the Agent is told a voice message arrived rather than answering a message it never received.
- **Story replies.** The Agent receives the reply text with a Story-reply marker. When Instagram provides an available Story photo, Quickchat AI attaches it to the conversation so the Agent can use it as visual context. Supported Story images are JPEG, PNG and WebP. If the media URL is missing, expired or cannot be downloaded, or the Story contains a video instead of a supported image, the Agent still receives the reply text without the Story's visual content.

Test a photo Story by replying from another Instagram account. Ask about a clearly identifiable item, then check the answer and the image attachment in the conversation. Configure the Agent to ask for clarification when the available text and image do not identify the item. A generic or unlabelled image may still require a follow-up question.

It ignores:

- **Story mentions.** Being tagged in someone's story is not a conversation, so no reply is sent.
- **Its own messages.** Instagram echoes back everything your account sends, including your AI Agent's replies. Those are dropped, otherwise the Agent would answer itself in a loop.
- **Deleted messages**, and message types Instagram itself marks as unsupported.
- **Shared posts and reels.** If someone shares a post along with a message, the Agent sees the message text but not the shared item.

Attachments above 25 MB are not downloaded. The Agent is told an attachment arrived that could not be opened, so it can ask the sender to describe it.

## The 24-hour reply window

Instagram lets a business reply to a person **for 24 hours after that person's last message**. Each new message from them starts the window again.

This is Instagram's rule, not a Quickchat setting, and there is no way to reopen a closed window. Your AI Agent is almost never affected because it answers straight away. It matters when a human takes over hours later: if the window has closed, Instagram rejects the reply and the Inbox shows *"Instagram only lets businesses reply within 24 hours of the person's last message. This conversation is outside that window."*

## Replying yourself

Open the conversation in the [Inbox](https://app.quickchat.ai) and take over from the AI, the same as on any other channel. Two things are specific to Instagram:

- You can send a **JPEG or PNG image** (up to 5 MB) or a **PDF** (up to 16 MB) from the Inbox composer. Instagram can't carry text and a file in one message, so the file goes on its own: send it first, then type your message. Other file types and voice messages are not supported on Instagram.
- A reply must **fit in one Instagram message**: up to 900 characters. Instagram also caps a message at 1,000 bytes, so text that takes more bytes per character fits less: about 330 characters of Japanese, Chinese or Korean, or about 250 emoji. If your reply is too long the Inbox asks you to shorten it. Your AI Agent's own replies are split automatically, so this only applies to messages you type.

## Staying connected

Instagram issues an access token that lasts **60 days**. Quickchat renews it automatically, well before it runs out, so a healthy connection keeps working with nothing for you to do. The **Connected since** date on the panel is when you connected, not a deadline.

Messages you may see on the Instagram panel, and what to do:

- **"Instagram access has expired."** The token lapsed, which usually means access was removed on the Instagram side. Click **Reconnect** and sign in again.
- **"Instagram is refusing replies from this account."** Instagram rejected a reply sent with this connection. Until you reconnect, your AI Agent stops answering new DMs on this account, so it spends no AI credits on replies Instagram would refuse. Click **Reconnect** and sign in again, and the Agent answers again from the next DM.
- **"Connected, but no message has arrived yet."** The connection looks healthy but no DM has ever reached your Agent. This almost always means the message permission was never really granted, or was removed later.
- **"Instagram is refusing replies because message access is off."** The same cause, confirmed by a rejected reply.
- **"Meta has temporarily blocked this account from sending messages."** Meta has restricted the Instagram account itself, so Instagram does not deliver its replies, and each undelivered reply carries the same explanation in the Inbox. Open **Account Status** in the Instagram app to see the restriction and request a review; reconnecting does not lift the block. Your AI Agent keeps answering new DMs meanwhile so it can tell when the block ends, and those replies still use AI credits. The first reply delivered after Meta removes the block clears this message.

While replies are paused, every Instagram conversation in the [Inbox](https://app.quickchat.ai) shows *"Instagram is refusing replies from this account, so your AI Agent is not answering new messages."* Team members who can open **External Apps** get a **Reconnect Instagram** link that opens the Instagram panel. Members with the **Support** role are asked to have an Administrator or Editor reconnect instead.

To check the permission in the Instagram mobile app, open **Settings and activity**, then **Your app and media**, then **App website permissions**, then **Apps and websites**. Quickchat AI should be listed under **Active**. If it is not, or if replies are still being refused, click **Reconnect** in Quickchat and leave the message permission on.

**Reconnect** keeps the connection in place and refreshes your access. **Disconnect** stops your account receiving AI Agent replies.

## What Quickchat AI can and cannot do with your account

We only request the permissions needed to identify your account and reply to DMs. We never post to your feed, read your followers, or change your account settings.

## Troubleshooting & FAQs

**That Instagram account is already connected.**

- Another AI Agent already answers on that account. Disconnect Instagram on that Agent first, or connect a different account.

**Instagram needs permission to manage your messages.**

- The sign-in completed without the message permission. Click **Reconnect** and leave **Access and manage messages** switched on.

**I get an error saying the sign-in link was already used.**

- Each connection attempt can be used once. Start a new one from the Instagram panel.

**Instagram would not enable messages.**

- Instagram accepted the sign-in but would not turn on message delivery. Try again, and [contact us](https://quickchat.ai/contact) if it keeps failing.

**My AI Agent doesn't reply.**

- If Instagram conversations in the Inbox say your AI Agent is not answering new messages, Instagram is refusing replies from this account. Click **Reconnect** in the Instagram panel and sign in again.
- If the Instagram panel says Meta has temporarily blocked the account, Instagram is not delivering its replies. Open **Account Status** in the Instagram app to see the restriction and request a review; reconnecting does not help.
- Check that the **Enable Instagram** toggle is on and the panel shows the account as connected.
- Confirm you connected the intended account and that the correct **AI Agent** is selected.
- Confirm the sender's last message is less than 24 hours old.
- Check that Quickchat AI is still authorized under **Settings and activity → Your app and media → App website permissions → Apps and websites** in the Instagram app.

**I connected the wrong account.**

- Click **Reconnect** in the Instagram panel and sign in as the correct account, or use **Sign in as a different account** to go through Instagram's sign-in from scratch.

**Can I connect a personal Instagram account?**

- No. Instagram does not deliver messages from a personal account to an app. Switch the account to Professional (Business or Creator) in the Instagram app, then connect it.

**Can two AI Agents share one Instagram account?**

- No. One Instagram account connects to one AI Agent.

**How do I change the welcome message?**

- The greeting is your AI Agent's message, configured in the [Quickchat AI App](https://app.quickchat.ai). Update it there and it applies to every channel, including Instagram.

## Need Help?

Still stuck? Reach out on [Discord](https://discord.gg/KqkHwvPRNH) or [contact us](https://quickchat.ai/contact) and we'll help you get your account connected.

[public-lab-deployment-fit-get]: https://app.quickchat.ai/v1/api_core/public-question/quickchat/tools/deployment-fit/lab/get/?placement=docs-instagram-deployment-fit-get-v1

[public-lab-credit-capacity-get]: https://app.quickchat.ai/v1/api_core/public-question/quickchat/tools/credit-capacity/lab/get/?placement=docs-instagram-credit-capacity-get-v1
