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: Up to 4 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 reply to comments on your Instagram posts. Comment replies are rule-driven and route through Human Review, so you stay in control of what goes live.

Configure on the Comments sub-page: Deploy > Instagram > Comments. Settings are per connected account.

Mode#

Detections#

Choose which comment signals can trigger a reply:

Saving these settings creates connection-scoped Human Review rules. Public replies follow the public comment surface policy (the agent invites the commenter to DM for anything that needs private details).

Example flow:

Customer comments on your post: "How much is this?"
          |
AlonChat detects a question comment
          |
Agent drafts a reply using your sources (routed through Human Review)
          |
You approve, and the reply posts: "This item is $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. Reply mode is set:

   • Go to Deploy > Instagram > Comments
   • Ensure Mode is set to "Draft" or "Auto" (not "Off")

2. A detection matches the comment:

   • Make sure the relevant detection (Questions or Mentions) is selected
   • A comment only triggers a reply when it matches a selected detection

3. Drafts are waiting for approval:

   • In Draft mode, replies wait in Human Review and Activity until you approve them

4. 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

Manual Replies & the 24-Hour Window#

Instagram enforces a 24-hour messaging window on business DMs, the same as Messenger.

When you open an Instagram conversation in AlonChat to reply manually:

• If the window is open, the reply box works normally.
• If the window is closed, AlonChat shows an inline warning explaining the window is expired and suggests replying from Instagram's native inbox instead.

This keeps your account compliant with Instagram's rules and avoids silently failed sends.

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
• 24-hour messaging window: Follow-ups outside this window require replying from Instagram's native inbox
• 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