Facebook Messenger Integration
Connect your Facebook Page to receive and reply to customer Messenger messages inside Fiko. Once connected, Messenger conversations appear in your inbox alongside all other channels.
Direct Meta API
Direct integration with Facebook Messenger Platform via Meta's Graph API — no third-party intermediary.
Real-time messaging
Receive and reply to Messenger page messages in real time from your Fiko inbox.
Custom webhook
Fiko generates a webhook URL for you. Paste it into your Facebook App — no server setup required.
Before you start
You will need the following from your Facebook Developer App and Facebook Page before beginning setup. Collect these before clicking Connect Messenger.
Facebook Page with Messenger enabled
The Facebook Page whose messages you want to receive in Fiko.
Facebook App ID
Your Facebook App's numeric ID. Found in Meta for Developers → your App → Settings → Basic.
App Secret
Your Facebook App's secret key. Found on the same Settings → Basic page, next to the App ID.
Page Access Token
A Facebook Page access token with Messenger permissions. Generate this in Meta for Developers → your App → Messenger → Page Access Tokens.
Page ID
Your Facebook Page's numeric ID. Find it in your Page settings or About section.
Verify Token
A custom string you create. Meta uses this to confirm you own the webhook. You will enter the same value in both Fiko and your Facebook App settings.
How to connect Facebook Messenger
Step 1 — Open the Messenger settings page
- 1In the main sidebar, click Apps.
- 2Under Channels in the Apps sidebar, click Facebook Messenger.
- 3Click Connect Messenger (if no pages are connected yet) or Connect New (to add another page).
Step 2 — Select provider
- 4The Select provider step opens. One option is available: Facebook Messenger (Meta Direct API). Click it to select it.
Step 3 — Enter app credentials
- 5The App Credentials step opens. Enter your Facebook App ID. Find this in Meta for Developers → your App → Settings → Basic.
- 6Enter your App Secret. This appears on the same Settings → Basic page, next to the App ID. Click Next to continue.
Step 4 — Enter page access token
- 7The Page Access Token step opens. Enter your Facebook Page access token. Generate this in Meta for Developers → your App → Messenger → Page Access Tokens. Click Next to continue.
Step 5 — Enter page ID
- 8The Page ID step opens. Enter your Facebook Page's numeric ID. Find this in your Facebook Page settings or About section. Click Next to continue.
Step 6 — Set up webhook
- 9The Webhook Setup step shows your Webhook URL. Copy it using the copy button.
- 10In a new browser tab, open Meta for Developers → your App → Messenger → Webhooks. Paste the Webhook URL as the Callback URL and enter your Verify Token. Save.
Step 7 — Enable Live Mode
- 11The Enable Live Mode step prompts you to publish your Facebook App. In Meta for Developers, switch your app from Development to Live mode using the toggle in the top bar of the app dashboard. This is required before the integration can receive messages from real users.
Step 8 — Complete setup
- 12The Complete Setup step shows a summary of the configuration.
- 13Click Connect Messenger. A success toast confirms the connection. Messenger conversations from your Facebook Page now appear in your Fiko inbox.
Configuration fields
| Field | Required | Description | Validation |
|---|---|---|---|
| App ID | Yes | Facebook App's numeric ID. Found in Meta for Developers → your App → Settings → Basic. | Must not be empty |
| App Secret | Yes | Facebook App's secret key. Found on the same Settings → Basic page, next to the App ID. | Must not be empty |
| Page Access Token | Yes | Facebook Page access token with Messenger permissions | Must not be empty |
| Page ID | Yes | Facebook Page ID connected to Messenger | Numbers only |
| Verify Token | Yes | Custom token used by Meta to verify the webhook. Enter the same value in your Facebook App's webhook settings. | Must not be empty |
Who can access this page
The Facebook Messenger settings page is visible to users with the Company Admin or Viewer role.
Troubleshooting
"Company not found"
Your account is not associated with a company. Contact your administrator.
"Failed to create Messenger channel"
The connection failed. Check that your Page Access Token is valid, has Messenger permissions, and is not expired. Verify the Page ID matches the page the token belongs to.
Credential test does not complete
The test calls Meta's API and times out after 10 seconds. If it does not complete, check your internet connection or try again. Make sure the Page Access Token is not expired.
Page ID validation error
The Page ID field accepts numbers only. Make sure you are entering the numeric Page ID, not the Page name or username.
Needs product confirmation
- Whether Viewer-role users can submit the connect form or only view the page.
- Whether there is a limit on how many Facebook Pages can be connected per company.
- How to disconnect or delete a connected Messenger channel.
- Which rich media types (images, video, stickers) are supported via Messenger.
- What error message appears when Meta's API rejects the Page Access Token.