BotForge

Channels

Instagram

Connect via Instagram Messaging API (Meta Business)

LiveAdvanced Adapter — requires PRO+ planAdapter: fully implemented

Authentication — How to get your credentials

  1. In Meta Business Manager, connect your Instagram Professional (Business/Creator) account to a Facebook Page
  2. Create/select a Meta App, add the Instagram product, and generate a long-lived Page Access Token with instagram_basic, instagram_manage_messages, instagram_manage_comments, pages_manage_metadata, pages_read_engagement
  3. Copy the Facebook Page ID from the Page's About section, and the Instagram Business Account ID from App Dashboard → Instagram → API setup
  4. Optionally copy the App Secret (App Settings → Basic) to enable webhook signature verification

Reference: Instagram Messaging API docs · Developer console: https://developers.facebook.com/apps

Connection flow

The Connect Channel wizard walks through: Credentials → Validate → Subscribe Events → Webhook → Done. Credentials are validated against Instagram's own API before being encrypted and stored — a bot never goes "connected" on an unverified credential.

Supported features

Message & media types

Text · Photo · Video · Document · Audio

DMs, comments, story replies and story mentions.

Buttons / interactions

Supported via NormalizedButton

Conversation model

DMs · Comments · Story replies · Story mentions

AI & Workflow support

Universal — any installed module (including AI Support) and every workflow trigger/action work identically on Instagram once the adapter is ready, since both operate on NormalizedUpdate, never on platform-specific payloads.

Health & analytics

Health signals

Database · Page Access Token & Instagram account · Webhook subscription · Recent delivery errors

Analytics metrics

messages · activeUsers · workflows

Limitations

  • Requires Meta platform approval before production use, and a PRO+ plan (Advanced Adapter gate).
  • Strictly 1:1 messaging — no group/channel concept, unlike Telegram or Discord.