故障排除

电话打不通、意向判断不对、消息没发出去——先查哪里。

电话打不通,先看接通状态

每条通话记录都有接通状态(reached),先确认具体是哪一种,排查方向完全不同:

状态说明先查什么
CALL_REJECTED用户拒接正常情况,不用处理
UNREACHED打通但未接听正常情况,可以走随访重拨
EMPTY_PHONE空号号码本身有问题,检查名单来源
SHUTDOWN停机号码或线路侧的问题,也可能是超时未确认振铃
UN_CONNECT未打通先看是不是集中在某条线路上
CALLER_ABNORMAL主叫号码异常不是被叫的问题,是我方外呼号码本身没在网 / 失效
INVALID无效接听接通了但内容判定无效,看录音确认

如果 UN_CONNECTCALLER_ABNORMAL 大量集中出现在某条特定线路上,去看这条线路是否已经触发了异常预警(连续秒拒会自动推送通知)——线路侧问题不要一条条人工核实,先看这条线路最近的整体接通率趋势,是系统性问题就直接换线路或联系供应商,而不是逐条排查。CALLER_ABNORMAL 特别值得关注:这种情况看起来像是"打不通",但根因是我方主叫号码出了问题,如果只处理表面(换个号码重试)而不去查这批号码本身的健康状态,同样的问题会反复出现。

意向判断看起来不准

意向判断依据的是通话内容本身,如果发现某一类场景下判断持续不准:

  1. 先听几条录音,确认是话术本身没问出关键信息,还是模型判断逻辑的问题
  2. 检查话术里的意向判断相关配置(director / cognition 模块,见 配置数字员工与话术
  3. 用通话记录的"优化标记"功能把典型的判断错误案例标记出来,这些案例是后续优化的输入

微信 / 短信没发出去

先看对应的发送记录(短信有独立的发送明细,带发送状态):

  • 短信显示"失败":检查服务商配置的 appKey / secretKey 是否过期,模板是否还在报备有效期内
  • 微信消息没发出:检查对应工具是否正确挂载在数字员工上、isActive 是否为开启状态
  • 企业微信场景:先确认企业微信侧的授权是否还有效,授权过期会导致同步和发送同时失效

Webhook 没收到回调

  • 确认项目里配置的 webhookUrl 地址可以从外网访问
  • 检查你这边的接收端是否正确校验了 webhookSecret 签名,签名校验失败常被误认为"没收到",实际是收到了但被拒绝处理
  • 具体的事件字段和签名方式见 Webhook 参考

还是没解决

带着具体的通话记录 ID 或时间范围联系我们,看 联系我们——有具体案例定位问题会快很多。

接下来是什么?

以下是建议的下一步操作:

安全与隐私
API Key、Webhook 签名、权限分级、通话数据——平台在这几层做了什么。
阅读指南
联系我们
需要接入协助、遇到文档没覆盖的问题,怎么找到我们。
阅读指南