Greeting Text

Messenger Profile API

greeting is a property of the Messenger Profile API. For information on retrieving, setting, updating, and deleting greeting, see the Messenger Profile API Reference.

The greeting property of your bot's Messenger profile allows you to specify the greeting message people will see on the welcome screen of your bot. The welcome screen is displayed for people interacting with your bot for the first time.

If greeting text is not set for the user's locale, the standard greeting text set with the thread settings API will be shown in the welcome screen. If the standard greeting text is not set either, the page description will be shown.

Requirements

To set or update the greeting text you must have the 'Administrator' role for the Page associated with the bot.

`greeting` Format

"greeting":[
  {
    "locale":"default",
    "text":"Hello!"
  }, {
    "locale":"en_US",
    "text":"Timeless apparel for the masses."
  }
]

Properties

Property Type Description

Property	Type	Description
`locale`	String	Locale of the greeting text, shown when the person's locale matches the provided locale. You must at least specify greeting text for the default locale, which will be displayed if no provided locale matches the person's locale. List of supported locales.
`text`	String	The greeting text for the specific locale. Must be in UTF-8. 160 character limit.

locale

String

Locale of the greeting text, shown when the person's locale matches the provided locale.

You must at least specify greeting text for the default locale, which will be displayed if no provided locale matches the person's locale.

List of supported locales.

text

String

The greeting text for the specific locale. Must be in UTF-8. 160 character limit.

Personalization

您可以使用用户姓名创建个性化欢迎语。可以使用以下模板字符串：

{{user_first_name}}
{{user_last_name}}
{{user_full_name}}

示例

"greeting":[
  {
    "locale":"default",
    "text":"Hello {{user_first_name}}!"
  }
]

流量限制

对 Messenger 个人主页 API 的调用限制在每 10 分钟最多 10 次 API 调用。此流量限制以主页为单位执行。