Skip to main content
Creating your own Facebook Messenger app allows you to customize the permission screen to show your own brand name and logo when customers connect their Facebook Pages.

​
Prerequisites

Before you begin, make sure you have:
  • A valid Facebook account
  • A Facebook Page you own or administer
  • 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

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 Messenger connection feature for your customers.
1

Open Integrations

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

Enter your App credentials

chatbotx_super_admin_messenger_edit_modal
Fill in the fields using the values from the Meta Developer Portal:
FieldDescriptionWhere to find it
App IDYour Facebook App IDSettings → Basic
App SecretYour Facebook App SecretSettings → Basic → click Show
Webhook Verify TokenRandom string for webhook verificationSelf-generated
API VersionFacebook API version (use v25.0)Settings → Advanced
3

Save

Click Save. The Messenger 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 4.
chatbotx_super_admin_messenger_overview

​
Step 3: Configure Facebook Login

1

Add the Facebook Login product

From your app dashboard, add the Facebook Login product.
Adding Facebook Login product
2

Configure Facebook Login settings

In the Facebook Login settings:
  • Enable Web OAuth Login
  • Enable Login with JavaScript SDK
  • Add your portal domain to Allowed Domains for the JavaScript SDK (e.g., app.chatconnectx.com)
Facebook Login settings with OAuth and SDK options

​
Step 4: Configure Webhooks on the Facebook App

1

Add your app domain

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

Add the Messenger product

From the Products section, add Messenger to your app.
Adding Messenger product
3

Configure the webhook

In the Messenger settings, configure the webhook:
  • Callback URL: Use the Webhook URL generated by the Admin Portal in Step 2 (e.g., https://app.chatconnectx.com/integrations/messenger/callback)
  • Verify Token: Enter the Webhook Verify Token value you configured in the Admin Portal (Step 2)
Webhook callback URL and verify token fields

​
Step 5: Test before Going to Production

Meta does not forward page messages to your webhook until your app is approved Live. You need to add a tester account to verify it first.
1

Connect your Facebook Page

In the Messenger settings of the Facebook App, click Connect next to the page you want to use for testing.
Connect button for a Facebook Page
2

Add subscriptions

On the connected page, click Add subscriptions.
Add subscriptions button
3

Select subscription fields

Subscribe to the following fields and save:
messages
messaging_postbacks
message_reads
message_echoes
messaging_optins
messaging_feedback
messaging_referrals
Subscription fields selection
4

Send a test message

Send a test message to your page from a personal Facebook account (which has Admin/Tester role in the app). It should appear in your portal.

​
Going to Production

Before your app can receive messages from real users, Meta must review and approve it.
1

Submit for App Review

Follow the Facebook App Review process to get your app verified.
2

Request advanced access

Request advanced access to the permissions below:Required permissions
PermissionPurpose
pages_messagingSend messages on behalf of your Page
pages_show_listList Pages available to connect
pages_manage_metadataSubscribe webhooks on behalf of the Page
Optional permissions
PermissionPurpose
pages_user_genderAccess a user’s gender via the connected Page
pages_user_localeAccess a user’s locale via the connected Page
pages_user_timezoneAccess a user’s timezone via the connected Page
pages_utility_messagingSend utility messages and manage messaging templates

​
API Version

The system supports Facebook API v25.0. Make sure your app is configured to use this version.
  • Update the API version under Settings → Advanced in your Facebook app.
  • Verify that your webhook subscription version is also set to v25.0.
API version setting in Advanced Settings

​
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 Facebook Pages. For step-by-step instructions, see the Facebook Messenger Connection Guide.