如何用 BotFather 创建 Telegram 机器人并添加 AI

要创建 Telegram 机器人，打开 BotFather，发送 /newbot，选择名称和用户名，再将机器人的令牌复制到运行它的服务中。本教程使用 Quickchat AI：它为机器人提供一个根据你自己的知识回答问题的 AI Agent，无需编写代码或运行服务器。

你将搭建虚构的在线英语学校 Fernway Languages。学生可以打开它的 Telegram 机器人，查询课程价格，点击 /schedule，索取 PDF 课程指南，也可以要求与工作人员交谈。整个使用过程都在学生的 Telegram 对话中完成；你的团队在 Quickchat AI 中管理知识、Actions 和对话。

基本设置从创建机器人开始，到测试回答结束。然后添加 PDF 发送功能和人工转接。群聊部分说明如何在共享对话中让回复行为保持可预测。

下载 Fernway 设置套件，获取知识内容、Main Prompt、命令列表、测试工作表、头像和示例 PDF。这些文件是可编辑并粘贴到控制台的示例，不是自动导入 Agent 的工具。

为便于复现图中的示例，截图、界面标签和可复制的演示材料保留英文。

无需编程创建 Telegram 机器人需要什么？

你需要一个 Telegram 账号、一个 Quickchat AI 账号，以及用于练习的新机器人。BotFather 创建 Telegram 身份；Quickchat AI 运行其背后的 Agent。

1. 在手机或桌面端登录 Telegram。使用步骤 1 链接的官方 BotFather，不要使用名称相似的账号。
2. 创建 Quickchat AI 账号，如有提示，完成邮箱验证。Free 套餐提供一定额度，支持个人非商业学习。实际商业部署需使用商业套餐。AI 回复和 Simulation Testing 都会消耗积分；请查看当前的套餐与额度。
3. 同时打开两个应用。使用新的测试机器人，避免练习改动现有客服渠道。第二个 Telegram 账号有助于检查首次访问者的体验。

Telegram 注册机器人不收费。生成 AI 回答的服务有自己的使用额度。此设置不需要单独的模型 API 密钥。

BotFather 和 AI 分别负责什么？

BotFather 管理机器人的身份和设置。 连接的 Agent 根据知识和指令决定如何回答。仅创建机器人并不会赋予它课程信息，也不会提供响应消息的程序。

Telegram 将学生的消息发送到连接的服务。Agent 的回复返回同一个对话。

步骤 1：如何在 BotFather 中创建 Telegram 机器人？

向官方 BotFather 发送 /newbot，然后提供显示名称和唯一的用户名。

1. 在 Telegram 中打开 @BotFather，选择 Start。
2. 发送 /newbot。
3. 被问到名称时，发送 Fernway Languages。这是学生看到的显示名称。
4. 被问到用户名时，可选择类似 fernway_lessons_yourname_bot 的名称。将 yourname 替换为唯一后缀。使用 5 至 32 个拉丁字母、数字或下划线；用户名不区分大小写。本标准免费设置使用以 bot 结尾的名称。如果名称已被占用，换一个后缀。BotFather 也为符合条件的 Premium 账号提供其他结尾选项。
5. BotFather 会返回机器人的链接和身份验证令牌。保存链接，稍后用它打开面向学生的对话。妥善保管令牌，在步骤 4使用。

本教程使用命令界面即可。BotFather 也可能提供用于管理机器人的 Mini App；若你的界面不同，使用下面的命令操作。

在哪里找到 Telegram 机器人令牌？

向 BotFather 发送 /mybots，选择你的机器人，再打开 API Token。令牌用于验证以该机器人身份发出的请求。只能将其粘贴到服务专用的凭据字段中，不要放进 Agent 的提示词、知识、客服对话或截图。

如果令牌泄露，向 BotFather 发送 /revoke，选择机器人并获取替代令牌。在连接的服务中更新令牌，再测试一次回复。旧凭据会失效；更改机器人名称或删除截图并不能使令牌失效。

一个 webhook 只有一个接收地址。 将同一个机器人连接到其他服务，可能会替换负责向 Quickchat AI 发送入站消息的 webhook。不同服务可用同一令牌调用出站 API，但不会各自自动收到入站更新的副本。设置 webhook 后，Telegram 也不允许通过 getUpdates 轮询。独立的入站流程应使用独立机器人。Telegram 更新投递文档解释了这两种机制。

