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

# Configure Instagram via Facebook Login

> Learn how to connect an Instagram Professional account via a Facebook App and configure credentials on your portal.

Creating and connecting your Instagram Professional account to a Facebook app allows your portal customers to connect their Instagram channels to send and receive Direct Messages automatically.

## Prerequisites

Before you begin, make sure you have:

* A valid Facebook account
* A Facebook Page you own or administer
* A valid Instagram Professional account (Business or Creator) linked to that Facebook Page
* Super Admin access to your portal to input configurations

<Note>
  If you are developing locally, you will need a tunneling tool such as ngrok to expose your local server to the internet to receive Facebook webhooks.
</Note>

## Step 1: Create a Facebook App

If you have already created a Facebook app for the [Messenger channel](./facebook-messenger), you can reuse it for Instagram, skip to Step 2.

<Steps>
  <Step title="Create a new app">
    Go to the [Facebook Developer Portal](https://developers.facebook.com/apps/) and click **Create App**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/6419eoAF_uo2OCBi/images/image-1.png?fit=max&auto=format&n=6419eoAF_uo2OCBi&q=85&s=a4312497d6e27a9d63e2c2adc4fd6d12" alt="Create App button in the Facebook Developer Portal" width="2409" height="757" data-path="images/image-1.png" />
    </Frame>
  </Step>

  <Step title="Enter app details">
    Enter your **App name** and **contact email**, then click **Next**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/bk1D42eDWTivbgT_/images/image-2.png?fit=max&auto=format&n=bk1D42eDWTivbgT_&q=85&s=5249012405fdb92ea7cadc59bbcd09ce" alt="App name and contact email fields" width="2197" height="937" data-path="images/image-2.png" />
    </Frame>
  </Step>

  <Step title="Select a use case">
    When asked for a use case, select **Other**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/bk1D42eDWTivbgT_/images/image-3.png?fit=max&auto=format&n=bk1D42eDWTivbgT_&q=85&s=bbd6313775d17a3971de57329c78c56f" alt="Use case selection - Other option highlighted" width="2151" height="1708" data-path="images/image-3.png" />
    </Frame>
  </Step>

  <Step title="Choose app type">
    For the app type, choose **Business**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/bk1D42eDWTivbgT_/images/image-4.png?fit=max&auto=format&n=bk1D42eDWTivbgT_&q=85&s=a7bc6f433111bee494f0220d8505799c" alt="App type selection - Business option highlighted" width="2173" height="844" data-path="images/image-4.png" />
    </Frame>
  </Step>

  <Step title="Finish creation">
    Review your details and click **Create App** to finish.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/bk1D42eDWTivbgT_/images/image-5.png?fit=max&auto=format&n=bk1D42eDWTivbgT_&q=85&s=5d530bddb2eeb78f5d24962a31fcfbb1" alt="Confirmation screen before creating the app" width="2177" height="1104" data-path="images/image-5.png" />
    </Frame>
  </Step>

  <Step title="Get your App ID and App Secret">
    After creating your app, go to **Settings → Basic** to find your **App ID** and **App Secret**. You will need both values in the next step.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/YBc7vqGEslWm7FIq/images/image-255.png?fit=max&auto=format&n=YBc7vqGEslWm7FIq&q=85&s=de815c709789df3181da74e5f0b51b2f" alt="App ID and App Secret in Basic Settings" width="2837" height="1581" data-path="images/image-255.png" />
    </Frame>
  </Step>
</Steps>

## Step 2: Configure Credentials in the Admin Portal

You must enter the Facebook App credentials in the Admin Portal to enable the Instagram connection feature for your customers.

<Steps>
  <Step title="Open Integrations">
    Log in to your Admin Portal, navigate to:

    ```text theme={null}
    https://app.chatconnectx.com/manage/integrations
    ```

    Then select **Instagram**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/rIKY9dgGT5yHSIxP/images/image-326.png?fit=max&auto=format&n=rIKY9dgGT5yHSIxP&q=85&s=87c16f1520ffe5e7184cb70459e58f94" alt="chatbotx_super_admin_integrations_instagram" width="2819" height="1602" data-path="images/image-326.png" />
    </Frame>
  </Step>

  <Step title="Open the Instagram configuration">
    Click the **Edit** button on the Instagram card to open the configuration modal.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/rIKY9dgGT5yHSIxP/images/image-327.png?fit=max&auto=format&n=rIKY9dgGT5yHSIxP&q=85&s=d6c40af14324f935a1571bfcc5bf336c" alt="chatbotx_super_admin_instagram_edit_modal" width="2821" height="1601" data-path="images/image-327.png" />
    </Frame>
  </Step>

  <Step title="Enter your App credentials">
    Fill in the following fields using the values from the Meta Developer Portal:

    | Field                  | Description                                                | Where to find it                                    |
    | :--------------------- | :--------------------------------------------------------- | :-------------------------------------------------- |
    | `Client ID`            | Your Facebook **App ID**                                   | **Settings → Basic**                                |
    | `Client Secret`        | Your Facebook **App Secret**                               | **Settings → Basic** → click **Show**               |
    | `API Version`          | Facebook API version (use `v2.0` or current version)       | **Settings → Advanced**                             |
    | `Webhook Verify Token` | A secret string used to validate incoming webhook requests | Choose your own value, for example, a random string |
  </Step>

  <Step title="Save">
    Click **Save**. The Instagram channel will now be ready for your customers to connect.

    After saving, the system will display a **Webhook URL**. Copy this URL to use in Step 3.
  </Step>
</Steps>

## Step 3: Configure the Instagram App

<Steps>
  <Step title="Add your app domain">
    Under **Settings → Basic**, add your portal domain (e.g., `app.chatconnectx.com`) as an app domain.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/FAZvdFXI0s4AXKUI/images/image-323.png?fit=max&auto=format&n=FAZvdFXI0s4AXKUI&q=85&s=9bc27b198f617cdfcb73c6d9e75ef723" alt="facebook_app_domain" width="2681" height="1466" data-path="images/image-323.png" />
    </Frame>
  </Step>

  <Step title="Add Instagram product to your app">
    In the App dashboard, find the **Instagram** card under "Add products to your app" and click **Set up**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/kDJf1v4d4sQ2ABir/images/image-261.png?fit=max&auto=format&n=kDJf1v4d4sQ2ABir&q=85&s=78af20e6afd17ccec25c979cc906b82d" alt="app_add_instagram" width="2800" height="1363" data-path="images/image-261.png" />
    </Frame>
  </Step>

  <Step title="Open the API setup page">
    After adding the Instagram product, you will be redirected to the **API setup with Instagram business login** page. This page consolidates all configuration into 4 steps.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/kDJf1v4d4sQ2ABir/images/image-263.png?fit=max&auto=format&n=kDJf1v4d4sQ2ABir&q=85&s=1eaee93ccbab1737b306664e473006cb" alt="instagram_api_setup_page" width="2786" height="1489" data-path="images/image-263.png" />
    </Frame>
  </Step>

  <Step title="Configure webhooks">
    Under **Step 2: Configure webhooks**, fill in the following:

    * **Callback URL**: Use the **Webhook URL** generated by the Admin Portal in Step 2 (e.g., `https://app.chatconnectx.com/webhooks/instagram`)
    * **Verify Token**: Enter the **Webhook Verify Token** value you configured in the Admin Portal (Step 2)

    Click **Verify and save** to confirm the webhook connection.

    <Note>
      To receive webhooks, your app mode must be set to **Live**. You can toggle this from the top bar of the App dashboard.
    </Note>

    <Frame>
      <img src="https://mintcdn.com/chatbotx/rIKY9dgGT5yHSIxP/images/image-329.png?fit=max&auto=format&n=rIKY9dgGT5yHSIxP&q=85&s=5b72292423817c1ab669f8287555d57a" alt="instagram_configure_webhooks" width="2576" height="720" data-path="images/image-329.png" />
    </Frame>
  </Step>
</Steps>

## Step 4: Connect your Facebook Page to Instagram

<Steps>
  <Step title="Open Facebook Page settings">
    Go to Facebook Page settings, select your page, and open **Settings**.
  </Step>

  <Step title="Link your Instagram account">
    Go to **Linked Accounts** and connect your Instagram Professional account.

    1. Select **Instagram**
           <Frame>
             <img src="https://mintcdn.com/chatbotx/kDJf1v4d4sQ2ABir/images/image-266.png?fit=max&auto=format&n=kDJf1v4d4sQ2ABir&q=85&s=5affc46065fe6c7018e2aac105ad7918" alt="facebook_linked_accounts_instagram" width="2639" height="1541" data-path="images/image-266.png" />
           </Frame>
    2. Click **Connect account**
           <Frame>
             <img src="https://mintcdn.com/chatbotx/kDJf1v4d4sQ2ABir/images/image-268.png?fit=max&auto=format&n=kDJf1v4d4sQ2ABir&q=85&s=b06be3f265ed718e0f8d281f185805f0" alt="instagram_connect_account" width="2674" height="1079" data-path="images/image-268.png" />
           </Frame>
  </Step>

  <Step title="Verify the connection">
    If everything is set up correctly, you will see the message **"Instagram connected."**
  </Step>
</Steps>

## User Connection Guide

After completing the app configuration on the Meta Developer Portal and entering the Credentials in the Admin Portal, your customers can connect their Instagram accounts.

For step-by-step instructions, see the [Instagram Connection Guide](/channels/instagram/connect-instagram).