STAROps 集成钉钉

更新时间:
复制 MD 格式

STAROps 支持将用户创建的数字员工快速接入钉钉。集成完成后,用户可以在钉钉中搜索机器人,直接与数字员工进行一对一对话或将机器人添加到群组,通过 @机器人发送消息即可获得回复。

前置条件

条件项

说明

钉钉组织管理员权限

用于在钉钉开放平台创建组织内应用

阿里云 RAM 权限

用于配置 AppFlow 的 Webhook

已创建 STAROps 数字员工

作为IM机器人的后端输入

操作步骤

步骤一:在钉钉开放平台创建应用

  1. 使用具备管理员或开发者权限的钉钉账号,登录钉钉开发者后台

  2. 登录后选择需要创建应用的企业组织。

  3. 在左侧导航栏点击应用开发 > 钉钉应用,点击右上角创建应用。填写应用名称(如“智能运维助手”)、应用描述,并上传应用图标,点击保存完成创建。

  4. 凭证与基础信息应用凭证处获取 Client ID 和 Client Secret 供下一步使用。

步骤二:创建STAROps与钉钉应用连接流

  1. 通过AppFlow 钉钉 X 智能运维助手模板 创建与钉钉应用的连接流。

  2. 创建钉钉应用机器人凭证,填入上一步获取的 Client ID 和 Client Secret。

  3. 创建智能运维助手凭证,选择已配置的角色名称进行策略授权。

  4. 填写Region、工作空间,选择已创建的数字员工。

  5. 填写连接流名称、连接流描述后完成创建,发布该连接流,并复制连接流的Webhook URL。

步骤三:创建钉钉应用的机器人

  1. 进入第一步中创建应用的详情页,点击左侧导航栏的添加应用能力,添加机器人

  2. 开启机器人配置,填写机器人的名称、头像、简介等基本信息。

  3. 消息接收模式选择HTTP 模式,并在消息接收地址中填写上一步获得的Webhook URL。

  4. 在应用详情页的开发配置 > 权限管理中,开通以下权限:

    权限名称

    说明

    是否必须

    qyapi_robot_sendmsg

    企业内部机器人发送消息

    Card.Instance.Write

    创建和投放卡片实例(交互卡片消息)

    按需

    Card.Streaming.Write

    对卡片进行流式更新(AI 流式卡片)

    按需

  5. 完成所有配置,进行版本发布。在应用详情页左侧导航栏,点击版本管理与发布。点击创建新版本,填写版本号和版本描述。

  6. 设置可使用范围,选择哪些部门或人员可以使用该机器人,完成配置后发布版本。

    重要

    该配置非常重要,否则组织内所有人员均可与该机器人对话,并通过STAROps数字员工查询可观测数据或进行一些管控动作。

  7. 拥有权限的钉钉组织内人员,即可在钉钉内搜索该机器人单聊,或者添加到钉钉群内@该机器人发送消息。

会话绑定

会话绑定功能可以将钉钉对话框与已有的 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 会话。