SysAgent 支持接入钉钉或飞书即时通信（Instant Messaging，IM）群聊。接入后，群成员可以在群聊中提交问题并接收处理结果。本文介绍创建和配置机器人、在 SysAgent 中登记连接信息、将机器人加入群聊，以及验证连通性的操作流程。
使用前准备
-
准备具备创建、配置应用和发布版本权限的钉钉或飞书账号。
-
确定需要接入 SysAgent 的群聊。
-
确认当前账号可访问操作系统控制台中的 SysAgent 机器人配置入口。
-
妥善保管应用密钥、Webhook 和访问令牌，不要在群聊、工单或公开材料中展示。
接入飞书机器人
配置飞书应用
-
登录飞书开放平台并创建应用。
-
为应用添加机器人能力。
-
配置机器人收发消息、读取群聊消息、获取群组信息、发送消息和更新卡片所需的权限。
-
选择长连接作为事件接收方式。
-
订阅机器人进群、机器人被移出群和消息接收事件，并配置卡片回传回调。
-
如需将机器人加入外部群，请在发布前启用允许机器人在外部群中使用。如页面要求审批，请联系飞书管理员处理。
-
确认配置无误后发布应用版本。
权限标识：im:message、im:message.group_at_msg:readonly、im:chat、im:message:send_as_bot 和 cardkit:card:write。如需接收单聊消息，还需开通 im:message.p2p_msg:readonly。
事件与回调标识：im.chat.member.bot.added_v1、im.chat.member.bot.deleted_v1、im.message.receive_v1 和 card.action.trigger。
在 SysAgent 中登记并加入群聊
-
登录操作系统控制台，在 SysAgent 机器人配置页填写连接信息并保存。
-
在飞书中选择目标群聊，使用机器人的完整名称将其添加到群聊。
-
确认机器人已显示在群聊成员列表中。
接入钉钉机器人
创建并添加钉钉机器人
-
登录钉钉开放平台并创建应用。
-
为应用申请群聊机器人能力。
-
设置消息接收模式并保存配置。
-
将机器人添加到目标群聊。
-
在群聊中打开机器人头像，进入机器人设置。
获取 Webhook 并在 SysAgent 中登记
-
在机器人设置中复制 Webhook。
-
登录操作系统控制台，打开 SysAgent 机器人配置页。
-
填写机器人连接信息并保存。
-
返回目标群聊，确认机器人已在群内。
验证接入结果
-
选择不含敏感信息的测试问题。
-
填写明确的对象和问题内容。
-
发送消息并确认机器人能够接收请求。
-
查看返回结果，确认对象和内容与请求一致。
常见问题
-
飞书机器人无响应：检查应用是否已发布、机器人权限、长连接、事件订阅、卡片回调和入群状态。
-
钉钉机器人无响应：检查机器人入群状态、消息接收模式和 Webhook 配置。
-
SysAgent 中未显示机器人配置入口：联系产品服务人员确认当前账号的开通状态，并以控制台页面提示为准。
-
能够接收消息但无法返回结果：核对 SysAgent 中登记的连接信息，保存后重新测试。
-
连接信息疑似泄露：更新对应平台的连接信息，并同步更新 SysAgent 中的登记信息。