智能机器人对接管理员配置指南

在三个平台开通并维护 ShareAgent 机器人。

概述

💡 完成配置后，员工可在日常使用的即时通讯工具中直接与 ShareAgent 对话。
管理员可按平台分别开通，并统一在 CRM 中维护配置。

开始之前

[!IMPORTANT]

• 角色权限：您需要 CRM 管理员权限，以及对应 IM 平台的管理权限。
• 前置配置：已完成 ShareAgent 配置，并确定要关联的 Agent。
• 影响范围：凭证变更对使用该机器人的员工立即生效。

一、企业微信开通流程

1. 在 CRM 中创建机器人配置

1. 登录 CRM 管理后台，前往 定制开发平台 > 智能机器人管理。

2. 点击 + 新建机器人。
3. 填写机器人名称。
4. 在 平台 中选择 企业微信。
5. 在 关联 Agent 中选择要关联的智能体。
6. 在 鉴权方式 中选择授权方式。

7. 点击 确定 保存。
8. 复制系统生成的回调地址。

2. 在企业微信中创建机器人

1. 登录企业微信管理后台。
2. 前往 安全与管理 > 管理工具 > 智能机器人。

3. 点击 创建机器人。
4. 将创建方式切换为 API 模式。

5. 在 URL 中粘贴 CRM 生成的回调地址。
6. 点击 随机获取 生成 Token。
7. 点击 随机获取 生成 EncodingAESKey，共 43 位字符。
8. 点击 保存。

[!NOTE]
若提示域名主题校验未通过，请先将域名添加到企业微信的 域名列表。

3. 回填凭证

1. 返回 CRM 的 机器人授权配置 页面。
2. 找到目标机器人，点击 编辑。
3. 填入企业微信的 Token 与 EncodingAESKey。
4. 点击 确定 保存。

二、飞书开通流程

1. 在 CRM 中创建机器人配置

1. 登录 CRM 管理后台，前往 企业设置 > 机器人授权配置。

2. 点击 + 新建机器人。
3. 在 平台 中选择 飞书。
4. 填写机器人名称，选择关联 Agent 与鉴权方式。
5. 点击 确定 保存，并复制回调地址。

2. 在飞书开放平台创建应用

1. 登录飞书开放平台。

2. 点击 创建企业自建应用。

3. 点击 创建 完成应用创建。
4. 在企业自建应用中添加机器人。

5. 在事件回调中填写上一步复制的回调地址。

6. 在权限管理中批量导入所需权限。

{
  "scopes": {
    "tenant": [
      "contact:contact.base:readonly",
      "contact:user.base:readonly",
      "contact:user.phone:readonly",
      "event:ip_list",
      "im:message",
      "im:message.group_at_msg.include_bot:readonly",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot"
    ],
    "user": [
      "im:message",
      "im:message:readonly"
    ]
  }
}

7. 发布应用。

3. 回填凭证

1. 返回 CRM 的 机器人授权配置 页面。

2. 找到目标机器人，点击 编辑。
3. 填入飞书的 App ID、App Secret 与 Token。
4. 点击 确定 保存。

三、钉钉开通流程

1. 在 CRM 中创建机器人配置

1. 登录 CRM 管理后台，前往 企业设置 > 机器人授权配置。

2. 点击 + 新建机器人。
3. 在 平台 中选择 钉钉。
4. 填写机器人名称，选择关联 Agent 与鉴权方式。
5. 点击 确定 保存，并复制回调地址。

2. 在钉钉开放平台创建应用

1. 登录钉钉开放平台。

2. 点击 创建应用。

3. 在应用中添加机器人。

4. 在权限管理中批量导入所需权限。

qyapi_chat_manage
Contact.User.mobile

5. 发布应用。

3. 回填凭证

在钉钉中，字段对应关系如下：

1. 返回 CRM 的 机器人授权配置 页面。

2. 找到目标机器人，点击 编辑。

3. 填入钉钉的 App ID、App Secret 与 Token。
4. 点击 确定 保存。

四、维护机器人配置

查看配置

1. 登录 CRM 管理后台，前往 定制开发平台 > 智能机器人管理。
2. 查看已配置的机器人列表。
3. 点击 详情 查看配置信息，支持按平台与租户筛选。

修改配置

1. 在配置列表中找到目标机器人。
2. 点击 编辑。
3. 修改对应字段。
4. 点击 保存。

[!WARNING]
修改 Token 或 EncodingAESKey 后，需同步更新 IM 平台侧的回调配置，否则消息无法送达。

删除配置

1. 在配置列表中找到目标机器人。
2. 点击 删除。
3. 确认删除。

[!NOTE]
删除后员工无法再通过该机器人使用 ShareAgent。
删除为软删除，可恢复。

五、安全与隐私

数据安全

• 消息传输采用 AES 加密。
• IM 平台与纷享销客之间的通信经过签名验证。
• 员工数据仅在授权范围内访问。

权限控制

• 员工只能查询自己有权限查看的数据。
• 管理员可控制机器人可访问的数据范围。
• 敏感操作需通过 CRM 完成。

验证方法

1. 在目标 IM 平台中搜索机器人名称。
2. 进入单聊，发送“你好”。
3. 确认收到机器人回复。
4. 让一位员工完成账号绑定，并确认可正常提问。

注意事项

• 群聊场景仅企业微信支持，且必须 @ 机器人。
• 免鉴权方式不校验身份，不建议在生产环境使用。
• 对话记录保存在 IM 平台侧，纷享侧不存储聊天记录。

相关主题

• 智能机器人对接概述
• 智能机器人对接快速上手
• 智能机器人对接用户操作指南
• MCP 服务管理员配置指南