怎么在易歪歪eyy后台配置工单字段必填校验?
易歪歪eyy后台配置工单字段必填校验,分平台最短路径与例外规则一次讲透,附回退方案与合规边界。

功能定位:为什么要在 eyy 后台打开“必填校验”
工单字段必填校验是易歪歪 eyy 后台「规则管理」模块的子功能,核心作用是在提交节点强制阻断空值,避免客服后续反复补录。2026 春季版(v8.14.0)把校验时机从“保存后”提前到“提交前”,并支持分平台差异提示,减少因客户端缓存导致的漏检。
经验性观察:当房间日工单量>200 单时,开启必填校验可使补录率由 18 % 降至 5 % 以内;若<50 单,收益有限,反而可能拉长前端提交耗时(验证步骤见文末“观测方法”)。
版本演进:必填校验的三次迁移
1. 旧版(≤v8.10)(2025Q4 及更早)
仅支持“文本-空值”判断,且提示语写死;一旦字段类型为“图片”或“文件”,即使勾选必填也形同虚设。
2. 新版(v8.11–v8.13)
新增“文件大小>0”校验,但 Android 端因缓存路径权限问题,偶现“已上传却仍提示为空”的假阴性,需要手动重进页面。
3. 当前版(v8.14.0)
引入“客户端预检+服务端二次确认”双阶段模型,并允许自定义提示语、多语言键值;同时提供“例外白名单”入口,可针对机器人生成的工单跳过校验,解决批量导入失败问题。
决策树:什么时候值得开、什么时候别开
提示
以下节点基于 2026-05 社区 500 人抽样问卷 + 官方后台脱敏数据,供快速自检。
- 日工单量 > 200 且客服人数 < 10 ⇒ 强烈建议开启,节省人力。
- 字段中若含“用户上传文件”且 Android 用户占比 > 60 % ⇒ 先开“例外白名单”,待 v8.15 修复后再全量。
- 业务需要“先提交后补录”(例如外呼回访场景)⇒ 不要开,或把字段移出模板。
- 使用第三方归档机器人每日批量关单 ⇒ 把机器人 UID 写入白名单,避免脚本被阻断。
操作路径:最短入口与平台差异
桌面端(Windows / macOS)
- 登录 admin.eyy.im → 左侧「工单中心」→「模板管理」。
- 选中目标模板 → 右上角「字段配置」→ 在对应字段行勾选「提交时必填」。
- 如需自定义提示,点击同一行尾「⚙️」→「多语言」→ 输入键值(例:ticket_field_empty)。
- 若需白名单,切到顶部「例外规则」→「添加 UID」→ 粘贴机器人或内部系统 ID → 保存。
移动端(Android / iOS 网页全屏)
路径与桌面端一致,但受限于屏幕宽度,「例外规则」被折叠在「更多」下拉菜单;iOS Safari 若出现“保存”按钮灰色,需先滚动至页面底部,触发一次 viewport 校验。
例外与取舍:白名单、条件字段、级联失效
1. 白名单粒度
目前仅支持 UID 维度,不支持 IP、角色或标签。若同一机器人同时承担“批量关单”与“正常留言”,需自行在脚本头部切换 UID,否则正常留言也会被跳过校验。
2. 条件字段(显示/隐藏)
当字段 A 选择“其他”时才显示字段 B,并设 B 必填。经验性观察:若用户先选“其他”使 B 出现,再回退 A,B 会被隐藏但校验仍生效,导致无法提交。缓解方案:在「字段配置」打开「同步清理隐藏字段值」,回退时自动清空 B,校验即通过。
3. 级联失效边界
模板复制到新房间时,白名单不会自动携带,需手动再配一次;否则新房间对机器人依旧触发校验,批量导入失败。
与机器人协同:最小权限原则
官方提供「工单机器人」模板代码(Python 3.9+),位于GitHub 仓库。若仅需关闭校验,不必给机器人分配「模板编辑」权限,只需把 UID 写入白名单即可;减少权限可降低因 Token 泄露导致的模板被篡改风险。
警告
不要通过“前端注入”方式强行把字段值设为空字符串绕过校验——新版服务端会在落库前二次哈希比对,若发现空值被伪装成“空格”或“零宽字符”,将返回 400 并记录异常日志,累计 10 次后自动禁用该 UID 的接口配额 1 小时。
故障排查:常见现象与验证方法
| 现象 | 可能原因 | 验证步骤 | 处置 |
|---|---|---|---|
| Android 端提示“文件未上传”但已显示缩略图 | 缓存路径权限被系统回收 | 换 iOS 或桌面端上传同文件,看是否仍报错 | 把该字段加入白名单,或引导用户用桌面端补传 |
| 批量导入 API 返回 422 | 机器人 UID 未写入白名单 | 在「例外规则」搜索该 UID,确认是否存在 | 添加后重试;若仍失败,检查是否用了旧 Token(v8.10 之前签发) |
| 条件字段回退后无法提交 | 隐藏字段仍被校验 | 打开浏览器控制台,看 hidden 输入框是否仍有 value | 开启「同步清理隐藏字段值」并重新加载模板 |
适用/不适用场景清单
- 适用:在线教学售后、狼人杀违规申诉、会员退款申请——字段少、值明确、客服人力紧。
- 不适用:外呼回访记录、创意征集活动——需要“先占位后补录”,强制校验会拉长闭环时间。
- 慎用:高比例 Android 上传、旧机器人未升级——建议灰度 20 % 观察一周,再全量。
最佳实践 6 条(检查表)
- 模板上线前,用「预览-提交」空表单,确认所有必填提示出现且可正常阻断。
- 把机器人 UID 写进白名单后,再跑一次批量导入脚本,确认 422 不再出现。
- 对含文件字段的模板,先在 Android 真机上传≥50 MB 视频,观察是否假阴性。
- 条件字段务必同步开启「清理隐藏值」,并在浏览器 DevTools 验证 hidden input 被清空。
- 每月初检查「例外规则」列表,剔除已失效的机器人,防止僵尸 UID 堆积。
- 重大节假日前,提前 3 天关闭非核心模板校验,避免峰值期因阻断导致客诉。
验证与观测方法
在「数据中心」→「工单事件」筛选 event=“submit_block”,可导出 CSV。字段“block_reason=required_empty”即为因必填校验被拦截的记录。连续观测 7 日,计算:
补录率 = 被拦截记录数 / 总提交数 × 100 %
若补录率下降 > 10 %,说明校验收益明显;若 < 2 %,可考虑放宽或关闭,减少用户摩擦。
FAQ(FAQPage Schema)
能否对同一字段部分房间开启、部分房间关闭?
不可以。必填校验绑定在模板级别,若房间差异大,请复制为新模板再单独设置。
提示语能否插入变量?
截至当前版本仅支持纯文本,不支持 {field_name} 变量;如需多语言,请用多语言键值方式手动维护。
白名单上限是多少?
经验性观察:单模板最多 200 条 UID;超过后页面保存会变慢,建议按业务分组拆模板。
收尾:下一步行动
读完本文,你已知道易歪歪 eyy 后台配置工单字段必填校验的完整路径、边界与回退方案。现在就打开模板管理,按“检查表”跑一遍预览-提交-拦截测试;若补录率高于 10 %,立刻把机器人 UID 写进白名单,再灰度 20 % 房间观察一周。验证有效后,全量上线,并把观测方法写进每月例行报告——让校验规则始终与业务节奏同步,而不是成为客服新的“人工补丁”。