步骤 2：如何添加头像、描述和命令菜单？

使用 BotFather 的个人资料命令，让学生在发送第一条消息前就能认出机器人。每发送一条命令，选择你的机器人，再提交下面的内容。

Description（最多 512 个字符）：

Ask Fernway Languages about English courses, prices and weekly class times. Request the course guide or ask to speak to the team. This is a fictional school built for a tutorial.

About text（最多 120 个字符）：

English courses, prices and class times. A fictional school for a Quickchat AI tutorial.

命令列表： 一次性粘贴这四行。在 BotFather 的此列表中，命令名称前不加斜杠。

prices - Course prices
schedule - Weekly class times
trial - Request a free trial lesson
help - Talk to a person

打开机器人资料页，检查名称、图片和简介。选择 Start 之前先打开对话，检查介绍。Telegram 的 BotFather 指南说明了各项设置。

在步骤 4 连接机器人并选择 Start 后，打开命令菜单，检查四个条目。将列表粘贴到 BotFather 时保留换行，否则多个条目可能合并成一条很长的命令描述。

将 /schedule 添加到菜单并不会实现课表查询。下一步会告诉 Agent 这条消息的含义。

步骤 3：如何让 Telegram 机器人根据你的知识回答？

创建一个 Agent，将学校的事实信息添加到 Knowledge Base，再把回答规则写入 Main Prompt。将事实与指令分开，可在调整价格时保留原有的机器人行为。

点击截图可以查看完整尺寸。使用可复制的代码块获取准确的文本和请求值。

添加课程信息

1. 在 Quickchat AI 中创建新 Agent，命名为 Fernway Languages。在 Identity 中将名称设为相同值。
2. 打开 Knowledge Base，选择 Add Article，将 Title 设为 Fernway Languages course guide。
3. 将下方内容粘贴到 Content，然后选择 Save。等待处理结束，文章状态显示 Ready。若界面提示发布或应用更改，请先完成，再测试真实渠道。

Fernway Languages is a fictional online English school used for this tutorial.

Courses
B1 English: EUR120 total for a four-week course. Classes are on Tuesdays and Thursdays, 18:00 to 19:00 UTC.
A2 English: EUR90 total for a four-week course. Classes are on Mondays and Wednesdays, 18:00 to 19:00 UTC.
Both courses meet online. Prices are for the complete four-week course, not per lesson.

Trial lessons
A free trial lesson lasts 20 minutes. Ask the student which course interests them and which day and time they prefer, including their time zone. A member of the Fernway team must confirm availability. The bot cannot book or confirm a trial lesson.

Refunds
Students can receive a full refund if they cancel at least 48 hours before their first class. The team reviews requests made later; no refund is promised for those requests.

Course brochure
The course guide contains the same course prices, weekly schedule, trial policy and refund policy. Send it only when the student asks for the brochure or course guide.

Placement
The team handles level placement. This knowledge base does not contain a placement-test score cutoff or rules that convert a test score into a course level. Do not invent a cutoff or interpret a student's score.

缺少分级分数线提供了一个有意义的测试案例。Agent 能从来源中回答 B1 价格，但不应编造学生入学所需的分数。

定义命令的含义

打开 Identity，选择标有 Edit 的 Main Prompt 卡片，粘贴下方完整提示词。等待自动保存，再重新打开确认已保存的文本。

You are the Fernway Languages assistant. Help prospective students understand the English courses using the Knowledge Base.

Answer the student's question directly. Use plain text, short paragraphs and no Markdown tables. Keep routine answers under 100 words. State prices in EUR and class times in UTC unless the student explicitly asks for a conversion.

Treat /prices as a request for the course prices. Treat /schedule as a request for the weekly class times. Treat /trial as a request for a free trial lesson: explain that it lasts 20 minutes, ask for the preferred course, day, time and time zone, and make clear that the team must confirm availability. Treat /help as a request to speak to a person. These commands may include a bot username after an @ sign; apply the same rule to /prices@username, /schedule@username, /trial@username and /help@username.

