1 Sep 2026 · 12 min read
Connect Facebook Messenger to the ConveRact inbox
Create the Meta app and Page connection, issue the correct Page token, configure secure webhooks, test as a real visitor, and prepare the app for production.
By ConveRact Channel Engineering
•
Reviewed for production implementation
WHAT YOU WILL LEARN
Facebook Page prerequisites
Page token and webhook setup
Real visitor and handover testing
01
Prepare the Facebook Page and Meta app
Messenger conversations are attached to a Facebook Page. Confirm that the client owns the Page and that the person completing setup has sufficient Page and app permissions. Avoid connecting an employee-owned test Page to a production tenant.
Create or select a Meta Business app and add the Messenger product. Keep development and production assets clearly labelled, because app-mode and role restrictions can make a connection appear healthy while messages from ordinary customers are still blocked.
STEP BY STEP
- 1
Create or select the client Facebook Page.
- 2
Create or select a client-owned Meta Business app.
- 3
Add Messenger to the app.
- 4
Connect the Facebook Page in the Messenger settings.
- 5
Add test users or roles needed during development.
LAUNCH CHECK
Client owns Page
Client owns app
Messenger product enabled
Page connected to app
02
Collect the Page credentials
ConveRact needs the Facebook Page ID, a Page access token, and the Meta app secret. The token must belong to the Page being connected. Verify the Page identity and granted tasks before saving it.
Treat the Page token and app secret like passwords. ConveRact stores them encrypted; the browser should never receive them again after save.
STEP BY STEP
- 1
Copy the numeric Page ID from the Page or Meta Business settings.
- 2
Generate the Page access token from the connected Messenger configuration.
- 3
Verify that the token resolves the expected Page.
- 4
Copy the Meta App Secret from App settings → Basic.
OFFICIAL LINKS
LAUNCH CHECK
Page ID verified
Page token verified
App secret available
No secret stored in client code
03
Connect Messenger in ConveRact
Open the correct workspace as Tenant Admin, select Facebook Messenger in Channels, and create a live connection. Meta channels require the Growth plan or above.
After saving, ConveRact shows the callback URL and verify token that belong to the connection. Do not reuse a callback from a different tenant.
STEP BY STEP
- 1
Open ConveRact → Channels → Facebook Messenger → Connect.
- 2
Enter the connection name and Facebook Page ID.
- 3
Paste the Page access token and Meta app secret.
- 4
Save the connection.
- 5
Open Connection details and copy the webhook URL and verify token.
LAUNCH CHECK
Correct workspace selected
Live mode saved
Webhook details copied
Raw secrets no longer visible
04
Configure and test the webhook
In the Messenger product settings, add the ConveRact callback URL and verify token, then subscribe the Page to the required messaging fields. ConveRact validates signed webhook requests before routing messages to the tenant inbox.
Test with a Facebook account that is not administering the Page. Confirm the inbound message, AI reply, delivery state, staff reply, AI pause during handover, and AI resume behavior.
STEP BY STEP
- 1
Add the ConveRact callback URL under Messenger webhooks.
- 2
Paste the ConveRact verify token and complete verification.
- 3
Subscribe to messages and messaging_postbacks.
- 4
Subscribe the intended Page to the app.
- 5
Send a message as a real visitor and verify the complete ConveRact timeline.
OFFICIAL LINKS
LAUNCH CHECK
Webhook verified
Page subscribed
Non-admin test passed
Human handover tested
05
Publish and operate safely
Complete all app review and business verification tasks required for the permissions used. Publish accurate privacy and data-deletion information and document who owns the Page, app, token, and renewal process.
Monitor token errors, permission changes, Page disconnection, webhook retries, response latency, opt-outs, AI handovers, and failed outbound sends. Re-test after changing Page access, app mode, provider permissions, or ConveRact business rules.
OFFICIAL LINKS
LAUNCH CHECK
App review complete where required
App moved to correct mode
Monitoring enabled
Rotation and incident owner assigned
Put this guide into practice
ConveRact exposes setup steps, credential tests, connection health, role controls, and post-connect guidance inside the workspace.
Open workspace