欢迎页面

本文档将介绍如何创建欢迎页面,以便为您打造 Messenger 体验。欢迎页面会显示商家 Facebook 公共主页的名称、您在 Facebook 公共主页上的头像和封面照片、商家回复消息通常所用的时长、可选的问候消息以及立即开始按钮。用户点击“立即开始”按钮之后,“立即开始”这条消息即会发布到对话中,您的应用便可向用户发送消息。

运作方式

用户在您的 Messenger 体验中点击“立即开始”按钮时,系统将向您发送一条 Webhooks 通知。您可以使用该通知发送初始欢迎消息,如一条文本消息或一系列快速回复。

准备工作

本指南假定您已阅读 Messenger 开放平台概览,并已实现所需组件,例如商家的 Facebook 公共主页(或测试版公共主页),已注册为 Meta 开发者,以及已创建 Meta 业务应用编号并为其设置支持 Messenger 产品。

您将需要:

  • 从可以在公共主页上执行 MESSAGING 任务的用户处请求获取的公共主页访问口令
  • pages_messaging 权限
  • 订阅 messaging_postbacks Webhooks 事件

限制

对于拥有标准访问级别权限的应用,欢迎页面只对在应用中拥有身份的用户显示。

命令

如果您的公共主页使用命令,欢迎页面会显示消息体验支持的命令清单,这便于用户了解可要求 Messenger 体验执行哪些操作。

实现“立即开始”按钮

如要设置回传负载,请发送 POST 请求至 Messenger 配置文件 API

curl -X POST -H "Content-Type: application/json" -d '{
  "get_started": {"payload": "

如需了解完整详情,请参阅 get_started 属性参考文档

最佳实践

  • 建议介绍接下来的步骤,鼓励用户对欢迎消息予以回应。您可以使用按钮,为消息添加结构,并指出用户可以采取的操作。
  • 建议在欢迎消息中分享基本互动指令。告知用户在寻求帮助、获得更新及执行其他操作时可以使用哪些关键字或词语,以便他们更快速地找到所需内容。
  • 建议根据智能助手体验的变化,相应地调整入门流程。更新功能后,应重新检查欢迎语和欢迎消息,确保它们仍然切合您打造的体验。
  • 请勿忘记屏幕上的所有元素是协调一体的。Messenger 欢迎语的背景信息应与“立即开始”按钮起到补充作用。
  • 不建议措辞太平淡普通。可以尝试以姓名称呼用户,让消息更具亲和力,并在消息中告知用户如何使用和控制体验。

设置欢迎语

欢迎页面上的欢迎语是在最开始时吸引用户与 Messenger 智能助手对话的重要手段。您可以在欢迎语中添加关于智能助手用途的简介(例如主要功能),或者添加一句标语。在此基础上,您可以构建智能助手的基调和风格。

您可以提供默认和本地化的问候语。

如要设置欢迎语,请发送 POST 请求至 Messenger 配置文件 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=

如需了解完整详情,请参阅greeting property 参考文档

个性化

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

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

示例

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

最佳实践

  • 建议在欢迎语中自我介绍并简要说明您提供的体验。欢迎语最多可以有 160 个字符,所以应尽量言简意赅。
  • 建议说明您提供的主要功能。背景信息有助于用户了解如何与您互动,及设立与您提供的功能相关的预期。
  • 不建议将欢迎语设计为说明手册类风格。因为欢迎语会消失,所以建议使用内容真切的消息介绍具体的功能和指令。
  • 不建议在欢迎语中使用过多的文本格式(例如:空格、标点、回车符),以便能够充分利用字符限制。

另请参阅

  • https://developers.facebook.com/docs/graph-api/reference/v14.0/page/messenger_profile