飞书集成开发者技能定位为飞书开放平台(国际版称 Lark)的全栈集成专家,覆盖从底层 API 调用到高层业务编排的各层能力,能够在飞书生态内实现企业 OA 审批、数据管理、团队协作与业务通知。
主要能力分为六个方向。机器人开发:支持基于 Webhook 的消息推送型自定义机器人,以及基于飞书应用的交互型机器人,可处理命令、会话与卡片回调;消息类型覆盖文本、富文本、图片、文件与交互式消息卡片;支持机器人入群、@机器人触发与群事件监听。要求所有机器人在 API 失败时做优雅降级,返回友好错误而非静默失败。
消息卡片与交互:可用卡片搭建工具或原始 JSON 构建交互卡片,处理按钮点击、下拉选择、日期选择等回调,通过 message_id 更新已发送卡片内容,并使用消息卡片模板实现可复用设计。
审批流集成:通过 API 创建与管理审批定义,提交审批实例、查询审批状态、发送提醒;订阅审批状态变更事件以驱动下游业务逻辑,并将审批回调接入外部系统,在审批通过时自动触发业务操作。
多维表格(Bitable):支持表记录的创建、查询、更新与删除,自定义字段类型与配置,视图创建切换、筛选与排序,以及与外部数据库或 ERP 系统的双向数据同步;含批量创建示例,单批最多 500 条记录。
单点登录与身份认证:提供 OAuth 2.0 授权码流程实现 Web 应用自动登录,支持 OIDC 协议对接企业 IdP,支持第三方网站接入飞书扫码登录,并通过通讯录事件订阅同步用户与组织架构信息。飞书小程序部分涉及开发框架与组件库、JSAPI 调用(用户信息、地理位置、文件选择)、与 H5 应用的容器与 API 差异、发布流程及离线能力与数据缓存。
使用方式上,技能给出项目目录结构建议(config、auth、bot、approval、bitable、sso、webhook、utils 等模块),并附令牌管理、卡片构建与发送、事件订阅分发、卡片回调、多维表格操作、审批实例创建、OAuth 扫码登录等代码示例。核心规范要求:区分 tenant_access_token 与 user_access_token 使用场景并缓存令牌、事件订阅需校验 verification token 或使用 Encrypt Key 解密、敏感信息不得硬编码而应使用环境变量或密钥管理服务、Webhook 必须使用 HTTPS 并验签、API 调用需实现重试以处理限流(HTTP 429)与瞬时错误、检查响应 code 字段并记录日志、卡片 JSON 需本地校验、事件处理需幂等、优先使用官方 SDK(oapi-sdk-nodejs / oapi-sdk-python)、遵循最小权限原则并区分应用权限与用户授权,敏感权限需管理员在管理后台手动审批。
适用场景包括企业内部 OA 审批自动化、业务数据在多维表格与外部系统之间的同步、机器人与消息卡片驱动的团队协作和业务通知、第三方系统接入飞书登录与通讯录同步等。限制方面,该资料为开发者技能说明,未提供具体收费、价格、平台支持范围与效果数据;实际可用权限取决于飞书开放平台及企业管理后台的授权配置。