CDR------呼叫数据记录
On this topic:
[启用 CDR](#启用 CDR)
[配置 CDR 字段](#配置 CDR 字段)
介绍 {#介绍}
3CX 电话系统具有内置的 CDR 服务，能够记录呼叫，包括可以保存到文件或通过 TCP 立即推送到另一个应用程序的记录。
通话记录包含各种通话详情，例如时间、日期、通话时长、来源号码和目的地号码以及费用。3CX 更进一步，添加了更多信息，例如通话类型、通话信息、主叫和被叫姓名以及通话转接时至关重要的最终显示名称。
配置输出格式 {#配置输出格式}
您可以生成 4 种不同格式的 CDR：
- 所有呼叫均采用单一文件
- 每次通话的单独文件
- 3CX CDR 服务是服务器/被动套接字
- 3CX CDR 服务是客户端/主动套接字
启用 CDR {#启用-cdr}
要启用 CDR，请访问 3CX 管理控制台。转到"高级">"CDR "，选择 "启用 CDR "。选择所需的输出。当您输出到文件时，该文件将存储在 3CX Logs 文件夹中，并命名为 cdr.log。示例位置："C:\ProgramData\3CX\Instance1\Data\Logs\CDR日志"
配置 CDR 以被动模式输出到套接字需要您在 3CX 电话系统服务器上配置一个空闲的端口。在此模式下，3CX CDR 服务将充当服务器，并期望 CDR 客户端连接到您配置的 IP:Port。这意味着您必须允许数据流量以 TCP 模式通过防火墙。
3CX CDR 可以将呼叫数据记录发送到 CDR 中央服务器。在此模式下，3CX CDR 服务将充当客户端，您需要提供处理您的 CDR 要求的 CDR 服务器的 IP 地址和 TCP 端口。
配置 CDR 字段 {#配置-cdr-字段}
除了输出和数据之外，CDR 面临的最大挑战之一是数据在发送到文件或套接字之前的结构和位置。
3CX CDR 服务允许管理员控制发送的内容和记录的外观，这在处理通常对格式极为敏感的传统 CDR 服务器、酒店 PMS 系统和第三方 CDR 应用程序时非常重要。
在 CDR 设置部分，单击"管理 CDR 输出字段 "下的"配置 CDR 输出字段" 部分。
您可以启用或禁用任何您不感兴趣的输出字段。您还可以通过单击上移或下移按钮。这会将字段移动到行的左侧或右侧。
默认情况下，示例 CDR 文件如下所示：
CDR记录文档 {#cdr记录文档}
以下是支持的输出字段及其含义：
- historyid - 这是呼叫号码 - 每个呼叫都有一个 3CX 内部号码。用于呼叫跟踪。
- callid - 这是呼叫 ID - 呼叫的唯一标识符。
- duration - 通话时长。
- time-start - 呼叫开始时间。
- time-answered - 回答时间。
- time-end - 呼叫终止时间。
- reason-terminated - 为何终止通话。
- from-no - 源呼叫者号码。
- to-no - 目的地号码。
- from-dn - 呼叫者的可分辨名称 - 这是 3CX 特定的，第三方开发人员可以省略。
- to-dn - 目的地的专有名称 - 这是 3CX 特定的，第三方开发人员可以省略。
- dial-no - 拨打的号码。
- reason-changed - 呼叫中发生变化的原因 - 例如在转移中您会看到"ReplacedDst"，这意味着目的地已被其他内容替换。
- final-number - 最终号码 - 被替换的最终号码（在转移中，这将是最终连接的号码）。
- final-dn - 最终数字实体的专有名称 - 这是 3CX 特有的，可以由第三方开发人员省略。
- bill-code - 目的地后拨打的帐单代码（例如：**销售）。
- bill-rate - 与费率前缀匹配的计费费率。用于应用成本计算差异。
- bill-cost - 通话费用按简单比例/分钟计算。
- bill-name - 计费差异的费率名称。
- chain - 参与呼叫的所有端点。
- from-type - 源类型。
- to-type - 目的地类型。
- final-type - 最终目的地类型。
- from-dispname - 源显示名称。
- to-dispname - 目的地显示名称。
- final-dispname - 最终目的地显示名称。
- missed-queue-calls - 在队列呼叫期间轮询的未接听呼叫的队列坐席列表。
上次更新
本文件最后更新于 2024 年 11 月 26 日
https://www.3cx.cn/docs/cdr-call-data-records/