Telegram Bot 使用指南:从创建到高级配置的完整教程

𝕏 f
Telegram Bot 使用指南:从创建到高级配置的完整教程

Telegram Bot(机器人)是 Telegram 平台最具特色的功能之一。与普通聊天账号不同,Bot 由程序驱动,能够自动回复消息、管理群组、推送通知,甚至对接外部 API 实现复杂的工作流自动化。无论是个人用户想提升效率,还是开发者希望构建智能服务,Telegram Bot 都提供了强大且开放的生态系统。

本指南将系统介绍 Telegram Bot 的核心概念、创建方法、群组使用技巧、常用 Bot 推荐,以及 Bot API 入门知识,帮助你从零开始掌握 Telegram 机器人的完整使用流程。如果你尚未注册 Telegram 账号,建议先阅读 Telegram 注册教程 完成账号准备工作。

什么是 Telegram Bot

Telegram Bot 是运行在 Telegram 平台上的自动化程序账号。它不同于普通用户账号——Bot 没有独立的在线状态,不占用手机号资源,由开发者通过 Telegram Bot API 进行控制。Bot 可以接收用户发送的消息、指令,并根据预设逻辑或实时计算返回响应内容。

从技术架构上看,Telegram Bot 采用典型的请求-响应模型。当用户向 Bot 发送消息时,Telegram 服务器会将该消息推送至开发者配置的 Webhook 地址或由开发者通过长轮询(Long Polling)主动拉取。Bot 处理完毕后,通过 Bot API 将回复内容发送回 Telegram 服务器,再由服务器推送给用户。这种架构使得 Bot 可以部署在任何服务器上,与 Telegram 平台本身完全解耦。

Telegram Bot 的能力边界非常广泛。基础能力包括收发文本、图片、视频、文件、贴纸等消息类型;进阶能力涵盖内联键盘(Inline Keyboard)、支付集成、Web App 小程序、群组管理、频道发布等。Telegram 为 Bot 提供了沙箱化的运行环境,确保 Bot 无法访问非授权的群组数据或用户隐私信息。

从应用场景来看,Telegram Bot 已经覆盖了效率工具、内容聚合、客服系统、社区管理、IoT 控制、加密货币交易等众多领域。Telegram 官方对 Bot 生态持开放态度,不收取任何 API 使用费用,这也是 Telegram Bot 生态能够快速繁荣的重要原因。如果你希望进一步了解 Telegram 的基础设置和功能配置,可以参考 Telegram 安装与设置指南

Telegram Bot 创建和机器人功能展示

如何创建 Telegram Bot

创建 Telegram Bot 的唯一官方途径是通过 @BotFather——这是 Telegram 官方提供的机器人管理工具。以下是完整的创建步骤:

第一步:启动 BotFather

在 Telegram 搜索栏中输入 @BotFather,点击进入对话界面,发送 /start 命令。BotFather 会返回一条欢迎消息,列出所有可用命令。

第二步:创建新 Bot

发送 /newbot 命令,BotFather 会要求你为 Bot 设置一个显示名称(Display Name)。这个名称可以随时修改,支持中文、Emoji 等字符。例如输入「我的助手」。

第三步:设置用户名

接下来 BotFather 会要求设置一个用户名(Username)。用户名必须以 Bot_bot 结尾,只能包含英文字母、数字和下划线,且全局唯一。例如 my_helper_bot。设置成功后,BotFather 会返回 Bot 的 Token——这是一串类似 123456789:ABCdefGhIjKlMnOpQrStUvWxYz 的密钥。

第四步:安全保存 Token

Token 是控制 Bot 的唯一凭证,务必妥善保管。 任何获得 Token 的人都可以完全控制你的 Bot。建议将 Token 存储在环境变量或加密配置文件中,切勿提交至公开代码仓库。如果 Token 泄露,应立即通过 BotFather 发送 /revoke 命令使其失效并重新生成。

第五步:配置 Bot 信息(可选)

