Telegram机器人不仅可以发送文字和图片，还能发送语音消息，这在语音助手、自动播报、语言学习等场景中非常实用。很多人以为这需要复杂的编码，其实通过Telegram官方Bot API的sendVoice方法，只需几个HTTP请求就能实现。本文将从零开始，完整讲解机器人发送语音消息的准备工作、三种实现方式以及常见问题排查。
准备工作：创建机器人与获取凭证
在编写任何代码之前，你需要先拥有一个Telegram机器人以及对应的API Token。步骤如下：
- 在Telegram中搜索@BotFather，发送
/newbot创建新机器人，按提示设置名称和用户名。 - 创建成功后，BotFather会返回一个
token，格式类似123456789:ABCdefGHIjklMNOpqrsTUVwxyz，请妥善保存。 - 获取目标聊天对象的chat_id：将机器人拉入群组或向机器人发送一条消息，然后访问
https://api.telegram.org/bot<你的token>/getUpdates，在JSON响应中找到chat.id字段。
理解语音消息的发送原理
Telegram机器人的语音消息本质上是通过sendVoice方法发送的音频文件。与普通音频不同，语音消息会被Telegram客户端以“语音”样式展示（带波形图标和播放按钮），且通常被压缩为Opus格式（.ogg）。sendVoice方法有四个常用参数：chat_id（必填）、voice（必填，可以是文件ID、URL或multipart上传的文件）、caption（可选，语音说明）、duration（可选，语音时长秒数）。
方法一：通过文件ID发送已上传的语音
如果你希望机器人多次发送同一段语音，最高效的方式是先用其他机器人或工具上传语音到Telegram服务器，获取其file_id。之后发送时直接引用该ID，无需重新上传，速度极快且节省流量。
curl -X POST "https://api.telegram.org/bot<你的token>/sendVoice" \
-d chat_id=<目标chat_id> \
-d voice=<文件ID>方法二：直接上传音频文件
当语音文件在你的本地或服务器上时，可以通过multipart/form-data方式直接上传。支持ogg、mp3、wav等格式，但建议使用Telegram推荐的ogg/opus以获得最佳兼容性。
curl -X POST "https://api.telegram.org/bot<你的token>/sendVoice" \
-F chat_id=<目标chat_id> \
-F voice=@"/path/to/voice.ogg"方法三：通过URL发送外部语音文件
如果你的语音文件已托管在公网URL上（如云存储），可以直接传URL，Telegram服务器会自行下载并发送，无需经过你的服务器中转。
curl -X POST "https://api.telegram.org/bot<你的token>/sendVoice" \
-d chat_id=<目标chat_id> \
-d voice="https://example.com/voice.ogg"注意：URL必须能公网直接访问，且Telegram会校验文件类型和大小（最大50MB）。
完整Python代码示例
以下是一个使用Python requests库发送语音消息的完整脚本，方便你集成到自己的机器人项目中。
import requests
TOKEN = "你的token"
CHAT_ID = "目标chat_id"
VOICE_FILE = "voice.ogg" # 文件路径
url = f"https://api.telegram.org/bot/sendVoice"
files = {"voice": open(VOICE_FILE, "rb")}
data = {"chat_id": CHAT_ID, "caption": "这是一条测试语音"}
response = requests.post(url, data=data, files=files)
if response.status_code == 200:
print("语音发送成功！")
else:
print("发送失败：", response.text)结合键盘与菜单的交互技巧
要让机器人更智能，可以结合Inline Keyboard或Reply Keyboard，让用户点击按钮后触发语音发送。例如使用callback_data传递语音标识，在回调处理器中调用sendVoice。此外，你还可以通过force_reply让用户回复一条语音，再转发给其他聊天对象，实现语音中转功能。
常见问题与错误处理
在实际使用中，你可能会遇到以下问题：
- 400 Bad Request: chat not found：检查chat_id是否正确，机器人是否被对方拉黑或移出群组。
- 语音文件格式不支持：确保文件为ogg、mp3或wav，且未超过50MB。
- 上传超时：如果文件较大，可考虑先上传到Telegram服务器获取file_id，再通过file_id发送。
总结
通过Telegram Bot API的sendVoice方法，发送语音消息变得非常简单。无论是直接上传、引用文件ID还是通过URL，都能快速实现。你只需掌握HTTP请求或熟悉一种编程语言的HTTP库，即可让机器人在聊天中“开口说话”。建议先从上传本地文件开始测试，再逐步扩展到群组管理、自动回复等场景，充分发挥语音消息的互动价值。