This document shows you how to create a welcome screen for your Messenger experience. The welcome screen displays the name for your business' Facebook Page, the profile picture and cover photo from your Facebook Page, the time it usually takes for your business to respond to messages, an optional greeting message, and a Get Started button. When a person clicks the Get Started button, a message Get Started will be posted into the conversation, and your app can send the person messages.
When a person clicks the Get Started button in your Messenger experience, a webhook notification will be sent to you. You can use this notification to send an initial welcome message such as a text or set of quick replies.
Before You StartThis guide assumes you have read the Messenger Platform Overview and implemented the needed components such as a Facebook Page for your business (or test Page), registered as a Meta developer, and created a Meta business app ID with the Messenger product. You will need:
LimitationsFor apps with Standard Access, the welcome screen will only be visible to people with role on the app. |
If your Page uses Commands, the welcome screen shows the list of commands supported by the messaging experience, making it easy for people to understand what actions the Messenger experience can be asked to perform.
To set the postback payload, send a POST
request to the Messenger Profile API:
curl -X POST -H "Content-Type: application/json" -d '{
"get_started": {"payload": "<postback_payload>"}
}' "https://graph.facebook.com/v2.6/me/messenger_profile?access_token=<PAGE_ACCESS_TOKEN>"
For complete details, see the get_started
property reference.
The greeting text on the welcome screen is your first opportunity to tell a person why they should start a conversation with your Messenger bot. Some things you might include in your greeting text might include a brief description of what your bot does, such as key features, or a tagline. This is also a great place to start establishing the style and tone of your bot.
You may provide default and localized greeting text.
To set the greeting text, send a POST
request to the Messenger Profile API:
curl -X POST -H "Content-Type: application/json" -d '{
"greeting": [
{
"locale":"default",
"text":"Hello!"
}, {
"locale":"en_US",
"text":"Timeless apparel for the masses."
}
]
}' "https://graph.facebook.com/v2.6/me/messenger_profile?access_token=<PAGE_ACCESS_TOKEN>"
For complete details, see the greeting property
reference.
You can personalize the greeting text using the person's name. You can use the following template strings:
{{user_first_name}}
{{user_last_name}}
{{user_full_name}}
"greeting":[
{
"locale":"default",
"text":"Hello {{user_first_name}}!"
}
]