Meta 推出的 Messenger

使用 Meta Messenger 集成，您可以创建一个 Meta 与最终用户互动的 Messenger 聊天机器人。

工作原理

集成的工作原理如下：

您创建了一个 Meta 应用，该应用使用 Meta Messenger 平台。
您可以配置对话代理 (Dialogflow CX) 集成和 Meta 应用，相互通信
对话式客服 (Dialogflow CX) 集成使用 Meta Messenger API 向最终用户发送消息。
对话代理 (Dialogflow CX) 集成通过以下操作接收来自最终用户的消息：该适用于 Messenger 平台的 Meta Webhook。

设置

如需设置集成，请执行以下操作：

按照以下步骤创建 Meta 应用： Meta 应用开发。
设置 Meta 应用以使用 Meta Messenger Platform。按照步骤适用于 Messenger 平台的 Meta Webhook 完成以下任务：
- 将 Messenger 平台添加到您的 Meta 应用。
- 为您的应用订阅元页面。确保已在页面订阅中启用 messages 和 messaging_postbacks。
- 在此步骤中，系统会为您提供访问令牌。复制此值。此令牌用于从对话式客服 (Dialogflow CX) 控制台配置集成。
- 请勿配置网络钩子或测试集成。
通过对话代理 (Dialogflow CX) 控制台配置集成：
1. 转到 Dialogflow CX 控制台。
2. 点击左侧面板上的管理标签页。
3. 点击左侧边栏菜单中的集成。
4. 点击 Meta Messenger 图块上的连接按钮。
5. 此时将打开一个配置对话框：
  - App Secret：输入应用 Secret 应用信息中心基本设置。
  - 验证令牌：您可以输入所需的任何私有令牌。复制此值。此值用于配置 Meta Messenger 网络钩子。
  - Page access token：输入您在执行删除操作步骤期间复制的访问令牌。上面的 Meta 应用设置。
  - 启用开始按钮：请参阅“开始”按钮部分。
  - 网络钩子网址：复制此值。此值用于配置 Meta Messenger 网络钩子。
  - 开始：点击即可为您的代理启动此集成服务。
完成 Meta 应用的设置并进行测试。按照 Messenger 平台专用 Meta Webhook 文档中的步骤完成以下操作：
- 为您的应用配置 Meta webhook。使用网络钩子网址和您在上面复制的验证令牌值。请务必在页面订阅中启用 messages 和 messaging_postbacks。
- 测试应用。

活动

此集成会调用以下事件。您可以创建自定义事件处理脚本来定义触发事件时要执行的操作。

Event	说明
`FACEBOOK_WELCOME`	当最终用户点击 Meta Messenger Get Started 按钮时触发。
`FACEBOOK_MEDIA`	当最终用户的消息包含附件（例如音频、图片、视频等）时触发。

“开始”按钮

如需设置 Meta Messenger 开始按钮，请执行以下操作：

在启用此集成服务时切换启用开始按钮。

此集成服务通过调用 Messenger Profile API。

curl -X POST \
-H "Content-Type: application/json" \
-d '{"get_started": {"payload": "FACEBOOK_WELCOME"}}' \
"https://graph.facebook.com/v10.0/me/messenger_profile?access_token=${PAGE_ACCESS_TOKEN}"

为 FACEBOOK_WELCOME 事件创建一个自定义事件处理脚本。

要进行测试，请按以下步骤操作：

从 Meta 页面中删除上一个对话（如果适用）。
- 开始按钮仅会显示在新对话上。
与您的元页面发起新对话。
点击开始按钮，并验证自定义事件处理脚本的响应。

您可以随时调用 Messenger Profile API 以管理开始按钮。这可能有助于进行测试。

例如，以下请求会检查开始按钮的状态：

curl -X GET \
"https://graph.facebook.com/v10.0/me/messenger_profile?fields=get_started&access_token=${PAGE_ACCESS_TOKEN}"

以下请求会停用开始按钮：

curl -X DELETE \
-H "Content-Type: application/json" \
-d '{"fields": ["get_started"]}' \
"https://graph.facebook.com/v10.0/me/messenger_profile?access_token=${PAGE_ACCESS_TOKEN}"

富响应消息

可通过履行中的自定义载荷支持富响应消息。请参阅发送 API 参数消息对象消息格式

例如，以下自定义载荷提供简单的文本消息：

{
  "text": "Hello, world"
}

以下自定义载荷提供图片消息：

{
  "attachment": {
    "type": "image",
    "payload": {
      "url": "https://example.com/test.jpg"
    }
  }
}

频道专用响应

在您配置频道专用响应后，当代理响应 Meta Messenger 消息时，系统会自动使用 DF_CX_FB_MESSENGER 频道。