从 OnlyTG Echo 迁移到 TG-Staff 完整检查清单：Bot、话术、群发、坐席与分流链接

如果你正在使用 OnlyTG Echo 管理 Telegram Bot 客服，但团队规模扩大后遇到了坐席协作瓶颈、缺少用户归因追踪或合规内控不足的问题，那么迁移到 TG-Staff 可能是一个值得考虑的方向。本清单将分步拆解从 OnlyTG Echo 迁移到 TG-Staff 的完整流程，涵盖 Bot 接入、话术重建、群发数据迁移、坐席配置与分流链接设置，帮助你的团队在最短时间内平稳过渡，避免数据丢失或服务中断。

为什么要从 OnlyTG Echo 迁移到 TG-Staff？—— 核心能力对比

在动手迁移之前，先明确迁移带来的实际收益。OnlyTG Echo 在单 Bot 自动回复场景下表现稳定，但当业务需要多人协作客服、多渠道引流归因或合规内控时，功能上限就显现了。

功能维度	OnlyTG Echo	TG-Staff
坐席管理	通常单账号操作，无独立坐席门户	独立坐席账号登录 Web 门户，支持 3/5/20 个坐席额度
会话分流	无高级分流规则	支持轮流分配与在线优先两种分流策略
分流链接（归因）	无内置短链抓取访客信息	提供官方域名短链，可捕获 IP、浏览器、UTM 参数
内容风控	无	专业版支持消息前风险词检测，含加密钱包地址监控
自动翻译	基础版有限制	标准版含 AI 翻译；专业版支持 Google、DeepL 专业翻译
群发功能	可能依赖第三方工具	内置批量群发，支持用户分群
多项目管理	有限	按套餐支持多个 Bot 项目

迁移的核心收益：从单点操作升级为团队协作 → 从被动响应变成主动归因 → 从无管控到合规内控。如果你正面临以下场景，迁移就很有价值：

• 团队有 2 人以上同时处理 Bot 咨询，需要会话转移与协作功能。
• 你在广告投放中使用 UTM 参数追踪转化，需要分流链接归因。
• 你的业务涉及加密货币或敏感领域，需要监控坐席消息中的钱包地址。

迁移前的准备工作：账号、数据与团队对齐

迁移成功的关键在于准备阶段。不要跳过这一步。

备份 OnlyTG Echo 中的关键数据

在 TG-Staff 中重建配置之前，先从 OnlyTG Echo 中导出以下数据：

• Bot Token：从 BotFather 获取，或从 OnlyTG Echo 设置中复制。注意：Token 是最高机密，不要泄露。
• 话术模板：包括欢迎语、菜单按钮、多轮对话的文本与条件逻辑。截图或导出纯文本。
• 群发用户 ID 列表：如果 OnlyTG Echo 支持导出，请导出所有用户 ID 或按分群导出。重要：TG 群发需要用户主动发过消息给 Bot 才能触达，确保列表有效。
• 坐席名单与权限：记录每个坐席的用户名、邮箱以及他们负责的 Bot 项目。
• 用户画像标签：如果 OnlyTG Echo 中已打标签，导出标签名称与关联用户 ID。

注册 TG-Staff 并确认套餐

1. 访问 https://app.tg-staff.com/ 注册账号，自动获得 3 天免费试用。
2. 根据团队规模选择套餐：
   • 标准版（约 $8.99/月）：适合 2–3 人团队，含分流链接、会话分流、3 个坐席额度。
   • 专业版（约 $16.99/月）：适合 5 人以上团队，额外提供内容风控（含钱包地址监控）、无限翻译、用户画像等高级功能。
3. 如果团队需要同时管理多个 Bot，确认套餐支持的项目数量。具体价格以官网套餐页为准。

第一步：Bot 迁移 —— 接入 Telegram Bot API

这是最核心的一步，直接决定迁移是否成功。

添加 Bot 到 TG-Staff 控制台

