跳转到内容

飞书

飞书提供通知和对话两类接入。固定群聊告警优先使用自定义机器人;需要按用户、部门或群聊动态发送时使用企业自建应用;需要接收单聊或群聊 @机器人 并回复时,使用对话机器人。

推送方式接收目标核心凭据适用场景
自定义机器人创建机器人的群聊Webhook、可选签名密钥告警、播报、固定群通知
企业自建应用用户、群聊等App ID、App Secret、访问令牌精确触达、组织级应用
对话机器人单聊、群聊 @机器人应用凭据、事件订阅普通 API 对话、AI 助手

三种方式的凭据、权限和请求体不同。自定义机器人 Webhook 不能接收用户消息,不应被当作对话入口。

  • 只向一个固定群发送告警,优先自定义机器人。
  • 需要按用户或群 ID 动态发送、管理可用范围和消息权限,选择企业自建应用。
  • 需要接收单聊或群聊提及、处理命令或 AI 对话,选择对话机器人。

自定义机器人在群客户端内创建;企业自建应用和对话机器人在飞书开发者后台配置。飞书中国版与国际版 Lark 的租户、开发者后台和 API 域名可能不同,凭据与用户 ID 不能跨环境混用。

当前三篇教程均为 source-reviewed,表示已按官方资料核对但没有真实租户发送证据。生产接入前仍需在自己的租户验证权限、可用范围、群类型和配额。