DATA INGESTION
数据导入
上传 Excel,逐行校验客服账号、会话编号唯一性与必填字段。校验全部通过后才允许入库,异常行按行导出。
导入顺序:解析文件 → 逐行校验 → 确认入库。同一时间只允许一个导入任务,提交前的预览会占用导入锁(10 分钟)。
拖拽 Excel 到这里,或点击选择文件
仅支持 .xlsx,单文件不超过 10MB、5000 行
请使用系统模板,工作表名必须为「会话数据」
请使用系统模板,工作表名必须为「会话数据」
1
上传文件xlsx
2
逐行校验不落库
3
确认入库形成批次
4
结果留档可导出
模板字段
加载中…
校验规则
- 客服必须唯一匹配启用账号(姓名 / 登录名 / 工号)
- 会话编号全局唯一,批内重复与库内重复都会跳过
- 编号相同但内容不同 → 进入冲突报告,不覆盖原数据
- 必填缺失、日期非法、来源不在字典内 → 行级错误
- 错误行不影响其他行,提交前必须为 0 错误
- 扩展字段由「字段映射」页面配置,模板自动跟随
安全提示:机器令牌等同于账号密码。系统只保存哈希值,明文无法找回;一旦泄露请立即吊销并重新签发。
Google 表格自动同步
用 Apps Script 把表格数据定时推送到质检系统
接入步骤
- 创建令牌:点下方「创建机器令牌」,勾选需要的权限,复制明文(只显示一次)。
- 配置脚本属性:在 Google 表格的 Apps Script 中打开「项目设置 → 脚本属性」,添加
QC_API_URL(本站地址,如https://你的域名)与QC_API_TOKEN(上一步复制的令牌)。令牌存在脚本属性里而不是代码中,避免泄露。 - 粘贴脚本:把下载的
google-sheets-sync.gs内容粘进 Apps Script,保存。 - 对齐表头:表格第一行的列名必须与「字段映射」页里的源列名完全一致。默认读取
日期、客服、客户标识、会话编号、关键对话摘要、来源,可在脚本顶部HEADERS里改。 - 先试跑:手动运行
syncNow()验证;确认无误后加定时触发器。
同步规则
- 校验口径与 Excel 导入完全一致:同一套字段映射、同一套客服匹配、同一套来源枚举。
- 错误行不中断整批:出错的行会被记录到导入批次的错误明细里,其余行照常入库。
- 断点续传:脚本用行号做游标保存到脚本属性,中途失败后重跑会从断点继续,不会重复导入。
- 内容幂等:同一份内容重复提交会被拒绝(返回 409),避免定时任务重复触发导致双份数据。
- 大批量自动分批:脚本按每批 300 行发送请求,避免 Apps Script 单次 6 分钟执行上限。
接口清单
| 接口 | 方法 | 权限 | 用途 |
|---|---|---|---|
| /api/sync/ping | GET | 任意 | 连通性自检 |
| /api/sync/fields | GET | sync:read | 读取当前表头要求 |
| /api/sync/sheets | POST | sync:write | 推送表格数据入库 |
机器令牌
用于外部程序化调用,与登录会话互相独立
校验结果
尚未选择文件