Instagram in a project: Direct through your own Meta app
Messages sent to your Instagram account's Direct arrive in the project's requests, and replies go back to the customer on Instagram. The connection runs through your own Meta app — the same app you use for WhatsApp works too. Meta App Review isn't required for your own account.
What you need
A professional Instagram account: business or creator. To switch a personal account, go to the Instagram app: Settings → Account type and tools → Switch to professional account.
Message access for connected tools: in the Instagram app, Settings → Messages and story replies → Message controls → Connected tools → Allow access to messages. Without this, Meta doesn't pass conversations along.
A developer account at developers.facebook.com and a Meta app.
A link to your website's privacy policy — Meta won't publish the app without it.
Owner or admin rights in the Sensever project.
Step 1. A Meta app with the Instagram use case
If you don't have an app, click "Create app" and choose the "Manage messaging & content on Instagram" use case.
If you already have an app (for example, for WhatsApp), open it → Use cases → Add use case → "Manage messaging & content on Instagram".
Step 2. Token and secret
In the Instagram use case, open "API setup with Instagram login".
In the "Generate access tokens" section, click "Add account", sign in to your Instagram account and allow access.
Next to the added account, click "Generate token" and copy the token — it starts with
IGAA.At the top of the same page, copy the Instagram app secret. This isn't the App secret from Settings → Basic: Instagram has its own secret.
The token is valid for 60 days. Sensever renews it on its own once a week, so you don't need to paste a new one manually.
Step 3. Connect the account in Sensever
Projects → the project → "Channels" → the "Messaging channels" block.
On the grey Instagram tile, click "Connect".
Paste the Instagram access token and the Instagram app secret, and choose a department or leave "Shared queue".
Click "Connect". You'll see "Account accepted. Now paste the Callback URL and Verify token into the Meta app", and the tile status reads "Waiting for the first request from Meta". This is normal.
Step 4. The webhook in the Meta app
In Sensever, click the gear on the Instagram tile. In the "Webhook details for the Meta dashboard" block, copy the Callback URL and Verify token with the "Copy" buttons.
In the Meta app: the Instagram use case → "API setup with Instagram login" → "Configure webhooks".
Paste the Callback URL and Verify token and click "Verify and save".
In the list of webhook fields, turn on messages, as well as message_reactions, messaging_seen, message_edit and messaging_postbacks — so that reactions, read receipts, edits and button taps come through.
As soon as Meta verifies the URL, the tile status changes to "Connected". If that hasn't happened within an hour, the "Sensever Channels" bot reminds you that the webhook isn't saved.
Step 5. Publish the app
While the app is in development mode, Meta sends messages only from people who have a role in the app — your customers won't reach you.
In the Meta app: App settings → Basic — enter the Privacy policy URL (a page on your website) and save.
Click "Publish" (switch the app to Live mode).
Step 6. Check it
Send a Direct message to your account from another Instagram account. The message appears in the project's requests with the customer's name from their profile, and an Instagram button appears in the widget on your site (if "Show in widget" is checked).
What is passed
From the customer: text, photos, videos, voice messages, files, message edits, reactions, read receipts, button taps. A reply to your story arrives with a link to it; forwarded posts and Reels arrive as links.
To the customer: text (a long reply is split into 1000-byte parts), reactions, read receipts, "typing…" and files: photos up to 8 MB and videos, audio and PDFs up to 25 MB are sent as files, everything else as a link that is valid for 48 hours. Instagram doesn't let you edit or delete a sent reply.
If the customer replies to a specific message, the request shows it as a reply.
Limitations
24 hours. You can reply only within 24 hours of the customer's last message. After that, the message shows "Not sent: in Instagram you can reply only within 24 hours of the customer's message".
Up to 7 days with the human_agent permission. Meta lets a human agent reply up to 7 days after the customer's message if the app has been approved for the human_agent permission. You request it in the Meta app: App Review → Permissions and Features → human_agent, with a description and a screen recording of an agent replying to a customer. Once the permission is approved, Sensever sends late replies with the required tag on its own — nothing to configure.
One account, one project. The same account can't be connected to a second Sensever project.
Possible errors
Message | What to do |
|---|---|
The app secret doesn't look real | Copy the Instagram app secret (letters and digits) from the "API setup with Instagram login" page |
Meta signs requests with a different secret | The App secret was pasted instead of the Instagram app secret, or the secret was reset. Click the gear, then × next to the secret, and paste the current one |
The messenger didn't accept the token | The token wasn't copied in full or was revoked. Generate a new one (step 2) and paste it via the gear |
The "Waiting for the first request from Meta" status doesn't change | The webhook isn't saved (step 4) or the Callback URL wasn't copied in full |
Customer messages don't arrive, but your test messages do | The app isn't published (step 5) or message access isn't allowed in Instagram settings |
Instagram didn't deliver the message | The customer is unavailable or has restricted messages from businesses |
General channel settings — department, showing in the widget, button order, notifications — are described in the article "Project messaging channels: messengers in Requests".
Comentarios