Facebook Workplace

利用 Dialogflow Facebook Workplace 集成,您可以创建 Facebook Workplace 聊天机器人以与最终用户互动。

限制

此集成仅支持默认代理语言

工作原理

集成的工作原理如下:

开始

如要开始集成,请执行以下操作:

  1. 如果没有 Workplace 实例,请注册一个,并确保您是该群组的系统管理员

  2. 从 Dialogflow 控制台启用集成:

    1. 前往 Dialogflow ES 控制台
    2. 点击左侧边栏菜单中的集成
    3. 点击 Facebook Workplace
    4. 点击开始,系统会将您重定向至 Workplace 以完成安装:
      • 登录您的 Workspace 账号。该账号必须是 Workspace 的 System Admin 才能安装集成。
      • 在要求您安装 Dialogflow 集成的弹出式窗口中,点击Add to Workplace。您还可以选择自定义聊天机器人的名称。
  3. 测试应用。

    1. 转到工作负载并登录账号。
    2. 在边栏的首页部分,找到聊天机器人Dialogflow(或是聊天机器人的自定义名称),然后开始与该聊天机器人聊天。

取消

如果您点击了开始按钮,但不想在 Workplace 中完成安装,请执行以下操作:

  1. 前往 Dialogflow ES 控制台

  2. 点击左侧边栏菜单中的集成

  3. 点击 Facebook Workplace

    1. 如果您看到取消按钮:点击 取消 取消安装。
    2. 如果您看到停止按钮:请按照以下说明卸载集成。

停止

要停止已成功安装的集成,请执行以下操作:

  1. 前往 Dialogflow ES 控制台

  2. 点击左侧边栏菜单中的集成

  3. 点击 Facebook Workplace

  4. 点击停止,系统会将您重定向到 Workspace 以完成安装:

    1. 登录您的 Workspace 账号。该账号必须是 Workplace 上的 System Admin,才能卸载集成。
    2. 从 Workplace 上已安装的集成中查找并选择 Dialogflow 集成,然后点击卸载以完成卸载。
  5. Dialogflow 集成将被卸载。

富响应消息

此集成会将一些富响应消息消息转换为 Facebook Messenger 平台消息类型

图片响应

图片响应将作为 Facebook Messenger 文件附件消息发送到 Facebook Messenger。 message.attachment.type 的值设置为 image。 支持以下格式:

  • jpg
  • png
  • 静态 gif
  • 动态 gif

卡片响应

卡片响应将作为 Facebook Messenger 通用模板发送到 Facebook Messenger。

快速回复响应

快速回复响应将作为 Facebook Messenger 快速回复发送到 Facebook Messenger。

自定义载荷响应

如需发送其他类型的 Facebook Messenger 消息,您可以使用自定义载荷

自定义载荷的一般格式如下所示:

{
  "facebook": {
    message
  }
}

提供 Facebook Messenger message 对象以替换 message。 如需详细了解 message 对象,请参阅 Facebook Messenger API 参考文档

例如:

  • 发送音频链接:
    {
      "facebook": {
        "attachment": {
          "type": "audio",
          "payload": {
            "url": "https://example.com/audio/test.mp3"
          }
        }
      }
    }
        
  • 发送可播放的视频:
    {
      "facebook": {
        "attachment": {
          "type": "video",
          "payload": {
            "url": "https://example.com/video.mp4"
          }
        }
      }
    }
        
  • 发送文件:
    {
      "facebook": {
        "attachment": {
          "type": "file",
          "payload": {
            "url": "https://example.com/file.pdf"
          }
        }
      }
    }
        

限制

  1. Dialogflow 代理只能安装在一个 Workspace 实例上,但您可以在一个 Workplace 实例上安装多个 Dialogflow 代理。

  2. 要移除失败的安装,您需要取消 Dialogflow 上的安装,并移除 Workplace 中的安装。

迁移

如果您要使用 Messenger 集成,并将其迁移到 Workplace 集成,则需要执行以下操作:

  1. 停止 Messenger 集成。

  2. 按照设置 Facebook 应用中的逆转步骤,移除 Facebook 应用上的 callback_url。

  3. 按照上述步骤启动 Workplace 集成。