Skip to main content

Instagram Business + Webhooks Integration

This guide shows how to connect an Instagram Business account to the system to enable:

⚠️ Some Meta screens may change visually over time, but the integration flow remains the same.

  • Instagram Login
  • Message receiving (DM)
  • Real-time Webhooks
  • Automated customer service

Prerequisites

Before you begin, you need to have:

  • A Professional Instagram account (Business or Creator)
  • A Facebook account connected to Instagram
  • A Meta Developers account

1. Creating the App on Meta

Go to:

https://developers.facebook.com/apps/

Click on:

  • Create App

Choose the app type​

Select:

  • "Business"

Then click:

  • Next

Illustrative image


Configure the application​

Fill in:

  • Application name
  • Contact email
  • Business account

Then click:

  • Create App

Illustrative image


2. Adding the Instagram API

Inside the app dashboard:

  • Go to Add Product

Search for:

  • Instagram API

Click:

  • Set Up

Illustrative image


3. Opening the API configuration

  • Instagram
  • API Setup

You will see:

  • App ID
  • App Secret

Illustrative image


4. Adding permissions

Click:

  • Add all permissions

The required permissions will be added automatically:

  • instagram_business_basic
  • instagram_business_manage_messages

Illustrative image


5. Adding the Instagram account

In the section:

  • Generate Access Tokens

Click:

  • Add Account

Illustrative image


6. Logging into Instagram

A window will open.

Now:

  • Log in to the Instagram account
  • Click Allow
  • Authorize access

⚠️ The account must be:

  • Business
  • or Creator

7. Copying the Access Token

After logging in:

  • A token will be generated
  • Copy the token

Example:

IGAAxxxxxxxxxxxxxxxxxxxx

Illustrative image


8. Configuring the Webhook

In the section:

  • Configure Webhooks

Fill in:

FieldValue
Callback URLURL provided by the system
Verify TokenToken provided by the system

Example:

Callback URL:
https://api.yoursystem.com/webhook

Verify Token:
my_token

Then click:

  • Test and Save

If everything went correctly, the system will show an alert confirming it's all set Illustrative image

After saving, the system will generate the Webhook URL Illustrative image


9. Subscribing to events

After validating the webhook:

Copy the system URL as shown in the example above, along with the verification token!

Save it.

Subscribe to the available events:

These events allow you to receive messages in real time.

Illustrative image


Configuring Instagram Business Login

In the section:

  • Configure Instagram Business Login

Add:

  • Redirect URI

Example:

https://app.yoursystem.com/auth/instagram/callback

Then click:

  • Save

Illustrative image

13. Done ✅

After completing:

  • Instagram will be connected
  • Messages will be received automatically
  • The system will start receiving events via webhook

What is this URL for?​

At this step, Meta generates an Instagram Business Login URL.

This URL is used to initiate the connection between the Instagram account and the system.

Illustrative image

What to do at this step​

  1. Locate the Configure Instagram Business Login section.
  2. Copy the URL displayed in the Embedded URL field.
  3. Send this URL to the team responsible for the system or register it in the designated location.
  4. This URL will be used in a button, such as Connect Instagram.

When the user clicks this URL, they will be taken to the Instagram login screen.

After logging in and granting access, Instagram automatically redirects to the URL configured in the system.


Possible errors

Personal account​

Error:

Instagram account type not supported

Solution:

Convert the account to:

  • Business
  • or Creator

On Instagram:

  • Settings
  • Account
  • Switch to professional account

Instagram not connected to Facebook​

Instagram must be linked to a Facebook page.

On Instagram:

  • Settings
  • Accounts Center
  • Link Facebook

Official documentation

Instagram API:

https://developers.facebook.com/docs/instagram-platform/

Webhooks:

https://developers.facebook.com/docs/instagram-platform/webhooks/

Instagram Login:

https://developers.facebook.com/docs/instagram-platform/instagram-api-with-instagram-login/