Instagram via Instagram Business Login

Set up Instagram integration using Instagram Business Login authentication (recommended method)

Please ensure you have installed version v4.1 or above. If not, please refer to this guide for the Facebook Login method.

Prerequisites

1. A valid facebook account.
2. A valid instagram professional account.

Register A Facebook App

To use Instagram Channel, you have to create a Facebook app in the developer portal. You can find more details about creating Facebook apps here.

1. Click on the “Create App” button

2. Select the option “Other”.

3. For the app type, choose “Business”

4. Add app name and connect business account

5. Add Instagram product from the Home page.

Configure Instagram settings for Chatwoot

1. Copy Instagram app ID and Instagram app secret

2. Add the Instagram app ID and Instagram app secret to your app config via {Chatwoot installation url}/super_admin/app_config?config=instagram

3. Configure Webhooks

Set the callback URL to {your_chatwoot_url}/webhooks/instagram. The verify token should match your INSTAGRAM_VERIFY_TOKEN, which can be configured through app_config

Subscribe to messages, messaging_seen, and message_reactions events.

To receive web hooks, app mode should be set to “Live”.

4. Set up Instagram business login

Set Redirect URL as {your_chatwoot_url}/instagram/callback

5. Create a new Instagram tester account

Create Instagram Inbox

Head over to Chatwoot and create a Instagram inbox. Please refer to this guide for more details on creating a Instagram inbox in Chatwoot.

How to test the Instagram before going to live

1. Add Instagram Testers by clicking “Add People” button.

2. Make sure that you have selected the role Instagram Tester while creating a new tester.

Going into production.

Before you can start using your Facebook app in production, you will have to get it verified by Facebook. Refer to the docs on getting your app verified.

Troubleshooting & Common Errors

Insufficient Developer Role Error

Ensure the Instagram user is added as a developer: Meta Dashboard → App Roles → Roles → Add People → Enter Instagram ID

API Access Deactivated

Ensure the Privacy Policy URL is valid and correctly set.

Invalid request: Request parameters are invalid: Invalid redirect_uri

Please configure the Frontend URL. The Frontend URL does not match the authorization URL.

Instagram Channel creation Error: Failed to exchange token

Please make sure that tester account has been added to the facebook app settings.

400: Session Invalid when connecting the instagram channel

This might be issue from facebook side. Please try again after some time.