用途:在用户要求创建 Telegram 机器人、搭建聊天机器人、设置 Webhook、添加内联键盘、处理媒体、接入支付或部署上线时使用。
主要能力:覆盖 Bot API v9.4,支持 Node.js 与 Python。包括通过 @BotFather 获取 token 并调用 https://api.telegram.org/bot<TOKEN>/METHOD_NAME;长轮询(getUpdates)与 Webhook(setWebhook,需 HTTPS,端口 443/80/88/8443)两种更新接收方式;sendMessage 文本与 HTML、MarkdownV2 解析模式;内联键盘与回复键盘、callback_query 处理(callback_data 限 64 字节,需调用 answerCallbackQuery);发送照片、文档、媒体组(2-10 项,上传 50MB、下载 20MB 限制);多步对话状态管理;错误处理(429、403、400、409 及速率限制);setMyCommands 注册命令;支付(sendInvoice、answerPreCheckoutQuery,Telegram Stars 用 XTR);内联模式;群组、频道、论坛话题管理;部署(PM2、Docker、Serverless、VPS)。
使用方式:Node.js 可执行 mkdir my-bot && cd my-bot、npm init -y、npm install node-telegram-bot-api dotenv;Python 可执行 pip install python-telegram-bot python-dotenv。token 存入环境变量,切勿提交到源码。常用库:node-telegram-bot-api、grammy、telegraf、python-telegram-bot、aiogram。
适用场景:从零构建机器人、集成消息功能、交互菜单、媒体处理、支付、内联模式、群组管理与生产部署。
限制:资料未提供具体收费、价格或效果数据;文件大小、callback_data 字节数、速率限制等为资料所述约束。安全上需校验 Webhook 的 X-Telegram-Bot-Api-Secret-Token、验证管理员用户 ID、实施限流、使用 HTTPS 并限制 allowed_updates。