Manage Conversations Addresses for Facebook Messenger (Public Beta)

Public Beta
Facebook Messenger for Flex is currently available as a Public Beta product and the information contained in this document is subject to change. This means that some features are not yet implemented and others may be changed before the product is declared as Generally Available. Public Beta products are not covered by a Twilio SLA.

Not a HIPAA Eligible Service
Facebook Messenger for Flex is not a HIPAA Eligible Service and cannot be used in Flex workflows that are subject to HIPAA.


This guide describes how to set up Facebook Messenger as a Flex Conversations channel. Once configured, agents in Flex can receive and reply to messages that come from Facebook Pages. Customers must message agents first, as agent-initiated outbound messages are not supported. For more details, see Facebook’s messaging policy. Messages can include text, images, and file attachments.

Some benefits of using Facebook Messenger with Flex include:

  • Customers who find your business through Facebook can contact you right away.
  • Supervisors can see live and historic data in the Flex dashboard and reports.
  • Admins can configure Studio flow responses so customers instantly receive auto-replies.


For limitations, see File Attachments and API Limits and Known Issues.

Connect Facebook Messenger to Flex


  • Twilio Console account with Admin access
  • Flex UI v2.4.x or later
  • Facebook Page for your business

Step 1: Connect your Facebook Page in the Twilio Console

  1. In the Twilio Console, from the Develop sidebar, click Explore Products.
  2. Under Marketplace, click Channels.
    Tip: To pin Channels to the sidebar for access later, click the pin icon.
  3. In the sidebar, click Facebook Messenger.
  4. Click Enable Facebook Messenger.
  5. Click Log in with Facebook.
  6. A Facebook login page appears. Log in to Facebook, and select the Facebook Page that you want Twilio to access.
  7. In the Create your first sender window, select the Page you’d like to connect. A Sender is the address used when you communicate with customers.
    Note: A Facebook page can be linked to only one Twilio Account.
  8. Review the terms of service, and select the checkbox to acknowledge and agree to them.
  9. Click Submit.

For more detailed information on setup and functionality, see Facebook Messenger Setup.

Step 2: Create a Conversations address for your Facebook Page

To receive and reply to messages in Flex, create a Conversations address through the Console or using the API.


  1. In the sidebar, select Flex > Manage > Messaging.
  2. Click Create New Address.
  3. From the Address Type list, select Facebook Messenger.
  4. From the Facebook page list, select the page you connected.
  5. From the Integration type list, select how you’d like conversations to pass to Flex, via Studio or Webhook.
    - If you selected Studio, from the Studio Flow list, you can select the out-of-box Messaging Flow, unless you have removed or changed your studio flow. If you’ve changed your studio flow, make sure the Incoming Conversations trigger connects to the Send to Flex widget.
    - To learn more about configuring Studio Flows, see Configure pre-agent workflow with Studio.
  6. Click Create Address.


You can programmatically create and manage a Messenger address using the Conversations API's Address Configuration Resource. The example below includes a retry count:

Loading Code Sample...

        Create a Facebook Messenger Address via the API

        Step 3: Send and receive your first Facebook Messenger message in the Flex UI

        1. Open the Flex UI and log in as an agent.
        2. Set your status to Available.
        3. From a different Facebook profile, send a message to the Facebook Page that you connected to Flex.
        4. In the Flex UI, accept the Incoming messenger request and type a reply. The reply appears in Facebook Messenger.


        Related documentation

        Rate this page:

        Need some help?

        We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.

        Thank you for your feedback!

        Please select the reason(s) for your feedback. The additional information you provide helps us improve our documentation:

        Sending your feedback...
        🎉 Thank you for your feedback!
        Something went wrong. Please try again.

        Thanks for your feedback!