Winora
Back to docs

Integrations

Facebook Messenger channel

Receive Facebook Messenger messages from your Page directly in your Winora inbox.

Facebook Messenger channel

Connect your Facebook Page to Winora so that Messenger messages from customers appear directly in your inbox. Agents can reply without leaving Winora.

Prerequisites

  • A Facebook Business Page (must be an Admin of the Page)
  • A Meta for Developers account
  • Owner or Admin role in your Winora workspace

Step 1 — Create a Meta App

  1. Go to developers.facebook.com/apps.
  2. Click Create App → choose Business type.
  3. Name the app and connect it to your Business Manager.
  4. On the app dashboard, click Add product → Messenger → Set up.

Step 2 — Generate a Page Access Token

  1. In the Messenger settings, scroll to Access tokens.
  2. Click Add or remove Pages and connect your Facebook Page.
  3. Copy the Page Access Token that appears.

Step 3 — Create a Verify Token

Choose any string you like (e.g. winora-messenger-xyz). You will need this in both Winora and in your Meta app webhook settings. Keep it secret.

Step 4 — Connect Messenger in Winora

  1. Go to Settings → Integrations → Facebook Messenger.
  2. Click Connect.
  3. Enter:
    • Page Access Token (from Step 2)
    • Verify Token (the string you chose in Step 3)
    • Facebook Page ID (found in your Page's About section)
  4. Click Save & Connect.
  5. Copy the Webhook callback URL shown in the modal.

Step 5 — Configure the Meta webhook

  1. In your Meta app, go to Messenger → Settings → Webhooks.
  2. Click Add callback URL.
  3. Paste the Winora webhook URL:
    https://app.winora.dev/api/v1/messenger/webhook?workspace=YOUR_WORKSPACE_ID
  4. Enter your Verify Token (same string you used in Step 4).
  5. Click Verify and save.
  6. Under Webhook fields, subscribe to the messages field.

How it works

When a customer sends a message to your Facebook Page via Messenger:

  • Meta forwards it to the Winora webhook.
  • Winora finds or creates a contact using the sender's Facebook user ID.
  • A new conversation (or existing open one) is created with channel messenger.
  • The message appears in the Winora inbox.

Filtering by channel

In the inbox, use the Channel → Messenger filter to view only Facebook Messenger conversations.

Note on Facebook App Review

For production use with members of the public (not just app testers), Meta requires your app to go through App Review and be approved for the pages_messaging permission. You can test with Page admins and testers without review.