Instagram Integration

Connect Instagram DMs and comments to your AI agent for automatic replies

Instagram Integration#

Connect your Instagram Business account to AlonChat and automatically respond to direct messages (DMs) and comments 24/7. Perfect for brands, influencers, and businesses managing Instagram customer inquiries.

Prerequisites#

Before you begin:

• Instagram Business or Creator account (not personal account)
• Facebook Page linked to your Instagram account (or use direct Instagram login)
• Trained AlonChat agent
• Facebook Business Account (recommended)

Important: Personal Instagram accounts cannot be connected -- only Business or Creator accounts.

Step-by-Step Setup#

Step 1: Convert to Business Account#

If you haven't already, convert your Instagram to a Business account:

1. Open Instagram app
2. Go to Settings > Account
3. Tap Switch to Professional Account
4. Choose Business or Creator
5. Complete setup

Step 2: Link Instagram to Facebook Page#

Instagram Business accounts must be linked to a Facebook Page:

1. Go to Instagram app > Settings > Account
2. Tap Linked Accounts > Facebook
3. Select your Facebook Page
4. Grant permissions
5. Confirm link

Verify link:

• Go to Facebook Page > Settings > Instagram
• Should show your Instagram account as "Connected"

Step 3: Connect in AlonChat#

1. Log in to AlonChat
2. Select your agent
3. Go to Deploy > Instagram
4. Click Connect Instagram

Two connection options:

• Via Facebook: Select the Facebook Page linked to your Instagram account
• Direct Instagram login: For users without a Facebook Page ("No Facebook Page? Connect directly")

1. Complete the OAuth authorization
2. Your Instagram account will appear with a connection status indicator

Multi-account support: You can connect multiple Instagram accounts by clicking "Add More".

Step 4: Configure Settings#

On the Instagram deploy page, configure:

• Ice Breakers: Conversation starters shown to new users
• Quick Replies: Up to 13 quick reply buttons
• Custom AI Prompt: Override or append to your agent's default prompt for Instagram
• Response Style: Presets or custom style configuration
• Auto-Reply Toggle: Enable/disable per connected account
• Learned Style: Use communication patterns learned from training

Step 5: Test Integration#

1. Send a DM to your Instagram account from a test account
2. Verify agent responds automatically
3. Test handoff phrase: "I want to speak to a human"
4. Check conversation appears in AlonChat dashboard

How It Works#

Message Flow#

User sends DM on Instagram
          |
Instagram forwards message to Facebook
          |
Facebook sends message to AlonChat via webhook
          |
AlonChat agent processes message (RAG retrieval)
          |
Agent generates response using AI model
          |
AlonChat sends response to Facebook
          |
Facebook delivers message to Instagram
          |
User receives response in Instagram DM

Average response time: 2-7 seconds (slightly slower than Facebook Messenger due to extra hop)

Features#

Auto-Response to DMs#

Agent automatically responds to:

• Direct messages (1-on-1 chats)
• First-time messages
• Follow-up questions
• Messages during off-hours

Does NOT respond to:

• Story mentions
• Story replies
• Group DMs (not supported)

Comment Auto-Reply#

Your agent can automatically reply to comments on your Instagram posts.

Configure in Deploy > Instagram, under the Comment Reply Settings section for each connected account.

Modes#

Reply Style#

Comment Filters#

Example flow:

Customer comments on your post: "How much is this?"
          |
AlonChat detects question comment
          |
Agent generates reply using your sources
          |
Reply posted: "This item is priced at $45! DM us if you'd like to order."

Quick Replies#

Use quick replies to guide conversations:

Example:

Agent: How can I help you today?

[Product Info] [Pricing] [Contact Us]

Setup: Add to agent's system prompt:

When greeting users, offer quick reply options:
"How can I help you today?
1. Product info
2. Pricing
3. Contact us"

Users can tap buttons or type numbers.

Media Sharing#

Agent can send:

• Text messages
• Images (from your sources or URLs)
• Links (with auto-preview)
• Emojis

Lead Collection#

Agent can collect lead information:

Example conversation:

User: Do you offer custom jewelry?
Agent: Yes! We create custom pieces. Would you like to see our portfolio?

User: Yes please

Agent: Great! I'll send you our catalog. May I have your email?

User: sarah@example.com

Agent: Perfect! I've sent the catalog to sarah@example.com.
      What's your name?

User: Sarah

Agent: Thanks Sarah! What type of jewelry are you interested in?

Lead captured:

• Name: Sarah
• Email: sarah@example.com
• Source: Instagram DM
• Interest: Custom jewelry

Handoff to Human Agents#

When user requests human assistance:

1. Trigger phrase detected (e.g., "speak to human")
2. Agent responds: "Let me connect you with our team. One moment!"
3. Notification sent to your team
4. Auto-reply paused for that conversation
5. Human takes over via AlonChat dashboard or Instagram app

Resume AI:

• Click "Resume AI Agent" in conversation view
• Agent continues responding automatically

Instagram vs Facebook Messenger#

Key Differences#

Why Instagram is Slightly Slower#

Instagram DMs go through an extra hop:

Instagram > Facebook > AlonChat > Facebook > Instagram

