Select the app you want to use with the integration.
From the left navigation bar, select Add Product.
Under the Instagram section, select Set up.
3
Configure Instagram Tester role
Next, add an Instagram Tester role to your Meta App:
From the left navigation bar, select App roles, then Roles.
Select Add People, then Instagram Tester.
Enter your Instagram username, then select Add.
Login to your Instagram account, then open the Apps and websites settings.
Open the Tester Invites tab, then select Accept.
4
Configure the integration
To configure the integration, you need to create a webhook endpoint for the WhatsApp integration. To do this, fill in the integration’s configuration fields:
Client Secret
From your Meta app’s left sidebar, expand Instagram and select API setup with Instagram login.
Make sure you’re in API setup with Instagram login and not API setup with Facebook login.
Copy the code under Instagram app secret.
Go back to the integration’s configuration menu in Botpress.
Paste the code into the Client Secret field.
Verify Token
Used by Meta to verify that you’re the real owner of the provided webhook. Can be any alphanumeric string.
Access Token
From your Meta app’s left sidebar, expand Instagram and select API setup with Instagram login.
Make sure you’re in API setup with Instagram login and not API setup with Facebook login.
Expand Generate access tokens, then Generate token.
Select Allow, then copy the access token.
Go back to the integration’s configuration menu in Botpress.
Paste the access token into the Access token field.
Instagram Account ID
From your Meta app’s left sidebar, expand Instagram and select API setup with Instagram login.
Make sure you’re in API setup with Instagram login and not API setup with Facebook login.
Expand Generate access tokens. Then, copy the number under your Instagram account handle.
Go back to the integration’s configuration menu in Botpress.
Paste the number into the Instagram Account ID field.
When you’ve filled in all the fields, select Save Configuration. This will automatically enable your integration.
5
Set up the Instagram API
Now, you can set up the Instagram API and add the webhook to your Meta app:
Go back to your Meta developer dashboard, then select Instagram from the left navigation bar.
Select API setup with Instagram login.
Under Configure webhooks, paste your Botpress webhook URL into the Callback URL field.
In the Verify token field, enter the same token you created in the previous step.
Select Verify and save.
If you receive an error message after selecting Verify and save, make sure you saved your integration’s configuration properly in the previous step.
Now, select the required subscriptions for your webhook. Select Add Subscriptions, then select:
messages
messaging_postbacks
instagram_manage_messages (if your app has been reviewed by Meta
Select Save.
You’ve manually configured your Instagram integration!
After setup is complete, you can submit your app for review by Meta, the parent company of WhatsApp. This verification confirms the identity and eligibility of your business to use Meta’s platforms.While the review is pending, your bot will work for admins, developers, and testers of the app only. After your app is approved and made public, it will work for the general public as well.
If you want to test your bot’s behaviour in Instagram before going through the actual setup process, you can use the Instagram integration playground.
