外呼失败日志

快速阅读

外呼失败日志用于回答：

• 外呼为什么没有成功。
• 失败来自预览外呼、预测外呼、主叫外呼、WebCall、RTC 还是其他来源。
• 原始错误码和原始错误描述是什么。
• 是否能通过请求 ID、log 唯一标识、任务 ID、外显导航等信息继续排障。
• 原“座席呼叫日志”中的外呼前置拦截是否已统一到外呼失败日志口径下查看。

外呼失败日志属于系统日志大类，重点记录外呼失败阶段、失败来源和失败原因。

阅读地图

一、文档说明

1.1 文档目的

本文档基于既有外呼失败日志整合设计、代码模型、查询接口和导出任务整理，说明外呼失败日志的产品定位、数据来源、查询条件、展示字段、导出字段和验收口径。

1.2 文档范围

覆盖：

• 外呼失败日志统一入口。
• 原座席呼叫日志中的外呼拦截数据。
• CTI、PaaS、RTC、WebCall、风控等失败来源的产品口径。
• 外呼失败分页查询、复制客户号码、导出能力。
• 与座席工作日志、绑定电话日志、话单和任务记录的联查关系。

不覆盖：

• 原始错误码体系的技术合并。
• 内部日志索引、表结构和服务实现细节。
• 完整外呼任务配置和线路配置说明。

二、产品总览

2.1 产品定位

外呼失败日志统一承接外呼过程中未按预期发起、接续、接通或提交成功的失败记录，帮助客户快速理解失败原因，并为实施和技术支持保留原始错误信息。

一句话理解：

外呼失败日志看“这次外呼为什么失败，同时保留原始错误码和排障线索”。

2.2 统一入口口径

既有设计已确认：

• 原“座席呼叫日志”主要记录 PaaS obInterception 外呼拦截事件，不是完整意义上的座席所有呼叫行为日志。
• 外呼失败日志应统一承接原座席呼叫日志中的外呼失败类记录。
• 页面主口径展示“失败原因”或结果描述，同时保留原始错误码、原始错误描述、日志来源、请求 ID 和 log 唯一标识。
• 原接口、旧权限、旧导出和历史数据应保留兼容，避免影响老客户。

三、核心概念

3.1 失败原因

失败原因是面向用户的业务理解口径，用于把不同来源的失败整理成可理解的原因，例如无外呼权限、号码限制、黑名单拦截、外显异常、RTC 终端权限异常等。

3.2 原始错误码与原始错误描述

外呼失败日志不建议强行统一原始错误码。原始错误码和原始错误描述应保留，用于兼容老客户查询习惯和支撑实施、研发排障。

3.3 日志来源

日志来源用于说明失败来自哪个外呼入口或终端来源。导出任务中已确认的日志来源格式化口径包括：

3.4 呼叫类型

导出任务中已确认的呼叫类型格式化口径包括：

四、数据来源与主链路

4.1 主列表数据来源

既有整合设计建议外呼失败日志主列表承接以下来源：

4.2 排障上下文来源

以下来源更适合作为详情或联查上下文，不建议全部堆到主列表：

4.3 查询链路

外呼请求产生
→ 前置检查、接续、终端或风控环节失败
→ 写入外呼失败相关来源
→ 统一进入外呼失败日志页面查询
→ 通过请求 ID、log 唯一标识、任务 ID、外显导航、座席和客户号码联查

五、能力地图

六、产品功能说明

6.1 分页查询

管理端已确认存在外呼失败日志分页查询能力：

POST /api/cdrFailLog/page

权限口径：

外呼失败日志查看权限

查询后系统会按登录用户的号码隐藏规则对客户号码及错误信息中的号码进行脱敏处理。

6.2 复制客户号码

管理端已确认存在复制客户号码能力：

POST /api/cdrFailLog/copyCustomerNumber

复制时同样会按号码隐藏规则处理。

6.3 导出

管理端已确认存在外呼失败日志导出能力：

POST /api/cdrFailLog/export

导出限制：

• 导出前校验开始时间和结束时间。
• 单次导出上限为 10 万条。
• 导出任务会进入任务中心类异步导出链路。
• 导出文件名默认采用“外呼失败日志_企业ID_时间”。
• 对特定存储环境，文件名可能转为英文 fail_log。

6.4 查询条件

分页查询和导出已确认使用的查询条件包括：

6.5 列表与导出字段

代码模型和导出枚举已确认字段包括：

七、典型业务场景

7.1 座席手动外呼失败

按座席、客户号码、时间查询外呼失败日志
→ 查看日志来源、呼叫类型、错误码、错误描述
→ 联查座席工作日志确认外呼动作和返回值
→ 联查绑定电话日志确认接续条件

7.2 任务外呼失败集中

按任务 ID 或任务名称查询
→ 按错误码、错误描述、日志来源分析集中原因
→ 判断是否与号码、外显、线路、风控或客户侧有关
→ 必要时联查任务记录和号码数据

7.3 RTC 或 WebCall 失败排查

按 RTC 或呼叫类型筛选
→ 查看原始错误码和错误描述
→ 按请求 ID 或 log 唯一标识联查上下文

7.4 老客户按错误码排查

按原始错误码查询
→ 保留原始错误描述
→ 结合失败原因和日志来源解释用户可理解原因

八、查询、详情与导出建议

8.1 列表默认字段建议

8.2 列设置或详情字段建议

• 任务 ID。
• 任务名称。
• 外显导航。
• 原始日志来源。
• 数据来源系统。
• 关联记录入口。

8.3 导出字段建议

导出字段应至少覆盖代码枚举中已确认的字段：客户号码、座席工号、座席名称、时间、日志来源、呼叫类型、RTC、任务 ID、任务名称、外显导航、错误码、结果描述、请求 ID、log 唯一标识。

九、与周边能力的关系

• 与座席工作日志：原座席呼叫日志中的外呼拦截本质上来源于座席工作日志中的外呼拦截事件。
• 与绑定电话日志：绑定电话异常可能导致外呼接续失败。
• 与任务记录：预测外呼或任务外呼失败需要联查任务上下文。
• 与话单：部分失败已形成话单，部分前置失败可能没有完整话单。
• 与外显导航：外显号码、外显导航异常是外呼失败的重要原因。

十、FAQ

Q1：外呼失败日志会统一所有错误码吗？
不建议统一原始错误码。应统一用户可理解的失败原因，同时保留原始错误码和原始错误描述。

Q2：外呼失败一定有话单吗？
不一定。前置检查或发起阶段失败时，可能没有完整话单。

Q3：原座席呼叫日志是否完全删除？
产品口径上不再作为独立用户入口展示，但原接口、历史数据、导出能力和权限应保留兼容，具体以版本落地为准。

Q4：客户号码为什么有时被隐藏？
外呼失败日志涉及客户号码，系统会按登录用户的号码隐藏规则展示和导出。

十一、总结

外呼失败日志是外呼异常排查的统一入口。它应统一用户入口和失败原因口径，保留原始错误码、原始错误描述、日志来源、请求 ID、任务和外显上下文，用于兼容老客户并支撑实施排障。

附录 A：入口与权限

附录 B：关键字段口径

附录 C：实施检查清单

• 可按时间、客户号码、座席、日志来源、呼叫类型、RTC 查询。
• 可按错误码、请求 ID、任务 ID 查询。
• 客户号码展示、复制、导出均按隐藏规则处理。
• 导出字段与页面字段口径一致。
• 原座席呼叫日志数据纳入外呼失败日志统一入口。
• 原始错误码和原始错误描述保留。
• 单次导出超过 10 万条时有明确提示。

附录 D：常见问题速查