1. 登录 TG-Staff 控制台 → 点击「新建项目」。
2. 输入你的 Bot Token（从 BotFather 获取，格式如 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11）。
3. 系统会自动验证 Token 有效性，并同步 Bot 名称与描述。你还可以直接在控制台中编辑 Bot 头像、名称和描述，无需跳转 BotFather。
4. 如果你的 OnlyTG Echo 管理了多个 Bot，重复以上步骤为每个 Bot 创建项目。

验证 Bot 功能完整性

添加完成后，用测试账号向 Bot 发送一条消息，确认：

• 消息出现在 TG-Staff 的实时聊天界面。
• 如果配置了欢迎语（下一步会做），检查是否正常触发。
• 坐席回复后，用户端能正常收到。

如果 OnlyTG Echo 中有自定义键盘或内联按钮，需要在 TG-Staff 中重新搭建（见下一步）。

第二步：话术与命令流程重建

OnlyTG Echo 中的话术逻辑（欢迎语、菜单、多轮对话）无法自动迁移到 TG-Staff。你需要使用 TG-Staff 的可视化命令流程编辑器重新搭建。

1. 在控制台进入项目 → 点击「命令流程」。
2. 拖拽节点到画布，配置欢迎语文本、按钮文字与跳转逻辑。
3. 如果 OnlyTG Echo 中有多步骤交互（如收集用户信息 → 发送确认 → 转人工），按相同逻辑创建多个节点并连线。
4. 保存并发布流程，然后用测试账号重新触发 Bot，验证每一步是否按预期执行。

提示：TG-Staff 的流程编辑器是零代码的，即使没有编程经验的运营人员也能操作。建议从简单场景开始（如欢迎语 + 菜单），逐步增加复杂度。

第三步：群发数据迁移与用户分群

群发是运营的重要工具。迁移步骤如下：

1. 将之前备份的用户 ID 列表整理为纯文本格式（每行一个用户 ID）。
2. 在 TG-Staff 控制台 → 「群发」功能中，点击「创建群发」。
3. 选择目标用户分群（如「所有用户」或自定义分群）。如果 OnlyTG Echo 中有标签，可在 TG-Staff 中手动创建对应分群并导入用户 ID。
4. 撰写消息内容，支持文本、图片、按钮等格式。
5. 建议先选择 50–100 个用户进行小规模测试，确认发送成功率和消息样式无误后，再执行全量群发。

注意：Telegram 对 Bot 群发有频率限制（约 30 条/秒），但 TG-Staff 已内置限速逻辑，避免触发风控。如果你的用户量很大（>10 万），建议分批次发送。

第四步：坐席配置与会话分流设置

这是 TG-Staff 相比 OnlyTG Echo 的核心优势：多人协作客服。

创建坐席账号与权限

1. 在控制台 → 「坐席管理」中点击「添加坐席」。
2. 输入坐席的邮箱或用户名，系统会发送邀请链接。
3. 为每个坐席分配项目权限：可以让他们只查看某个 Bot 的会话，或查看所有 Bot。
4. 坐席通过独立 Web 门户登录（https://app.tg-staff.com/），无需共享账号密码。

配置分流规则与测试

1. 进入项目设置 → 「会话分流」。
2. 选择分流规则：
   • 轮流分配：按顺序轮询有权限的坐席，适合工作量均衡的日常场景。
   • 在线优先：优先分配给当前在线的坐席，适合咨询高峰时段快速响应。
3. 设置客服范围：可以选择「全部客服」或「指定客服」（如仅让高级坐席处理复杂问题）。
4. 用多个测试账号向 Bot 发送消息，观察会话是否按规则分配给不同坐席。如果坐席不在线，系统会排队等待或回退到轮流分配。

注意：OnlyTG Echo 中的坐席无法直接迁移到 TG-Staff，每个坐席都需要重新注册账号。建议在迁移前通知坐席团队准备好邮箱或用户名。

第五步：分流链接迁移与广告归因重建

如果你在 OnlyTG Echo 中使用过类似短链追踪功能，那么 TG-Staff 的分流链接（Diversion Link） 可以提供更强大的归因能力。

