消息自动翻译
TG-Staff 在聊天会话中提供两种自动翻译能力，帮助客服与不同语言的用户沟通：
- 发送消息自动翻译 — 坐席输入原文，发送前自动翻译为目标语言再发给用户
- 接收消息自动翻译 — 用户发来的消息自动翻译为客服可读语言并展示在会话中
两种翻译 独立计费额度，可在欢迎页与套餐说明中查看每日剩余次数。
套餐额度
| 套餐 | 发送自动翻译 / 日 | 接收自动翻译 / 日 |
|---|---|---|
| 免费版 | 20 次 | 50 次 |
| 标准版 | 300 次 | 500 次 |
| 专业版 | 不限 | 不限 |
额度说明
- 每次成功使用发送自动翻译消耗 1 次发送额度。
- 每次成功翻译一条入站文本消息消耗 1 次接收额度。
- 专业版不受每日次数限制。
发送消息自动翻译
开启方式
在 聊天会话 或 客服端 的消息输入框上方，点击 自动翻译 开关即可启用。
开关旁会显示当日剩余额度，例如「自动翻译 (18/20)」。
使用流程
- 开启 自动翻译。
- 在输入框用您的语言输入原文。
- 停止输入后，系统按 自动翻译延迟（默认约 2 秒）触发翻译，输入框下方显示译文预览。
- 点击发送 — 实际发给 Telegram 用户的是 译文；系统同时保存原文与译文。
语言与延迟设置
点击会话工具栏中的 翻译设置（或会话设置 → 翻译设置），可配置：
| 设置项 | 说明 | 默认值 |
|---|---|---|
| 发送原文语言 | 您输入的语言，auto 为自动检测 | 自动 |
| 发送目标语言 | 发给用户的语言 | 英语 |
| 自动翻译延迟 | 停止输入后多久触发翻译（1–8 秒） | 2 秒 |
优先级
会话级翻译设置 优先于账号后台的全局默认；留空字段则使用全局默认。
译文显示方式
对于含原文与译文的消息，可在翻译设置中选择 消息显示模式：
- 仅显示译文
- 仅显示原文
- 同时显示原文与译文
接收消息自动翻译
开启方式
- 打开目标会话。
- 进入 会话设置 → 翻译设置。
- 开启 接收消息自动翻译 开关。
- 设置 消息原文语言 与 消息目标语言（默认目标为简体中文）。
- 保存设置。
开启后，用户通过 Telegram 发来的 文本消息 将自动翻译，并在会话列表中展示译文（按您设置的显示模式）。
面板中会显示 今日剩余接收消息自动翻译次数。
与发送翻译的区别
| 发送自动翻译 | 接收自动翻译 | |
|---|---|---|
| 触发时机 | 客服输入并发送前 | 用户消息到达时 |
| 默认状态 | 输入框开关，按会话手动开启 | 会话设置中默认关闭 |
| 额度字段 | 发送自动翻译 | 接收自动翻译 |
| 影响对象 | 发给用户的内容 | 客服看到的内容 |
两种翻译可 同时开启，实现双向跨语言沟通。
全局默认设置
账号所有者可在 用户中心 / 后台设置 中配置聊天翻译的全局默认值（发送语言、接收语言、延迟等）。新建会话时继承全局默认，可在单个会话中覆盖。
欢迎页 会话翻译 卡片汇总展示当日发送与接收翻译剩余额度。
使用建议
| 场景 | 建议配置 |
|---|---|
| 海外用户咨询 | 开启接收翻译（用户语 → 中文）+ 发送翻译（中文 → 用户语） |
| 单语团队 | 仅开启接收翻译，方便阅读用户外文消息 |
| 高频接待 | 标准版以上避免免费版每日额度用尽；专业版适合大流量 |
常见问题
翻译失败怎么办？
- 检查当日额度是否已用完
- 确认网络正常后重试
- 过短或无法识别语言的文本可能翻译失败
发送后用户收到的是原文还是译文？
- 开启发送自动翻译且翻译成功时，用户收到 译文
- 关闭发送自动翻译时，用户收到输入框中的原文
接收翻译会影响群发或命令流程吗？
- 不会。接收自动翻译仅作用于 聊天会话 中的入站文本消息展示
