故障排除
电话打不通、意向判断不对、消息没发出去——先查哪里。
电话打不通,先看接通状态
每条通话记录都有接通状态(reached),先确认具体是哪一种,排查方向完全不同:
| 状态 | 说明 | 先查什么 |
|---|---|---|
CALL_REJECTED | 用户拒接 | 正常情况,不用处理 |
UNREACHED | 打通但未接听 | 正常情况,可以走随访重拨 |
EMPTY_PHONE | 空号 | 号码本身有问题,检查名单来源 |
SHUTDOWN | 停机 | 号码或线路侧的问题,也可能是超时未确认振铃 |
UN_CONNECT | 未打通 | 先看是不是集中在某条线路上 |
CALLER_ABNORMAL | 主叫号码异常 | 不是被叫的问题,是我方外呼号码本身没在网 / 失效 |
INVALID | 无效接听 | 接通了但内容判定无效,看录音确认 |
如果 UN_CONNECT 或 CALLER_ABNORMAL 大量集中出现在某条特定线路上,去看这条线路是否已经触发了异常预警(连续秒拒会自动推送通知)——线路侧问题不要一条条人工核实,先看这条线路最近的整体接通率趋势,是系统性问题就直接换线路或联系供应商,而不是逐条排查。CALLER_ABNORMAL 特别值得关注:这种情况看起来像是"打不通",但根因是我方主叫号码出了问题,如果只处理表面(换个号码重试)而不去查这批号码本身的健康状态,同样的问题会反复出现。
意向判断看起来不准
意向判断依据的是通话内容本身,如果发现某一类场景下判断持续不准:
- 先听几条录音,确认是话术本身没问出关键信息,还是模型判断逻辑的问题
- 检查话术里的意向判断相关配置(
director/cognition模块,见 配置数字员工与话术) - 用通话记录的"优化标记"功能把典型的判断错误案例标记出来,这些案例是后续优化的输入
微信 / 短信没发出去
先看对应的发送记录(短信有独立的发送明细,带发送状态):
- 短信显示"失败":检查服务商配置的
appKey/secretKey是否过期,模板是否还在报备有效期内 - 微信消息没发出:检查对应工具是否正确挂载在数字员工上、
isActive是否为开启状态 - 企业微信场景:先确认企业微信侧的授权是否还有效,授权过期会导致同步和发送同时失效
Webhook 没收到回调
- 确认项目里配置的
webhookUrl地址可以从外网访问 - 检查你这边的接收端是否正确校验了
webhookSecret签名,签名校验失败常被误认为"没收到",实际是收到了但被拒绝处理 - 具体的事件字段和签名方式见 Webhook 参考
还是没解决
带着具体的通话记录 ID 或时间范围联系我们,看 联系我们——有具体案例定位问题会快很多。