Voice Message

Voice Message

Send text as voice messages to any chat channel.

Prerequisites

• edge-tts — Microsoft Edge TTS (pip install edge-tts)
• ffmpeg / ffprobe — audio conversion and duration detection

Default Voices

• Chinese: zh-CN-XiaoxiaoNeural
• English: en-US-JennyNeural
• Other languages: see references/voices.md

Step 1: Generate Voice File

Use scripts/gen_voice.sh to convert text to an ogg/opus file:

scripts/gen_voice.sh "你好" /tmp/voice.ogg
scripts/gen_voice.sh "Hello" /tmp/voice.ogg en-US-JennyNeural

Arguments: <text> <output.ogg> [voice]

• If voice is omitted, defaults to zh-CN-XiaoxiaoNeural.

Step 2: Send by Channel

Generic (Telegram, Signal, WhatsApp, etc.)

Use the message tool directly:

action=send, asVoice=true, filePath=/tmp/voice.ogg

This works for most channels. Telegram confirmed working.

Feishu/Lark

⚠️ Feishu does NOT support asVoice=true via the message tool. You must use the dedicated script.

Use scripts/send_feishu_voice.sh:

scripts/send_feishu_voice.sh /tmp/voice.ogg <receive_id> <tenant_access_token> [receive_id_type]

• receive_id_type: open_id (default), chat_id, user_id, union_id, email
• The script handles upload (as opus with duration) and sends as audio message type to produce a voice bubble.
• To get tenant_access_token, use the Feishu tenant token API with your app credentials.

Discord

Discord voice messages require a waveform and special flags.

1. Generate ogg with scripts/gen_voice.sh
2. Generate waveform: python3 scripts/gen_waveform.py /tmp/voice.ogg
   • Outputs JSON: {"duration_secs": 4.2, "waveform": "base64..."}
3. Send via Discord API with flags: 8192 (IS_VOICE_MESSAGE) and the waveform/duration in attachments metadata.
   • Missing waveform/duration causes error 50161.

Fallback

If asVoice=true does not produce a voice bubble on a channel:

1. Try sending via the platform's native API
2. If native API unavailable, send as audio file attachment