飞书语音消息技能

该技能支持通过开放API向飞书/Lark用户发送语音消息（非文件附件）。

使用场景

在以下情况下使用该技能：

• - 用户希望向飞书发送语音消息
• 用户希望将音频（MP3、WAV等）转换并作为语音消息发送
• 用户明确要求发送音频消息，而非文件上传

前置要求

1. 1. ffmpeg - 用于将音频转换为OPUS格式
2. Node.js 18+ - 用于运行发送脚本
3. 飞书应用凭证：

工作原理

1. 1. 将音频转换为OPUS格式 - 飞书要求音频为OPUS格式
2. 上传音频文件 - 以filetype: opus格式上传至飞书，并附带时长信息
3. 发送音频消息 - 以msgtype: audio格式发送消息

使用方法

步骤1：将音频转换为OPUS格式

bash
ffmpeg -i input.mp3 -c:a libopus -b:a 32k output.opus

步骤2：获取音频时长

bash
ffprobe -v quiet -showformat -printformat json input.mp3

在输出中查找duration字段

步骤3：运行脚本

bash
node scripts/send-voice.mjs \
--app-id cli_xxx \
--app-secret xxx \
--user-id ou_xxx \
--audio-file audio.opus \
--duration 3480

或使用环境变量：
bash
export FEISHUAPPID=cli_xxx
export FEISHUAPPSECRET=xxx
node scripts/send-voice.mjs --user-id ou_xxx --audio-file audio.opus --duration 3480

API详情

1. 获取租户访问令牌

POST https://open.feishu.cn/open-apis/auth/v3/tenantaccesstoken/internal

2. 上传音频文件

POST https://open.feishu.cn/open-apis/im/v1/files
Content-Type: multipart/form-data

file_type: opus
file_name: voice.opus
duration: <毫秒>
file: <二进制数据>

3. 发送音频消息

POST https://open.feishu.cn/open-apis/im/v1/messages?receiveidtype=open_id

{
receiveid: ouxxx,
msg_type: audio,
content: {\filekey\:\filev3_xxx\}
}

重要提示

• - 音频必须为OPUS格式 - MP3/WAV格式将失败
• 时长为毫秒单位
• 应用必须启用机器人能力
• 速率限制：每个用户/聊天5 QPS

示例输出

🎤 开始发送语音消息到飞书...

📁 音频文件: /path/to/voice.opus
⏱️ 时长: 3480ms

✅ 获取 Tenant Access Token 成功
✅ 上传语音文件成功, filekey: filev300uhxxx
✅ 发送语音消息成功!
消息 ID: om_x100b5731827e6ca4b10d48c15dfa3ab

🎉 完成！

故障排除