Messaging Channels


Messaging channels


Setting up the Instagram integration in Botpress

  1. Go to the Integration Hub (opens in a new tab) in Botpress Cloud (if you don't have the integration installed yet).
  2. Find and open the Instagram integration then click on the "Install to Bot" button, now go back to your bot settings.

The Instagram integration has the following settings:

  • Enabled: Whether Botpress will communicate with Instagram
  • Webhook URL: The URL for receiving data in Botpress
  • App ID: The ID of your Meta app
  • App Secret: The secret of your Meta app
  • Verify Token: The token used to verify the webhook requests
  • Page ID: The ID of your Facebook page
  • Access Token: The access token

Setting up Instagram

Create a Facebook Page

If you do not already have a Facebook page you will need to create one. You can find details on how to create a new Facebook page here (opens in a new tab). To link your chatbot to a pre-existing page, you must have an administrator or developer role.

  1. Give a name to your Facebook Page.
  2. Pick a Category.

Create a Meta App

  1. Log in to your Facebook account and go to the Facebook for Developers website (opens in a new tab).
  2. Select My Apps from the top menu, and create a new app.
  3. Select Business as App Type.
  4. Give a name to your App.

Add Messenger to your Meta App

Messenger is the proxy for Instagram settings, and since is not added by default in your Meta app it must be added manually.

  1. In the left sidebar of your app dashboard, click on Add Product.
  2. Look for Messenger and click Set Up.

API version

Botpress can interact with the version 15.0 or higher of the Instagram API. It is not the default version so it must be changed in your app's settings

  1. Go to your Meta app.
  2. In the left sidebar, expand the Settings menu and select Advanced.
  3. In the Upgrade API version section, select v15.0 or higher as the API version.
  4. Click on Save Changes.

App ID and Secret

  1. In the left sidebar, expand the Settings menu and select Basic. Here you can find the App ID and App Secret.
  2. Click on the Show button in the App Secret text box. Copy the App Id and App Secret to your channel configuration.

Page ID and Access Token

  1. In the left sidebar, expand the Messenger menu and select Instagram Settings
  2. In the Access Tokens section, click Add or Remove Pages and add your Facebook page.
  3. Copy the number under you page name and paste it in you Page ID channel configuration.
  4. Click on Generate Token. Copy this token and paste it in the Access Token channel configuration.

Verify Token

The Verify Token is used by Facebook to verify that you are the real owner of the provided webhook.

You can generate any random alphanumerical string for this configuration. Paste it in your Verify Token channel configuration.

Save Configuration

Channel configuration is completed, you can now click Save. It is important you save your configuration before configuring the webhook, otherwise Messenger will be unable to validate the webhook URL.

Webhook Configuration

To receive messages from Instagram in your Botpress bot, you will need to setup some webhook settings.

  1. Go to your Meta App.
  2. In the left sidebar, expand the Messenger menu and select Settings.
  3. In the Webhooks section, click Add Callback URL.
  4. Copy and paste the webhook URL provided in the channel configuration UI.
  5. Copy and paste the Verify Token you generated earlier.
  6. Click on Verify and Save. Make sure your channel configuration was saved before doing this step, otherwise the webhook validation will fail.
  7. Click on Add Subscriptions and add messages, instagram_manage_messages and messaging_postbacks to your webhook.

Note: If you can't find the above permissions, then you need to get your meta app reviewed first (opens in a new tab)

That's it, you may now start chatting with your bot on Instagram!

Submit your App for Meta Approval

When your app is in Development Mode, your bot will work for admins, developers, and testers of the app. After your app is approved and made public, it will work for the general public. (opens in a new tab)