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

Integrating Instagram with Chatbase allows your custom agent to communicate directly with customers via your Instagram pages. This integration also enables you to take over the conversation whenever you want and communicate with users yourself through Instagram's direct messaging. It provides a seamless and efficient way to handle inquiries and automate responses, while giving you the freedom to interact with your customers whenever you choose. This guide will walk you through the necessary steps to connect your agent to Instagram, ensuring smooth and effective customer interactions.

<Info>
  Attachments are supported, allowing your agent to process them and respond based on their content. For more information, please refer to [this section](/user-guides/chatbot/deploy#attachments).
</Info>

## Prerequisites

You will need the following:

* An Instagram [Professional Account](https://www.facebook.com/help/instagram/138925576505882).

* A Facebook Page connected to that account.

## Connecting Instagram

1\. First navigate to the instagram page settings for you Professional Account, then under '**How others can interact with you**', click on **Messages and story replies** > **Message controls** > **Allow Access to Messages**

2\. Navigate to your dashboard, and pick an agent.

3\. Navigate to **Deploy**.

4\. Click on **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="image" width="1000" height="724" data-path="user-guides/integrations/images/instagram/instagram-3.png" />
</Frame>

5\. Click on **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="image" width="888" height="763" data-path="user-guides/integrations/images/instagram/instagram-4.png" />
</Frame>

6\. Login on **Get Started**. This will allow you to login to instagram and turn your account to a Professional Account if it is not 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="image" width="1124" height="1306" data-path="user-guides/integrations/images/instagram/instagram-5.png" />
</Frame>

7\. Login to instagram.

<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="image" width="682" height="633" data-path="user-guides/integrations/images/instagram/instagram-6.png" />
</Frame>

8\. Choose the businesses affiliated with you Instagram page. If you have no business 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="image" width="889" height="961" data-path="user-guides/integrations/images/instagram/instagram-7.png" />
</Frame>

9\. Choose the Facebook Page(s) 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="image" width="891" height="885" data-path="user-guides/integrations/images/instagram/instagram-8.png" />
</Frame>

10\. Select the Instagram page(s) 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="image" width="889" height="925" data-path="user-guides/integrations/images/instagram/instagram-9.png" />
</Frame>

11\. 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="image" width="891" height="1188" data-path="user-guides/integrations/images/instagram/instagram-10.png" />
</Frame>

12\. Your page should be integrated successfully, to see the integrated page click on **Manage.**

<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="image" width="792" height="384" data-path="user-guides/integrations/images/instagram/instagram-11.png" />
</Frame>

13\. 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="image" width="1028" height="812" data-path="user-guides/integrations/images/instagram/instagram-12.png" />
</Frame>

## The Human Takeover Feature

The human takeover feature allows you to takeover the conversation whenever you would like so you can respond to your users directly. It works on a conversation level meaning you would be able to choose a specific conversation from the dashboard and stop the agent from answering.

<Note> some conversations may not have the human takeover icon, that happens when you delete a page from instagram's integration, you would still have access to your conversations in the chat logs, but since the integration was deleted you will not have access to the takeover feature. This will also happen if you delete a page and add it again. </Note>

#### Enable Human Takeover for a Specific Conversation

1\. Navigate to Activity > Chat logs

2\. in the **Chat logs section** make sure to show only Instagram chats.

3\. Click the human takeover icon.

4\. You can click the icon again to restore access to the 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="image" width="2928" height="654" data-path="user-guides/integrations/images/instagram/instagram-14.png" />
</Frame>

## Connecting different agents to different pages

With the Chatbase Instagram integration, you can connect different agents to various pages. This capability allows multiple agents to manage different Instagram pages, providing specialized interactions for each page. here are the steps to adding different agents to different pages.

1\. After connecting the first page(s) you should now have access to the **manage Instagram pages** integrations page. navigate to the agent you want to connect then **Deploy > Manage.**

2\. Click the **Manage** button to navigate to the dashboard. If you want to connect another agent to an already connected page, click, then delete the page.

3\. Navigate to the agent you want to integrate to the page deleted, then reinitialize the integrations steps.

> **Note:** if you deleted an agent it will be selected in the integration steps, don't deselect any agent you want to stay connected to the instagram or facebook integrations on chatbase as deselecting the agent will result in disabling that agent for chatbase.

## Troubleshooting Authentication Issues

If you're having trouble completing the Instagram authentication flow, check the following:

<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. To check this setting, go to your Facebook account settings and look under privacy settings for Off-Meta activities tracking, then 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. If you experience this, 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 now enable or disable Instagram integration without disconnecting it. Disabling pauses messages while keeping your setup intact, and you can re-enable anytime to resume. New chats will still appear in your Chatbase dashboard chat logs.
</Info>

Now this brings an end to the Instagram integration guide, for any further questions please do not hesitate to [contact us](https://www.chatbase.co/help).
