飞书应用
飞书应用通知媒介
概述
- 飞书应用通知媒介，支持将告警发送到飞书群聊或者单聊。
- 当前仅支持企业自建应用。
- 飞书应用支持发送告警截图。
使用步骤
创建飞书应用
-
登录钉钉开放平台 -> 创建企业自建应用 -> 填写信息进行创建，并添加机器人能力。
-
进入创建的应用 -> 基础信息 -> 凭证与基础信息 -> 获取 App ID / App Secret 填写到系统中。
-
进入创建的应用 -> 开发配置 -> 权限管理 -> 开通如下权限。
- 获取用户 user ID
- 通过手机号或邮箱获取用户 ID
- 获取群组信息
- 获取群组中用户@机器人消息
- 读取用户发给机器人的单聊消息
- 以应用的身份发消息
- 获取与上传图片或文件资源
- 进入创建的应用 -> 开发配置 -> 事件与回调 -> 订阅如下事件类型。
- 用户进入与机器人的会话
- 接收消息
- 机器人自定义菜单事件
- 进入创建的应用 -> 应用发布 -> 版本管理与发布 -> 创建版本
创建类型为飞书应用的通知媒介
将飞书应用机器人添加到告警群
## 常见问题
Q1：飞书应用通知和飞书群机器人 / 卡片机器人有什么区别？
A：
- 飞书群机器人 / 卡片（webhook 类）：发到指定群；
- 飞书应用：发给具体人的私聊消息，需要应用开通"获取与发送单聊消息"权限。
Q2：应用配置必须哪些权限？
A：
获取通讯录基本信息（拿用户 open_id）；获取用户基本信息；获取与发送单聊消息；- 申请后等审批通过才生效（部分公司流程比较慢）。
Q3：通知失败的常见错误？
A：
- App ID / Secret 不对（开放平台核对）；
- 用户 open_id 错误（飞书 open_id 跨应用不通用，必须用对应应用的）；
- 应用未发布 / 未启用；
- 用户拒收了应用通知。
Q4：飞书 vs Lark？
A：飞书国内版 + Lark 国际版是独立租户，API 域名不同（open.feishu.cn vs open.larksuite.com）。需要根据租户类型配置 API URL。
