Using Facebook Messenger with Content Templates
Facebook Messenger Pre-requisites for Content Templates
- A Facebook page for your business
- A Facebook account with admin access for your business
- 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.
Important Considerations
- 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 ID's are not returned in the msg metadata and therefore do not work. Quick reply button text will be returned instead.
Find your Facebook Page's Messenger ID
- Log into your Facebook Messenger Account.
- Go to your Facebook Page.
- Open a chat in Messenger
- It will redirect you to another page.
- 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.
Set up your FBM Sender
- Open your Twilio Console in a new browser. Click on Explore Products link in the left navigation pane and select Channels Beta product.
- Navigate to the Facebook Messenger product.
- Click New Messenger Sender, sign into the Facebook account with admin access to your Facebook Page.
- Add the Facebook Page that you want to send messages from confirming the FBM ID matches.
Messages sent from Facebook Business Manager will not appear in Twilio. Please ensure that all messages intended for Twilio are sent directly from the Twilio platform.
Add your FBM Sender to your Messaging Service
- 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.
- 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 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.
Set up Webhooks for your Messaging Service
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.
- Navigate to Messaging Services and go to the Integration tab.
- Select Send a webhook.
- 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
- Copy the webhook into the Delivery Status Callback URL section.
Find your Customer's FBM ID
- 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.
- 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. - In your send request, you'll use the FBM ID found in the
From
field for the incoming message's webhook response.
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.