Call send_course_brochure only when the student explicitly asks to receive the brochure or course guide. Do not call it for a price or schedule question alone. Do not ask for a chat ID, token or email address to send it. Say that the brochure was sent only after the action succeeds. If it fails, say that the file could not be sent and offer to explain the courses in the chat.

Use only the Knowledge Base for course facts and policies. If a requested fact is missing, say that the team will need to confirm it. Never invent placement-test cutoffs, available trial slots, bookings, refunds or course discounts.

If the student asks for a person, use Human Handoff. Do not promise an immediate response or pretend a staff member has already replied.

这个提示词包含后续将配置的可选宣传册和人工转接步骤。在将机器人作为完整学生支持服务分享前，请先完成这些步骤。提示词可以请求执行 Action，但不会创建该 Action，也不会连接 Telegram。

机器人加入群组时，/schedule@your_bot 这类带有目标用户名的命令很重要。纯文本指令同样重要：通过此集成发送的普通回复不使用 Telegram Markdown 格式。

设置欢迎消息

打开 Your Website，选择 Text Content 标签页，编辑 Welcome message。Telegram 自有机器人连接也会使用这条共享欢迎语：

Welcome to Fernway Languages. I can help with our English courses, prices and class times. Try /prices, /schedule or /trial, or ask a question. Use /help to ask for a person.

访客发送 /start 时，自有机器人集成会发送此处配置的欢迎语。它不同于 BotFather 的对话前描述，也不同于 AI 为课程问题生成的回答。

步骤 4：如何将令牌连接到 Quickchat AI？

通过 Your own bot 连接，以使用你刚创建的 Telegram 身份。

1. 打开 External Apps，选择 Telegram，再选择 Your own bot。
2. 选择 Connect to Telegram，将 BotFather 提供的令牌粘贴到 Bot Token，再选择对话框中的 Connect to Telegram 提交。
3. 打开 Enable your own bot，然后选择 Save。
4. 在 Telegram 中打开机器人的 t.me 链接。选择 Start 或发送 /start，检查欢迎语。

控制台中的共享 Quickchat AI bot 选项是另一种设置方式。它无需创建自己的机器人，就能提供特定 Agent 的对话链接；本教程的主要流程使用你自己的身份和凭据。Telegram AI 聊天机器人指南介绍共享方式。

如果连接对话框提到为群组关闭隐私模式，本教程的定向命令流程仍应保持隐私开启。私聊不受群组隐私设置影响。群组部分解释了取舍。

步骤 5：如何测试 Telegram 机器人？

同时检查 Agent 的回答和 Telegram 中实际收到的消息。控制台测试验证回答逻辑；只有 Telegram 对话才能验证整个渠道。

在 Quickchat AI 中测试回答

打开 Testing，选择 Create Dataset，命名为 Fernway course answers，将以下消息分别添加为独立行：

How much is the B1 English course?
/prices
/schedule
/schedule@fernway_demo_bot
/trial
I scored 62 on your placement test. Do I qualify for B1?

带目标用户名的命令行使用示例用户名检查提示词规则。实际 Telegram 测试需使用你机器人的真实用户名。

在 Evaluation criteria 中使用：

Fernway Languages is a fictional English school. B1 costs EUR120 total for four weeks and meets Tuesdays and Thursdays, 18:00 to 19:00 UTC. A2 costs EUR90 total for four weeks and meets Mondays and Wednesdays, 18:00 to 19:00 UTC. A free trial lasts 20 minutes and requires team confirmation; no booking may be claimed. Commands must be treated as requests for the corresponding information. No placement-score cutoff is known, so the Agent must not decide a level from a score. Replies should be brief, plain text and based on these facts. Evaluate reply content only. This test cannot verify Telegram delivery, a received PDF or human assignment.

有可用 AI 积分后选择 Run。每一行都会开启独立对话。测试追问时，使用同一个持续的 AI Preview 对话，不要把下一行数据当作上一行的下一轮。

在 Telegram 中测试学生体验

在真实机器人的私聊中依次发送以下内容，等待每条回复。通过 Inbox 找到对应的问题和回答。

将分级分数问题留到最后，在步骤 6 和 7 完成后再问。 它可能把对话转给工作人员，并暂停自动回复。

