Telegram AI 聊天机器人：无代码搭建群组与私聊助手

Telegram AI 聊天机器人可以根据你的业务知识，在群组或私聊中回答问题。Quickchat AI 通过共享机器人将 AI Agent 连接到 Telegram：把机器人加入群组，在控制台确认连接，成员就能通过提及机器人来提问。此流程不需要编程，也不需要 BotFather 令牌。

本教程以虚构的 Saltmarsh Sailing School 为例，搭建成员群组与私聊咨询流程。两个 Agent 使用同一套学校资料：Saltmarsh Group 回答公开问题，Saltmarsh Sailing School 处理私聊体验课申请，并在退款时转交人工。申请只是交给办公室跟进的咨询，不代表预订已经确认。

两个 Agent 将对话责任分开。群组 Agent 没有转人工或登记 Action；私聊 Agent 处理咨询与员工回复。

按下表完成搭建。Google Sheets 扩展是可选步骤，可以先完成答疑和转人工流程。

下载 Saltmarsh Telegram 套件，获取本教程使用的完整知识、Main Prompt、Action 配置、评估标准和测试消息。这些是供下述步骤编辑使用的文件，不是一键导入 Agent 的安装包。可复制的演示材料和截图保留英文。

创建 Telegram 聊天机器人需要哪些条件？

你需要一个 Quickchat AI 账户、两个 Agent，以及有权将机器人加入测试群组的 Telegram 账户。可选的申请登记步骤还需要能够授权 Google Sheets 的 Google 账户。

1. 创建 Quickchat AI 账户，如有要求，完成邮箱验证。Free 支持个人非商业学习。方案按 Agent 计算，因此实际企业若使用两个 Agent，需要分别具备适当的商业使用方案。Preview 和 Simulation 会消耗 AI 积分。请查看当前方案。
2. 创建名为 Saltmarsh Members 的 Telegram 群组。先用测试群组检查提及、保持静默和后续消息，再邀请客户加入。
3. 使用你自己的 Telegram 账号完成本教程，包括发送访客消息。你也可以同时操作 Quickchat AI 的 Inbox。邀请客户之前，请同事用另一个账号检查使用体验。
4. 解压套件。保留学校示例资料的完整性；正式部署前，替换为你自己核实过的政策。

Quickchat App 截图来自配置了虚构 Saltmarsh 场景的本地运行应用；连接测试数据已在图注中注明。Telegram 和 Google Sheets 截图展示已连接演示的实际回复及保存的咨询记录。个人账号信息已裁剪或明确遮挡。请使用最后的检查清单，结合你自己的知识和已连接账号重复验证。

第 1 步：如何让 Telegram 聊天机器人了解你的业务？

把业务事实放入 Knowledge Base，把运行指令放入 Main Prompt。将两者分开，方便在不改变 Agent 行为的情况下修正答案。

价格和政策属于来源事实。简洁回复、不确定性处理和路由属于指令。

创建 Agent 并添加知识

1. 新账户选择 Set up manually。已有账户先选择 Add new AI Agent，再进入手动配置。
2. 在 Identity 的 Name your AI Agent 中输入 Saltmarsh Group。将套件中的 group-main-prompt.txt 粘贴到 Describe what you want your agent to do。
3. 继续配置，暂时不要连接外部应用。完成方案选择；若从学习账户开始，可使用 Skip for now。
4. 打开 Knowledge Base > Add Article。在 Create custom article 输入 Courses and trial enquiries，选择 Create article，将 saltmarsh-courses.txt 粘贴到 Content，然后点击 Save。
5. 用 saltmarsh-policies.txt 重复操作，创建 Weather, parking and personal enquiries。等待两篇文章均显示 Ready。
6. 打开 Saltmarsh Group 的 Actions & MCPs。保持 Human Handoff 关闭，不添加体验课申请 Action。
7. 选择 Add new AI Agent，使用 main-prompt.txt 和同样的两份知识文件，手动配置 Saltmarsh Sailing School。第二个 Agent 负责私聊。修改设置前，先在账户切换器中选中目标 Agent。

两份简短资料清楚展示 Agent 掌握的事实。测试知识前，确认状态为 Ready。

资料刻意不包含潜水服租赁信息。 正确答案应是 Agent 无法确认，而不是编造“有”或“没有”。同样，天气政策不能让 Agent 知道今日预报，私人课程价格也不能用作体验课价格。

设置 Main Prompt 并检查答案

1. 在每个 Agent 中打开 Identity > Main Prompt，核对对应的 Saltmarsh 提示词。群组提示词负责一般问题，并指向群里置顶的私聊链接；私聊提示词负责收集咨询并使用 Human Handoff。
2. 打开 AI Preview，询问 How much is Start Sailing?。确认答案包含两天和 EUR 240。
3. 询问 Do you rent wetsuits?。确认答案承认缺少这项信息。

私聊 Agent 的提示词定义信息收集与转人工。群组 Agent 使用独立提示词，两项 Action 均关闭。

群组 Agent 真实设置的两处截图。它能回答知识问题，但没有可执行的登记或转人工 Action。

两个 Agent 让路由关系更明确。群组 Agent 没有可被误触发的转人工能力；私聊 Agent 可以转交退款请求，而不暂停群组。Preview 检查学校事实，接下来的步骤验证各自的 Telegram 连接。

第 2 步：如何将 AI 聊天机器人加入 Telegram 群组？

打开 External Apps > Telegram，把共享机器人加入群组，然后回到 Quickchat AI 点击 Confirm。在确认前，Agent 不会在该群组回复。

加入 Telegram 群组与在 Quickchat AI 确认是两个独立步骤。

1. 在 Agent 切换器选择 Saltmarsh Group。打开 External Apps，选择 Telegram，找到 Quickchat AI bot。
2. 选择 Add to a Telegram group。在 Telegram 中选择 Saltmarsh Members，批准添加机器人。
3. 回到 Quickchat AI。在 Waiting for your confirmation 下核对群名和 Added by 信息。
4. 为目标群组选择 Confirm。群组应移到 Connected chats，启用开关应处于打开状态。
5. 在 Telegram 输入 @，从提及选择器中选择机器人。询问 How much is Start Sailing?。共享机器人通常使用 @QuickchatAI_bot；请以群组中实际显示的用户名为准。
6. 直接回复它的答案，发送 What should I bring?。然后另发一条不提及机器人的消息：Does anyone know the gate code?。共享机器人应回答直接回复，但对普通消息保持静默。

在 Telegram 选择 Saltmarsh Members，然后回到 Quickchat AI 确认连接。

真实本地界面使用预先写入的测试群组数据，展示 Confirm 的位置。这用于说明操作控件，不代表机器人已加入真实 Telegram 群组。

确认后的群组收到了预期的课程答案。请使用机器人的实际用户名提及它。

直接回复机器人的消息即可，无需再次提及。答案列出了已提供的装备信息。

确认很重要，因为邀请数据会出现在群组里。Quickchat AI 要求账户持有者作出确认，才会将群组视为 Agent 的目标。不要确认不认识的群组。Telegram 连接参考说明了这一边界。

离开设置页面前，请完成确认。如果机器人退出了未确认的群组，请重新生成 Add to a Telegram group 链接，再次添加它，然后立即在 Quickchat AI 中确认待处理的群组。通过 Telegram 的成员搜索添加机器人不能替代此连接流程。

Admin 标记显示机器人在 Telegram 中的身份。共享机器人的普通回复不需要管理员权限。将共享机器人设为管理员，也不会改变它仅响应提及或回复的规则。

第 3 步：如何启用 Telegram 私聊？

启用 Direct message link，分享生成的完整 URL。链接会在共享 Telegram 机器人中选中你的 Agent，让客户无需把机器人加入群组，也能私下提问。

群组是共享对话。个人信息和员工接管应移到私聊。

1. 选择私聊 Agent Saltmarsh Sailing School。打开 External Apps > Telegram，启用 Direct message link。不要为它连接群组。
2. 复制生成的链接。保留 start= 参数；仅使用共享机器人的基础链接，无法标识你的 Agent。
3. 在 Telegram 打开链接，如有提示，点击 Start。
4. 不提及机器人，直接询问 How much is Start Sailing?。核实学校答案，并在 Inbox 找到该对话。
5. 将链接放入群组欢迎消息并置顶，让成员在分享个人信息前找到私聊入口。

使用你自己 Agent 生成的链接。这里的本地配置不是 Telegram 真实交付的回执。

点击 Start 后，Telegram 送达了 Saltmarsh 欢迎消息。接下来请检查一条基于知识的回答；仅有问候语不能验证信息检索。

同一 Telegram 屏幕的两处裁剪展示了置顶邀请。演示链接的 start 值已省略；请置顶你自己生成的完整链接。

与共享机器人的私聊一次绑定一个 Agent。打开另一 Agent 的私聊链接可能切换绑定。若需要自己的 Telegram 身份和专属机器人对话，请使用自有机器人流程。

关闭 Direct message link 会阻止通过它建立新连接。要停止已有聊天，使用该聊天的启用开关或 Disconnect。将链接视为公开入口，不要把它当作保密知识的访问限制。

第 4 步：如何将体验课申请保存到 Google Sheets？

Google Sheets 集成会创建电子表格和追加行 Action。修改该 Action，登记体验课申请的三个必填字段，再验证实际新增的行。这一步可选，并支持共享 Telegram 机器人。

输出是需要人工跟进的申请。它不会预留名额，也不会确定体验课价格。

连接 Sheets 并配置一个 Action

1. 在 Saltmarsh Sailing School 打开 Actions & MCPs > Add Action > Google Sheets，选择 Connect Google Sheets。登录目标 Google 账户并批准请求的访问权限。
2. 打开生成的 Quickchat Leads 电子表格。保持工作表名称为 Leads，因为生成的 Action URL 指向该工作表。
3. 将表头依次替换为 Name、Preferred weekday、Sailing experience、Conversation link、Channel。
4. 打开 Actions & MCPs，编辑生成的 log_lead_to_google_sheet Action。使用下面的配置。同时修改参数、请求体和表头，确保各位置对应。

API Action Name

Record trial-lesson request

What to ask the user first

将三个参数均设为 No default，移除默认的邮箱和咨询参数。这三个字段是本配置唯一需要询问的内容。Telegram 用户名是可选项，不能可靠地作为必填联系方式；记录的对话链接让员工能够回到该咨询。

方法与 URL：保留生成的 POST URL。它已经包含你的电子表格 ID、Leads 工作表和 valueInputOption=RAW，无需填写占位用的表格 ID。

请求头：保留集成原有配置。

在 API Endpoint 的 Body 标签页使用：

{"values":[["{{name}}","{{preferred_weekday}}","{{sailing_experience}}","{{conversation_url}}","{{conversation_channel}}"]]}

需要时，用 Add AI Data 插入参数和对话变量标签。前三个值来自对话，最后两个由 Quickchat AI 提供。

API Action Description

In a private chat only, call this once when the person has requested a trial lesson and provided their name, preferred weekday and sailing experience. Ask for the next missing required field before calling. Do not call it for general course questions, in groups, or to confirm a booking. A successful call records an enquiry for the office; it does not reserve a place.

打开 Advanced settings > Run only when，添加 telegram_chat_type equals private。只使用元数据键本身，不加 metadata_ 或花括号。这样即使模型尝试调用，也不会为群组消息发送 HTTP 请求。运行条件参考解释了这一检查。

将 Response filter 设为 $.updates.updatedRows，让 Action 返回行数，而不是不必要的完整服务响应。保持 Action 启用。

使用的键是 telegram_chat_type。发送请求前会先检查条件。

申请配置的本地示例。生成的 Sheets URL 和 OAuth 授权必须来自你自己的 Google 连接。

检查新增行，再检查不完整申请

通过 Agent 的 Telegram 私聊链接发送以下消息：

I am Alex Morgan. I want a trial on Tuesday. I am a beginner.

同时检查三个位置：回复描述的是申请，Inbox 中的 Action 卡片显示提供的值，真实 Leads 工作表中有对应行。令人放心的回复或较高的 Simulation 分数，都不能证明 Google Sheets 已写入数据。

Agent 记录了提供的姓名、周二偏好和初学者经验。是否有名额及确切价格仍需办公室确认。

同一条已保存记录的两处细节使五列内容清晰可读。账号专属的聊天链接已遮挡，其他四个值保持原样。

另开一个测试，发送 I would like a trial lesson。Agent 应在执行 Action 前，逐次询问缺少的字段，每条消息只问一个问题。再试 How much is Start Sailing?；普通课程问题不应生成行。提示词要求每次申请只写入一次，但这个追加配置并非幂等的预订系统。投入实际登记前，先检查重复记录。

第 5 步：如何将 Telegram 对话转交人工？

配置 Human Handoff，然后在 Inbox 核对对话归属。提示词说“办公室会回复”，本身不会转移责任或暂停 AI。

验收点是归属变化。由人工完成个案；任何返回 AI 的流程都应单独验证。

1. 选择 Saltmarsh Sailing School，打开 Actions & MCPs > Human Handoff 并启用。Saltmarsh Group 的这项 Action 应保持关闭。
2. 在 Handoff Rules 点击 +。将 Rule Name 设为 Private enquiries，把 handoff-rule.txt 粘贴到 Description，打开 State。新规则默认不启用。此规则涵盖该私聊 Agent 中的退款、投诉、要求人工和接受人工帮助的情况。
3. 清空 Keywords，关闭本示例的预设规则，只保留这一条自定义规则启用，然后保存。群组隔离依赖于独立群组 Agent 关闭 Human Handoff；自定义规则描述的是私聊 Agent 何时转交。
4. 将 Confirmation 设为 I have passed this private conversation to the Saltmarsh office. A member of staff can reply here. 按团队实际值班时间配置 Human Agents’ availability，并设置真实准确的非工作时间消息。
5. 在 Telegram 私聊发送 I want a refund for last week. Can I speak to a person?。
6. 在 Inbox 找到对话、检查归属，选择 Assign to me，发送 Hi, I’m Alex from the office. I’ll review your request. 核对 Telegram 是否收到。
7. 在人工接管期间，再发送一条客户消息。AI 应保持静默。让操作员在 Inbox 完成并解决个案。返回 AI 应作为独立测试。

自定义规则的 State 已启用。预设触发条件关闭，因此只需检查一条规则。

实际 Telegram 请求触发了 Handoff。Inbox 分配状态和工作人员发送的回复经过了单独验证。

实际检查中，对话转为 Unassigned，等待工作人员接手。工作人员选择 Assign to me，发送办公室回复，Telegram 接受了该消息。上方截图展示的是转交回复，不包含工作人员随后发送的消息。重复测试时，请同时检查分配状态和消息发送结果。

在问题解决前，请由工作人员继续负责此案例。 在本地退款测试中，转回 AI Agent 后只回答了一次，Handoff 就再次触发。转回 AI 需要单独通过后续消息测试，不属于本工作流程的完成标准。人工转接指南进一步介绍了人员安排和对话责任。

第 6 步：如何完整测试 Telegram 聊天机器人？

用 Testing 做可重复的回复检查，再分别验证真实 Telegram 路径与外部效果。模型可能回答正确，但群组连接、表格写入或转人工消息交付仍然有问题。

检查实际负责结果的系统：知识来源验证事实，Action 日志验证请求，Sheets 验证行，Telegram 验证交付。

运行可重复的回复数据集

1. 打开 Testing，创建名为 Saltmarsh: knowledge checks 的数据集，选择 Paste messages。
2. 粘贴 simulation-messages.txt。保留测试用例之间单独一行的 --- 分隔符。
3. 打开 Evaluation criteria，粘贴套件中的 evaluation-criteria.txt 并保存。
4. 选择 Run > Start Run，同时检查各条回复和分数。

修改一项指令时，保持问题不变，才能进行有用的比较。

不仅看分数，也要读回复。这些是本地知识测试，不是 Telegram 交付测试。

评估器需要学校事实才能判断准确性，也需要知道聊天记录无法证明表格行、Telegram 交付或对话归属变化。标准文本 Simulation 不提供 Telegram 聊天元数据，因此缺少这些元数据时，不应判定“仅私聊”Action 条件失效。依赖渠道的检查应在真实私聊中进行。

本地测试带来了哪些调整？

最初的设计由一个 Agent 服务两个入口。本地测试发现，群组中的退款请求会将共享对话转交至 Human Handoff。我们拆分了 Agents，并在群组 Agent 上禁用了 Handoff 和用于收集申请的 Actions。再次测试群组中的退款和体验课咨询时，回复引导用户使用置顶私聊链接，同时保留 AI 负责状态。因此，步骤 1 同时使用配置和指令来分离两类对话。

最后十项本地知识检查均获得 5/5，两个托管 Agent 也通过了相同的十个案例。这些小规模测试不能估计生产环境的准确率。实际群组也回答了课程价格和携带物品问题，随后拒绝确认是否出租潜水服。调整套件时，请保留这些缺失事实的案例；仅回答对价格不足以检验 Agent 是否谨慎作答。

缺少知识时，答案是“无法确认”。另一条门禁码消息没有向机器人发问，此截图中也未显示对它的回复。

实际私聊中的体验课申请成功调用了一次 Sheets Action，参数为 Alex Morgan、Tuesday 和 beginner。Google 返回 HTTP 200，更新了一行；保存的行还包含聊天链接和 telegram 渠道。另一次使用群组聊天元数据的 Action 测试没有发送 HTTP 请求。调整执行条件时，请同时检查被接受的私聊申请和被拒绝的群组上下文。

检查渠道及其外部效果

使用套件中的空白 test-matrix.csv 记录自己的观察。上方截图展示了已演示的结果；下表还包含应在你自己的配置中运行的检查。测试静默行为时请记录等待时长，并将人工接手与日后转回 AI 分开验证。

检查失败时，只修改一个相关设置，再发送同一条消息。缺少来源事实就在 Knowledge Base 补充；Action 过早调用就改描述或必填参数；群组不回复则先检查确认和提及方式。保留失败结果，让改进可见。

何时需要通过 BotFather 创建自己的机器人？

当你需要自己的机器人名称和图片、Telegram Bot API Actions，或接收普通群消息时，创建自己的 Telegram 机器人。上述群组答疑和私聊流程使用共享机器人即可。

添加第二个机器人前，先确定所需身份和消息行为。

1. 在 Telegram 打开已验证的 BotFather 账户，发送 /newbot。
2. 选择显示名称，再选择一个可用、以 bot 结尾的用户名。BotFather 会返回令牌，请保密。
3. 如果要将此机器人加入群组，请选择 Saltmarsh Group。Saltmarsh Sailing School 仅用于私聊。 在 External Apps > Telegram 打开 Your own bot，选择 Connect to Telegram。
4. 将令牌粘贴到 Bot Token 并完成连接。确认 Enable your own bot 已启用。
5. 打开机器人 Telegram 链接，发送 /start，再询问相同的课程价格问题。
6. 如果要接收普通群消息，在 BotFather 使用 /setprivacy，选中机器人并选择 Disable，然后将它从测试群组移除再重新添加。管理员机器人也会收到普通消息。Telegram 的隐私模式文档说明了交付规则。

只将令牌粘贴到 Bot Token。截图保留空白字段，避免公开凭据。

将共享机器人和自有机器人放在不同群组。两个机器人同群可能导致重复回复。如需置顶公告或管理成员，请参阅独立的 Telegram 群组管理教程，并配置其中仅管理员可触发的 Action 条件。

ChatGPT 或 Claude 可以帮助配置 Telegram 聊天机器人吗？

已连接的 Quickchat AI 账户管理应用可以协助创建 Agent、添加知识、配置受支持的设置并运行测试。如果客户端提供 Telegram 设置功能，它可以启用共享机器人的私聊链接。选择群组及在控制台确认仍由账户所有者完成。部分客户端也需要通过控制台启用私聊链接和配置 Human Handoff，因此应让助手先检查可用工具。

连接 Quickchat AI ChatGPT 插件或 Claude 连接器，附上套件文件，并使用以下提示词：

Use my connected Quickchat AI account to create two Agents from the attached kit: Saltmarsh Group with group-main-prompt.txt and Saltmarsh Sailing School with main-prompt.txt. Add both knowledge files to each. Keep Actions and Human Handoff off on Saltmarsh Group. Prepare the supplied knowledge-test dataset. Check the tools available in this client before changing settings. Show me the configuration and ask before running credit-consuming tests or writing to Google Sheets. Where supported, enable only Saltmarsh Sailing School's shared-bot direct-message link and return the complete link. Leave group selection, dashboard confirmation, BotFather setup, Google OAuth and unsupported settings for me, with exact dashboard steps. Report what was configured, what was actually tested and what remains to verify in Telegram.

工具可用性取决于客户端和账户权限。登录步骤参见账户管理配置参考。这会将助手连接到你的 Quickchat AI 账户，不会把个人 ChatGPT 或 Claude 对话变成 Telegram 机器人的托管后端。

为什么 Telegram 聊天机器人不回复？

重写提示词前，先检查连接和消息路径。以下症状各有不同原因。

邀请客户前，请替换虚构事实，检查群组与私聊的分离，并安排工作人员处理转接队列。请同事使用另一个账号检查公开入口，作为上线前的最后验证。若要使用其他社区渠道，Discord 聊天机器人教程提供了类似的搭建和测试流程。角色对话请参阅 Telegram 角色扮演指南。

可选配置检查：按你声明的需求比较部署方式，或按提供的预算比较每份积分预算的回复量。这些计算器不会检查你的账户、网站或余额。

可复制的 Saltmarsh 配置

以下是本教程使用的完整事实资料和指令。下载包还包含 Action 配置、评估标准和测试。

群组 Agent：Main Prompt

将以下内容粘贴到 Saltmarsh Group 的 Identity > Main Prompt。保持此 Agent 的 Human Handoff 和自定义 Actions 关闭。

You answer general questions in the Saltmarsh Sailing School members' group. Use only the Knowledge Base and keep each reply to two or three sentences. Do not add facts or requirements the sources do not contain. If a fact is missing, say that you cannot confirm it.

For trial requests, refunds, complaints, personal details or a request for a person, direct the member to the school's private link pinned in the group; do not invent a link. Do not collect personal details in this group. You cannot record requests, confirm bookings, approve refunds or transfer a conversation to staff. Do not claim you did any of these things. The private Agent records an enquiry; it cannot check live availability or confirm a trial. Only the office confirms availability and price.

私聊 Agent：Main Prompt

将以下内容粘贴到 Saltmarsh Sailing School 的 Identity > Main Prompt。Action 名称应与配置保持一致。

You are the private-chat assistant of Saltmarsh Sailing School. Answer school questions from the Knowledge Base. Do not add plausible details that are not in the sources, including extra clothing or footwear requirements. Keep replies to two or three sentences and ask at most one question per message. If a fact is missing, say that you cannot confirm it; do not invent dates, availability, gate codes or wetsuit rental. Explain weather policy without claiming to know the current forecast.

When a person requests a trial lesson, collect their name, preferred weekday and sailing experience. Ask for only the next missing field. When all three are present, use Record trial-lesson request once. Say the request was recorded only after the Action succeeds. Explain that the office still needs to confirm availability and price; never say a lesson is booked. If the Action is unavailable or fails, say the request has not been recorded and offer a person.

Use Human Handoff for a current unresolved refund request, complaint or explicit request for a person. After a staff member has resolved the enquiry and returned the conversation to AI, answer new general questions normally; do not hand off again solely because an earlier message mentioned a refund or asked for a person. Do not approve refunds or promise a response time. For a missing fact, say what is unknown and offer a person; do not treat uncertainty as a negative answer about the service.

知识：课程与体验课申请

将以下内容粘贴到第一篇知识文章的 Content 字段。

Saltmarsh Sailing School demonstration information

This fictional school is used only for a tutorial. It contains no real customer data.

