Skip to contentSkip to navigationSkip to topbar
Rate this page:
On this page

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.


overview page anchor

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(link takes you to an external page). 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.


limitations page anchor

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

Connect Facebook Messenger to Flex

connect-facebook-messenger-to-flex page anchor

Step 1: Connect your Facebook Page in the Twilio Console

step-1-connect-your-facebook-page-in-the-twilio-console page anchor
  1. In the Twilio Console(link takes you to an external page) , 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

step-2-create-a-conversations-address-for-your-facebook-page page anchor

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


console page anchor
  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:

Create a Facebook Messenger Address via the API

create-a-facebook-messenger-address-via-the-api page anchor

// Download the helper library from
// Find your Account SID and Auth Token at
// and set the environment variables. See
const accountSid = process.env.TWILIO_ACCOUNT_SID;
const authToken = process.env.TWILIO_AUTH_TOKEN;
const client = require('twilio')(accountSid, authToken);
'autoCreation.enabled': true,
'autoCreation.type': 'studio',
'autoCreation.studioRetryCount': 3,
type: 'messenger',
address: 'messenger:<facebook_page_id>'
.then(address_configuration => console.log(address_configuration.sid));


"address": "messenger:<facebook_page_id>",
"type": "messenger",
"friendly_name": "My Test Configuration",
"address_country": "CA",
"auto_creation": {
"enabled": true,
"type": "webhook",
"webhook_url": "",
"webhook_method": "POST",
"webhook_filters": [
"date_created": "2016-03-24T21:05:50Z",
"date_updated": "2016-03-24T21:05:50Z",
"url": ""

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

step-3-send-and-receive-your-first-facebook-messenger-message-in-the-flex-ui page anchor
  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(link takes you to an external 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.

Rate this page: