CognoThe Messenger integration is receive-only. "Receive-only" means Cogno never sends to Messenger — not that it captures only one side. Cogno ingests the whole conversation on a Facebook Page (both the contact's messages and the Page's own replies) and uses it as workspace context and tasks. Cogno never auto-replies or delivers notifications back to Messenger.
It works in two parts.
- Connection (OAuth): authorizes Cogno to work with your Facebook Page. You pick the Page through Facebook Login.
- Receiving (Webhook): the path that delivers the Page conversation (both the contact's messages and the Page's replies) to Cogno. This is configured on the Meta app side.
Before you start
- You are the owner of the Cogno workspace.
- You can sign in with a Facebook account that manages the source Page.
- The Meta app side is already set up (app created, Messenger settings, Facebook Login settings, Webhook settings).
- This Meta setup is an admin task. If it is not done, ask your admin first.
- For a shared team integration, use an operations account that will not break when an individual leaves or loses access.
Connect Messenger in Cogno
- Open the Cogno app.
- Open Integrations for the target workspace.
- Select Messenger.
- Click Connect Messenger.
- In the Facebook authorization screen, review and approve what Cogno may access.
- The Cogno screen switches to Page selection.
Once connected, Cogno stores the OAuth connection and lets you continue to Page selection.
Select a Facebook Page
- In the Facebook Page section, review the Pages managed by the connected account. If none appear, click Refresh.
- Click Select on the Page you want to receive from.
- On selection, Cogno subscribes that Page to webhooks automatically.
From then on, the Page conversation (both directions) is delivered to Cogno.
About sender names
Contact display names are resolved automatically from the Facebook profile — there is no manual mapping step. A Messenger contact is an external party, not a workspace member, so there is nothing to link them to (and no UI for it). The Page's own replies are recorded under the Page's name.
Common states
| State | Meaning | Next action |
|---|---|---|
| Stuck on the Connect screen | OAuth finished but the connection row is not created yet | Wait a few seconds and refresh. If it persists, ask admin to check Meta setup |
| Page list is empty | Pages managed by the connected account could not be fetched | Click Refresh. Confirm the account manages the target Page |
| "App Not Active" | The Meta app is in development mode and the account has no role | Ask admin to add you as a tester and accept the invite (or connect with the admin account) |
| Can't load URL / connection failed | Meta-side OAuth redirect settings are incomplete | Ask admin to check the Facebook Login redirect URI settings |
| Messages do not reach Cogno | Page webhook subscription or Meta webhook settings incomplete | Re-select the Page. Ask admin to verify webhook subscription state |
Notes
- Messenger is receive-only. There is no automatic reply or notification delivery from Cogno.
- Instagram direct messages use a different API and are out of scope for this integration.
- To offer Page connection to arbitrary users, the Meta app must be published (App Review + Business Verification). During development, only accounts with an app role (admin/tester) can connect.