Using Facebook Messenger with Content Templates

1. A Facebook page for your business
2. A Facebook account with admin access for your business
3. Install Facebook Messenger Channel in the Twilio Console

For more information about the prerequisites of using Facebook Messenger with the Content API, see the Twilio FBM channel help article here.

• Twilio/location and twilio/list-picker do not work on FBM.

• FBM is in-session (user initiated) only. It means:

  • You will not be able to start a conversation with a user, only respond to them.

  • Once they've messaged you, you can respond any number of times within a 24 hour period.

    • FBM is subject to FB's commerce and business policies.
    • Users can report spam, abuse, and unpleasant messages. If there is a pattern of such messages, FB will disable the page from FBM.

• Quick Reply button IDs are not returned in the msg metadata and therefore do not work. Quick reply button text will be returned instead.

1. Log into your Facebook Messenger Account.

2. Go to your Facebook Page.

3. Open a chat in Messenger

   Expand image

4. It will redirect you to another page.

5. Note the page URL's suffix. This is your page's FBM ID. (i.e. 103800709108123 in this URL). You will use this later in the configuration process.

   Expand image

1. Open your Twilio Console in a new browser. Click on Explore Products link in the left navigation pane and select Channels Beta product.

   Expand image

2. Navigate to the Facebook Messenger product.

3. Click New Messenger Sender, sign into the Facebook account with admin access to your Facebook Page.

4. Add the Facebook Page that you want to send messages from confirming the FBM ID matches.

1. Set up a Messaging Service if you don't already have one. In the Twilio Console, go to Messaging > Services > Create Messaging Service. This is the same Messaging Service and sender pool to which you can add your WhatsApp and SMS/MMS senders.
2. To add a FBM Sender, navigate to the Messaging Service created previously. Go to the Sender Pool section and add the Facebook Sender that you've set up. Take a look at Using Facebook Messenger with Content Templates for more information.

*This is not a hard requirement. But if you do not do this then you will need to set up the webhook in your FBM Sender. Additionally, you will need to specify a Messaging Service Sid parameter and put your FBM sender in the from field. Similar to here except replace phone numbers with the respective FBM sender id.

To send a message in FBM, you need to know your recipient's FBM ID. Facebook does not make FBM IDs public so you will need to use a webhook to retrieve the FBM ID from an inbound message. For setup purposes and testing purposes, you will need to set up a webhook and message yourself to get your personal FBM ID.

1. Navigate to Messaging Services and go to the Integration tab.

2. Select Send a webhook.

3. Add a "Request URL" where you can receive incoming messages from your end users. If you need a testing webhook, try going to webhook.site

4. Copy the webhook into the Delivery Status Callback URL section.

   Expand image

1. Send a message to your page from your personal Facebook Messenger:

   • Log into your FBM account and click Message on your FBM page.
   • Send any message.

2. After sending your FB page a message with your personal FBM account. Check the webhook for the FROM field. This will contain the end user's FBM ID.

3. In your send request, you'll use the FBM ID found in the From field for the incoming message's webhook response.

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 createMessage() {
11
  const message = await client.messages.create({
12
    contentSid: "HXXXXXXXXXXXXXXXX",
13
    contentVariables: JSON.stringify({
14
      1: "YOUR_VARIABLE1",
15
      2: "YOURVARIABLE2",
16
    }),
17
    from: "MGXXXXXXXXXXXXXXX",
18
    to: "messenger:REPLACE_WITH_VALUE_FROM_WEBHOOK",
19
  });
20

21
  console.log(message.body);
22
}
23

24
createMessage();

1
{
2
  "account_sid": "ACXXXXXXXXXXXXXXXXXXX",
3
  "api_version": "2010-04-01",
4
  "body": "Hello! 👍",
5
  "date_created": "Thu, 24 Aug 2023 05:01:45 +0000",
6
  "date_sent": "Thu, 24 Aug 2023 05:01:45 +0000",
7
  "date_updated": "Thu, 24 Aug 2023 05:01:45 +0000",
8
  "direction": "outbound-api",
9
  "error_code": null,
10
  "error_message": null,
11
  "from": "MGXXXXXXXXXXXXXXX",
12
  "num_media": "0",
13
  "num_segments": "1",
14
  "price": null,
15
  "price_unit": null,
16
  "messaging_service_sid": "MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
17
  "sid": "SMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
18
  "status": "queued",
19
  "subresource_uris": {
20
    "media": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Messages/SMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Media.json"
21
  },
22
  "tags": {
23
    "campaign_name": "Spring Sale 2022",
24
    "message_type": "cart_abandoned"
25
  },
26
  "to": "messenger:REPLACE_WITH_VALUE_FROM_WEBHOOK",
27
  "uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Messages/SMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.json"
28
}