Manage Conversations Addresses for Facebook Messenger (Public Beta)

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.

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

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.

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.

   Expand image

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:

1
// Download the helper library from https://www.twilio.com/docs/node/install
2
const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
3

4
// Find your Account SID and Auth Token at twilio.com/console
5
// and set the environment variables. See http://twil.io/secure
6
const accountSid = process.env.TWILIO_ACCOUNT_SID;
7
const authToken = process.env.TWILIO_AUTH_TOKEN;
8
const client = twilio(accountSid, authToken);
9

10
async function createConfigurationAddress() {
11
  const addressConfiguration =
12
    await client.conversations.v1.addressConfigurations.create({
13
      address: "messenger:<facebook_page_id>",
14
      "autoCreation.enabled": true,
15
      "autoCreation.studioFlowSid": "FWXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
16
      "autoCreation.studioRetryCount": 3,
17
      "autoCreation.type": "studio",
18
      type: "messenger",
19
    });
20

21
  console.log(addressConfiguration.sid);
22
}
23

24
createConfigurationAddress();

1
{
2
  "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
3
  "sid": "IGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
4
  "address": "messenger:<facebook_page_id>",
5
  "type": "messenger",
6
  "friendly_name": "My Test Configuration",
7
  "address_country": "CA",
8
  "auto_creation": {
9
    "enabled": true,
10
    "type": "webhook",
11
    "conversation_service_sid": "ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
12
    "webhook_url": "https://example.com",
13
    "webhook_method": "POST",
14
    "webhook_filters": [
15
      "onParticipantAdded",
16
      "onMessageAdded"
17
    ]
18
  },
19
  "date_created": "2016-03-24T21:05:50Z",
20
  "date_updated": "2016-03-24T21:05:50Z",
21
  "url": "https://conversations.twilio.com/v1/Configuration/Addresses/IGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
22
}

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.

Expand image

• Facebook Messenger Setup
• Configure pre-agent workflow with Studio