> ## Documentation Index
> Fetch the complete documentation index at: https://chatbase.co/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Instagram

> Connect your Instagram professional account so your AI agent can handle direct messages, with human takeover

## Overview

Integrating Instagram with Chatbase lets your AI agent communicate directly with customers through Instagram direct messages. You can also take over any conversation yourself, so routine inquiries are automated but you keep the freedom to step in whenever you want.

<Card title="What you can do:" icon="comments">
  Answer Instagram DMs automatically, take over a conversation the moment you want to handle it yourself, and run different AI agents on different pages.
</Card>

<Info>
  Attachments are supported, so your AI agent can process them and respond based on their content. See [Attachments](/docs/user-guides/chatbot/channels#attachments).
</Info>

<Note>
  You can connect more than one Instagram page: select multiple pages during setup, or add more later from the **Manage** page.
</Note>

## Before you start

* An Instagram [Professional Account](https://www.facebook.com/help/instagram/138925576505882)
* A Facebook Page connected to that account
* A Chatbase account with an AI agent

## How to connect Instagram

<Steps>
  <Step title="Allow access to messages in Instagram">
    In your Instagram settings for your Professional Account, under **How others can interact with you**, click **Messages and story replies > Message controls > Allow Access to Messages**.
  </Step>

  <Step title="Open the Instagram channel">
    Navigate to your dashboard, pick an AI agent, and go to **Channels**. Click **Connect**, then **I understand**.

    <Frame>
      <img src="https://mintcdn.com/chatbase/yfTgmAASFJyGs3D_/user-guides/integrations/images/instagram/instagram-3.png?fit=max&auto=format&n=yfTgmAASFJyGs3D_&q=85&s=9c78dce53951846421a3741576819381" alt="Starting the Instagram connection from the Channels tab" width="1000" height="724" data-path="user-guides/integrations/images/instagram/instagram-3.png" />
    </Frame>

    Click **Continue**.

    <Frame>
      <img src="https://mintcdn.com/chatbase/yfTgmAASFJyGs3D_/user-guides/integrations/images/instagram/instagram-4.png?fit=max&auto=format&n=yfTgmAASFJyGs3D_&q=85&s=c0b264c52c1efbe06c4a02f4b61083d1" alt="Continuing the Instagram connection flow" width="888" height="763" data-path="user-guides/integrations/images/instagram/instagram-4.png" />
    </Frame>
  </Step>

  <Step title="Log in to Instagram">
    Click **Get Started** to log in to Instagram. This also converts your account to a Professional Account if it isn't one already.

    <Frame>
      <img src="https://mintcdn.com/chatbase/yfTgmAASFJyGs3D_/user-guides/integrations/images/instagram/instagram-5.png?fit=max&auto=format&n=yfTgmAASFJyGs3D_&q=85&s=6214019546f762dabc638531374b659c" alt="The Get Started screen for Instagram login" width="1124" height="1306" data-path="user-guides/integrations/images/instagram/instagram-5.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/chatbase/yfTgmAASFJyGs3D_/user-guides/integrations/images/instagram/instagram-6.png?fit=max&auto=format&n=yfTgmAASFJyGs3D_&q=85&s=baeac2262e002ef52a4017b1d4d65e40" alt="Logging in to Instagram" width="682" height="633" data-path="user-guides/integrations/images/instagram/instagram-6.png" />
    </Frame>
  </Step>

  <Step title="Choose your businesses and pages">
    Choose the businesses affiliated with your Instagram page. If you have none, select **Opt in all current future businesses**.

    <Frame>
      <img src="https://mintcdn.com/chatbase/yfTgmAASFJyGs3D_/user-guides/integrations/images/instagram/instagram-7.png?fit=max&auto=format&n=yfTgmAASFJyGs3D_&q=85&s=2b691f036247003ce6a26cb89c9bfc33" alt="Choosing affiliated businesses" width="889" height="961" data-path="user-guides/integrations/images/instagram/instagram-7.png" />
    </Frame>

    Choose the Facebook Page or Pages linked to your Instagram.

    <Frame>
      <img src="https://mintcdn.com/chatbase/yfTgmAASFJyGs3D_/user-guides/integrations/images/instagram/instagram-8.png?fit=max&auto=format&n=yfTgmAASFJyGs3D_&q=85&s=14af52e349d5373071f5d34831ccff85" alt="Choosing the linked Facebook Pages" width="891" height="885" data-path="user-guides/integrations/images/instagram/instagram-8.png" />
    </Frame>

    Select the Instagram page or pages you want to integrate.

    <Frame>
      <img src="https://mintcdn.com/chatbase/yfTgmAASFJyGs3D_/user-guides/integrations/images/instagram/instagram-9.png?fit=max&auto=format&n=yfTgmAASFJyGs3D_&q=85&s=5bb68a8c285c91faa4c55d013a3c7d09" alt="Selecting Instagram pages to integrate" width="889" height="925" data-path="user-guides/integrations/images/instagram/instagram-9.png" />
    </Frame>
  </Step>

  <Step title="Save and confirm">
    Click **Save**.

    <Frame>
      <img src="https://mintcdn.com/chatbase/yfTgmAASFJyGs3D_/user-guides/integrations/images/instagram/instagram-10.png?fit=max&auto=format&n=yfTgmAASFJyGs3D_&q=85&s=b24a1cce742591e6a3ec004378f46f27" alt="Saving the Instagram page selection" width="891" height="1188" data-path="user-guides/integrations/images/instagram/instagram-10.png" />
    </Frame>

    Your page should be integrated successfully. Click **Manage** to see the integrated page.

    <Frame>
      <img src="https://mintcdn.com/chatbase/BmrOmHxfb5Jvt0l2/user-guides/integrations/images/instagram/instagram-11.png?fit=max&auto=format&n=BmrOmHxfb5Jvt0l2&q=85&s=73d9a6fbb8d60aa8f6eb0319c3fb2e06" alt="The Manage button for the Instagram integration" width="792" height="384" data-path="user-guides/integrations/images/instagram/instagram-11.png" />
    </Frame>

    You can add more pages or delete existing ones from the Manage page.

    <Frame>
      <img src="https://mintcdn.com/chatbase/BmrOmHxfb5Jvt0l2/user-guides/integrations/images/instagram/instagram-12.png?fit=max&auto=format&n=BmrOmHxfb5Jvt0l2&q=85&s=e33d5f67f400f060925af9108cb67ccc" alt="Managing connected Instagram pages" width="1028" height="812" data-path="user-guides/integrations/images/instagram/instagram-12.png" />
    </Frame>
  </Step>
</Steps>

<Check>
  Send a direct message to your connected Instagram account and confirm your AI agent replies.
</Check>

## Human takeover

The human takeover feature lets you take over a conversation whenever you want so you can respond to customers directly. It works at the conversation level, so you can pick a specific conversation from the dashboard and stop the AI agent answering.

### Enable human takeover for a conversation

1. Navigate to **Activity > Conversations**.
2. In the **Conversations** section, filter to show only Instagram chats.
3. Click the human takeover icon.
4. Click the icon again to restore access to the AI agent.

<Frame>
  <img src="https://mintcdn.com/chatbase/BmrOmHxfb5Jvt0l2/user-guides/integrations/images/instagram/instagram-14.png?fit=max&auto=format&n=BmrOmHxfb5Jvt0l2&q=85&s=6d85d350aa611b42f4e3ae12563378c6" alt="The human takeover icon in the Conversations list" width="2928" height="654" data-path="user-guides/integrations/images/instagram/instagram-14.png" />
</Frame>

<Warning>
  Some conversations won't have the human takeover icon. This happens when you delete a page from the Instagram integration. You keep access to the conversations in your chat logs, but not the takeover feature. The same applies if you delete a page and add it back.
</Warning>

***

## Comment monitoring

Turn comments on your **Instagram posts into Chatbase Helpdesk tickets**, so your team can monitor and respond to customers directly from Chatbase. Comment monitoring is available from the channel settings for your Instagram accounts.

<Steps>
  <Step title="Open your channel settings">
    Go to **Channels** and select your connected **Instagram** channel.
  </Step>

  <Step title="Open Comments">
    Select the **Comments** tab.
  </Step>

  <Step title="Enable comment monitoring">
    Turn on **Comment monitoring** and select the connected accounts you want to monitor.
  </Step>

  <Step title="Receive comments as tickets">
    When someone comments on a monitored Instagram post, Chatbase automatically creates a ticket in the **Chatbase Helpdesk**.

    The ticket includes information about the original post and the comment, giving your team the context needed to respond.
  </Step>

  <Step title="Reply from the Chatbase Helpdesk">
    Open the ticket in the **Chatbase Helpdesk** and reply directly to the comment.

    Replies sent from Chatbase are posted as replies to the original Instagram comment.
  </Step>
</Steps>

## Connecting different AI agents to different pages

You can connect different AI agents to different Instagram pages, so each page gets specialized interactions.

1. After connecting your first pages, you have access to the **manage Instagram pages** integrations page. Navigate to the AI agent you want to connect, then **Channels > Manage**.
2. Click **Manage** to open the dashboard. To connect another AI agent to an already-connected page, click the page and delete it.
3. Navigate to the AI agent you want to integrate with the deleted page, then run through the integration steps again.

<Warning>
  If you deleted a page, it will be preselected in the integration steps. Don't deselect any page you want to stay connected to the Instagram or Facebook integrations on Chatbase, because deselecting disables that page for Chatbase.
</Warning>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Off-Meta activities tracking is disabled">
    If your Facebook account has **Off-Meta activities** set to "Don't track", this can block the Instagram authentication. Go to your Facebook account settings, look under privacy settings for Off-Meta activities tracking, and enable it temporarily during the connection process.
  </Accordion>

  <Accordion title="Network redirect blocking authentication">
    Some networks redirect Facebook from `facebook.com` to `web.facebook.com` during login, which can block the authentication flow. When this happens, the Instagram login popup completes successfully and closes, but the first Meta window doesn't move to the next step. Try switching to a different network, such as mobile data or a different WiFi connection, and attempt the connection again.
  </Accordion>
</AccordionGroup>

<Info>
  You can enable or disable the Instagram integration without disconnecting it. Disabling pauses messages while keeping your setup intact, and you can re-enable at any time. New chats still appear in your Chatbase dashboard chat logs.
</Info>

## Limitations

* **A Professional Account and a linked Facebook Page are required.** A personal Instagram account can't be connected.
* **Deleting a page removes takeover for its conversations.** The chat logs remain, but the takeover icon disappears.

## Next steps

<Card icon="facebook-messenger" href="/docs/user-guides/integrations/messenger" title="Messenger">
  Connect the Facebook pages linked to your Instagram accounts for the same treatment.
</Card>
