STAROps 集成飞书

更新时间:
复制 MD 格式

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

前置条件

条件项

说明

飞书组织管理员权限

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

阿里云 RAM 权限

用于配置 AppFlow 的 Webhook

已创建 STAROps 数字员工

作为IM机器人的后端输入

数字员工集成至飞书

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

  1. 使用具备管理员或开发者权限的飞书账号,登录飞书开发者后台:https://open.feishu.cn/

  2. 在右侧导航栏点击进入开发者后台 > 创建企业自建应用,填写应用名称、应用描述,上传应用图标,点击创建完成。

  3. 凭证与基础信息获取 App ID 和 App Secret。在事件与回调 > 加密策略中获取 Encrypt Key 和 Verification Token。

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

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

  2. 创建飞书应用机器人凭证,填入上一步获取的App ID 、App Secret、Encrypt Key、Verification Token。

  3. 创建智能运维助手(即 STAROps 控制台中的数字员工)凭证,选择角色名称进行策略授权(角色在 STAROps 控制台的权限管理中配置,请确保已为目标数字员工分配运维角色后再执行此步骤)。

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

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

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

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

  2. 在左侧导航栏选择事件与回调 > 事件配置。订阅方式选择将事件发送至开发者服务器。并填写上一步获得的Webhook URL。

  3. 点击添加事件,搜索并添加接收消息 v2.0(im.message.receive_v1)事件。

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

    重要

    未配置与机器人对话后无法收到回复信息。

    权限标识

    说明

    是否必须

    im:message.p2p_msg:readonly

    读取用户发给机器人的单聊消息

    im:message.group_at_msg:readonly

    接收群聊中 @机器人的消息

    im:message:send_as_bot

    以应用身份发送消息(机器人回复)

    im:chat:readonly

    获取群组信息

    按需,群组聊天需要

    im:message

    获取与发送单聊、群组消息

    contact:user.employee_id:readonly

    获取用户 user ID

    cardkit:card:write

    创建与更新卡片

  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 加会话编号,将当前对话框绑定到目标会话:

# 绑定编号为 1 的工作空间
/bind 1

绑定成功后,后续在该对话框中发送的所有消息,都会在被绑定会话的历史上下文基础上进行,AI 能够理解之前的对话内容和分析结果。

解除绑定

向机器人发送以下命令,解除当前会话的工作空间绑定:

/unbind

解绑后,后续消息恢复默认行为,每条消息创建新的对话。