Feishu Audio Message

将TTS音频作为可播放的音频消息(非文件附件)发送到飞书聊天。用于用户要求发送语音消息、TTS音频、语音公告等场景。

安装

概览

飞书音频消息工具(Feishu Audio Message)是一个专为飞书企业协作平台设计的实用脚本,其核心功能是将文本通过语音合成技术(TTS)转换为高质量的音频文件,并以可播放的音频消息形式直接发送到指定聊天窗口。与普通的文件附件不同,该工具利用飞书特有的两步API流程,确保接收方在聊天界面中能够像收听语音消息一样即时播放音频内容,极大提升了沟通效率和用户体验。这一能力尤其适用于需要发送语音公告、自动播报通知或向用户传递语音信息的场景,填补了飞书原生功能中缺乏自动化TTS语音消息支持的空白。 该工具基于OpenClaw框架开发,无需复杂的配置即可运行。它会自动读取系统预设的飞书账户凭证,用户只需提供要转换的文本内容和目标聊天ID或用户open_id即可完成操作。支持多种主流TTS语音类型,包括中文男女声和英文男女声,满足不同语言和语调需求。整个调用过程简洁高效,通过一行命令即可实现从文本到语音再到消息的完整链路,非常适合集成到自动化工作流或机器人系统中。 值得注意的是,该工具采用了飞书官方推荐的两步API机制:首先将音频文件以opus格式上传获取file_key,然后将此file_key嵌入到msg_type为audio的消息体中发送。这种设计虽然比直接发送文件稍显复杂,但正是实现真正‘可播放音频消息’的关键所在。开发者在使用时需特别注意两个常见陷阱:一是上传时必须声明file_type为opus,否则会返回错误码234001;二是发送消息时msg_type必须设为audio而非file,否则只会显示为普通附件而无法播放。

核心功能特点

  1. 将任意文本通过TTS技术转换为高质量语音并作为可播放消息发送
  2. 支持中英文多种语音类型,默认使用中文女声
  3. 自动读取系统凭证,无需手动配置飞书Token
  4. 采用两步API流程确保音频消息正确渲染为可播放格式
  5. 兼容群聊和私聊场景,支持chat_id和open_id两种接收方式

适用场景

该工具最典型的应用场景是客服机器人或智能助手系统,当用户需要通过语音方式接收信息时,系统可自动调用此功能将文字回复转为语音消息发送,提升交互自然度。例如,在银行APP的语音客服中,客户询问账户余额后,后台可直接生成语音播报并通过飞书发送给对接人员,避免打字输入的延迟。另一个高频使用场景是企业内部通知系统,如HR部门需要向全体员工发送会议提醒、政策变更等语音公告,传统邮件或文字通知容易被忽略,而语音消息更具亲和力且打开率更高。此外,教育培训机构也可利用该工具制作课程语音摘要,一键推送给学员家长,方便他们随时听取学习要点。 对于运维监控系统而言,当服务器出现告警时,管理员可通过该工具快速将故障详情转为语音通知相关负责人,确保关键信息不被遗漏。特别是在值班期间,语音消息比文字更便于快速理解问题严重性。市场推广活动中,品牌方也可以批量发送语音优惠信息或活动介绍,相比纯文字更能营造亲切感,提高用户参与意愿。所有上述场景都受益于该工具将文本动态转化为真实语音的能力,同时保持了飞书生态内无缝的消息体验。