Instagram Integration

Connect Instagram DMs to your AI agent

Instagram Integration#

Connect your Instagram Business account to AlonChat and automatically respond to direct messages (DMs) 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:

• ❌ Comment replies on posts (not supported by Instagram API)
• ❌ Story mentions
• ❌ Story replies
• ❌ Group DMs (not supported)

Instagram Story Replies (Coming Soon)#

Currently NOT supported:

• Story replies
• Story mentions
• Story reactions

Workaround: Encourage users to send DMs directly instead of replying to stories.

Add this to your stories:

"Have a question? Send us a DM! 💬"

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 knowledge base or URLs)
• ✅ Links (with auto-preview)
• ✅ Emojis 😊 🎉 ❤️

Coming soon:

• Videos
• Carousels (multiple images)
• Product catalogs

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 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?"
• "Yay! 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

Examples:

• Product inquiry: "Let me tell you about our products! 🛍️"
• Pricing: "Our prices start at ₱500! 💰"
• Shipping: "We ship nationwide! 📦🚚"

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

Bad:

"Our return policy allows returns within 30 days of purchase as long as the item is unused and in original packaging with all tags attached. You'll need to contact us first to get a return authorization number and then ship the item back to our warehouse at your own expense. Once we receive and inspect the item we'll process your refund within 5-7 business days."

Good:

"You can return items within 30 days! 📦

Just make sure they're unused with tags attached.

Contact us first for a return number, then ship it back. We'll refund you within 5-7 days after receiving it! 💰"

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!" (with agent auto-response)

5. Monitor Response Quality#

Review Instagram conversations weekly:

• Check if tone matches brand
• Look for unanswered questions
• Update knowledge base 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 → Settings → Integrations
   • 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 → Settings → Integrations → 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 knowledge base (slow retrieval)
• Slow AI model

Solutions:

1. Switch to faster AI model:

   • Settings → AI Settings → Model
   • Try Grok 4.1 or Gemini Flash (fastest, 1 credit)

2. Optimize knowledge base:

   • Remove duplicate sources
   • Delete outdated content

3. Reduce retrieval chunks:

   • Admin settings → Retrieval
   • Lower from 20 → 10 chunks

"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

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)

Instagram Comment Auto-Reply (Coming Soon)#

Currently in development:

• Auto-respond to comments on your posts
• Reply to mentions in other posts
• Automatically delete spam comments

Notify me: Contact support@alonchat.com to get notified when this feature launches.

Disconnecting Instagram#

To disconnect Instagram:

1. Go to Settings → Integrations
2. Find Instagram integration
3. Click ⋮ → Disconnect
4. Confirm disconnection

What happens:

• ✅ Agent stops auto-responding to Instagram DMs
• ✅ 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
• No story replies: Instagram API doesn't support story reply automation
• No group DMs: Only 1-on-1 conversations supported
• No comment replies: Post comments not yet supported (coming soon)
• Rate limits: Instagram limits outbound messages to prevent spam

Privacy & 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