Facebook Messenger

profClaw integrates with Facebook Messenger through the Meta Messenger Platform. The bot is attached to a Facebook Page and responds to messages sent to that page.

Capabilities

Feature	Supported
1:1 messaging	Yes
Quick replies	Yes
Persistent menu	Yes
Generic templates	Yes
Media messages	Yes
Webhook	Yes
Page subscription	Yes

Setup

Create a Facebook App

Go to developers.facebook.com and create a new app. Choose Business type.

Add Messenger Product

Under your app, add the Messenger product.

Link to a Facebook Page

Under Messenger > Settings, generate a Page Access Token for your Facebook Page.

Configure webhook

Set webhook URL to: https://your-domain.com/webhooks/messengerSet a verify token (any string you choose) and subscribe to messages and messaging_postbacks.

Configure profClaw

MESSENGER_PAGE_ACCESS_TOKEN=EAABwzLixnjYBO...
MESSENGER_VERIFY_TOKEN=my-verify-token
MESSENGER_APP_SECRET=your-app-secret

Environment Variables

string

required

Facebook Page access token (from Meta Developer portal).

string

required

Your custom verify token for webhook setup.

string

required

App secret for request signature verification.

Configuration Example

.env
settings.yml

MESSENGER_PAGE_ACCESS_TOKEN=EAABwzLixnjYBO...
MESSENGER_VERIFY_TOKEN=my-verify-token
MESSENGER_APP_SECRET=abc123def456

chat:
  messenger:
    page_access_token: "${MESSENGER_PAGE_ACCESS_TOKEN}"
    verify_token: "${MESSENGER_VERIFY_TOKEN}"
    app_secret: "${MESSENGER_APP_SECRET}"

Message Templates

profClaw can send rich templates:

{
  "recipient": { "id": "user-psid" },
  "message": {
    "attachment": {
      "type": "template",
      "payload": {
        "template_type": "button",
        "text": "What would you like to do?",
        "buttons": [
          { "type": "postback", "title": "Get Status", "payload": "STATUS" }
        ]
      }
    }
  }
}

Notes

Status: Beta
Requires a public HTTPS webhook URL.
Messenger Platform requires App Review for production use with more than 5 testers.
After App Review, the bot can message any Facebook user who messages the page.
GDPR compliance: Users can opt-out via the standard Messenger controls.

Chat Providers Overview - Compare all 27 supported channels
WhatsApp - Meta’s other messaging platform for business
Viber - Similar audience in Eastern Europe and Southeast Asia
profclaw channels - Enable and test the Messenger connection from the CLI

​Capabilities

​Setup

​Environment Variables

​Configuration Example

​Message Templates

​Notes

​Related

Capabilities

Setup

Environment Variables

Configuration Example

Message Templates

Notes

Related