Messenger 开放平台

欢迎语

Messenger 配置文件 API

greeting 是 Messenger 配置文件 API 的一个属性。如需了解如何检索、设置、更新和删除 greeting，请参阅 Messenger 配置文件 API 参考文档。

借助智能助手 Messenger 配置文件中的 greeting 属性，您可指定用户将在智能助手欢迎页面看到的欢迎语。首次与智能助手交互的用户会看到欢迎页面。

若未针对用户的区域语言设置欢迎语，欢迎页面便会显示使用对话设置 API 设置的标准欢迎语。如果也没有设置标准欢迎语，则会显示主页描述。

目录

要求

如要设置或更新欢迎语，您必须在与智能助手关联的主页上拥有“管理员”身份。

greeting 格式

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

属性

属性 类型 说明

locale

字符串

欢迎语的区域设置，在用户的区域设置与提供的区域设置匹配时显示。


您至少必须针对默认区域设置指定欢迎语，该欢迎语会在提供的区域设置与用户的区域设置均不匹配时显示。


支持的语言列表。

text

字符串

特定区域的欢迎语。必须采用 UTF-8 格式，且不可超过 160 个字符。

个性化

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

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

示例

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

流量限制

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