Skip to main content
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

FeatureSupported
1:1 messagingYes
Quick repliesYes
Persistent menuYes
Generic templatesYes
Media messagesYes
WebhookYes
Page subscriptionYes

Setup

1

Create a Facebook App

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

Add Messenger Product

Under your app, add the Messenger product.
3

Link to a Facebook Page

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

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.
5

Configure profClaw

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

Environment Variables

MESSENGER_PAGE_ACCESS_TOKEN
string
required
Facebook Page access token (from Meta Developer portal).
MESSENGER_VERIFY_TOKEN
string
required
Your custom verify token for webhook setup.
MESSENGER_APP_SECRET
string
required
App secret for request signature verification.

Configuration Example

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

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.