1. 在控制台 → 「分流链接」中创建新链接。
2. 输入原始 URL（通常是 Bot 的 t.me 链接），系统会生成一个 https://app.tg-staff.com/{code} 格式的短链。
3. 绑定追踪参数：在链接后添加 ?utm_source=facebook&campaign_id=123 等自定义参数，系统会自动捕获访客的 IP、浏览器信息、URL 参数。
4. 将生成的短链替换广告、社媒、邮件中的原链接。

测试流程：点击分流链接 → 自动跳转到 Bot → 发送消息 → 坐席端查看用户画像中是否显示来源信息。如果一切正常，分流归因链路就重建完成了。

迁移后检查清单与常见问题排查

完成以上步骤后，使用这份检查清单确认所有环节正常：

• Bot 响应正常：用户发送消息后，坐席端实时显示。
• 话术流程正确：欢迎语、菜单、多轮对话按预期执行。
• 坐席登录正常：每个坐席都能通过独立账号登录 Web 门户。
• 会话分流生效：消息按规则分配给正确坐席，无漏分配或错分配。
• 群发测试通过：小规模群发成功，无发送失败或重复发送。
• 分流链接跳转正确：点击短链后跳转到 Bot，用户画像显示来源信息。
• 自动翻译（如有）正常：坐席发送消息后，用户端看到翻译后的内容。
• 内容风控（专业版）正常：坐席发送含风险词的消息时触发二次确认或阻止。

常见问题排查：

问题	可能原因	解决方案
Bot 无响应	Token 无效或 Bot 被暂停	从 BotFather 重新获取 Token，检查 TG-Staff 中 Token 是否正确
群发失败	用户 ID 无效或 TG 频率限制	确认用户 ID 格式正确，分批发送（每批 1000 条）
分流不生效	规则配置错误或坐席未在线	检查分流规则是否为「在线优先」，确认坐席已登录
分流链接跳转 404	链接已过期或项目被删除	重新生成分流链接并替换旧链接

常见问题

问：OnlyTG Echo 中的数据（如用户画像、聊天记录）可以自动导入 TG-Staff 吗？

答： TG-Staff 目前不支持自动从 OnlyTG Echo 导入数据。建议在迁移前手动导出用户 ID 列表、话术模板和坐席名单，然后通过控制台重新配置。聊天记录无法迁移，但 Bot 接入后新会话将正常显示。

问：迁移期间，我的 Telegram Bot 会中断服务吗？

答： 会有一个短暂的切换窗口。建议在低峰时段操作：先在 OnlyTG Echo 中暂停 Bot 响应，然后在 TG-Staff 中添加同一 Bot Token 并激活。整个过程通常在 5–10 分钟内完成。建议提前通知用户维护时间。

问：TG-Staff 支持多个 Bot 同时管理吗？与 OnlyTG Echo 有何不同？

答： 支持。TG-Staff 按套餐支持不同数量的 Bot 项目（标准版与专业版具体数量见官网）。与 OnlyTG Echo 相比，TG-Staff 提供了更灵活的多坐席协作、分流规则（轮流/在线优先）和分流链接归因功能，更适合多 Bot 运营的团队。

问：迁移后，原有的群发列表和发送频率会受影响吗？

答： 群发列表需重新导入 TG-Staff。TG-Staff 的批量群发功能支持按用户分群发送，并内置频率限制（遵循 Telegram 官方限制）。迁移后建议先小规模测试（如 50–100 条消息），确认发送成功率后再执行全量群发。

问：我是 OnlyTG Echo 的付费用户，迁移到 TG-Staff 后能获得相同或更好的功能吗？

答： 取决于你的套餐选择。TG-Staff 标准版（约 8.99/月）已包含实时双向聊天、会话分流、分流链接等核心功能；专业版（约16.99/月）额外提供内容风控（含加密钱包地址监控）、无限翻译、用户画像等高级功能。建议利用 3 天试用期对比测试，确认满足需求后再订阅。

---

立即开始迁移：注册 TG-Staff 3 天免费试用 → https://app.tg-staff.com/

获取详细操作指南：查阅 TG-Staff 文档 → https://docs.tg-staff.com/

迁移中遇到问题？ 联系客服 Bot → @tgstaff_robot