谷歌Chat 空间集成 |Botpress Hub

# 为Botpress 集成谷歌Chat 功能Botpress

该集成可让您将Botpress 聊天机器人与谷歌Chat 空间连接起来,实现机器人与谷歌Chat 用户之间的无缝交流。

功能

  • 在谷歌Chat 空间发送和接收消息
  • 自动处理和回复消息
  • 支持多个谷歌Chat 空间
  • 使用谷歌服务账户进行安全验证

前提条件

1.谷歌云平台(GCP)账户 2.要在其中部署机器人的谷歌Chat 空间 3.安装了谷歌Chat 集成的Botpress 实例

安装说明

1.启用谷歌Chat API

1.进入 Google 云控制台 2.导航至 "API 和服务">"库" 3. 3.搜索 "GoogleChat API 4.点击谷歌Chat API 5.点击 "启用 "为您的项目激活 API

2.创建谷歌服务账户

1.进入 Google 云控制台 2.创建新项目或选择现有项目 3.导航至 "IAM 和管理">"服务帐户" 4. 4.单击 "创建服务帐户 5.填写服务账户详细信息并点击 "创建 6.为服务账户创建一个新密钥:

  • 点击服务账户
  • 转到 "密钥 "选项卡
  • 单击 "添加密钥">"创建新密钥
  • 选择 JSON 格式
  • 下载密钥文件

3.配置谷歌Chat 应用程序设置

1.进入 Google 云控制台 2.导航至 "APIs & Services" > "GoogleChat API" 3. 3.单击 "配置 4.使用以下设置设置您的应用程序:

  • ** 应用程序名称**:为机器人选择一个名称
  • 描述:添加机器人功能描述
  • Avatar URL:添加机器人头像的 URL
  • 功能***:
    • 启用互动功能
    • 启用接收 1-1 条消息
    • 启用加入空间和群组对话
  • HTTP 端点 URL:将其设置为在谷歌Chat 集成配置中找到的Botpress webhook URL。

4.在Botpress

中配置集成Botpress

1.在Botpress 实例中,进入集成部分 2.找到并选择谷歌Chat 集成 3.配置以下设置

  • 服务账户 JSON:粘贴下载的服务账户密钥文件的全部内容
  • 默认空间**:输入默认 GoogleChat 空间的 ID(可选)

5.将机器人添加到谷歌Chat 空间

1.打开谷歌Chat 空间 2.点击空间名称打开空间详情 3.转到 "应用程序和集成 4.点击 "添加应用程序 5.使用服务账户电子邮件搜索机器人 6.将机器人添加到您的空间

使用方法

发送信息

机器人可以向其添加的任何 GoogleChat 空间发送消息。信息可以发送

  • 回复用户消息
  • 通过Botpress 流程编辑器主动发送
  • 通过自定义代码调用 API

接收消息

机器人会自动接收并处理谷歌Chat 空间发送的消息。它会

  • 解析收到的消息
  • 通过Botpress 流程进行处理
  • 向空间发送适当的回复
消息格式

该集成支持谷歌Chat 空间中的文本消息。信息可以包括

  • 纯文本
  • 基本格式
  • 链接
  • 提及

安全考虑因素

  • 妥善保管服务帐户密钥,切勿公开共享
  • 定期轮换服务帐户密钥
  • 在为服务账户分配角色时使用最小权限原则
  • 监控机器人的活动并设置适当的日志记录

疑难解答

常见问题

1.机器人没有响应

  • 验证服务账户权限是否正确
  • 检查机器人是否已正确添加到空间中
  • 确保在Botpress 中正确配置了集成Botpress

2.身份验证错误

  • 验证服务账户 JSON 格式是否正确
  • 检查服务账户密钥是否有效且未过期
  • 确保服务帐户已启用必要的 API 范围

3.信息传送问题

  • 验证空间 ID 是否正确
  • 检查机器人是否有在空间中发布信息的权限
  • 确保信息格式有效

API 参考

有关 GoogleChat API 的更多详情,请参阅 官方文档