Start Sailing is a two-day course costing EUR 240. Day Skipper theory runs across five evenings and costs EUR 310. A private lesson lasts 90 minutes and costs EUR 95.

Courses run from April to October. Course dates are published on the school's website one month ahead. This source does not contain the next available date or live availability.

Bring a waterproof jacket, non-marking shoes and a change of clothes. The school provides buoyancy aids.

A trial-lesson request is an enquiry, not a confirmed booking. The office needs the person's name, preferred weekday and sailing experience, then confirms availability and price. Do not collect payment details. Do not infer a trial price from the private-lesson price.

知识：政策与成员信息

将以下内容粘贴到第二篇文章的 Content 字段。

Saltmarsh Sailing School demonstration policies

If the forecast shows more than 25 knots of wind or thunderstorms, the session moves to the next available date at no extra cost. The instructor decides on the morning of the session. This source is a policy, not a live weather forecast or a cancellation decision.

Parking is free at the clubhouse. The gate code is sent to enrolled students the day before their course. The code itself is not in this Knowledge Base.

Refunds and complaints are handled by the office. An AI answer cannot approve a refund. A member of staff must decide each case.

The Telegram members' group is for general questions. Trial requests, refunds and other personal details belong in a private conversation with the school's Agent, opened from the school's direct-message link.

Human Handoff 规则

将以下内容粘贴到 Human Handoff > Handoff Rules，并配置实际可用时间。

Transfer this private conversation to a person when the visitor has a current unresolved refund request, complaint, explicit request for a person, or accepts an offer of human help. After a staff member resolves the enquiry and returns it to AI, earlier refund or handoff messages must not trigger a new transfer for a general course question. Explain that a staff member can review the case here without approving a refund or promising a response time. This Agent is used only for private enquiries; the separate group Agent has Human Handoff disabled.

常见问题

如何将 AI 聊天机器人加入 Telegram 群组？

在 Quickchat AI 打开 External Apps，选择 Telegram，再选择 Add to a Telegram group。在 Telegram 选择群组后，回到 Quickchat AI 点击 Confirm。成员可以提及共享机器人，或回复它的某条消息来提问。

Telegram AI 聊天机器人会回答每条消息吗？

Quickchat AI 共享机器人只回答提及它或回复它的群组消息。普通群聊不会触发回复。当 Telegram 隐私模式关闭，或自有机器人是管理员时，它可以收到普通群消息。请在独立群组测试这种配置。

我需要 BotFather 或 Telegram 机器人令牌吗？

共享机器人及其私聊链接不需要 BotFather 或令牌。如果需要自定义 Telegram 名称和图片，或调用 Telegram Bot API 的 Actions，再通过 BotFather 创建自己的机器人。普通 Google Sheets Actions 可以使用共享机器人。

客户能私聊 Telegram 聊天机器人吗？

可以。在 Quickchat AI 启用 Direct message link，分享生成的完整链接。客户打开后，如有提示就点击 Start。链接会在共享机器人中选中你的 Agent。关闭链接会阻止新连接；已有私聊具有独立的启用和断开控件。

Telegram AI 聊天机器人免费吗？

通过 BotFather 创建机器人，本身不会增加 AI 服务。Quickchat AI 提供适合个人非商业学习的 Free 方案，含有限 AI 积分。商业部署需要付费方案。回复、Preview 和 Simulation 会消耗 AI 积分，外部服务也可能另行收费。

Telegram 支持 AI 聊天机器人吗？

Telegram 支持第三方 AI 机器人和 AI 集成。本教程连接一个根据你自己的业务知识回答问题的 Quickchat AI Agent。BotFather 只创建机器人身份，不提供这些知识，也不会配置客服流程。

聊天机器人能理解照片和文件吗？

Telegram 集成可以接收照片并分析视觉内容。其他文件可作为附件进入对话，但不会自动读取其内容。请测试客户实际使用的文件类型，并同时检查 Telegram 和 Inbox。

可以创建 Telegram 角色扮演或角色机器人吗？

可以。同一 Telegram 连接可以服务于具备角色身份和适当指令的 Agent。本教程采用企业客服示例；角色扮演 Agent 需要独立的提示词和测试。