INSTAGRAM DIRECT CRM

Instagram DM to CRM: Connect Instagram Direct

Link an Instagram Professional account to Smart Business 360 Leads Inbox so Instagram DMs become trackable sales leads in your CRM.
Audience: Administrator · Estimated Time: ~25 Minutes.

4 Mandatory Account Requirements

Instagram messages route through a connected Facebook Page. All four of the following requirements must be true:

1. Professional Account Type The Instagram account must be a Business or Creator account. Personal accounts cannot be connected.

2. Connected to a Facebook Page The Instagram account must be linked to a Facebook Page that you administer.

3. Mobile App "Allow Access to Messages" Permission Inside the Instagram mobile app, navigate to Settings → Privacy → Messages → Connected tools and toggle Allow access to messages to ON. (Crucial: This is disabled by default on many accounts and cannot be edited in Meta Business Manager; it must be enabled inside the mobile app!).

4. Facebook Page Admin Access You must hold administrator access rights to the connected Facebook Page.

Before You Start (Prerequisites)

Required Value	Where to Find it in Meta
Meta App ID & App Secret	`Meta for Developers → My Apps → Settings → Basic`
Access Token	A long-lived Page access token for the linked Facebook Page
Instagram Account ID	Graph API Explorer or displayed on Smart Business 360 settings after validation
Instagram Username	Your public Instagram handle (e.g. @yourbusiness)
Facebook Page ID / Name	The linked Facebook Page ID and Page name

Required Meta App Permission Scopes

instagram_basic — Access basic Instagram profile data.
instagram_manage_messages — Read and respond to Instagram Direct messages.
pages_manage_metadata — Register webhook subscriptions.
pages_show_list — Enumerate Pages administered by the user.

5-Step Integration Setup Guide

Open Instagram Connection ScreenIn Smart Business 360, navigate to: Leads Inbox → Instagram → Settings.

Enter Credentials & SaveEnter Page Token and linked Page info. Click Save. The platform validates against Meta and stores the Instagram Account ID, username, Page ID, and profile picture.

Register Webhook in Meta Developer Console In Meta Console → Webhooks → select the Instagram object → enter Callback URL below:

https://<your-domain>/integrations/instagram-inbox/meta/webhook

Enter the Verify Token and click Verify and Save.

Subscribe to Messaging EventsUnder the Instagram object webhooks, subscribe to the messages event field.

Send Test DM from Unrelated AccountSend a DM to your Instagram business account from an unrelated personal Instagram account. (Rule: Meta does NOT trigger webhook events for messages sent from an admin account!).

The Instagram 24-Hour Messaging Window

Instagram Direct operates a strict 24-hour messaging window from the customer's last inbound message. Inside the window, free-form replies are unrestricted. Outside the window, free-form replies are rejected.

Crucial Differences from Facebook Messenger:

No 7-Day Human Extension: The 7-day human agent extension available on Messenger does NOT apply to Instagram!
Less Forgiving Network: Instagram threads left unread for 48 hours are significantly harder to re-open. Sales teams must prioritize Instagram threads promptly.

Troubleshooting Setup Errors

Connection saves but no messages arrive.

Check the 4 requirements at the top of this guide. 90% of cases are caused by the "Allow access to messages" toggle being OFF inside the Instagram mobile app.

"Instagram account is not connected to a Page." error.

Connect the Instagram account to the Facebook Page in Facebook Page settings and reconnect in Smart Business 360.

Only new conversations appear; past history is missing.

Expected behavior. Meta's Instagram API does not deliver historical conversations. Only messages received after the webhook connection was established are captured.

Media attachments do not display.

Instagram media CDN URLs are time-limited. Download image and file attachments while the thread is recent.

Status shows "Not Connected" after saving.

No webhook event has been received yet. Send a test DM from an unrelated personal Instagram account (not an admin account).

Replies rejected outside 24 hours.

Expected behavior. Instagram's messaging window rules are strictly enforced and do not support 7-day extensions.

Frequently Asked Questions

No. Meta API rules require Instagram messaging to be connected through a linked Facebook Page.

Direct messages are recorded automatically. Story interaction recording depends on the specific webhook fields subscribed in Meta Developer Console.

Yes, media replies are supported within the active 24-hour messaging window.

No. This connection handles direct message conversations. It does not automatically convert public post or Reel comments into private DMs.

On this page