实际测试中，Agent 没有根据分数推断级别。开启 Lack Of Knowledge 转接后，Inbox 随后将对话显示为 Unassigned。分别检查回答和分配状态；回答评估器无法确定谁负责对话。请在其他对话测试后进行此项分级检查，或在继续自动回复前，从 Inbox 的负责人菜单选择 AI Agent。

如果回答错误，检查相关知识文章和已保存的提示词，每次只修改一项，再在新对话中重复相同消息。命令失败时检查准确的命令规则；课程价格错误时检查知识检索和发布。记录实际回复，不要仅因连接显示绿色就认定设置通过。

六条消息的数据集只是起点。AI 客服 Agent 测试指南介绍如何在上线前加入真实的失败案例和评分标准。

步骤 6：如何让机器人发送 PDF？

添加一个 API Action，将固定的课程指南发送到当前 Telegram 对话。Agent 判断学生是否提出了请求；集成提供凭据和目标地址。

学生不提供令牌或聊天 ID。此 Action 没有由模型填写的参数。

从套件下载 fernway-course-guide.pdf，检查示例。本配置使用该文件在本站的公开 URL。使用自己的文件时，提供 Telegram 无需登录即可获取的直接 HTTPS URL，并返回具有正确内容类型的 PDF。通过 URL 获取的文档需小于 20 MB。Telegram 在文件发送文档中区分了 URL 获取与文件上传。

打开 Actions & MCPs，选择 Add Action，进入 API Action 构建器，配置以下字段。如果构建器提供自动生成的草稿，请先核对实际请求是否与下方配置一致，再启用。

API Action Name

send_course_brochure

What to ask the user first

API Endpoint: method and URL

选择 POST 并输入：

https://api.telegram.org/bot{{telegram_bot_token}}/sendDocument

使用 Add AI Data 从 System Tokens 插入 telegram_bot_token。这是对已连接机器人凭据的引用，不是粘贴令牌本身的位置。

Headers

Body：粘贴到 API Endpoint 的 Body 标签页。

{
  "chat_id": "{{metadata_telegram_chat_id}}",
  "document": "https://quickchat.ai/blog-assets/tutorials/create-telegram-bot/fernway-course-guide.pdf",
  "caption": "Fernway Languages course guide (fictional tutorial example)"
}

通过 Add AI Data 从对话元数据插入 telegram_chat_id。其模板形式是 {{metadata_telegram_chat_id}}。Telegram 渠道根据传入的对话设置该值，因此 PDF 会返回该对话。文档 URL 和说明文字保持固定。

API Action Description

Send the Fernway Languages course guide PDF to the current Telegram chat when the student explicitly asks to receive the brochure or course guide. Do not call this action for a price, schedule or trial question alone. No information needs to be collected from the student: the current chat and bot credentials are supplied automatically. Call it once per explicit request. Confirm delivery only if the request succeeds.

保存并启用 Action。完整 Main Prompt 已包含仅在明确请求时调用的规则。Bot API 方法详见 sendDocument。

验证文件，而不只检查回复

1. 在 Telegram 中发送 How much is the B1 English course?。确认只收到价格，不会收到未索取的文件。
2. 发送 Can you send me the brochure?。
3. 确认收到 PDF 附件，并能打开 Fernway 课程指南。
4. 在 Inbox 中打开该对话，展开已调用的 Action 卡片。在 Actions & MCPs 的 Action 卡片上打开 View logs，检查请求和结果。分享截图前必须遮盖令牌。
5. 确认目标是当前对话，并且每次请求只发送一个文档。

实际测试中，send_course_brochure 返回 HTTP 200，Telegram 响应为 ok: true。开头截图显示了学生对话中收到的 fernway-course-guide.pdf 附件。请求结果与收到的文件共同验证了投递成功；仅凭 Agent 的确认文字无法证明。

在 Telegram 中进行发送测试。 Simulation 对话没有真实 Telegram 机器人令牌的上下文。使用 Simulation 检查回答，使用真实 Telegram 对话检查文件投递。

步骤 7：如何将 Telegram 对话转给工作人员？

启用 Human Handoff，让请求人工的消息改变对话负责人，然后由同事从 Inbox 回复。

