Skip to main content
Connect your Facebook Page to Chatwoot to manage Messenger conversations alongside other channels in a unified inbox.

​
Prerequisites

  • A Facebook Page (not a personal profile)
  • Admin access to the Facebook Page
  • Facebook account with appropriate permissions

​
Setup

1

Navigate to inbox settings

Go to Settings → Inboxes → Add Inbox → Messenger
2

Authorize Facebook

Click Sign in with Facebook and authorize Chatwoot to access your pages.You’ll need to grant these permissions:
  • pages_show_list - View list of pages you manage
  • pages_messaging - Send and receive messages
  • pages_read_engagement - Read page content
  • pages_manage_metadata - Manage page settings
3

Select your page

Choose which Facebook Page to connect from the list of pages you manage.
4

Configure inbox settings

  • Add agents to the inbox
  • Configure auto-assignment rules
  • Set business hours
5

Test the integration

Send a test message to your Facebook Page. It should appear in Chatwoot within seconds.

​
Features

  • Real-time messaging - Instant message sync
  • Message templates - Use Facebook approved message templates
  • Rich media - Send images, videos, files
  • Conversation history - Access past conversations
  • Page mentions - Get notified when your page is mentioned
  • Handoff protocol - Transfer conversations to human agents

​
Message Templates

For sending messages outside the 24-hour response window, use Facebook approved message templates:
  1. Create templates in Facebook Business Manager
  2. Get template approval from Facebook
  3. Use templates in Chatwoot conversations

​
Best Practices

Respond within 24 hours to maintain high response rate
Use canned responses for common questions
Set up automation rules for common scenarios
Keep Facebook Page published and active
Monitor connection status regularly

​
Troubleshooting

  • Reconnect your Facebook Page in inbox settings
  • Check Facebook permissions are granted
  • Verify page is published
  • Check Chatwoot logs for API errors
  • Check if 24-hour messaging window has passed
  • Use message templates for messages outside window
  • Verify page token is valid
  • Ensure page is not restricted by Facebook
  • Clear browser cache and cookies
  • Try different browser
  • Check if Facebook account has admin access to page
  • Ensure business verification is complete (if required)

​
Limitations

  • Facebook has a 24-hour messaging window for promotional messages
  • Message templates require Facebook approval
  • Some Facebook features (buttons, cards) may not render in Chatwoot
  • Rate limits apply based on page tier

Build docs developers (and LLMs) love

Get started for freeTalk to us