自定义群机器人通知
向机器人所在群推送文本、富文本、图片和消息卡片，适合监控告警、日报和系统通知。
接入要求在有权添加机器人的群创建 Webhook；无需租户管理员审核。仅在当前群使用，没有数据访问权限，也不能接收并回复用户消息。
办公协作 / Feishu Open Platform
飞书
面向企业内部工具和服务商应用，提供消息与群组、云文档、多维表格、日历、审批、任务等开放能力。可以从群通知开始，也能开发需要租户与用户授权的完整业务应用。
01 / CAPABILITIES
开放功能
应用机器人与群组管理
接收并回复机器人相关会话消息，发送交互卡片，创建或管理群组及成员，适合问答助手和工单协作。
接入要求创建应用并启用机器人；按消息、群管理和事件分别申请权限。群消息范围依权限而定，不能默认读取所有群聊；机器人需处于目标会话允许的范围内。
通讯录与身份登录
查询获授权的成员和部门，维护组织数据，使用用户授权完成登录或以用户身份操作。
接入要求申请所需字段和接口权限；应用身份还需配置通讯录数据范围。用户身份访问需用户授权，并受该用户原有权限限制。
云文档、知识库与文件
创建和编辑在线文档、电子表格，管理文件夹和知识库节点，上传下载文件并处理评论与协作者权限。
接入要求API 权限和具体资源权限都要满足。以应用身份访问他人文档，通常还需把应用添加为文档协作者；知识库另需管理员授权。
多维表格数据互通
管理多维表格、数据表、字段、记录和视图，并按接口能力接入仪表盘及高级权限，连接自有业务系统。
接入要求分别申请读写权限。应用身份需成为表格所有者或协作者；高级权限与表格套餐、资源模型会影响可操作范围。单表写入建议串行。
日历、日程与忙闲
创建或同步日历日程、邀请参与人、查询忙闲，并结合会议室资源安排会议。
接入要求按接口申请日历读写或忙闲权限，使用所支持的应用或用户令牌；能否读写某本日历还取决于日历访问控制。
原生审批与第三方审批集成
读取审批定义和实例、发起原生审批、接收状态变化，或把外部审批的实例与任务同步到飞书。
接入要求审批定义、实例、任务权限需分别核对。部分应用身份接口的数据范围较广，管理员需审慎授权；原生审批和第三方审批使用不同接口。
任务、清单与项目跟进
创建任务和子任务、分配负责人、设置时间，维护清单、评论、自定义字段和附件。
接入要求任务 v2 有独立的读写权限；还需满足任务或清单的角色权限。应用身份调用部分任务接口时须配置任务数据权限。
事件订阅与交互回调
订阅消息、资源变更和业务事件，让外部系统及时响应；交互卡片等场景可配置回调。
接入要求先开通对应权限并订阅。自建应用可用 SDK 长连接，仅需主动访问公网；服务端回调方式则要提供可访问的地址并完成验证、验签及相应加解密。
网页应用与界面扩展
把现有 H5 工具嵌入飞书工作台，实现免登录入口，也可开发云文档小组件、多维表格插件和链接预览。
接入要求启用对应应用能力；网页和授权流程需按后台配置首页、重定向地址与安全域名。界面扩展不会自动获得业务数据权限。
02 / REQUIREMENTS
接入条件
- 适用主体
- 企业内部开发者、组织管理员、办公自动化开发者、第三方软件服务商
- 接入方式
- 自定义群机器人 Webhook，可配置签名、关键词或 IP 白名单 / App ID 与 App Secret 换取 tenant_access_token，代表应用调用 / OAuth 用户授权换取 user_access_token，代表用户调用 / 商店应用使用 app_ticket 与应用凭证，再取得获授权租户的访问凭证
- 申请概况
- 群通知可快速接入；业务数据需组织与资源授权
- 企业自建应用开发前需创建或加入飞书组织，并具备应用开发或协作权限；个人加入组织不等于获得企业数据访问权。
- 内部使用选择企业自建应用；面向多个组织分发应选择商店应用，并按服务商资质、上架和安装授权流程办理。
- 接口权限、应用可用范围、应用数据范围和文档等资源权限分别核对；用户令牌还需要真实用户授权。
- 自建应用正式版按租户管理员配置的审核规则发布；免审配置可简化部分流程。商店应用需飞书上架审核及安装租户授权。
- 使用公网回调需完成 URL 验证与安全校验；网页应用需按具体能力登记重定向地址和安全域名。自建应用长连接接收事件无需公网入站域名或固定 IP。
- 企业认证、套餐及特定敏感能力资格以目标租户后台和对应接口要求为准，不能把某项能力的开通条件推广到全部 API。
03 / GET STARTED
开通步骤
- 01
先确定入口形态
只发群通知可从自定义机器人开始；要读写数据、回复消息或管理流程，则创建应用并选定自建或商店类型。
- 02
申请最小权限
根据目标接口申请应用或用户权限，配置可用范围、数据范围；需要文档数据时，再向资源所有者取得授权。
- 03
配置凭证与事件
服务端保存应用凭证；按调用身份取得令牌。需要事件时配置长连接或回调，用户授权场景登记重定向地址。
- 04
先用测试企业验证
使用测试版应用和测试人员核对消息、数据范围、失败处理。测试配置不会自动成为正式企业的有效权限。
- 05
发布正式版
切回正式版，核对权限与范围，创建版本并按企业审核规则发布；商店应用另外完成平台审核和租户安装。
04 / COSTS & LIMITS
费用、边界与测试方式
费用概况
先确认租户套餐和实际额度，再评估自己的部署及外部服务费用。
- 企业自建应用可能受租户总调用额度及接口频控限制，管理员应在当前后台查看实际额度；不将历史临时赠送额度写成长期规则。
- 自定义群机器人推送与普通应用 API 使用不同的频控规则。
- 升级套餐、使用付费业务模块或采购商店应用可能另有费用；官方版本对比与实际合同为准。
- 服务器、域名、数据存储和外部模型等成本由开发者自行承担。
使用范围与限制
- 自定义 Webhook 机器人仅能向所在群推送消息；持有 Webhook 不代表能够读取聊天、通讯录或云文档。
- 获取 API Scope 不等于拥有全部资源权限；应用令牌和用户令牌可访问的数据不同，权限变化后应重新验证。
- 企业自建应用以组织内部使用为主；对外共享机器人等特定能力有自己的范围限制，不能据此当作跨租户通用数据接口。
- 调用频控按接口、应用、租户和套餐等维度计算；同一资源的读写接口可能不同，遇到限流按响应等待再重试。
- 审批、通讯录和任务等业务有各自的数据范围规则，不能用文档协作者权限代替业务权限。
- 飞书中国版与 Lark 的账号、域名及租户环境需分别确认，本条目面向飞书中国版。
如何进行开发测试
- 正式企业租户：使用正式版应用及经批准的权限、范围。
- 测试企业与测试人员：可生成测试版应用，测试配置在隔离租户中生效；完成后需切回正式版发布。
- 私有化部署不支持此处介绍的测试企业与人员功能，其他能力需按部署版本确认。
接入前再确认
- 在开发者后台和版本对比中确认目标租户的开通情况、当前套餐、调用额度与价格。
- 具体接口的应用类型、令牌、敏感字段和数据范围需组合核对；测试租户通过不代表正式租户已获授权。
05 / OFFICIAL SOURCES
官方资料
以下资料用于核对本页内容。申请与使用时，请以对应接口的最新规则为准。
- 01自定义机器人使用指南已核对官方资料 · 2026-10-15
- 02机器人概述已核对官方资料 · 2026-10-15
- 03应用概述：类型与应用能力已核对官方资料 · 2026-10-15
- 04企业自建应用开发流程已核对官方资料 · 2026-10-15
- 05申请 API 权限：身份、审核与测试已核对官方资料 · 2026-10-15
- 06获取访问凭证已核对官方资料 · 2026-10-15
- 07配置应用数据权限已核对官方资料 · 2026-10-15
- 08通讯录概述已核对官方资料 · 2026-10-15
- 09云文档概述：能力与资源授权已核对官方资料 · 2026-10-15
- 10多维表格概述已核对官方资料 · 2026-10-15
- 11日历概述已核对官方资料 · 2026-10-15
- 12审批概述已核对官方资料 · 2026-10-15
- 13任务概述与任务 v2 权限已核对官方资料 · 2026-10-15
- 14使用长连接接收事件已核对官方资料 · 2026-10-15
- 15网页应用概述已核对官方资料 · 2026-10-15
- 16服务端 SDK 概述已核对官方资料 · 2026-10-15
- 17测试企业与人员已核对官方资料 · 2026-10-15
- 18频控策略已核对官方资料 · 2026-10-15
- 19版本对比官方入口 · 细则待复核 · 2026-10-15
- 20开发者后台入口官方入口 · 细则待复核 · 2026-10-15
官方文档核对，未进行接口实测
最近核验 2026-10-15 · 查看核验说明
最近核验 2026-10-15 · 查看核验说明