🇨🇳中文介绍

飞书语音消息技能

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

使用场景

在以下场景中使用此技能：

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

要求

1. ffmpeg - 用于将音频转换为 OPUS 格式
2. Node.js 18+ - 用于运行发送脚本
3. 飞书应用凭证：
   • App ID
   • App Secret
   • 目标用户的 Open ID

工作原理

1. 将音频转换为 OPUS 格式 - 飞书要求音频为 OPUS 格式
2. 上传音频文件 - 以 file_type: opus 和时长参数上传到飞书
3. 发送语音消息 - 使用 msg_type: audio 发送消息

使用方法

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

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

步骤 2：获取音频时长

ffprobe -v quiet -show_format -print_format json input.mp3
# 在输出中查找 "duration" 字段

步骤 3：运行脚本

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

或使用环境变量：

export FEISHU_APP_ID="cli_xxx"
export FEISHU_APP_SECRET="xxx"
node scripts/send-voice.mjs --user-id "ou_xxx" --audio-file "audio.opus" --duration 3480

API 详情

1. 获取 Tenant Access Token

POST https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/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: <milliseconds>
file: <binary>

3. 发送语音消息

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

{
  "receive_id": "ou_xxx",
  "msg_type": "audio",
  "content": "{\"file_key\":\"file_v3_xxx\"}"
}

重要说明

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

示例输出

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

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

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

🎉 完成！

故障排除

每周安装次数

–

代码仓库

futaoj/feishu-message

首次出现

–

安全审计

Gen Agent Trust HubPassSocketFailSnykFail