核心用法
飞书全员广播(Feishu Broadcast) 是一款面向企业租户管理员的消息推送工具,能够将文本、富文本(Markdown)或媒体内容(图片/GIF/贴纸)批量发送至飞书组织的全部成员。该工具通过动态调用飞书 OpenAPI 获取实时用户列表,避免硬编码维护用户 ID。
主要功能
- 动态用户获取:自动拉取租户内全部用户,支持组织架构变更后的实时同步
- 富文本渲染:依赖
feishu-post技能解析 Markdown,支持标题、列表、链接等格式 - 多媒体支持:通过
feishu-sticker技能发送 WebP/GIF 动图及静态贴纸 - 安全机制:内置速率限制(Rate Limiting)防止 API 超限;提供 Dry Run 模式用于发送前验证
使用方式
通过命令行参数组合实现灵活调用:
--title/--text:直接输入标题与正文--text-file:从 Markdown 文件读取长文本(推荐用于周报、公告)--image:指定媒体路径发送图片或贴纸- 支持组合使用,同时发送图文消息
显著优点
1. 零维护成本:无需手动维护用户列表,自动同步组织架构
2. 格式友好:Markdown 原生支持,适合技术团队撰写结构化公告
3. 扩展性强:模块化依赖设计,可独立升级消息渲染或媒体处理能力
潜在局限
- 依赖前置:必须预先安装
feishu-post和feishu-sticker两个子技能,否则无法运行 - 权限门槛:需要飞书管理员权限获取 tenant_access_token 及用户列表读取权限
- 无交互反馈:当前版本未提及发送状态回执或失败重试机制
- 平台锁定:仅支持飞书生态,无法迁移至其他 IM 平台
适合人群
- 飞书企业管理员 / IT 运维人员
- 需要定期群发公告的 HR、行政或项目负责人
- 技术驱动型团队(偏好 Markdown 工作流)
常规风险
- 信息过载风险:全员广播易被滥用,导致员工通知疲劳
- 权限泄露风险:管理员凭证若保管不当,可能被用于发送伪造公告
- 内容合规风险:群发的 Markdown/媒体内容需经审核,防止敏感信息外泄
- API 稳定性依赖:飞书 API 变更或限流可能影响发送成功率