# The Welcome Screen



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, 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.

## How It Works

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 Start

This guide assumes you have read the [Messenger Platform Overview](https://developers.facebook.com/documentation/business-messaging/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:

* A Page access token requested from a person who can perform the `MESSAGING` task on the Page
* The `pages_messaging` permission
* To subscribe to the `messaging_postbacks` webhook event

### Limitations

For apps with Standard Access, the welcome screen will only be visible to people with role on the app.

## Commands

If your Page uses [Commands](https://developers.facebook.com/documentation/business-messaging/messenger-platform/reference/messenger-profile-api/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.

## Implement the Get Started Button {#set_postback}

To set the postback payload, send a `POST` request to the [Messenger Profile API](https://developers.facebook.com/documentation/business-messaging/messenger-platform/reference/messenger-profile-api):

```curl
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](https://developers.facebook.com/documentation/business-messaging/messenger-platform/discovery/welcome-screen).

**Warning:** The Get Started Button feature is not supported when Messenger is accessed via the Facebook Mobile Browser (the in-app browser within the Facebook app).

### Best Practices

* **Do** communicate next steps to encourage a response in your welcome message. You can use buttons to add structure to your message and call out specific actions people can take.
*  **Do** share basic commands in your welcome message. Communicate which keywords or terms people can use to ask for help, get updates, etc., so they find what they want more quickly.
* **Do** change your onboarding experience when your bot experience changes. Revisit your welcome message as you update your capabilities to make sure they're still relevant.
* **Don't** be too generic. Try addressing people by name to make the message feel personal and treating it as an opportunity to teach them how to use and control the experience.

## See Also

* [Messenger Profile API](https://developers.facebook.com/docs/graph-api/reference/page/messenger_profile)