利用 Dialogflow Facebook Workplace 集成,您可以创建 Facebook Workplace 聊天机器人以与最终用户互动。
限制
此集成仅支持默认代理语言。
工作原理
集成的工作原理如下:
- 配置 Dialogflow 集成和 Workplace 实例,使其互相通信。
- Dialogflow 集成使用 Facebook Messenger API 向最终用户发送消息。
- Dialogflow 集成充当 Facebook Workplace 网络钩子接收来自最终用户的消息。
开始
如要开始集成,请执行以下操作:
如果没有 Workplace 实例,请注册一个,并确保您是该群组的系统管理员。
从 Dialogflow 控制台启用集成:
- 前往 Dialogflow ES 控制台。
- 点击左侧边栏菜单中的集成。
- 点击 Facebook Workplace。
- 点击开始,系统会将您重定向至 Workplace 以完成安装:
- 登录您的 Workspace 账号。该账号必须是 Workspace 的 System Admin 才能安装集成。
- 在要求您安装 Dialogflow 集成的弹出式窗口中,点击Add to Workplace。您还可以选择自定义聊天机器人的名称。
测试应用。
- 转到工作负载并登录账号。
- 在边栏的首页部分,找到聊天机器人的 Dialogflow(或是聊天机器人的自定义名称),然后开始与该聊天机器人聊天。
取消
如果您点击了开始按钮,但不想在 Workplace 中完成安装,请执行以下操作:
点击左侧边栏菜单中的集成。
点击 Facebook Workplace:
- 如果您看到取消按钮:点击 取消 取消安装。
- 如果您看到停止按钮:请按照以下说明卸载集成。
停止
要停止已成功安装的集成,请执行以下操作:
点击左侧边栏菜单中的集成。
点击 Facebook Workplace。
点击停止,系统会将您重定向到 Workspace 以完成安装:
- 登录您的 Workspace 账号。该账号必须是 Workplace 上的 System Admin,才能卸载集成。
- 从 Workplace 上已安装的集成中查找并选择 Dialogflow 集成,然后点击卸载以完成卸载。
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" } } } }
限制
Dialogflow 代理只能安装在一个 Workspace 实例上,但您可以在一个 Workplace 实例上安装多个 Dialogflow 代理。
要移除失败的安装,您需要取消 Dialogflow 上的安装,并移除 Workplace 中的安装。
迁移
如果您要使用 Messenger 集成,并将其迁移到 Workplace 集成,则需要执行以下操作:
停止 Messenger 集成。
按照设置 Facebook 应用中的逆转步骤,移除 Facebook 应用上的 callback_url。
按照上述步骤启动 Workplace 集成。