Skip to main content
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
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.

​
Step 1: Create a Facebook App

If you have already created a Facebook app for the Messenger channel, you can reuse it for Instagram, skip to Step 2.
1

Create a new app

Go to the Facebook Developer Portal and click Create App.
Create App button in the Facebook Developer Portal
2

Enter app details

Enter your App name and contact email, then click Next.
App name and contact email fields
3

Select a use case

When asked for a use case, select Other.
Use case selection - Other option highlighted
4

Choose app type

For the app type, choose Business.
App type selection - Business option highlighted
5

Finish creation

Review your details and click Create App to finish.
Confirmation screen before creating the app
6

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.
App ID and App Secret in Basic Settings

​
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.
1

Open Integrations

Log in to your Admin Portal, navigate to:
https://app.chatconnectx.com/manage/integrations
Then select Instagram.
chatbotx_super_admin_integrations_instagram
2

Open the Instagram configuration

Click the Edit button on the Instagram card to open the configuration modal.
chatbotx_super_admin_instagram_edit_modal
3

Enter your App credentials

Fill in the following fields using the values from the Meta Developer Portal:
FieldDescriptionWhere to find it
Client IDYour Facebook App IDSettings → Basic
Client SecretYour Facebook App SecretSettings → Basic → click Show
API VersionFacebook API version (use v2.0 or current version)Settings → Advanced
Webhook Verify TokenA secret string used to validate incoming webhook requestsChoose your own value, for example, a random string
4

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 3: Configure the Instagram App

1

Add your app domain

Under Settings → Basic, add your portal domain (e.g., app.chatconnectx.com) as an app domain.
facebook_app_domain
2

Add Instagram product to your app

In the App dashboard, find the Instagram card under “Add products to your app” and click Set up.
app_add_instagram
3

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.
instagram_api_setup_page
4

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.
To receive webhooks, your app mode must be set to Live. You can toggle this from the top bar of the App dashboard.
instagram_configure_webhooks

​
Step 4: Connect your Facebook Page to Instagram

1

Open Facebook Page settings

Go to Facebook Page settings, select your page, and open Settings.
2

Link your Instagram account

Go to Linked Accounts and connect your Instagram Professional account.
  1. Select Instagram
    facebook_linked_accounts_instagram
  2. Click Connect account
    instagram_connect_account
3

Verify the connection

If everything is set up correctly, you will see the message “Instagram connected.”

​
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.