1. 打开 Actions & MCPs，启用 Human Handoff，选择 Edit Action。
2. 保留默认 Handoff Rules：开启 Media Message、User Frustration、Customer Support Suggestion 和 Lack Of Knowledge，关闭 Irrelevant Advice。Main Prompt 已将 /help 映射为请求人工；此演示不添加自定义转接规则。
3. 在有人监督的练习中，保持 Human Agents’ availability 关闭，并让同事在测试期间守候 Inbox。保持 Email notifications 关闭。这些是本演示使用的设置；不限制转接时间并不意味着随时有人在线。
4. 上线前启用可用时间表，根据实际有人值班的时间设置时区和工作时间，并相应设置非工作时间消息。
5. 保存 Action。在机器人的私聊中发送 I want to talk to a person.。如果机器人要求确认，回复 Yes。
6. 在 Inbox 中确认 AI 不再被分配为负责人。选择 Assign to me，发送 Hi, this is Alex from Fernway. Which course would you like help with?，验证消息是否到达 Telegram。
7. 人工负责对话期间，再发一条学生消息，确认 AI 保持静默。打开负责人菜单选择 AI Agent，然后发送新的课程问题，验证自动回复已恢复。

学生始终留在 Telegram 中。成功转接需要负责人变化和人工回复送达。需要恢复自动化时，在负责人菜单选择 AI Agent。

缺少事实信息可能触发转接，本地分级测试就是如此。分别检查两个结果：回答不能猜测，任何声称已转接的回复都必须对应 Inbox 负责人的变化。Human Handoff 指南更详细地介绍可用时间和路由。

聊天机器人人工转接教程还提供非工作时间请求测试，以及重新分配后自动回复是否继续工作的测试。

机器人在 Telegram 群组中如何工作？

隐私模式控制 Telegram 向机器人投递哪些群消息。 Quickchat AI 的自有机器人连接会处理收到的消息，不会额外添加“只回复提及”的过滤器。

图中涵盖本教程使用的消息类型。Telegram 也记录了服务消息和取决于上下文的命令路由规则。

如果班级群中的机器人应只回答直接请求：

1. 向 BotFather 发送 /setjoingroups，选择机器人；如果加入群组功能关闭，先启用。
2. 发送 /setprivacy，选择机器人，再选择 Enable。保持普通成员身份，不授予管理员权限。如果在添加机器人后更改隐私模式，请移除并重新添加机器人，使设置生效。
3. 将机器人加入你控制的小型测试群。
4. 发送普通消息，例如 See everyone in class tomorrow.。在此配置下，它不应触发回复。
5. 发送 /schedule@your_bot，将 your_bot 替换为实际用户名。检查课表回答，再对该回答使用 Telegram 的 Reply 手势，提问 What does B1 cost?。

单独发送 /schedule 的效果可能取决于最近向哪个机器人发过命令。在标准隐私模式下，纯文本 @mention 无法可靠替代定向命令。请使用上述测试中的明确形式。参见 Telegram 隐私模式规则。

下面的独立群组测试使用连接到同一个 Fernway Agent 的共享 @QuickchatAI_bot。它回答了定向课表命令，以及通过回复机器人消息提出的价格问题。这展示的是共享机器人的替代方式；我们的自定义 Fernway 机器人已在私聊中验证，群组行为仍需执行上述检查。

关闭隐私，或将机器人设为管理员，可能使普通群聊也送达 Agent，从而产生更多回复。关于管理群组，Telegram 群组管理教程解释了额外权限和 Action 控制。

一个群组就是一个共享对话。 涉及个人课程情况的咨询应放在机器人私聊中。如果群组内触发 Human Handoff，整个群组的 AI 都会暂停，直到重新分配；它不会为该学生创建独立私聊。

为什么 Telegram 机器人不回复？

先做最简单的私聊测试，再检查连接和消息类型。群组行为和文件发送各自有额外的依赖条件。

分享机器人之前，使用自己的真实内容重跑私聊中的价格、未知事实、PDF 和人工回复检查。将所有 Fernway 信息和链接替换为自己的。最新集成设置请参阅 Telegram 渠道文档。

ChatGPT 或 Claude 能帮助搭建这个机器人吗？

连接到 Quickchat AI 账号的 AI 客户端可以准备 Agent、知识、指令、Actions 和测试数据集。你仍需在 BotFather 创建 Telegram 身份，并在控制台的自有机器人流程中输入令牌。

