Back to Details

voice

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Voice Skill

语音技能

Send a voice message (text-to-speech) to the user.
向用户发送语音消息（TTS）。

Send a Voice Message

发送语音消息

bash
undefined
bash
undefined

Normal context (active Telegram chat)

Normal context (active Telegram chat)

curl -s -X POST http://localhost:23001/api/voice/send
-H 'Content-Type: application/json'
-d '{"text": "Hello! How are you today?"}'
curl -s -X POST http://localhost:23001/api/voice/send
-H 'Content-Type: application/json'
-d '{"text": "Hello! How are you today?"}'

From cron job or background task (specify chatId)

From cron job or background task (specify chatId)

curl -s -X POST http://localhost:23001/api/voice/send
-H 'Content-Type: application/json'
-d '{"text": "Hello!", "chatId": "TELEGRAM_CHAT_ID"}'

Response: `{"success": true}` or `{"success": false, "error": "..."}`
curl -s -X POST http://localhost:23001/api/voice/send
-H 'Content-Type: application/json'
-d '{"text": "Hello!", "chatId": "TELEGRAM_CHAT_ID"}'

响应：`{"success": true}` 或 `{"success": false, "error": "..."}`

When to Use

适用场景

  • User sent you a voice message and you want to reply with voice
  • Short, casual replies that feel natural as speech
  • Storytelling or narration moments
  • 用户发送了语音消息，你想用语音回复
  • 简短、随意的回复，用语音更自然
  • 讲故事或旁白的场景

When NOT to Use

不适用场景

  • Long technical explanations (better as text)
  • Code snippets or structured data
  • When the user explicitly prefers text
  • 冗长的技术说明（文本形式更合适）
  • 代码片段或结构化数据
  • 用户明确偏好文本的情况

Tips

小贴士

  • Keep voice messages concise — under 2-3 sentences works best
  • Use natural, conversational language
  • Only works when there's an active Telegram chat context
  • 语音消息要简洁——最好控制在2-3句话以内
  • 使用自然、口语化的语言
  • 仅在存在活跃Telegram对话上下文时可用