Telegram机器人上传文件实现全攻略：从API调用到实际部署的详细指南

在开发Telegram机器人时，文件上传是一项核心功能。无论是发送文档、图片、视频还是音频，都需要借助Bot API完成。本文将从最基础的实现原理出发，手把手教你在Telegram机器人中上传文件，并提供多种语言的具体代码示例，帮助你快速上手。

一、Telegram机器人上传文件的三种核心方式

Telegram Bot API允许机器人上传文件到聊天，官方提供了三种方式：

使用文件ID：如果文件已经上传过一次，Telegram会返回一个唯一的file_id，之后可以直接用该ID发送，无需重新上传。
使用URL：将文件托管在外部服务器上，通过公开的URL发送给Telegram，Telegram会自动抓取并发送。
Multipart/form-data：将本地文件直接以二进制流形式通过POST请求上传，适用于需要即时发送的场景。

二、准备工作：获取Bot Token与了解API地址

在开始上传文件之前，你需要在Telegram中创建一个机器人。通过官方BotFather创建后，会获得一个以数字和字母组成的Token，形如123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11。

所有与文件上传相关的API调用都基于https://api.telegram.org/bot<token>/方法名的格式。例如，发送文档的方法名为sendDocument。

三、通过HTTP请求直接上传文件（以sendDocument为例）

最直接的方式是使用HTTP客户端发送POST请求，将文件以multipart/form-data格式附加。下面以Python的requests库为例：

import requests

token = "YOUR_BOT_TOKEN"
chat_id = "TARGET_CHAT_ID"
file_path = "/path/to/your/file.pdf"

url = f"https://api.telegram.org/bot/sendDocument"
files = {'document': open(file_path, 'rb')}
data = {'chat_id': chat_id, 'caption': '这是一个测试文件'}

response = requests.post(url, data=data, files=files)
print(response.json())

注意：上传文件时，必须将文件放在files字段中，而聊天ID等信息放在data字段中。如果文件较大，建议使用流式上传以减少内存占用。

四、使用开发库简化上传操作

手动构造HTTP请求容易出错，更推荐使用成熟的Bot库，它们封装了底层细节。以下是常用语言的上传示例：

4.1 Python：使用python-telegram-bot库

from telegram import Bot
from telegram.ext import Updater

bot = Bot(token="YOUR_BOT_TOKEN")
bot.send_document(chat_id="TARGET_CHAT_ID", document=open("/path/to/file.pdf", "rb"))

4.2 Node.js：使用node-telegram-bot-api库

const TelegramBot = require('node-telegram-bot-api');
const bot = new TelegramBot('YOUR_BOT_TOKEN');

bot.sendDocument('TARGET_CHAT_ID', '/path/to/file.pdf', {caption: '文件说明'});

五、上传其他类型的文件

Telegram Bot API为不同媒体类型提供了专用方法：

sendPhoto: 发送图片，支持JPG、PNG等。
sendVideo: 发送视频，MP4、MOV等。
sendAudio: 发送音频，MP3、M4A等。
sendVoice: 发送语音消息，OGG格式。

这些方法的上传方式与sendDocument完全一致，只需将POST参数中的document换成对应的字段名（如photo、video等）。

六、常见错误与调试技巧

413 Payload Too Large: 文件超过50MB上限，需要分片或压缩文件。
Bad Request: file is too big: 同样表示文件超出Telegram限制。
Unauthorized: Token无效或已被撤销，检查Token拼写。
Chat not found: chat_id错误或机器人不在该聊天中。
Network timeout: 上传时网络不稳，可以增加超时时间并重试。

七、进阶：通过URL发送文件与设置缩略图

如果文件已经托管在公网，可以直接传递URL字符串，Telegram会后台下载并发送。例如：

bot.send_document(chat_id, "https://example.com/file.pdf")

对于图片和视频，还可以指定缩略图（thumb）参数，提升用户体验。

总结

Telegram机器人上传文件并不复杂，掌握multipart/form-data方式与常用库的用法后，你可以轻松实现各种文件分享功能。关键在于理解API参数和正确处理错误。希望本教程能帮助你顺利完成机器人开发。