Connect Facebook Messenger

Step-by-step guide to get your Meta Graph API credentials for Facebook Messenger

📋 Prerequisites

  • Facebook Business Page (not personal profile)
  • Admin access to the Facebook Page
  • Meta Business Account (verified)

🚀 Step 1: Create Meta App

  1. Go to Meta for Developers
  2. Click "Create App"
  3. Select "Business" as app type
  4. Fill in app details:
    • App Name: Your company name
    • Contact Email: Your email
    • Business Account: Select your Meta Business Account
  5. Click "Create App"

🔧 Step 2: Add Messenger Product

  1. In your app dashboard, find "Messenger" product
  2. Click "Set Up"
  3. Scroll to "Access Tokens" section
  4. Click "Add or Remove Pages"
  5. Select your Facebook Page and authorize
  6. Click "Generate Token" for your page
  7. Copy the Page Access Token (starts with EAAA...)

🔑 Step 3: Get Your Credentials

Meta App ID:

Go to App Settings → Basic, copy "App ID"

Meta App Secret:

In the same page, copy "App Secret" (click "Show")

Facebook Page ID:

  1. Go to your Facebook Page
  2. Click "Settings"
  3. Scroll to "About" section
  4. Find "Page ID" and copy the number

🪝 Step 4: Set Up Webhooks

  1. In your Meta App, go to Messenger → Settings
  2. Scroll to "Webhooks" section
  3. Click "Add Callback URL"
  4. Enter Callback URL: https://yourdomain.com/api/v1/webhooks/360dialog
  5. Enter Verify Token: Use the token from your backend env
  6. Click "Verify and Save"
  7. Subscribe to webhook fields:
    • messages
    • messaging_postbacks
    • message_deliveries
    • message_reads

🎯 Step 5: Request Permissions

For your app to work in production, you need to request permissions:

  1. Go to App Review → Permissions and Features
  2. Request these permissions:
    • pages_messaging
    • pages_manage_metadata
  3. Fill in the required information
  4. Submit for review (usually takes 3-5 business days)

⚠️ Important Notes

  • • Page Access Tokens don't expire if page permissions remain unchanged
  • • Test in Development Mode before submitting for review
  • • Only page admins can test during development
  • • Rate limits: 200 API calls per hour per user
  • • 24-hour messaging window applies (outside window requires message templates)

✅ Final Step: Enter in Settings

Once you have all credentials, go to your Settings → Socials page and enter:

  • Meta Access Token (Page Access Token)
  • Meta App ID
  • Meta App Secret
  • Facebook Page ID

Click "Save & Connect" to test the connection!