vs Facebook Messenger:

Facebook > AlonChat > Facebook

Impact: 1-2 seconds additional latency

Best Practices#

1. Set Instagram-Appropriate Tone#

Instagram is more casual than email or website chat:

Good examples:

• "Hey! What can I help you with?"
• "Let me tell you all about that!"
• "Sure thing! Here's what you need to know"

System prompt example:

You are a friendly AI assistant for [Brand Name].
Use a casual, upbeat tone appropriate for Instagram.
Use emojis frequently to show personality.
Keep responses short and conversational.

2. Use Emojis Generously#

Instagram users expect visual communication:

• 2-3 emojis per message is normal
• Match brand personality (playful vs professional)
• Use relevant emojis for context

3. Keep Responses Short#

Instagram users read on mobile:

• 2-3 sentences per message (ideal)
• Break long answers into multiple messages
• Use line breaks liberally

4. Leverage Instagram Features#

Bio link: Add link to chatbot landing page:

"Questions? Chat with our AI assistant! [Link]"

Story stickers: Use "Questions" sticker to encourage DMs:

"Ask us anything! We'll respond within minutes"

Highlights: Create "FAQ" highlight with common questions:

"Can't find your answer? DM us!"

5. Monitor Response Quality#

Review Instagram conversations weekly:

• Check if tone matches brand
• Look for unanswered questions
• Update your sources with Instagram-specific FAQs
• Adjust emoji usage if needed

Troubleshooting#

Agent Not Responding to Instagram DMs#

Check these in order:

1. Verify Instagram Business account:

   • Settings > Account > Professional Dashboard
   • Should show "Business" or "Creator"

2. Check Facebook Page link:

   • Settings > Account > Linked Accounts > Facebook
   • Should show your Facebook Page

3. Verify AlonChat connection:

   • AlonChat > Deploy > Instagram
   • Instagram should show "Connected" (green)

4. Test Facebook connection:

   • Send test message to Facebook Page
   • If Facebook works but Instagram doesn't, problem is with Instagram-Facebook link

5. Reconnect Instagram:

   • AlonChat > Deploy > Instagram
   • Click "Disconnect"
   • Wait 5 minutes
   • Reconnect Instagram

Instagram Shows "Not Connected"#

Causes:

• Facebook Page link was removed
• Instagram account was downgraded from Business to Personal
• Facebook permissions were revoked

Fix:

1. Verify Instagram is still Business account
2. Re-link Instagram to Facebook Page
3. Reconnect in AlonChat

Delayed Responses (> 10 seconds)#

Causes:

• Instagram API latency (uncontrollable)
• Large source library (slow retrieval)
• Slow AI model

Solutions:

1. Switch to faster AI model:

   • Settings > AI
   • Try a budget model (fastest, 1 credit)

2. Optimize your sources:

   • Remove duplicate sources
   • Delete outdated content

"Can't send message to this person"#

Causes:

• User blocked your Instagram account
• User is not following you AND has restricted DMs
• Instagram detected spam behavior

Fix:

• If legitimate user, ask them to send you a DM first
• Check Instagram account status for restrictions
• Reduce outbound message frequency if flagged as spam

Comment Auto-Reply Not Working#

Check these:

1. Comment reply mode is enabled:

   • Go to Deploy > Instagram
   • Find the Comment Reply Settings section
   • Ensure mode is set to "Auto Reply" or "Draft" (not "Off")

2. Filter matches the comment:

   • If filter is set to "Questions", only question comments trigger replies
   • Try setting filter to "All" for testing

3. Permissions:

   • Ensure Instagram messaging and comment permissions are granted
   • Re-authorize if needed

Story Replies Not Working#

Instagram API limitation: Instagram does NOT allow apps to read story replies via API.

Workaround:

1. Add text to stories encouraging DMs:

   "Questions? DM us! We respond instantly"

2. Add "Send Message" button sticker to stories

3. Manually respond to story replies (cannot be automated)

Disconnecting Instagram#

To disconnect Instagram:

1. Go to Deploy > Instagram
2. Find the connected account
3. Click the disconnect option
4. Confirm disconnection

What happens:

• Agent stops auto-responding to Instagram DMs and comments
• Webhook removed from Facebook/Instagram
• Existing conversations preserved
• Can reconnect anytime

Limitations#

• Business accounts only: Personal accounts cannot be connected
• Requires Facebook Page: Instagram must be linked to Facebook Page (unless using direct login)
• No story replies: Instagram API doesn't support story reply automation
• No group DMs: Only 1-on-1 conversations supported
• Rate limits: Instagram limits outbound messages to prevent spam

Privacy and Compliance#

Data Collection#

AlonChat collects:

• Message content (encrypted)
• Instagram username
• Profile picture
• Conversation timestamps

AlonChat does NOT collect:

• Instagram password
• Instagram posts or photos
• Follower lists
• Private account information

GDPR Compliance#

• Data encrypted at rest and in transit
• User data deletion on request
• No data sold to third parties
• Secure storage in compliant data centers

Next Steps#

• Facebook Messenger Integration -- Connect Facebook Page
• Telegram Integration -- Connect Telegram
• Webhook Examples -- Integrate with CRM