Skip to main content

​
Overview

Facebook Messenger integration allows your agent to respond to messages sent to your Facebook Business Page.

2.9B Users

Massive Facebook user base

Page Integration

Connect to business page

Rich Media

Images, videos, buttons

Social Context

See user’s public profile

​
Prerequisites

1

Facebook Business Page

Must have admin access to a Facebook Page
Facebook Page
Screenshot: Your Facebook Business Page
2

Facebook App (Optional for CLI)

Create at https://developers.facebook.comOnly needed for CLI method

​
Facebook OAuth Flow

1

Open Admin Dashboard

lua admin
Navigate to: Channels → Connect New Channel
Connect channel
Screenshot: Connect New Channel button
2

Click Facebook Messenger

Facebook tile
Screenshot: Facebook Messenger option in channel grid
3

Facebook Authorization Popup

Click “Connect with Facebook”
OAuth popup
Screenshot: “Connect with Facebook” button that triggers OAuth
4

Login to Facebook

Facebook OAuth window opens
Facebook login
Screenshot: Facebook login dialog
5

Select Your Page

Choose which page to connect
Page selection
Screenshot: List of your pages with radio buttons/checkboxes
6

Grant Permissions

Approve messaging permissions
Grant permissions
Screenshot: Permission screen showing “Manage and access Page conversations in Messenger”
7

Connection Complete

Returns to admin with success message
Connected
Screenshot: Success message showing connected page name and details

​
Connection Method 2: CLI (Advanced)

​
CLI Setup with Page Token

1

Get Page Access Token

From Facebook App Dashboard:
  1. Go to your app
  2. Messenger → Settings
  3. Generate Page Access Token
  4. Copy token
Generate token
Screenshot: Token generation in Facebook App
2

Get Page ID

From your Facebook Page:
  1. Go to page settings
  2. Copy Page ID
Or from URL: facebook.com/[page-id]
3

Run lua channels

$ lua channels
✅ Using agent: myAgent

? What would you like to do? 🔗 Link new channel
? Select channel type: 💬 Facebook Messenger

? Enter Facebook page access token: ****
? Enter Facebook page ID: 705555819301071

📡 Creating Facebook channel...

✅ Facebook channel created successfully!

💬 Page Name: My Business Page
📄 Category: Local Business
🔗 Webhook: https://wa.heylua.ai/fb/webhook/xyz789
4

Configure Webhook in Facebook App

  1. Go to App Dashboard
  2. Messenger → Settings → Webhooks
  3. Click “Add Callback URL”
  4. Paste webhook URL
  5. Enter verify token (optional)
  6. Subscribe to:
    • messages
    • messaging_postbacks
    • messaging_optins
Webhook setup
Screenshot: Facebook webhook configuration screen

​
Testing

1

Send Message to Page

Open Messenger and message your page
Send test
Screenshot: Messenger conversation sending “Hi!”
2

Agent Responds

Agent response
Screenshot: Agent’s response in Messenger
3

View in Admin

Monitor conversation in admin dashboard
Admin conversation
Screenshot: Admin dashboard showing the conversation

​
Features

Text Messages

Send and receive text

Rich Media

Images, videos, files

Quick Replies

Suggested response buttons

Templates

Reusable message templates

​
Best Practices

  • Respond quickly (within minutes)
  • Facebook shows “Typically responds in…”
  • Fast responses improve visibility
  • Set greeting message
  • Configure away message
  • Use quick replies
  • Add call-to-action buttons
  • Check page rating regularly
  • Respond to all messages
  • Address negative feedback

​
Next Steps

Instagram

Connect Instagram DMs

Email

Add email support