# Telegram (Beta) 将您现有的 Telegram 帐户连接到平台，这样您的 Telegram 对话就可以直接流入应用程序，并由 AI 智能体进行回复。您只需输入电话号码和登录验证码即可连接——这与您在其他设备上添加 Telegram 的方式相同。 > **Beta 版本。** Telegram 现已向所有人开放，但它仍处于初期阶段——在我们进行优化的过程中，可能会偶尔出现一些小问题。如果发现功能与描述不符，请告知支持团队。 --- ## 什么是 Telegram 集成？ Telegram 集成使用 Telegram 自身的登录流程将您的个人 Telegram 帐户连接到平台。无需创建机器人，也无需购买单独的电话号码——您只需使用现有的 Telegram 帐户登录，您的 1 对 1 聊天记录即可在应用程序内显示。 这对于已经在 Telegram 上与客户沟通，并希望在现有帐户基础上使用 AI 智能体、广播功能和共享收件箱的企业来说非常理想。 > **重要提示 — 连接前请阅读。** 这是一个**非官方**集成，用于自动化操作**个人 Telegram 帐户**。Telegram 的规则不鼓励自动化以及群发或未经请求的消息，违反这些规则的帐户可能会被**限制或永久封禁**（在某些情况下，电话号码本身可能会被禁止重新注册）。请仅使用此渠道向**已经联系过您或已保存的联系人**发送消息，保持较低的发送量，并让 AI 以自然的节奏进行回复。请**勿**将其用于冷启动的大规模外联。 --- ## Telegram 与 WhatsApp Web 的对比 两者都无需官方商业 API，即可连接您已拥有的帐户。 | 功能 | Telegram | WhatsApp Web | |---|---|---| | **设置** | 输入电话号码 + 登录验证码 | 配对您的手机（二维码或配对码） | | **帐户类型** | 您的个人 Telegram 帐户 | 您的个人/商业 WhatsApp | | **每条消息成本** | 免费 | 免费 | | **模板消息** | 不适用 | 不支持 | | **正在输入指示器** | 支持 | 支持 | | **媒体（接收）** | 照片、文档、语音笔记 | 照片、文档、语音笔记 | | **官方支持** | 非官方集成 | 非官方集成 | | **最适合** | 已在 Telegram 上活跃的企业、热线/现有联系人 | 使用 WhatsApp 的企业、快速启动 | > **同一个号码可以同时使用吗？** 可以。如果同一个电话号码同时在 Telegram 和 WhatsApp (Web) 上使用，您可以将其作为**两个**渠道进行连接——它们在“渠道”页面上作为两个独立的连接运行，每个连接都有自己的状态、预热和限制。连接其中一个不会影响或替换另一个。 --- ## 设置 Telegram ### 第 1 步：打开连接流程 1. 在左侧边栏中，点击底部的**设置**。 2. 在“设置”左侧导航栏的**渠道**下，点击**渠道**。 3. 找到 **Telegram** 卡片（带有 **Beta** 标记），然后点击**连接**。 ### 第 2 步：输入您的电话号码 1. 输入您要连接的 Telegram 账号的电话号码，包括国家代码（例如 `555 123 4567`）。 2. 如果您希望将最近的一对一 Telegram 对话作为联系人导入，请开启 **导入现有聊天**，这样您就不会面对一个空的收件箱。（开启此选项还可以让您控制 **对导入的聊天保持 AI 暂停状态** —— 建议开启，且默认为开启，这样导入历史记录时就不会触发对旧消息的自动回复。准备好后，您可以稍后针对每个联系人单独关闭此选项。） 3. 点击 **发送登录代码**。 4. Telegram 会**向您的 Telegram 应用**发送一个登录代码（通常作为来自官方“Telegram”服务聊天的消息到达，并不总是以短信形式发送）。 ### 第 3 步：输入登录代码 1. 在手机上打开 Telegram。 2. 从 **Telegram** 服务聊天中读取登录代码。 3. 在应用中输入该代码。 4. 点击 **验证代码**。 > **代码很快会过期。** 在点击 **发送登录代码** 之前请准备好手机，并及时输入代码。如果代码过期，请重新开始连接以获取新代码。 ### 第 4 步：双重验证密码（如果您已设置） 如果您的 Telegram 账号启用了 **两步验证**，应用会在输入代码后要求您输入 **2FA 密码**。输入密码，然后点击 **验证密码**。您的密码仅用于完成安全登录，且绝不会以可读形式存储。 验证完成后，您的账号将在“频道”页面显示为 **已连接**。您的 Telegram 对话现在可以通过平台访问，分配给此频道的 AI 智能体可以回复收到的消息。 ### 导入现有聊天 如果您在第 2 步中开启了 **导入现有聊天**： - 仅导入最近的私聊（一对一）记录。群聊不包含在内，且每个聊天仅会拉取有限的近期历史记录。 - 导入操作会在您连接后立即在后台运行一次。对于较大的账户，可能需要一些时间才能显示所有内容。 - 导入的消息会填充“聊天”中的对话，但不会计入您的 [Dashboard](../get-started/dashboard.md) 数据或图表。只有在连接后发送和接收的内容才会被统计在内。 如果您在连接时未选择导入，新的对话仍会从那一刻起正常流入 —— 只是会跳过旧的历史记录。 --- ## 会话管理 ### 检查连接状态 您的 Telegram 连接状态显示在“频道”页面的 **Telegram** 卡片上： | 状态 | 含义 | |---|---| | **已连接** | 处于活跃状态，可接收/发送消息 | | **验证码已发送** | 等待您输入登录验证码 | | **需要双重验证** | 等待您输入两步验证密码 | | **未连接** | 无活跃会话 | ### 重新连接 如果会话中断，请打开 **设置 → 频道 → 频道**，找到 Telegram 卡片，并使用其连接/管理操作。如果无法自动恢复会话（例如，您在手机上结束了会话），系统会要求您使用新的验证码重新登录。 ### 断开连接 打开 **Telegram** 卡片并点击 **断开连接**。这将使平台退出您的 Telegram 账号并清除会话。您也可以直接在 Telegram 中结束会话：**设置 → 设备 → 活跃会话**，然后终止平台的会话。 --- ## 在 Telegram 上保持安全 由于这是在自动化操作个人账号，保护账号免受封禁是您的责任。平台会对 AI 和外发消息进行限速以使其看起来自然，但请遵循以下做法： - **仅向熟人/现有联系人发送消息。** 回复那些先给您发消息的人或已保存的联系人。避免向陌生人批量发送消息 — 这是触发 Telegram 垃圾信息标记的最快方式。 - **保持低发送量**，尤其是对于刚连接的账号。请在几天内缓慢增加发送量，而不是一次性增加。 - **避免向不认识的人发送链接** — 向陌生人发送包含大量链接的消息是常见的封禁触发因素。 - **让 AI 以自然的节奏回复。** 内置的延迟和输入指示器旨在保持对话的人性化 — 不要试图绕过它们。 - **使用您自己控制的真实号码。** 一次性/虚拟（VoIP — 基于互联网的电话号码，而非实体 SIM 卡）号码更容易被标记。 > **警告。** 如果 Telegram 将该账号标记为垃圾信息，发送功能将停止，直到行为改变 — 仅等待并不能解除标记。重复违规可能导致账号及其电话号码被永久封禁。 --- ## 发送限制、预热与跟进控制 Telegram 使用与 WhatsApp Web 相同的保护性发送限制、自动预热和账号级跟进终止开关。这些设置旨在防止个人账号看起来像垃圾信息群发工具并被标记。在“频道”页面，当您的 Telegram 账号连接后，您将看到： - 一个 **发送限制与预热** 卡片，其指标与 WhatsApp Web 相同 — 今日已发送消息数、今日新增联系人数以及当前的预热天数。 - 一个 **自动跟进** 开关 — 对于新连接的号码，它默认处于 **开启** 状态，因此在号码预热期间，请自行将其关闭。它在整个过程中保持交互状态，但会显示哪些预热门槛（号码使用时长、活跃度提升、近期联系人互动）尚未通过。 ### 自动预热（爬坡） 刚连接的 Telegram 账号会被有意限速，并随着时间的推移逐步解锁更多容量。账号只有在实际发送量达到当前上限 75% 的日子里才会获得“合格天数” — 空闲天数不计入，因此账号必须通过真实、稳定的使用才能完成预热。 - **每日消息上限** = `50 + 8 × (day − 1)`，上限为 **500条/天**（在第 58 天达到）。 - **每日新增联系人上限** = `floor((day − 1) × 5 / 6)`（向下取整），上限为 **50条/天**（在第 61 天达到）。 因此，新账户的初始额度为每天 50 条消息和 0 个新联系人，在大约两个月内逐步提升至最高上限。“频道”页面会显示当前天数、今日使用量与上限的对比，以及距离达到上限还有多远。 ::: tip **提示：** 如果您连接的账户**已经**拥有数月的真实 Telegram 使用记录，预热面板允许您提前预热天数，从而立即解除上限。请诚实使用此功能——仅适用于确实有自然使用记录的账户。跳过预热的全新账户被封禁的可能性要大得多。 ::: ### 爬坡后的手动覆盖 当账户完成完整的 58 天预热期后，您可以选择通过覆盖设置将每日消息上限提高到 500 以上（从 750 到 5,000，以 250 条消息为步长）。Telegram 官方并没有所谓的“安全”数值——请保持保守，留意垃圾信息标记，一旦发现异常立即调低。此覆盖功能仅适用于已完成预热的账户；新账户无法通过此方式跳过预热。 ### 单个账户的自动跟进终止开关 **自动跟进**开关仅控制当前账户。当它关闭时，无论您的广播或活动设置如何，该账户**不会发送任何形式的自动跟进消息**。对于新账户（预热期少于约 30 天），最安全的做法是关闭跟进功能，仅发送初始回复——跟进消息最容易让低信任度的账户被判定为“机器人”。待账户预热完成且稳定后，再将其重新开启。 当达到每日消息上限时，计划内的跟进消息会自动推迟到第二天发送，而不会发送失败。 --- ## 媒体消息 收到的照片、文档和语音笔记会被拉取到聊天中，以便 AI 理解它们（语音笔记会自动转录）。在此版本中，AI 的外发回复**仅限文本**。过长的回复会自动截断至 Telegram 的 4,096 字符限制。 --- ## 手机端的已读状态 当 AI 回复 Telegram 聊天，或者您在“聊天”中打开该对话时，您的 Telegram 应用中该对话也会被标记为已读——这样您手机上的未读角标就能保持同步，而不会堆积成百上千条未读消息。 机器人**未**回复的聊天（例如当机器人关闭、处于非活跃时间或选择不回复时）会特意保留为**未读**状态，以便您仍能发现并亲自处理它们。 --- ## 限制 - **仅限个人一对一聊天。** 此版本暂不支持群组和频道消息。 - **不支持内联按钮。** 不支持交互式按钮菜单。 - **仅限发送文本。** AI 回复为文本格式；发送媒体文件的功能计划在后续更新中推出。 - **非官方集成。** 它依赖于 Telegram 客户端登录，且未得到 Telegram 的认可；其平台侧的变动可能会影响此功能。 - **账户风险。** 过度或未经请求的自动化操作可能导致账户受限或被封禁——请遵循上述安全指南。 --- ## 故障排除 ### 未收到登录验证码 - 请检查 Telegram 应用内的 **Telegram** 服务聊天窗口 — 验证码通常会发送到那里，而不是通过短信发送。 - 请确保您输入的手机号包含正确的国家/地区代码。 - 如果 Telegram 认为账户/号码存在可疑行为，会限制验证码的发送。请等待几分钟后再试。 ### “验证码过期”或“验证码无效” - 验证码的有效期很短。请重新开始连接流程以获取新的验证码，并尽快输入。 ### 意外要求输入密码 - 您的账户已启用两步验证。请输入您的 Telegram 密码以完成登录。如果您忘记了密码，请在 Telegram 的 **设置 → 隐私与安全 → 两步验证** 中进行重置。 ### 消息无法发送 - 请确认“频道”页面上的连接状态显示为 **已连接**。 - 请确认该联系人是您可以在 Telegram 上发送消息的对象。 - 如果账户最近被标记为垃圾信息，请减少发送量并仅与现有联系人沟通。 ### 账户已登出 - 您的会话已结束（由您本人、从其他设备操作或由 Telegram 系统终止）。请前往 **设置 → 频道 → 频道**，点击 **断开连接**，然后重新登录。 --- ## 最佳实践 - **连接一个已经在 Telegram 上与客户进行过沟通的账户**，而不是全新的临时账户。 - **从较低的自动化发送量开始**，然后逐渐增加。 - **回复入站消息和已建立联系的客户**，而不是向陌生人发送冷启动消息。 - **保持账户健康** — 使用真实号码、保持正常使用习惯并采取保守的发送节奏，可以显著降低被封禁的风险。