TgSpark 入门指南

这份指南面向第一次使用 TgSpark 的客服、运营和团队负责人。完成下面的流程后，你应能进入正确的工作区、找到有权限使用的 Telegram 账号，并完成一次消息处理。

先理解系统中的几个对象

会员账户和 Telegram 账号各有自己的登录流程。一个会员可以加入多个工作区；加入工作区后，还需要取得具体 Telegram 账号的使用权限。同一 Telegram 账号可以关联多个工作区，其真实消息和已读状态仍属于同一个 Telegram 账号。

使用前准备

向团队负责人取得以下信息：

• 站点访问地址，以及你的会员登录方式。已有团队时，请取得发给你的邀请链接。
• 应进入的工作区名称。
• 应使用的 Telegram 账号，以及是否需要查看、发送或群发权限。
• 用于首次熟悉流程的自有测试聊天。发送会产生真实 Telegram 消息。

如果由你负责绑定 Telegram 账号，还要能使用该账号的手机 Telegram；手机号登录需要接收 Telegram 验证码，开启两步验证时还需要对应密码。

第一步 登录会员账户

1. 打开团队提供的站点。
2. 按页面开放的方式使用邮箱和密码，或邮箱验证码登录。
3. 新用户在站点开放注册时，按提示验证邮箱、填写显示名称并设置密码。注册和新密码的长度要求为 12 至 128 个字符。
4. 忘记密码时使用页面开放的找回入口；入口未开放时联系站点管理员。

没有注册入口通常与站点配置有关；不要尝试使用旧 HotGo 管理端的示例账户登录会员端。邮箱验证码与 Telegram 登录验证码来自不同服务，填写在各自的页面。

**完成标志：**进入工作区选择页，或自动回到仍有权限访问的工作区。

第二步 创建或加入工作区

已有团队时，打开邀请链接，登录被邀请的账户，核对工作区和角色后接受邀请。若提示身份不符，请让邀请者核对邮箱或用户标识。

自己建立团队时，在工作区选择页填写名称和默认时区，点击“创建并进入”。创建者成为所有者。时区会影响定时任务的展示、自动回复时段和分析日期，请选团队实际使用的时区。

进入系统后，可通过侧栏的工作区切换入口选择其他工作区。每次切换后，先核对当前工作区名称。

**完成标志：**看到“消息、群发、工单、分析、设置”主要导航。具体操作按钮仍受权限限制。

第三步 准备可用的 Telegram 账号

如果团队已经接入账号，先进入“消息”检查是否可见。提示没有查看权限时，请管理员在“设置 → Telegram 账号”的成员授权中给你授权。

如果需要新接入账号，由有绑定权限的人操作：

1. 进入“设置 → Telegram 账号”，打开绑定入口。
2. 选择扫码登录，使用手机 Telegram 的“设置 → 设备 → 扫描二维码”确认；也可以选择手机号登录。
3. 按提示填写 Telegram 验证码和必要的两步验证密码，登录过程中保持绑定窗口打开。
4. 等待页面显示绑定成功，检查账号运行状态。
5. 在账号的成员授权中，为普通成员分别分配查看、发送、群发或管理授权权限。

**完成标志：**账号显示已绑定且运行就绪；“消息”页开始出现会话。绑定成功但未就绪时，让管理员检查 Worker，反复扫码通常不能解决节点离线。

第四步 找到会话并回复

1. 进入“消息”，默认从“全部账号”查看，也可筛选单个账号。
2. 搜索会话名称或 ID，必要时检查普通会话、归档和类型筛选。
3. 打开自有测试会话，核对聊天顶部和发送区的实际 Telegram 账号。
4. 输入简短文字，点击发送，或使用 Ctrl / Command + Enter。
5. 等待发送成功状态。若显示结果待确认，先查询原任务，不要连续重发。

**完成标志：**系统确认发送成功，测试目标收到相应消息。仅出现排队状态不等于已发送成功。

打开会话并在前台看到最新消息时会触发已读；只想查看内容而不改变已读状态，请在会话右键菜单中使用“静默预览”。已读会同步影响这个 Telegram 账号的其他使用者。

第五步 熟悉常用模块

每天开始工作时

先核对工作区和 Telegram 账号，再查看连接状态、待回复会话及“我的未完成”工单。准备离开时，处理发送失败或待确认任务，保存需要保留的内容，并更新工单状态。

聊天草稿和待上传附件不能当作永久保存。刷新或关闭页面前应处理未发送内容；系统版本更新的保护提示也不能代替主动保存。

第一次使用遇到问题

更多操作和故障处理见模块帮助。