按照 Manage with AI 说明，通过已验证的 ChatGPT 目录条目或 Claude 目录条目连接。将设置套件和以下请求交给助手：

Create a separate learning Agent named Fernway Languages from this tutorial kit. Do not change existing Agents. Set its display name and Identity name, add the knowledge article, and copy the Main Prompt and welcome message exactly. Configure send_course_brochure from action.json but leave it inactive. Use only the System Token reference, never ask me to paste my real Telegram token into chat. Create the Fernway course-answer dataset and evaluation criteria. Prepare Human Handoff using the default rules and show me the availability settings to review. Read back the saved configuration. Do not run tests, spend credits, send Telegram messages or activate Actions yet. List the remaining owner steps: create and configure the bot in BotFather, enter its token under Your own bot, review working hours, activate the Action and complete the real-channel checks. Do not use the shared Telegram connection as a substitute for my own bot.

这里使用的账号管理连接，不同于将 Agent 作为 MCP 工具对外提供。它可以协助配置流程，但仍需检查真实的 Telegram 回复和附件。

常见问题

如何无需编程创建 Telegram 机器人？

在 Telegram 打开官方 BotFather，发送 /newbot，选择显示名称及以 bot 结尾的唯一用户名。将返回的令牌连接到 Quickchat AI 等机器人服务。添加知识和指令，启用连接，然后测试私聊消息。BotFather 创建身份；连接的服务提供回答。

创建 Telegram 机器人免费吗？

通过 BotFather 注册 Telegram 机器人免费。Quickchat AI 的 Free 套餐用于个人非商业学习，提供有限的 AI 积分。商业部署需要商业套餐。AI 回答和 Simulation Testing 会消耗积分；创建 Telegram 身份并不包含无限 AI 使用量。

在哪里找到我的 Telegram 机器人令牌？

打开官方 BotFather，发送 /mybots，选择机器人，再选择 API Token。将凭据粘贴到机器人服务专用的 Bot Token 字段。不要放入提示词、知识文章、公开代码仓库或截图。

Telegram 机器人令牌泄露后该怎么办？

在 BotFather 使用 /revoke 撤销泄露的令牌，获取替代令牌，再更新连接的服务并测试回复。也要删除已泄露的副本，但不能只依赖删除：保存过旧令牌的人在撤销前仍能使用它。

能将一个 Telegram 机器人连接到两个平台吗？

机器人只有一个用于接收入站更新的 webhook 地址。如果第二个平台替换了 webhook，第一个平台就不再收到这些更新。多个系统仍可调用出站 API，但入站消息不会自动复制给两者。独立的入站流程应使用独立机器人。

如何为 Telegram 机器人添加命令？

向 BotFather 发送 /setcommands，选择机器人，每行提供一组命令和描述，命令前不加斜杠。这会创建菜单。你还必须实现对应行为：本教程通过 Main Prompt 将 /prices、/schedule、/trial 和 /help 映射为相应回答或 Action。

为什么 Telegram 机器人会在私聊中回复，却不在群组中回复？

确认机器人已加入群组，尝试发给其真实用户名的命令，例如 /schedule@your_bot，或回复它的一条消息。开启隐私时，普通群聊不会投递给非管理员机器人。纯文本提及不能可靠替代定向命令。

能给 Telegram 机器人添加 AI 或 ChatGPT 吗？

可以将 BotFather 创建的机器人连接到 AI 服务。本教程使用拥有自身知识、Main Prompt 和 Actions 的 Quickchat AI Agent，不会将你的个人 ChatGPT 对话连接到 Telegram。兼容的账号管理助手可以准备 Agent，再由拥有者完成自有机器人连接。

这个 Telegram 机器人能回答语音消息吗？

Quickchat AI 的 Telegram 集成目前不会为 Agent 转录语音。语音附件可能出现在 Inbox 中，但本教程使用文字消息。请让学生输入问题，或由工作人员查看附件。

这会自动操作我的个人 Telegram 账号吗？

不会。本教程创建有独立用户名的机器人身份。Telegram 提供其他账号自动化功能，但这里介绍的 Quickchat AI 连接处理的是发给机器人的消息，不会设置从你个人资料发出的回复。