Skip to main content

Instagram via Instagram Business Login

Note: Please ensure you have installed version v4.1 or above. If not, please refer to this guide

  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

Note: 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.