> ## Documentation Index
> Fetch the complete documentation index at: https://docs.airys.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# Instagram via Instagram Business Login

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

<Note>
  Please ensure you have installed version v4.1 or above. If not, please refer to this [guide](./instagram-channel-setup) for the Facebook Login method.
</Note>

## 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](./facebook-channel-setup).

1. Click on the "Create App" button

<img src="https://mintcdn.com/airys/1FWn-RJM-8Ky_sbQ/self-hosted/images/facebook/facebook-create-app.png?fit=max&auto=format&n=1FWn-RJM-8Ky_sbQ&q=85&s=91b0ba730c32c22745d0ae6bfc6d88a2" alt="facebook_create_app" width="2548" height="1474" data-path="self-hosted/images/facebook/facebook-create-app.png" />

2. Select the option "Other".

<img src="https://mintcdn.com/airys/1FWn-RJM-8Ky_sbQ/self-hosted/images/facebook/facebook_other_app.png?fit=max&auto=format&n=1FWn-RJM-8Ky_sbQ&q=85&s=383511288f142ff1d0591efc5b7bf9b4" alt="facebook_other_app" width="1654" height="1254" data-path="self-hosted/images/facebook/facebook_other_app.png" />

3. For the app type, choose "Business"

<img src="https://mintcdn.com/airys/1FWn-RJM-8Ky_sbQ/self-hosted/images/facebook/facebook_business.png?fit=max&auto=format&n=1FWn-RJM-8Ky_sbQ&q=85&s=7ccd8c51f7bf38128d5f33013c320a0d" alt="facebook_business" width="2164" height="1744" data-path="self-hosted/images/facebook/facebook_business.png" />

4. Add app name and connect business account

<img src="https://mintcdn.com/airys/1FWn-RJM-8Ky_sbQ/self-hosted/images/facebook/facebook_business_details.png?fit=max&auto=format&n=1FWn-RJM-8Ky_sbQ&q=85&s=8b2ecd5377bdbd03a265bf28923bdfcf" alt="facebook_business_details" width="2150" height="922" data-path="self-hosted/images/facebook/facebook_business_details.png" />

5. Add Instagram product from the Home page.

<img src="https://mintcdn.com/airys/8PgT_S4ekmZVDkFb/self-hosted/images/instagram/instagram_product.png?fit=max&auto=format&n=8PgT_S4ekmZVDkFb&q=85&s=f7cd4e313431e8768ec0777c5fa7a8da" alt="instagram_product" width="2984" height="1716" data-path="self-hosted/images/instagram/instagram_product.png" />

## Configure Instagram settings for AirysChat

1. Copy Instagram app ID and Instagram app secret

<img src="https://mintcdn.com/airys/8PgT_S4ekmZVDkFb/self-hosted/images/instagram/instagram_app_id.png?fit=max&auto=format&n=8PgT_S4ekmZVDkFb&q=85&s=50f06db2c754aa6c2ce36684d04ed4b6" alt="instagram_app_id" width="2138" height="1874" data-path="self-hosted/images/instagram/instagram_app_id.png" />

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

<img src="https://mintcdn.com/airys/8PgT_S4ekmZVDkFb/self-hosted/images/instagram/instagram_app_config.png?fit=max&auto=format&n=8PgT_S4ekmZVDkFb&q=85&s=265b16391d84ac16c0d96338e2407f31" alt="instagram_app_config" width="1844" height="1295" data-path="self-hosted/images/instagram/instagram_app_config.png" />

3. Configure Webhooks

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

<img src="https://mintcdn.com/airys/8PgT_S4ekmZVDkFb/self-hosted/images/instagram/instagram_webhook.png?fit=max&auto=format&n=8PgT_S4ekmZVDkFb&q=85&s=16d23517691e6a0d3a808903215c8127" alt="instagram_webhooks" width="1432" height="594" data-path="self-hosted/images/instagram/instagram_webhook.png" />

Subscribe to `messages`, `messaging_seen`, and `message_reactions` events.

<img src="https://mintcdn.com/airys/8PgT_S4ekmZVDkFb/self-hosted/images/instagram/instagram_webhooks_subscribe.png?fit=max&auto=format&n=8PgT_S4ekmZVDkFb&q=85&s=88c942194da1a95b8766289825e4c470" alt="instagram_webhooks_subscribe" width="1420" height="1648" data-path="self-hosted/images/instagram/instagram_webhooks_subscribe.png" />

<Note>
  To receive web hooks, app mode should be set to "Live".
</Note>

4. Set up Instagram business login

Set Redirect URL as `{your_airyschat_url}/instagram/callback`

<img src="https://mintcdn.com/airys/8PgT_S4ekmZVDkFb/self-hosted/images/instagram/instagram_business_login.png?fit=max&auto=format&n=8PgT_S4ekmZVDkFb&q=85&s=9e68f9b7463c9803284c2852a565922e" alt="instagram_business_login" width="1466" height="692" data-path="self-hosted/images/instagram/instagram_business_login.png" />

5. Create a new Instagram tester account

## Create Instagram Inbox

Head over to AirysChat and create an Instagram inbox. Please refer to this [guide](https://airyschat.help/hc/user-guide/articles/1744361165-how-to-setup-an-instagram-channel-via-instagram-login) for more details on creating an Instagram inbox in AirysChat.

## How to test the Instagram before going to live

1. Add Instagram Testers by clicking "Add People" button.

<img src="https://mintcdn.com/airys/8PgT_S4ekmZVDkFb/self-hosted/images/instagram/instagram-testers-list.png?fit=max&auto=format&n=8PgT_S4ekmZVDkFb&q=85&s=acf89a3e0df69c99e707ed26f826204e" alt="facebook_instagram_test" width="3526" height="2526" data-path="self-hosted/images/instagram/instagram-testers-list.png" />

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

<img src="https://mintcdn.com/airys/8PgT_S4ekmZVDkFb/self-hosted/images/instagram/instagram-add-tester.png?fit=max&auto=format&n=8PgT_S4ekmZVDkFb&q=85&s=8ffd3c15c4a7562cfa387ae02b8c1168" alt="instagram_tester_list" width="2946" height="1822" data-path="self-hosted/images/instagram/instagram-add-tester.png" />

## 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](https://developers.facebook.com/docs/messenger-platform/instagram/app-review) 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.