Meta 推出的 Messenger

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

工作原理

集成的工作原理如下：

您可以创建一个使用 Meta Messenger 平台的 Meta 应用。
您配置 Conversational Agents (Dialogflow CX) 集成和 Meta 应用，以使其互相通信。
对话式客服 (Dialogflow CX) 集成使用 Meta Messenger API 向最终用户发送消息。
Conversational Agents (Dialogflow CX) 集成充当 Messenger 平台专用 Meta 网络钩子接收来自最终用户的消息。

设置

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

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

活动

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

Event	说明
`FACEBOOK_WELCOME`	最终用户点击 Meta Messenger 开始按钮时触发。
`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 页面中删除上一个对话（如果适用）。
- 开始按钮仅会显示在新对话上。
使用您的 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}"

富响应消息

可通过履行中的自定义载荷支持富响应消息。如需了解消息格式，请参阅 Send API 参数消息对象。

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

{
  "text": "Hello, world"
}

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

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

频道专用响应

配置特定于渠道的回复后，当客服人员回复 Meta Messenger 消息时，系统会自动使用渠道 DF_CX_FB_MESSENGER。