WhatsApp 工作台
WhatsApp 工作台
{{ convName(currentConv) }}
+{{ currentConv.contact_phone }}
{{ l[1] }}{{ l[2] }}
没有匹配的语言
未选择会话
从左侧列表中选择一个会话开始工作
客户发送的消息会自动翻译成中文
{{ dayLabel(m, i) }}
{{ voiceTime(m) }}
{{ durText(m.id) }}
{{ docExt(m) }}
{{ m.text || '文件' }}
{{ docExt(m) }} 文件
{{ m.text.startsWith('http') ? '查看位置' : m.text }}
{{ m.text }}
[{{ m.message_type }}]
{{ m.direction === 'outbound' && m.translated_text ? m.translated_text : m.text }}
翻译：{{ m.translated_text }}
翻译中…
翻译失败
译文：{{ m.text }}
客户将收到（{{ preview.langName }}）
{{ preview.text }}
你的中文：{{ preview.draft }}
坐席管理
审计日志
成本统计
{{ c.label }}
{{ c.value }}
{{ c.sub }}
牛信云金额为 CDR 话单真实价格（每 10 分钟自动同步，话单有延迟属正常）；AI 金额按模型单价估算（常见模型已内置，.env 的 AI_PRICE_IN / AI_PRICE_OUT 可覆盖）。
配置管理 · AI 密钥
翻译时按顺序取用第一个「正常」状态的密钥；返回欠费/余额不足时自动标记为「欠费停用」并切换下一个。充值后点「恢复正常」重新启用。列表为空时回退使用服务器 .env 里的 AI_API_KEY。
使用指南
一、快速上手（30 秒）
- 登录后进入「消息工作台」，左侧是会话列表。
- 有多个商户号时，左上角选择你负责的账号（只有一个号会自动跳过）。
- 客户发来的消息自动翻译成中文：气泡上半是原文，下半灰字「翻译：…」是译文。
- 你直接用中文输入，点「发送」，系统翻译成客户语言发出去；想先检查就点发送键旁的「翻译」图标。
二、界面总览
| 左侧菜单 | 消息工作台（日常用）、坐席管理（管理员）、使用指南。桌面端可点左上角箭头折叠成图标 |
| 账号列表 | 左上角列出你有权的商户号，红点数字 = 该号未读消息数；只有一个账号时自动隐藏 |
| 页面页签 | 顶栏中部，可同时打开工作台、坐席管理、指南并来回切换，状态不丢 |
| 红绿灯 | 顶栏右侧小圆点：绿 = 实时通道已连接（新消息即时到达），红 = 断线重连中 |
| 浏览器标题 | 括号里的数字 = 全部未读消息数，切走页面也能看到 |
三、会话列表
筛选：顶部「全部 / 未读 / 已完成」（括号是会话数）。上班先看「未读」清零。
搜索：输入号码片段或备注名，快速定位客户。
每条会话显示：客户昵称（或号码）、最后一条消息、最后消息时间。标签说明：
| 暂不能发消息 | 该客户超过 24 小时没联系你（见「24 小时规则」） |
| 橙色图钉 | 已置顶，排在列表最前 |
| 红色数字 | 未读消息数，打开会话自动清零 |
悬停操作（条目右侧）：📌 置顶/取消置顶、✓ 完成（已解决的会话移到「已完成」，里面可恢复）。客户再发消息时，已完成的会话会自动回到「全部」，不会漏消息。
备注名：点名称旁的铅笔图标，把号码备注成"西班牙 Carlos"这类好记的名字。客户发消息带来的 WhatsApp 昵称会自动显示，加了备注后显示为「昵称(备注)」。
四、聊天与翻译
| 客户消息 | 白气泡：上半原文，下半灰字「翻译：…」是中文译文 |
| 你的消息 | 绿气泡：正文是客户看到的译文，下方灰字「翻译：…」是你输入的中文原话 |
| 翻译失败 | 点旁边的「重试」即可重新翻译，不产生额外消息 |
| 不用翻译的内容 | 纯数字、标点、表情不触发翻译，直接显示原文（预览时也会直接给原文） |
| 手机 App 消息 | 你在手机 WhatsApp 上发的消息会同步过来，带「手机App」标记 |
| 客户语言 | 标题栏右侧自动识别显示，翻译回复时自动使用该语言；识别不准可点旁边的「更换」手动指定 |
五、消息状态图标（很重要）
| 转圈 | 发送中，请稍等，不用重复点 |
| ✓（灰） | 已发出（平台已受理） |
| ✓✓（灰） | 已送达客户手机 |
| ✓✓（蓝） | 客户已读 |
| ✗（红） | 发送失败；最常见原因是超过 24 小时窗口（见「24 小时规则」） |
灰 ✓ 长时间不变：对方手机关机或没网络，送达后会自动更新，无需处理。
六、发送各种消息
| 文本 | 输入中文 →「发送」直接发出（自动翻译）；点发送旁的「翻译」图标先看译文气泡再决定 |
| 图片 / 视频 | 点输入框左侧图片视频按钮选择（手机可直接拍照/从相册选） |
| 文件 | 点附件按钮选任意文件发出 |
| 语音 | 点语音按钮开始录音，说完点「发送语音」，无需提前录文件 |
| 查看图片 | 点聊天里的图片放大预览，再点一下关闭 |
| 播放语音 | 语音消息带播放器，直接点播放键 |
提示：客户的媒体链接有 48 小时时效，过期后显示"无法加载"，属 WhatsApp 平台限制。
七、24 小时规则（必须知道）
WhatsApp 规定：客户最后一次发消息后的 24 小时内，你才能自由发消息。超过后该客户会显示「暂不能发消息」，输入框锁住。
- 客户回复任何一句话，24 小时窗口重新打开，自动恢复聊天。
- 超窗后必须主动联系时，只能通过 WhatsApp审核通过的模板消息——联系管理员协助处理。
- 所以看到重要客户请尽量在 24 小时内回复完。
八、受限地区（制裁地区）说明
WhatsApp 官方规定：位于古巴、伊朗、朝鲜、叙利亚以及乌克兰的克里米亚、顿涅茨克、卢甘斯克地区的用户，不具备通过 WhatsApp Business 开放平台收发消息的资格。给这些地区的号码发消息可能无法送达。
- 发送失败且命中受限地区时，系统会自动给会话打上「受限地区」标记（会话列表和聊天页顶部都能看到）。
- 标记只是提醒，不影响发送——您仍可照常尝试，部分号码可能偶尔能送达。
- 之后只要有消息发送成功，标记会自动取消。
九、常见问题
| 历史消息会同步吗？ | 会。商户号首次接入时如果选择"共享聊天"，系统会全量导入历史聊天（通常最近约 180 天）。历史消息默认不翻译（省费用）：想看哪条点消息下方的「翻译」逐条翻，或点聊天顶部的「翻译历史」批量翻译本会话；之后的新消息实时同步并自动翻译。你在手机 WhatsApp 上发的消息也会实时同步，带「手机App」标记 |
| 为什么发不出去？ | 先看状态：✗ 红色 = 失败，多半是超 24 小时窗口；转圈不动 = 网络慢，稍等 |
| 翻译错了？ | 金额、型号、SKU 正常不会被改写；发现被改写立即上报管理员 |
| 数字没翻译？ | 正常现象，纯数字/标点没有翻译必要 |
| 收不到新消息？ | 看顶栏红绿灯，红色说明断线，会自动重连；长时间红色请联系管理员 |
| 息屏/没开页面能提醒吗？ | 能。右上角用户名 → 「开启消息通知」，允许权限后新消息会推送系统通知（即使页面没打开）。手机需用 https 地址访问才能开启 |
| 忘记密码？ | 找管理员在「坐席管理」里重置 |
| 手机上能用吗？ | 可以，浏览器打开同一地址，界面自动适配手机 |
十、名词解释
| 商户号 | 公司对外的 WhatsApp 号码（客户看到的"你"） |
| 会话 | 与某个客户的一段完整聊天记录 |
| 24 小时窗口 | WhatsApp 限制：客户发消息后的 24 小时内才能自由回复 |
| 模板消息 | 在 Meta 审核过的固定格式消息，用于超窗后触达客户 |
| 已完成 | 处理完的会话归档，减少列表干扰，可随时恢复 |
十一、管理员专区
| 添加坐席 | 填邮箱（登录账号）、初始密码、可用商户号（逗号分隔，可多个）、备注（可选）；一个商户号只能分配给一名启用状态的坐席 |
| 编辑 | 改邮箱、改可用商户号、改备注；管理员账号也可编辑 |
| 重置密码 | 坐席忘记密码时使用，管理员账号同样适用；重置后其所有登录立即失效 |
| 停用 / 启用 | 停用后该坐席立即无法登录，历史会话保留 |
| 转移会话 | 把某坐席名下的会话批量转给另一坐席（离职交接用） |
| 删除 | 删除坐席，其名下会话变为未分配 |
| 审计日志 | 左侧菜单「审计日志」：查看全部坐席的操作记录（翻译/发送/分配/设置），仅管理员可见 |
| 成本统计 | 左侧菜单「成本统计」：AI 翻译 token 用量和牛信云发送条数，按日/月汇总，仅管理员可见 |
| 配置管理 | 左侧菜单「配置管理」：维护 AI 翻译密钥（grok 等），可添加多个；按顺序取用，欠费的自动停用并切换下一个，充值后点「恢复正常」 |
| 全部账号 | 管理员专属视图，可看所有商户号的会话 |
| 修改自己密码 | 右上角用户名 → 修改密码 |
多个密钥按添加顺序取用；某个密钥欠费时系统自动停用并切换下一个。
重置后该坐席的所有登录状态立即失效，需用新密码重新登录。
其名下所有已分配会话将转给所选坐席。