Skip to main content

Instagram Integration

Connect your Instagram Business account to SuperWaba and manage all Instagram DMs, story replies, and mentions from a single unified inbox — powered by AI automation.


Capabilities

Messaging

FeatureDescription
Receive DMsAll Instagram Direct Messages appear in your unified inbox
Send repliesReply to DMs directly from SuperWaba
Media messagesReceive and view images, videos, reels, and voice messages inline
Story repliesReceive and respond to story reply messages
Story mentionsGet notified when someone mentions you in their story
Shared postsView posts/reels shared via DM with media preview
Quick repliesSend saved reply templates for common questions

AI Automation

FeatureDescription
AI auto-replyAI agents respond to Instagram DMs automatically 24/7
Product recommendationsAI suggests products from your catalog based on conversation context
FAQ handlingAI answers common questions using your knowledge base
Lead qualificationAI asks qualifying questions and tags contacts
Language detectionAI responds in the customer's language automatically
Smart escalationAI hands off to a human agent when it can't resolve the issue
Conversation summaryAI generates summaries for agents taking over

Automation workflows

AutomationDescription
Welcome messageAuto-send greeting when someone DMs for the first time
Away messageAutomatic response outside business hours
Story mention thank-youAuto-reply when someone mentions you in their story
Follow-up messagesSend follow-ups if customer doesn't respond after X hours
Auto-taggingAutomatically tag contacts based on conversation content
Auto-assignRoute conversations to specific team members by topic

Contact & CRM

FeatureDescription
Profile syncInstagram username, display name, and profile photo imported
Contact enrichmentMerge Instagram contacts with WhatsApp/Messenger contacts
Labels & tagsOrganize Instagram contacts with custom labels
NotesAdd internal notes to Instagram conversations
Contact historyView full conversation history across all channels
Export contactsExport Instagram contact list with metadata

Analytics & insights

FeatureDescription
Response time trackingMonitor average response times for Instagram DMs
AI resolution ratePercentage of conversations resolved without human
Message volumeTrack incoming/outgoing DM volume over time
Peak hoursIdentify when most Instagram DMs come in
Agent performanceTrack individual agent response metrics

Prerequisites

  • An Instagram Business or Creator account
  • A Facebook Page connected to your Instagram account
  • Admin access to the Facebook Page
  • Messaging enabled in Instagram Settings > Privacy > Messages

Setup steps

  1. Go to Settings > Integrations > Instagram
  2. Click Connect Instagram
  3. Sign in with Facebook and grant the required permissions:
    • instagram_manage_messages — read and send DMs
    • instagram_basic — access account info
    • pages_manage_metadata — webhook subscription
  4. Select the Instagram account to connect
  5. SuperWaba automatically subscribes to message webhooks
  6. (Optional) Configure AI agent for Instagram channel

Message types supported

Incoming (receive)

TypeSupportedNotes
TextYesRegular DM text messages
ImageYesPhotos sent in DMs, with lightbox preview
VideoYesVideos and reels shared in DMs
VoiceYesVoice messages (audio clips)
Story replyYesReply to your story, includes story context
Story mentionYesSomeone mentions your account in their story
Shared post/reelYesPosts or reels forwarded via DM
StickerYesInstagram stickers
GIFYesAnimated GIFs

Outgoing (send)

TypeSupportedNotes
TextYesPlain text replies
ImageYesSend images in DMs
Generic templateYesCard with image, title, subtitle, buttons
Quick repliesYesButtons for fast responses
Heart/reactionNoInstagram API limitation

AI agent on Instagram

Your AI agent works across Instagram just like WhatsApp:

  1. Same knowledge base — AI uses your uploaded documents, URLs, and FAQs
  2. Same personality — Consistent tone and brand voice across channels
  3. Same escalation rules — Triggers human handoff based on your configured rules
  4. Channel-aware — AI knows it's on Instagram and adapts (no template messages, respects media limitations)

Configure AI for Instagram

  1. Go to AI Agents > Your Agent > Channels

  2. Enable Instagram channel

  3. Set Instagram-specific behavior (optional):

    • Custom welcome message for Instagram DMs
    • Different business hours for Instagram
    • Instagram-specific escalation triggers

Limitations

LimitationDetails
No template messagesInstagram API doesn't support pre-approved templates like WhatsApp
No interactive listsOnly quick reply buttons are supported
24-hour windowYou can only reply within 24 hours of the last customer message (Instagram policy)
Rate limit200 messages per hour per Instagram account
No broadcastCannot send proactive messages (customer must message first)
Media reply onlyImages only; no document or location sharing via Instagram API

Troubleshooting

IssueSolution
DMs not appearingVerify account is Business/Creator (not personal)
Token expiredRe-authenticate — Instagram tokens expire every 60 days
Story mentions missingCheck pages_manage_metadata permission is granted
AI not respondingVerify Instagram channel is enabled in AI Agent settings
Media not loadingCheck Instagram CDN URLs haven't expired (they expire after ~1 hour)
Wrong account connectedDisconnect and reconnect with the correct Facebook Page

Re-authenticate

Instagram tokens expire every 60 days. When expired:

  1. Go to Settings > Integrations > Instagram
  2. Click Reconnect
  3. Re-authorize with Facebook
  4. No configuration is lost — only the token is refreshed