Skip to main content

๐Ÿ’™ Facebook Messenger

PulseHub receives and sends Facebook Messenger messages via the Meta Graph API.

Prerequisitesโ€‹

  1. A Facebook Page
  2. A Meta Developer App with the Messenger product added
  3. The pages_messaging permission

Setup Stepsโ€‹

1. Create/Configure Your Meta Appโ€‹

  1. At developers.facebook.com, open your app
  2. Add the Messenger product
  3. Under Messenger โ†’ Settings, link your Facebook Page

2. Get Your Credentialsโ€‹

CredentialWhere to Find
Page Access TokenMessenger โ†’ Settings โ†’ Access Tokens โ†’ Generate for your Page
App SecretApp Dashboard โ†’ Settings โ†’ Basic โ†’ App Secret
Verify TokenA string you define (any random secure string)

3. Add the Channel in PulseHubโ€‹

  1. Go to Channels โ†’ Add Channel
  2. Select Facebook Messenger
  3. Fill in Page Access Token, App Secret, and Verify Token
  4. Click Save Channel
  5. Copy the Webhook URL

4. Configure the Webhook in Metaโ€‹

  1. Go to Messenger โ†’ Settings โ†’ Webhooks
  2. Click Add Callback URL
  3. Enter your PulseHub webhook URL and Verify Token
  4. Subscribe to: messages, messaging_postbacks

24-Hour Messaging Windowโ€‹

Facebook Messenger has a Standard Messaging policy: you can only send free-form messages within 24 hours of the last customer message.

Common Issuesโ€‹

SymptomLikely Cause
Webhook verification failsVerify Token mismatch or webhook URL unreachable
Messages not receivedPage not subscribed to webhook
Replies fail after 24 hoursStandard Messaging window expired