STAROps 集成钉钉
STAROps 支持将用户创建的数字员工快速接入钉钉。集成完成后,用户可以在钉钉中搜索机器人,直接与数字员工进行一对一对话或将机器人添加到群组,通过 @机器人发送消息即可获得回复。
前置条件
条件项 | 说明 |
钉钉组织管理员权限 | 用于在钉钉开放平台创建组织内应用 |
阿里云 RAM 权限 | 用于配置 AppFlow 的 Webhook |
已创建 STAROps 数字员工 | 作为IM机器人的后端输入 |
操作步骤
步骤一:在钉钉开放平台创建应用
使用具备管理员或开发者权限的钉钉账号,登录钉钉开发者后台。
登录后选择需要创建应用的企业组织。
在左侧导航栏点击应用开发 > 钉钉应用,点击右上角创建应用。填写应用名称(如“智能运维助手”)、应用描述,并上传应用图标,点击保存完成创建。
在凭证与基础信息的应用凭证处获取 Client ID 和 Client Secret 供下一步使用。
步骤二:创建STAROps与钉钉应用连接流
通过AppFlow 钉钉 X 智能运维助手模板 创建与钉钉应用的连接流。
创建钉钉应用机器人凭证,填入上一步获取的 Client ID 和 Client Secret。
创建智能运维助手凭证,选择已配置的角色名称进行策略授权。
填写Region、工作空间,选择已创建的数字员工。
填写连接流名称、连接流描述后完成创建,发布该连接流,并复制连接流的Webhook URL。
步骤三:创建钉钉应用的机器人
进入第一步中创建应用的详情页,点击左侧导航栏的添加应用能力,添加机器人。
开启机器人配置,填写机器人的名称、头像、简介等基本信息。
消息接收模式选择HTTP 模式,并在消息接收地址中填写上一步获得的Webhook URL。
在应用详情页的开发配置 > 权限管理中,开通以下权限:
权限名称
说明
是否必须
qyapi_robot_sendmsg
企业内部机器人发送消息
是
Card.Instance.Write
创建和投放卡片实例(交互卡片消息)
按需
Card.Streaming.Write
对卡片进行流式更新(AI 流式卡片)
按需
完成所有配置,进行版本发布。在应用详情页左侧导航栏,点击版本管理与发布。点击创建新版本,填写版本号和版本描述。
设置可使用范围,选择哪些部门或人员可以使用该机器人,完成配置后发布版本。
重要该配置非常重要,否则组织内所有人员均可与该机器人对话,并通过STAROps数字员工查询可观测数据或进行一些管控动作。
拥有权限的钉钉组织内人员,即可在钉钉内搜索该机器人单聊,或者添加到钉钉群内@该机器人发送消息。
会话绑定
会话绑定功能可以将钉钉对话框与已有的 STAROps 会话关联,使后续消息在该会话的上下文中继续对话。
查看可绑定的会话
在钉钉对话框中发送以下命令查看可绑定的会话列表:
/bind机器人返回可绑定的会话列表,格式如下:
可绑定的会话列表:
[1] K8s 集群巡检会话 — 2026-06-04 10:30
[2] RDS 慢查询分析 — 2026-06-04 09:15
[3] ECS 磁盘告警排查 — 2026-06-03 16:42
输入 /bind <编号> 绑定到指定会话。会话列表按最近活跃时间倒序排列,仅显示当前数字员工下的会话。
绑定到指定会话
发送 /bind 加会话编号绑定到目标会话。例如绑定编号为 2 的会话:
/bind 2机器人返回绑定确认:
已绑定到会话:RDS 慢查询分析
后续消息将基于该会话的上下文继续对话。
输入 /unbind 可解除绑定。绑定成功后,数字员工可以理解之前的对话内容和分析结果。
解除绑定
发送以下命令解除当前绑定:
/unbind机器人返回解绑确认:
已解除当前会话的绑定,后续消息将创建新的会话。解绑后,后续每条消息将恢复为创建新的 STAROps 会话。