Integration Guide: Linking a Facebook Page for Messenger

You can connect a Facebook Page to create a Messenger channel in your RapidPro.app workspace in just a few steps. The connection flow uses Facebook (Meta) authorization to grant access to your business/pages, then completes setup back in RapidPro.app. This guide walks you through adding the Page, enabling Messenger triggers, and troubleshooting reconnects if the channel stops working.
Reading time
4–6 min read
Category
Channels
Updated on
Updated on: 22/12/2025

Quick setup checklist

  1. Start adding a new Messenger channel
  2. Authorize RapidPro App and add your Facebook Page
  3. Select the Page(s) to connect and finish setup
  4. Add Messenger triggers for new conversations
  5. Use opt-ins to message outside the 24-hour window
  6. Troubleshoot and reconnect if needed
Step 1
Start adding a new Messenger channel

  1. Go to Workspace Settings.
  2. Click + New Channel.
  3. Scroll down to the Facebook Messenger section.

[CAPTURE: Workspace Settings showing “+ New Channel” and the Facebook Messenger section.]

Step 2
Authorize RapidPro App and add your Facebook Page

  1. Read the directions shown in the Messenger section.
  2. Click Add Facebook Page.
  3. Log in to your Facebook account (if prompted).
  4. Choose what you want to grant RapidPro App access to:
    • a specific business, or
    • all current and future businesses

[CAPTURE: Facebook authorization screen showing business access options.]

💡
Tip: If you manage multiple Pages across multiple businesses, keep access as narrow as possible to reduce confusion later.

Step 3
Select the Page(s) to connect and finish setup

  1. Choose which Facebook Page(s) you want to give RapidPro App access to:
    • all current and future pages, or
    • select specific pages by checking their boxes
  2. Approve the remaining permission steps.
  3. You’ll be redirected back to RapidPro.app:
    • select the Page you’re adding
    • complete the final steps

Result: After completion, you’ll land on the new channel page, where you can view the channel log.

[CAPTURE: RapidPro.app page listing available pages to connect + confirmation of the new channel.]

⚙️
Technical Detail: If you previously integrated a bot under older Messenger policies, you typically don’t need to change anything—existing channels should continue working.

Step 4
Add Messenger triggers for new conversations

Once your channel is connected, you can create a trigger to start a flow when a new Messenger conversation begins.

  1. Go to your Triggers area (or the location in your workspace where triggers are managed).
  2. Create a new trigger for Messenger.
  3. Select the event such as New conversation started (or equivalent).
  4. Select the flow you want to start for new conversations.
  5. Save.

[CAPTURE: Trigger setup showing “New conversation started” (or equivalent) for Messenger.]

💡
Tip: Keep your welcome flow short and clear (what the bot can do + a simple first question) so users don’t drop off.

Step 5
Use opt-ins to message outside the 24-hour window

Meta supports sending an opt-in request so you can message contacts outside the standard 24-hour messaging window.

  • Use opt-ins when you need to send follow-ups after a conversation becomes inactive.
  • Keep opt-in messaging explicit so users understand what they’re agreeing to receive.
Step 6
Reconnect your Page if the channel stops working

If your Messenger integration has issues, you usually do not need to remove the channel. Reconnect refreshes authentication and often resolves the issue.

  1. Go to Workspace Settings → Channels.
  2. Open your Messenger channel page.
  3. Open the channel menu (☰ / ⋮) and click Reconnect.
  4. Re-test inbound and outbound messaging.

[CAPTURE: Channel page menu showing the “Reconnect” option.]

Common Issues

I don’t see my Page in the list

Fixes:

  • Confirm you have the right permissions on the Page (admin/editor level).
  • Re-run the connection flow and ensure you selected the correct business/page access.
  • If you selected “specific pages,” confirm the correct Page checkbox was enabled during authorization.
The channel was working, then stopped

Fixes:

  • Use Reconnect from the channel page to refresh authentication.
  • Check the channel log for errors and timestamps (it helps identify whether the issue is auth-related).
I can’t message outside the 24-hour window

Fixes:

  • Use Meta’s opt-in request feature so you can message outside the standard window.
  • Adjust your flow design so important follow-ups are delivered within the allowed window whenever possible.
Related Resources
Discover Facebook Messenger: Features and Rules
Understanding Channels: Types, Roles, and Connection Limits
Quick Guide: How to Add a New Channel to Your Workspace
Channel Priority: Managing a Contact’s Preferred Channel