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
facebook_create_app
  1. Select the option “Other”.
facebook_other_app
  1. For the app type, choose “Business”
facebook_business
  1. Add app name and connect business account
facebook_business_details
  1. Add Instagram product from the Home page.
instagram_product

Configure Instagram settings for Chatwoot

  1. Copy Instagram app ID and Instagram app secret
instagram_app_id
  1. Add the Instagram app ID and Instagram app secret to your app config via {Chatwoot installation url}/super_admin/app_config?config=instagram
instagram_app_config
  1. 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 instagram_webhooks Subscribe to messages, messaging_seen, and message_reactions events. instagram_webhooks_subscribe
To receive web hooks, app mode should be set to “Live”.
  1. Set up Instagram business login
Set Redirect URL as {your_chatwoot_url}/instagram/callback instagram_business_login
  1. 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.
facebook_instagram_test
  1. Make sure that you have selected the role Instagram Tester while creating a new tester.
instagram_tester_list

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.