Connect Messenger
Bring your Facebook Page messages into the inbox and let the AI agent reply on Messenger, step by step.
Once connected, anyone who messages your agency's Facebook Page lands in your inbox, and the AI agent replies on Messenger. Messenger is available on Growth and Pro (and during the free trial).
You connect through your agency's own Meta app. If you already connected WhatsApp, you can reuse the same app and System user.
Want us to do it for you?
The Meta setup add-on: our team sets up WhatsApp, Messenger and Instagram for you. A one-time 1,500 EGP / $49 on Starter and Growth, and included in Pro. Request it from Settings → Plan & billing (Add-ons).
Before you start
- A Facebook Page for your agency, added to your Business portfolio at business.facebook.com.
- A developer account at developers.facebook.com.
- In Flyby: you're the owner or a manager, on Growth or Pro.
Part 1: The Meta app and the token
Prepare the app
- Already have an app from WhatsApp? Open it, go to Use cases, click Add use case and choose Engage with customers on Messenger from Meta.
- No app yet? At developers.facebook.com/apps click Create app, choose the Messenger use case and the Business type, and link it to your Business portfolio.
Then connect your Facebook Page to the app from the Messenger settings (Messenger API Settings).
Create a System user (or reuse yours)
- Business Settings → Users → System users → Add.
- Enter a name and choose the Admin role.
If you have a System user from WhatsApp, use it and carry on.
Give it access to the app and the Page
Under Assign assets:
- Apps → your app → Manage app.
- Pages → your agency's Page → Full control, including messaging.
- Save changes.
Don't skip this
If the System user has no access to the Page, Flyby can't get the Page token and you'll see a no_page_token error.
Generate the token
- Generate new token → choose your app.
- Token expiration: Never.
- Permissions:
pages_messagingpages_manage_metadatapages_show_listpages_read_engagementbusiness_management(optional)pages_read_user_contentandpages_manage_engagement(only for comment replies on your Page posts)
- Generate token and copy it right away.
Same System user as WhatsApp?
Your WhatsApp token doesn't include Page permissions. Generate a new token for Messenger with the permissions above. Each Flyby channel keeps its own token, so this doesn't affect WhatsApp.
Copy the App secret and the Page ID
- App secret: in your app → App settings → Basic → App secret → Show.
- Facebook Page ID: open your Page → About → Page transparency, or Business Settings → Accounts → Pages and select the Page.
Part 2: Connect in Flyby
Switch on Facebook Messenger
Open Settings → Channels & integrations and switch on Facebook Messenger.
Paste the details and click Connect
| Field | Value |
|---|---|
| System user access token | The new token with Page permissions |
| App secret | App settings → Basic |
| Facebook Page ID | Your Page's ID |
Flyby fetches the Page token itself and subscribes your Page to messages automatically (messages, messaging_postbacks, message_deliveries, message_reads). When it works, the badge turns Connected and your Page's name appears.
Part 3: The webhook in your Meta app
For Messenger you paste the webhook yourself at the app level. Flyby can't do this step for you.
Open the webhook settings
In your Meta app: Messenger → Settings → Webhooks (in the newer dashboard: Use cases → Customize → Messenger API Settings → Configure webhooks).
Paste the URL and token
- Callback URL: copy it from Flyby (the Webhook box).
- Verify token: copy it from the same place.
Click Verify and save. When it works, Verified updates in Flyby.
Subscribe to the fields
Subscribe to:
messagesmessaging_postbacksmessage_deliveriesmessage_reads
If your Page isn't listed in the webhooks section, add it and click Subscribe next to it.
Part 4: Live mode and App Review
Switch the app to Live
At the top of the app dashboard switch App Mode to Live (Meta asks for a Privacy Policy URL in App settings → Basic: use your agency's own privacy page).
Request App Review
In Development mode or without approval, your Page only receives messages from app admins and testers. To receive messages from the public, Meta requires:
- App Review with Advanced Access for
pages_messaging. - Business verification of your Business portfolio.
In your app open App Review → Permissions and features, request Advanced Access, and explain that the app answers customer messages to your agency's Page through an AI assistant and a support team. Meta may ask for a short screencast.
Meta now asks you to become a Tech Provider before it accepts this request, even for an app that only serves your own Page. That needs business verification (your company's papers) and access verification, and can't be undone, so start it only when you can finish every step. Until then, messages arrive only from people with a role on your app.
Optional: Human Agent
Once Human Agent is approved in App Review, your team can reply for up to 7 days after the customer's last message (Flyby adds the HUMAN_AGENT tag to team replies after 24 hours automatically). Without it, all replies are limited to 24 hours. The AI itself never replies after 24 hours.
Test the connection
- From a Facebook account that isn't a Page admin (or a tester account while the app is in review), message your Page.
- In Flyby, Last event updates.
- In Conversations you'll find a new Messenger conversation with the AI's reply. The customer sees "seen" and "typing…".
Customer names
Messenger doesn't send the customer's name with the message, so Flyby tries to look it up once. That needs Business Asset User Profile Access on your app. Without it, the conversation shows without a name until the AI asks the customer.