创建完成后,你可以通过以下命令进一步配置 Bot:

  • /setdescription — 设置 Bot 的简介,用户在对话页面底部可以看到
  • /setabouttext — 设置 Bot 的「关于」信息
  • /setuserpic — 设置 Bot 头像
  • /setcommands — 设置命令菜单,用户输入 / 时会显示快捷命令列表
  • /setinline — 开启或关闭内联模式(允许 Bot 在任意对话中被 @ 调用)
  • /setjoingroups — 允许或禁止 Bot 加入群组

如何在群组中使用 Bot

将 Bot 添加到群组中可以极大提升群组的协作效率。以下是群组中使用 Bot 的关键操作和注意事项:

添加 Bot 到群组

打开群组设置页面,点击「添加成员」,在搜索栏中输入 Bot 的用户名并添加。需要注意的是,群组管理员才有权限添加 Bot。某些 Bot 可能设置了隐私模式(Privacy Mode),在此模式下 Bot 只能接收以 / 开头的命令消息以及被 @ 的消息,无法读取群组中的普通聊天内容。

Bot 群组权限管理

群组管理员可以精细控制 Bot 的权限:

  • 发送消息:允许 Bot 在群组中主动发送消息
  • 删除消息:允许 Bot 删除群组中的消息(适用于管理类 Bot)
  • 封禁用户:允许 Bot 将违规用户移出群组
  • 置顶消息:允许 Bot 置顶重要公告
  • 添加 Web Preview:控制 Bot 发送的链接是否显示预览卡片
  • 管理视频通话:允许 Bot 发起和管理群组视频通话

常见群组 Bot 应用场景

在群组中,Bot 最常用于以下场景:自动欢迎新成员过滤垃圾消息和违规内容定时推送通知或摘要管理投票和调查集成外部服务(如 GitHub、Jira 的状态通知)。建议在正式使用前,先在测试群组中验证 Bot 的行为是否符合预期。

常用 Bot 推荐

Telegram 生态中有大量高质量的 Bot,以下精选了 8 个实用 Bot,涵盖不同使用场景:

1. @combot(群组管理)

Combot 是最受欢迎的群组管理 Bot 之一,提供自动欢迎新成员、违规词过滤、消息统计、用户活跃度排行、防刷屏等功能。适合中型和大型社区群组使用,免费版即可满足基本需求。

2. @ControllerBot(多功能管理)

ControllerBot 提供丰富的群组管理工具,包括自定义命令、防垃圾消息、用户警告系统、封禁管理、规则展示等。它的自定义命令功能特别强大,可以设置自动回复和快捷指令。

3. @DropMailBot(临时邮箱)

DropMailBot 可一键生成临时邮箱地址,接收到的邮件会实时转发到 Telegram 对话中。适合需要临时注册账号、接收验证码但不想暴露真实邮箱的场景。

4. @telegraph(内容发布)

Telegraph Bot 可以将文字、图片快速发布为 Telegraph 文章,生成可直接分享的链接。适合在 Telegram 中分享长文内容,阅读体验远优于直接发送大段文字。

5. @GmailBot(邮件管理)

GmailBot 可以将你的 Gmail 收件箱与 Telegram 对接,新邮件到达时即时推送通知,并支持在 Telegram 中直接阅读、搜索和管理邮件。

6. @SaveAsBot(收藏管理)

SaveAsBot 支持将任意消息(文字、图片、链接、文件)转发到个人收藏频道,并自动按标签分类整理。适合需要频繁保存资料和灵感的人士。

7. @veezie_bot(视频下载)

Veezie Bot 支持从 YouTube、Twitter、Instagram、TikTok 等主流平台下载视频,直接以文件形式发送到 Telegram 对话中。对于需要保存网络视频的用户非常实用。

8. @ifttt(自动化工作流)

IFTTT Bot 是 IFTTT 自动化平台的 Telegram 接口。通过配置 Applet,可以实现「收到特定消息则触发指定操作」的自动化流程,例如自动将 Telegram 消息同步到 Google Sheets、触发智能家居设备等。

Telegram 常用机器人推荐和应用场景

Bot API 入门

Telegram Bot API 是一套基于 HTTPS 的 RESTful 接口,开发者可以通过 HTTP 请求控制 Bot 的所有行为。官方提供了两种主流的接入方式:

