Feishu Voice Bubble

Send native voice bubble messages in Feishu using Edge TTS + opus format.

Why This Exists

Feishu bot API only renders voice bubbles for audio message type with opus format.

Standard TTS outputs mp3 → Feishu shows it as a file attachment, not a voice bubble.

This skill: Edge TTS → opus → Feishu audio → native voice bubble.

Prerequisites

npm install node-edge-tts

No API keys required. Edge TTS is free.

Usage

Basic

node scripts/gen_voice.js "你好世界" output.opus

With Options

node scripts/gen_voice.js "播报内容" output.opus --voice zh-CN-YunxiNeural --rate +15% --pitch -5%

Long Text Auto-Split

node scripts/gen_voice.js "很长的文本..." output.opus --split 500

Produces output_1.opus, output_2.opus, etc. Split at sentence boundaries.

Send to Feishu

{ "action": "send", "filePath": "output.opus" }

The .opus extension triggers Feishu's native audio message type automatically.

Arguments

Chinese Voices

How It Works

1. Edge TTS converts text → webm-24khz-16bit-mono-opus
2. Saved as .opus file
3. Feishu plugin detects .opus → uploads as opus type → sends as audio message
4. Feishu client renders native voice bubble with play button

Limitations

• Requires internet (Microsoft hosted service)
• No SLA (free public service)
• ~10 min max audio per request
• node-edge-tts must be installed in the working directory or globally