Instagram Integration

Overview

Nexus receives Instagram DMs via the Instagram Messaging API (part of the Meta Graph API). Instagram conversations appear in the omnichannel inbox.

Capabilities

• Receive inbound Instagram DMs (text, media, story replies).
• Send outbound text and media messages.
• Monitor post comments and insights.

Required permissions / scopes

• instagram_basic
• instagram_manage_messages
• pages_manage_metadata (Instagram API access flows through Facebook)

Edge Functions

Function	Direction	Purpose
instagram-webhook	Inbound	Receives Instagram DMs and events
instagram-send-message	Outbound	Sends Instagram DMs
exchange-instagram-token	Auth	Exchanges Instagram token

Webhook setup

Instagram webhooks share the same Meta App as Facebook. Subscribe to the messages topic for Instagram in the Meta App Dashboard.

Common troubleshooting

Issue	Resolution
Instagram option not available	Ensure the Instagram account is a Business or Creator account linked to a Facebook Page.
DMs not appearing	Verify webhook subscription and that instagram_manage_messages permission is granted.