HTTP API(直接调用)

这是最基础的接入方式。开发者直接向 https://api.telegram.org/bot<token>/ 发送 HTTP 请求。例如发送一条文本消息:

curl -X POST "https://api.telegram.org/bot<TOKEN>/sendMessage" \
  -d "chat_id=123456789" \
  -d "text=你好,这是一条来自 Bot 的消息"

所有 API 端点都有完整的文档说明,支持 GET 和 POST 两种请求方式,参数可以以 URL query string 或 JSON body 的形式传递。这种方式适合快速原型开发和简单场景。

Bot API 封装库

对于生产环境,推荐使用官方或社区提供的 SDK 封装库。Python 用户可以使用 python-telegram-botaiogram,Node.js 用户可以使用 telegrafnode-telegram-bot-api,Go 用户可以使用 telebot。这些库封装了底层 HTTP 通信细节,提供了类型安全的方法调用、中间件机制、会话管理等高级功能,显著降低开发门槛。

Webhook 与长轮询

Bot API 有两种接收消息的方式:Webhook长轮询(Long Polling)。Webhook 方式下,Telegram 服务器会主动将新消息推送到你配置的 HTTPS 地址,实时性更好,资源消耗更低,适合部署在云服务器上的正式服务。长轮询方式则由你的程序持续向 Telegram 服务器发起请求获取新消息,适合开发调试和小规模部署。

Telegram Bot API 开发接口介绍

常见问题 FAQ

Bot 创建后用户找不到怎么办?

Bot 创建完成后,用户可以通过搜索 Bot 的用户名找到它。确保用户名没有拼写错误,且以 _botBot 结尾。你也可以将 Bot 的 t.me/<username> 链接直接分享给用户,点击即可打开对话。

Bot Token 泄露了怎么办?

立即前往 BotFather 对话界面,发送 /token 命令,选择 Revoke current token 选项使旧 Token 失效,系统会自动生成新 Token。旧 Token 失效后,任何使用旧 Token 的程序都将无法继续控制 Bot。

Bot 可以主动发送消息吗?

可以,但有限制。Bot 可以主动向曾经与其发起过对话的用户、以及在同一个群组中的用户发送消息。Bot 不能向从未互动过的用户主动发送消息(这是 Telegram 的反垃圾机制)。另外,Bot 向同一用户发送消息的频率有限制,建议控制在一秒内不超过一条。

隐私模式(Privacy Mode)有什么影响?

开启隐私模式后,Bot 在群组中只能接收以下类型的消息:以 / 开头的命令、回复 Bot 消息的消息、通过内联键盘触发的回调查询、以及 Bot 被管理员权限允许的所有消息类型。普通聊天消息 Bot 将无法读取。可以通过 BotFather 发送 /setprivacy 命令切换此设置。

一个账号可以创建多少个 Bot?

Telegram 对单个账号创建 Bot 的数量没有明确上限。实际上,用户可以根据需要创建任意数量的 Bot。每个 Bot 都有独立的 Token 和配置,互不影响。

Bot 可以读取群组历史消息吗?

不可以。Bot 只能接收到被添加到群组之后的新消息,无法读取群组的历史消息记录。这是 Telegram 的隐私保护设计。

Bot 和用户账号有什么区别?

Bot 是程序账号,没有独立的在线状态,不支持语音通话,不能主动添加联系人加入群组(需要被邀请)。Bot 无法查看其他 Bot 的在线状态。但 Bot 有一些用户账号不具备的特权:可以发送超大文件(单个文件最大 2GB)、可以无限量创建内联查询结果、可以为群组成员设定自定义标题等。更多关于 Telegram 账号和功能的疑问,可以查阅 Telegram 常见问题解答


本文介绍了 Telegram Bot 的核心概念、创建流程、群组使用方法、常用 Bot 推荐以及 API 入门知识。Telegram Bot 生态仍在快速发展中,无论是作为工具使用者还是开发者,都能在其中找到丰富的可能性。建议从简单的 Bot 开始尝试,逐步探索更高级的自动化和开发能力。

更多 Telegram 使用技巧和安全指南,请访问我们的主页。