Prerequisites
- An Instagram Business or Creator account
- A connected Facebook Page
- Admin access to both accounts
- A Chatoura agent with training data
Instagram messaging requires a connected Facebook Page. This is a Meta requirement.
Connecting Instagram
1
Go to Integrations
Navigate to Integrations > Instagram
2
Connect with Facebook
Click Connect Instagram (uses Facebook login)
3
Select accounts
Choose your Facebook Page and linked Instagram account
4
Grant permissions
Allow Chatoura to access Instagram messaging
5
Confirm connection
You’ll see a success message when connected
Required Permissions
Supported Message Types
How It Works
- User sends a DM or replies to your Story
- Message is received by Chatoura
- Your AI agent generates a response
- Response is sent back as a DM
Settings
Response Settings
Story Interactions
When someone replies to your Story or mentions you:- The message includes context about the Story
- AI can reference the Story in its response
- Works the same as regular DM conversations
Viewing Sessions
All Instagram DMs appear in:- Chat History with Instagram icon badge
- Individual session message threads
- Lead profiles (if lead capture is enabled)
Escalation
When escalation is triggered:- You receive a notification (email/Telegram)
- AI continues responding unless you pause the session
- You can respond directly on Instagram DMs
- Pause the session in Chat History if you want to handle manually
Disconnecting
- Go to Integrations > Instagram
- Click Disconnect
- Confirm removal
Troubleshooting
Can't connect Instagram
Can't connect Instagram
- Ensure you have an Instagram Business or Creator account
- Verify your Facebook Page is linked to Instagram
- Check that you’re an admin of both accounts
- Try disconnecting and reconnecting your Facebook Page first
Story replies not working
Story replies not working
- Verify “Handle story replies” is enabled
- Check that the Story is still active (not expired)
- Ensure permissions include story access
Messages delayed
Messages delayed
- Instagram API may have slight delays
- Check your response delay settings
- Verify credit balance is sufficient

