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

# Instagram

> Connect your Instagram Business account to add AI chatbot capabilities to your customer support

Transform your Instagram Direct Messages with an intelligent AI chatbot that can answer questions, provide support, and engage with your customers automatically 24/7.

## Why Connect Instagram?

<CardGroup cols={2}>
  <Card title="Instant AI Responses" icon="zap">
    Customers get immediate answers based on your website's knowledge base
  </Card>

  <Card title="24/7 Availability" icon="clock">
    AI responds day and night, even when your team is offline
  </Card>

  <Card title="Human Takeover" icon="users">
    Support agents can jump into any conversation from the dashboard
  </Card>

  <Card title="Conversation History" icon="history">
    All Instagram DM conversations are logged and searchable
  </Card>

  <Card title="Multi-Language" icon="globe">
    AI supports 100+ languages for international customers
  </Card>

  <Card title="Knowledge-Powered" icon="brain">
    Answers based on your website's content and documentation
  </Card>
</CardGroup>

## What Can the Instagram Bot Do?

### Answer Customer Questions Instantly

Your customers can ask questions about your products, services, or content directly through Instagram Direct Messages:

**Example Questions:**

```
What are your business hours?
How do I track my order?
Tell me about your return policy
What payment methods do you accept?
```

### Provide 24/7 Support

* Responds instantly to common questions
* No waiting for business hours
* Reduces support ticket volume
* Consistent, accurate answers

### Search Your Knowledge Base

The bot uses your website's content to provide accurate answers:

* Product information
* Help articles
* FAQ sections
* Pricing details
* Shipping information

### Human Agent Handoff & Unified Inbox

Instagram messages appear in your **Live Support** unified inbox alongside website widget and other platform conversations. Each conversation shows an Instagram badge so you always know the source platform.

<Note>
  When replying to Instagram conversations from the dashboard, be aware of Meta's 24-hour messaging window. Messages sent more than 24 hours after the customer's last message will be blocked with a clear error message.
</Note>

**How agent replies work:**

1. Go to **Live Support** in your dashboard
2. Find the Instagram conversation (look for the Instagram badge)
3. Click to open and type your reply
4. Your message is sent directly to the customer's Instagram DM
5. The AI remains paused while you're active in the conversation

The AI resumes automatically when you leave the conversation.

## Prerequisites

* Instagram Business account or Creator account
* Active BubblaV account with a website
* Website with knowledge base content (crawled pages)

## Setup Steps

<Steps>
  <Step title="Navigate to Integrations">
    Go to **Dashboard** → **Your Website** → **Integrations** and find the Instagram card
  </Step>

  <Step title="Click Connect">
    Click **Connect Instagram** to open the Facebook authorization flow
  </Step>

  <Step title="Select Your Instagram Account">
    1. Select which account to connect
    2. Click **Select** to confirm
  </Step>

  <Step title="Verify Connection">
    Return to the BubblaV dashboard. The Instagram integration should now show **Connected** with your username and account ID
  </Step>

  <Step title="Test the Bot">
    Send a test DM to your Instagram account to verify the AI responds correctly
  </Step>
</Steps>

## Managing Your Integration

### View Connected Accounts

From the Instagram configuration page, you can see all connected accounts:

* Instagram username and profile picture
* Display name and account type
* Connection status (Active)

### Disconnect an Account

To remove an Instagram account:

1. Go to **Dashboard** → **Your Website** → **Integrations**
2. Click **Instagram** → **Configure**
3. Find the account you want to remove
4. Click the disconnect button
5. Confirm the disconnection in the dialog

<Note>
  Disconnecting an account will stop the AI from responding to DMs for that account.
</Note>

## How Messages Are Processed

1. **Customer sends DM** → Message arrives at your Instagram account
2. **Webhook triggers** → BubblaV receives the message
3. **AI analyzes question** → Your website's knowledge base is searched
4. **Response generated** → AI formulates an answer with sources
5. **Sent to Instagram** → Customer receives the response in their DM
6. **Conversation logged** → Message stored in your dashboard

## FAQ

<AccordionGroup>
  <Accordion title="Do I need an Instagram Business account?">
    Yes, the Instagram Messaging API only works with Instagram Business accounts. Personal accounts cannot receive messages via webhooks. Converting to a Business account is free and can be done in Instagram Settings.
  </Accordion>

  <Accordion title="Can I customize the bot responses?">
    The AI uses your website's content to generate responses. To improve answer quality, ensure your website has comprehensive, up-to-date information. You can also add custom content through the Knowledge section.
  </Accordion>

  <Accordion title="What happens when the AI can't answer a question?">
    If the AI is unsure or the customer needs complex help, they can be escalated to a human agent. You'll see all conversations in the Live Support dashboard and can jump in anytime.
  </Accordion>
</AccordionGroup>

## Next Steps

* Set up your [Live Support](/user-guide/live-support) to monitor conversations
* Improve your [Knowledge Base](/user-guide/knowledge) content for better answers
* Explore other [Integrations](/user-guide/integrations/overview) to connect more platforms
