话单(CDR)产品说明
快速阅读
话单(CDR,Call Detail Record)是通话结束后留下的事实。主话单(Main CDR)看整通结果,从话单(Sub CDR)看座席腿、转接腿、咨询腿等过程。录音、报表、质检和推送都消费这套事实。
- 话单回答「发生了什么」;录音回答「说了什么」;报表回答「一段时间整体如何」。话单时长不是计费账单。
- 一次业务通话以主话单为主线,可关联从话单、机器人会话、满意度、录音和事件。
- 多段链路不要只用单个「主叫 / 被叫」字段解释业务角色;结合通话类型、主被叫角色、第一方 / 第二方视角一起看。
- 座席是人。查单通优先用
mainUniqueId;定位某一段用uniqueId。
阅读地图
- 先建立对象:读「二」「三」。
- 看生成链路和主从关系:读「四」。
- 查、导出、录音、权限:读「六」和附录 B。
- 上线验收与周边关系:读「八」「九」和附录 C。
一、文档说明
本文给管理员、实施和业务负责人统一话单口径,方便解释记录页、导出、录音和报表,而不是替代某一类记录页的操作手册。
本文主要说明 CDR 的产品定位、主话单与从话单、通话标识、常见字段、查询导出与录音关联。页面筛选和导出列以各记录页为准。开通了哪些记录入口,以企业开通清单为准。
二、产品总览
话单是呼叫中心在通话过程中或结束后沉淀的通话事实,通常包含双方、通话类型、关键时间、接听状态、挂断方、座席、队列、热线、外显、录音和业务标识等。
| 价值 | 说明 |
|---|---|
| 服务留痕 | 记录来电、外呼、回拨、转接和机器人通话的事实 |
| 运营复盘 | 按时间、号码、座席、队列、任务、结果查单通 |
| 质检依据 | 关联录音、座席、客户和业务结果 |
| 报表基础 | 为接通率、通话量、时长、未接原因等提供明细 |
| 对账审计 | 支撑业务单据、事件和录音之间对账 |
| 问题排查 | 定位失败阶段、挂断方和录音是否生成 |
CDR 是数据事实;记录页是不同业务视角的展示。
| 记录页面 | 主要视角 | 对应 CDR 对象 |
|---|---|---|
| 客户来电记录 | 一通客户呼入的完整过程 | 呼入主话单 |
| 座席接听记录 | 座席被呼叫、接听或未接 | 呼入从话单 |
| 外呼记录 | 座席发起的一通外呼 | 外呼主话单,可关联从话单 |
| WebCall 记录 | 网页、App 或业务系统触发的回拨 | WebCall 主话单及首叫、转接明细 |
| 任务呼叫记录 | 外呼任务产生的一通通话 | 任务外呼主话单 |
| 机器人对话记录 | 机器人参与的一段会话 | 机器人会话记录 |
| 呼损记录 | 呼入未被有效承接的衍生事件 | 从话单或过程事件加工结果 |
| 对象 | 主要回答 | 使用场景 |
|---|---|---|
| 话单 / CDR | 这通电话发生了什么 | 查询、详情、导出、对账、报表基础 |
| 录音 | 这通电话说了什么 | 试听、下载、质检、投诉复盘 |
| 报表 | 一段时间整体表现如何 | 运营分析、绩效、趋势 |
| 日志 | 某个过程为什么这样发生 | 排障、异常定位 |
| 事件推送 | 外部系统应知道什么变化 | CRM、工单、订单同步 |
三、核心概念
| 对象 | 是什么 | 不要当成 |
|---|---|---|
| 主话单(Main CDR) | 一通电话的主链路摘要 | 某一段座席腿本身 |
| 从话单(Sub CDR) | 座席腿、转接腿、咨询腿、三方腿等过程明细 | 整通电话的唯一结果 |
| 通话类型 | 呼入、外呼、WebCall、任务外呼等业务场景分类 | 计费账单类型 |
| 客户号码 | 客户侧真实联系方式或业务联系号码 | 某一段通信主叫 / 被叫的别名 |
| 客户分机号 | 客户侧分机,和客户号码分开保存 | 座席分机、外显号码 |
| 主叫 / 被叫号码 | 某一段通信链路中的号码方向 | 业务主被叫身份 |
| 外显号码 | 被呼叫方看到的来电号码 | 座席真实号码 |
| 接听状态 | 是否被有效接起 | 挂断方 |
| 挂断方 | 由哪一侧结束通话 | 失败原因的全部解释 |
| 录音文件 | 与话单关联的音频留痕 | 话单本身 |
常见通话标识:
| 标识 | 产品含义 | 常见用途 |
|---|---|---|
| mainUniqueId | 一通电话或一次业务会话的主锚点 | 串联主话单、从话单、录音、机器人会话和满意度 |
| uniqueId | 某条从话单或某段通话腿的标识 | 定位座席腿、转接腿、咨询腿 |
| requestId | 某次请求或机器人会话标识 | 关联机器人对话、外部请求 |
| taskId | 外呼任务标识 | 关联任务、名单、任务记录和任务报表 |
| businessId | 客户侧业务标识 | 关联 CRM、工单、订单或自定义业务 |
不同通话类型下,接听状态解释不同:呼入看是否进线、是否被座席接听;外呼看客户是否接听;WebCall 看首叫、转接和桥接;机器人看是否接通、是否转人工。挂断方要结合通话阶段解释。
原始话单是呼叫过程中的基础事实;标准话单是面向查询、导出、报表和客户解释的产品化记录。培训和对外说明通常用标准话单口径。
四、对象关系与数据流
一次业务通话 / 一次通话会话
↓
主话单(mainUniqueId)
├─ 从话单(uniqueId):座席腿、转接腿、咨询腿、三方腿
├─ 录音文件
├─ 机器人会话(requestId)
├─ 满意度结果
├─ 事件推送
└─ 衍生记录:呼损、业务话单、专项记录通话发起或接入
↓
路由、外呼、回拨、转接或机器人接待
↓
响铃、接听、桥接、保持、转接、挂断等事件
↓
沉淀原始通话事实
↓
整理为主话单、从话单、会话记录和附属结果
↓
管理端查询、导出、录音、报表、事件对接| 关系 | 说明 | 示例 |
|---|---|---|
| 一对一 | 一通简单通话只有一条主话单 | 座席直接外呼客户并结束 |
| 一对多 | 一条主话单关联多条从话单 | 先呼座席 A 未接,再呼座席 B 接听 |
| 多段桥接 | 主话单下存在首叫、转接、桥接等阶段 | WebCall 先呼座席再呼客户 |
| 多方协同 | 咨询、转接、三方或邀请第三方 | 客户通话中座席邀请专家加入 |
| 附属关联 | 主话单关联录音、满意度、机器人会话 | 通话结束后客户评价并生成录音 |
多段链路先判断通话类型、业务发起方、平台连接顺序,再看主话单整体结果和从话单各段过程。录音可能覆盖整通或某一段。
通话结束后,话单、录音、报表和推送不一定同时完成。记录已出现但录音暂不可听、报表暂未汇总,并不一定表示事实丢失。
五、能力地图
| 能力层 | 能力 | 说明 |
|---|---|---|
| 通话采集层 | 呼入、外呼、WebCall、任务外呼、机器人、转接、三方 | 产生通话事实和过程事件 |
| 话单整理层 | 主话单、从话单、机器人会话、附属结果 | 整理为可查询、可解释的记录 |
| 查询层 | 列表、详情、筛选、通话标识检索 | 定位单通记录 |
| 导出层 | 列表导出、明细导出、录音打包、专项导出 | 离线分析、归档、对账 |
| 录音层 | 试听、下载、临时访问地址 | 质检、投诉、合规留存 |
| 报表层 | 呼入、外呼、任务、座席、队列、机器人报表 | 周期汇总 |
| 对接层 | 事件推送、结果同步、业务标识回写 | CRM、工单、订单协同 |
| 权限层 | 数据范围、号码脱敏、录音与导出权限 | 控制谁能看、能听、能导出 |
六、产品功能说明
话单查询与详情
常见查询条件:时间范围、通话类型、客户 / 主叫 / 被叫 / 外显号码、座席、队列、热线、分机、接听状态、呼叫结果、失败原因、挂断方、任务、名单、机器人,以及 mainUniqueId、uniqueId、requestId、taskId、业务标识。
详情建议覆盖:通话类型与标识、参与方与号码角色、开始 / 响铃 / 接听 / 结束时间、接听状态与挂断方、从话单与过程信息、录音 / 满意度 / 业务单据 / 推送结果。
话单导出
| 导出类型 | 说明 |
|---|---|
| 列表导出 | 按当前筛选导出主列表字段 |
| 明细导出 | 导出主话单及从话单明细 |
| IVR 导出 | 导出 IVR 路径、按键、节点等 |
| 满意度导出 | 导出满意度结果和评价信息 |
| 机器人对话导出 | 导出会话、意图、轮次、转人工等 |
| 录音打包 | 按条件批量获取录音,通常有权限和数量限制 |
导出字段应与页面展示口径一致,并遵循权限与脱敏规则。
录音关联
通常先查话单,再从详情试听或下载。记录存在不代表录音已生成;录音可听不代表当前用户可下载。多段通话可能有多段录音;转接、咨询、三方、机器人接待可能影响录音起止。
状态、权限与对接
结果优先用业务语言解释:客户未接、座席未接、队列超时、客户放弃、线路失败、第二方未接、桥接失败等。技术原因码用于排障,不宜作为客户理解的唯一口径。
权限常见控制:数据范围、完整号码 / 脱敏、试听与下载、列表与批量导出、跨部门 / 跨队列 / 跨座席范围。
外部系统用通话标识、业务标识或事件结果关联 CDR。对接前确认主键、时间范围、状态口径、脱敏、录音权限和数据延迟。
七、典型业务场景
| 场景 | 怎么查 | 关注点 |
|---|---|---|
| 客户来电追溯 | 按客户号码和时间查客户来电记录,再下钻从话单 | 进线、队列、接听状态、哪些座席被呼、客户何时挂断 |
| 座席外呼复盘 | 按座席、时间、结果查外呼记录 | 客户号码、外显、接听、时长、挂断方、录音 |
| WebCall 回拨排障 | 按时间与客户号码查 WebCall 记录 | 首叫是否成功、转接是否发起、客户是否接听、是否桥接 |
| 机器人会话分析 | 先查任务或来电记录,再用 mainUniqueId 关联机器人对话 | 轮次、意图、是否转人工、对话文本 |
| 录音质检与投诉 | 按通话标识定位话单再试听 | 录音状态、权限、是否多段录音 |
| 报表与明细核对 | 先对齐周期、时间字段、通话类型、接听状态、是否含从话单 | 再抽样核对 CDR |
八、上线准备与运营建议
上线前确认:涉及哪些通话类型与记录入口;是否需要主话单、从话单、机器人、满意度、呼损;查询与导出是否覆盖追溯和对账;号码脱敏与录音权限;是否对接外部系统;报表口径是否与明细一致;验收是否覆盖接通、未接、转接、三方、机器人、录音延迟。
运营建议:
- 查单通优先用通话标识;没有标识再用时间、号码、座席组合。
- 看客户体验优先看主话单;看座席绩效看座席接听或外呼记录;看多段链路必须结合从话单。
- 查录音先确认话单存在,再确认文件与权限;查报表差异先对齐时间、类型和状态口径。
定期抽查:记录可查、主从可关联、录音可试听、脱敏正确、导出与页面一致、报表可追溯到明细、外部系统能按标识对账。
九、与周边能力的关系
| 周边能力 | 关系 |
|---|---|
| 通话类型 | 决定字段重点、状态口径和记录入口;IVR 外呼任务在控制台常称自动外呼 |
| 主被叫角色定义 | 解释业务主被叫与通信主被叫;号码字段不能只看字段名 |
| 第一方与第二方 | 解释平台先连谁、后连谁;WebCall、回拨、直呼等多段链路需结合该视角 |
| 通话记录与录音 | 记录是 CDR 的页面化展示;通常先查记录再听录音 |
| 报表 | 基于 CDR 聚合;不一致时核对周期、过滤、去重和异步延迟 |
| 事件推送 | 过程或结果通知;对账用通话标识关联事件与话单 |
| 日志 | 解释过程原因;排障通常先从 CDR 定位再下钻日志 |
十、FAQ
CDR 和通话记录是同一个东西吗?
不完全是。CDR 是通话事实数据;通话记录是面向用户的页面展示。一套 CDR 可支撑多个记录页。
为什么一通电话会有多条记录?
可能包含主链路、座席腿、转接腿、咨询腿、三方腿、机器人会话和满意度。主话单看整体,从话单看过程。
为什么记录有了,录音还不能听?
录音生成、转码、归档或访问地址可能有延迟;也可能当前用户没有试听或下载权限。
为什么话单里的主叫号码不是客户号码?
主叫号码是某一段通信方向;客户号码是业务身份。回拨、WebCall、直呼、转接等场景中两者可能不同。
为什么报表数量和导出明细不一致?
常见原因:时间字段、统计周期、通话类型范围、状态过滤、主从是否去重、报表异步延迟。
从话单一定要给客户看吗?
不一定。日常可先看主话单;分析座席接听、转接、咨询、三方或多段失败时再看从话单。
事件推送成功是否代表话单一定可查?
不一定。推送和查询是不同链路,可能有先后和延迟。对账用通话标识关联。
CDR 能否作为计费依据?
可作为通话事实依据之一;是否用于计费取决于计费产品和合同口径。话单不等于账单。
十一、总结
话单(CDR)是通话结束后留下的事实。主话单看整通结果,从话单看过程腿。查询、导出、录音、报表和推送用通话标识关联同一通。
附录 A:入口与权限
| 入口类型 | 常见页面 | 说明 |
|---|---|---|
| 呼入记录 | 客户来电记录、座席接听记录 | 客户来电主链路和座席接听明细 |
| 外呼记录 | 外呼记录 | 座席外呼、预览外呼、主叫外呼等 |
| WebCall 记录 | WebCall 记录 | 网页、App 或业务系统触发的回拨 |
| 任务记录 | 预测外呼记录、自动外呼记录、任务呼叫记录 | 预测外呼任务与 IVR 外呼任务(自动外呼) |
| 机器人记录 | 呼入机器人记录、外呼机器人记录、机器人对话记录 | 机器人会话和转人工过程 |
| 录音能力 | 录音试听、下载、打包 | 基于话单关联录音 |
| 报表能力 | 呼入、外呼、座席、任务报表 | 基于 CDR 聚合 |
| 权限项 | 说明 |
|---|---|
| 记录查看权限 | 能否进入对应记录页面 |
| 数据范围权限 | 可查看哪些部门、队列、座席或任务数据 |
| 号码权限 | 完整展示、脱敏或加密串 |
| 录音试听 / 下载权限 | 在线播放、单条或批量下载 |
| 导出权限 | 能否导出列表和明细 |
| 敏感字段权限 | 业务标识、客户信息、自定义字段等 |
附录 B:关键字段口径
| 字段 | 业务含义 | 使用建议 |
|---|---|---|
| 通话类型 | 本次话单所属业务类型 | 区分呼入、外呼、WebCall、任务外呼等 |
| mainUniqueId | 一通电话或业务会话主标识 | 排障和跨对象关联优先使用 |
| uniqueId | 某段通话腿或从话单标识 | 定位座席腿、转接腿、咨询腿 |
| requestId | 请求或机器人会话标识 | 关联机器人对话和外部请求 |
| taskId | 外呼任务标识 | 关联任务、名单和任务报表 |
| 客户号码 | 客户侧真实联系方式或业务联系号码 | 客户追溯和业务关联 |
| 客户分机号 | 客户侧分机 | 和外呼、预测外呼、自动外呼、SIP 接入记录里的客户号码分开看,导出也单独一列 |
| 座席号码 | 座席设备、分机或工作号码 | 座席接听和外呼分析 |
| 主叫号码 | 某段通信链路中的主叫号码 | 通信方向解释和排障 |
| 被叫号码 | 某段通信链路中的被叫号码 | 通信方向解释和排障 |
| 外显号码 | 被呼叫方看到的号码 | 客户感知、线路和合规 |
| 开始时间 | 通话或请求开始时间 | 查询和导出常用时间口径 |
| 接听时间 | 被接起或进入有效接听的时间 | 接听率和等待时长 |
| 结束时间 | 通话结束时间 | 总时长和查询范围 |
| 通话时长 | 有效通话持续时间 | 区分总时长、振铃时长、桥接时长 |
| 接听状态 | 是否被有效接起 | 需结合通话类型解释 |
| 呼叫结果 | 平台归类后的通话结果 | 运营分析和失败分类 |
| 挂断方 | 结束通话的一方 | 投诉复盘和体验分析 |
| 失败原因 | 未接通或异常结束原因 | 排障和运营优化 |
| 录音文件 | 关联录音的文件标识 | 试听、下载和质检 |
| 业务标识 | 客户侧业务单据或上下文标识 | CRM、工单、订单关联 |
附录 C:实施检查清单
| 检查项 | 检查内容 |
|---|---|
| 通话类型 | 是否明确项目涉及哪些通话类型和记录入口 |
| 主从关系 | 是否能解释主话单、从话单和机器人会话 |
| 标识串联 | 是否明确 mainUniqueId、uniqueId、requestId、taskId 的使用场景 |
| 查询条件 | 是否覆盖时间、号码、座席、队列、状态、任务、通话标识 |
| 详情信息 | 是否能查看主话单、从话单、录音、IVR、机器人、满意度 |
| 导出能力 | 是否确认导出类型、字段、数量上限和权限 |
| 录音能力 | 是否验证试听、下载、批量导出和延迟说明 |
| 权限脱敏 | 是否配置数据范围、号码脱敏、录音和导出权限 |
| 报表口径 | 是否确认明细与报表指标的统计口径 |
| 对接口径 | 是否确认外部系统用哪个通话标识关联 |
| 验收用例 | 是否覆盖接通、未接、转接、三方、机器人、录音不可用 |
附录 D:常见问题速查
| 问题 | 可能原因 | 建议处理 |
|---|---|---|
| 查不到话单 | 时间范围、号码、权限或数据延迟 | 先用通话标识查询,再检查数据范围和时间口径 |
| 有记录无录音 | 录音生成延迟、未开启录音或无权限 | 检查录音状态、权限和录音配置 |
| 一通电话多条记录 | 存在从话单、转接、座席腿或机器人会话 | 用 mainUniqueId 串联完整链路 |
| 主叫号码不是客户号码 | 多段链路或回拨导致号码方向变化 | 结合主被叫和第一方 / 第二方口径解释 |
| 报表和明细不一致 | 时间、状态、去重、异步汇总口径不同 | 统一统计口径后抽样核对 CDR |
| 导出字段和页面不同 | 导出模板、权限或字段范围不同 | 确认导出类型和字段配置 |
| 外部系统对不上记录 | 标识不一致或事件与话单延迟 | 用 mainUniqueId、requestId 或业务标识对账 |
附录 E:术语表
| 术语 | 说明 |
|---|---|
| CDR | Call Detail Record,通话详情记录,即话单 |
| 话单 | 通话过程和结果的事实记录 |
| 主话单 | Main CDR,一通电话或一次业务会话的主链路摘要 |
| 从话单 | Sub CDR,主话单下的过程明细,如座席腿、转接腿、咨询腿 |
| 通话标识 | 用于定位和关联通话记录的唯一标识 |
| mainUniqueId | 一通电话或业务会话的主锚点 |
| uniqueId | 某段通话腿或从话单的标识 |
| requestId | 请求或机器人会话相关标识 |
| taskId | 外呼任务相关标识 |
| 录音文件 | 与话单关联的音频文件 |
| 接听状态 | 描述通话是否被有效接起 |
| 挂断方 | 结束通话的一方 |
| 外显号码 | 被呼叫方看到的来电号码 |
| 事件推送 | 将通话过程或结果同步给外部系统 |
| 报表 | 基于话单明细聚合形成的统计结果 |
| 座席 | 接听和外呼的人,英文 agent |
Updated 26 days ago