STAROps 集成飞书
STAROps 支持将用户创建的数字员工快速接入飞书。集成完成后,用户可以在飞书中搜索机器人,直接与数字员工进行一对一对话或将机器人添加到群组,通过 @机器人发送消息即可获得回复。
前置条件
条件项 | 说明 |
飞书组织管理员权限 | 用于在飞书开放平台创建组织内应用 |
阿里云 RAM 权限 | 用于配置 AppFlow 的 Webhook |
已创建 STAROps 数字员工 | 作为IM机器人的后端输入 |
数字员工集成至飞书
步骤一:在飞书开放平台创建应用
使用具备管理员或开发者权限的飞书账号,登录飞书开发者后台:
https://open.feishu.cn/。在右侧导航栏点击进入开发者后台 > 创建企业自建应用,填写应用名称、应用描述,上传应用图标,点击创建完成。
在凭证与基础信息获取 App ID 和 App Secret。在事件与回调 > 加密策略中获取 Encrypt Key 和 Verification Token。
步骤二:创建STAROps与飞书应用连接流
通过AppFlow 飞书 X 智能运维助手模板 创建与飞书应用的连接流。
创建飞书应用机器人凭证,填入上一步获取的App ID 、App Secret、Encrypt Key、Verification Token。
创建智能运维助手(即 STAROps 控制台中的数字员工)凭证,选择角色名称进行策略授权(角色在 STAROps 控制台的权限管理中配置,请确保已为目标数字员工分配运维角色后再执行此步骤)。
填写Region、工作空间,选择已创建的数字员工。
填写连接流名称、连接流描述后完成创建,发布该连接流,并复制连接流的Webhook URL。
步骤三:创建飞书应用的机器人
进入第一步创建应用的详情页,点击左侧导航栏的添加应用能力,添加机器人。
在左侧导航栏选择事件与回调 > 事件配置。订阅方式选择将事件发送至开发者服务器。并填写上一步获得的Webhook URL。
点击添加事件,搜索并添加接收消息 v2.0(im.message.receive_v1)事件。
在应用详情页的权限管理中,开通以下权限:
重要未配置与机器人对话后无法收到回复信息。
权限标识
说明
是否必须
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
创建与更新卡片
是
完成所有配置,进行版本发布。在应用详情页左侧导航栏,点击版本管理与发布。点击创建新版本,填写版本号和版本描述。
配置应用可用范围(选择可使用该机器人的部门或人员)。点击申请线上发布,等待企业管理员审核通过后即可上线。
重要该配置非常重要,否则组织内所有人员均可与该机器人对话,并通过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 加会话编号,将当前对话框绑定到目标会话:
# 绑定编号为 1 的工作空间
/bind 1绑定成功后,后续在该对话框中发送的所有消息,都会在被绑定会话的历史上下文基础上进行,AI 能够理解之前的对话内容和分析结果。
解除绑定
向机器人发送以下命令,解除当前会话的工作空间绑定:
/unbind解绑后,后续消息恢复默认行为,每条消息创建新的对话。