CDR——呼叫数据记录

介绍

3CX 电话系统具有内置的 CDR 服务，能够记录呼叫，包括可以保存到文件或通过 TCP 立即推送到另一个应用程序的记录。

通话记录包含各种通话详情，例如时间、日期、通话时长、来源号码和目的地号码以及费用。3CX 更进一步，添加了更多信息，例如通话类型、通话信息、主叫和被叫姓名以及通话转接时至关重要的最终显示名称。

配置输出格式

您可以生成 4 种不同格式的 CDR：

  1. 所有呼叫均采用单一文件
  2. 每次通话的单独文件
  3. 3CX CDR 服务是服务器/被动套接字
  4. 3CX 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 面临的最大挑战之一是数据在发送到文件或套接字之前的结构和位置。

3CX CDR 服务允许管理员控制发送的内容和记录的外观，这在处理通常对格式极为敏感的传统 CDR 服务器、酒店 PMS 系统和第三方 CDR 应用程序时非常重要。

在 CDR 设置部分，单击“管理 CDR 输出字段”下的“配置 CDR 输出字段“ 部分。

您可以启用或禁用任何您不感兴趣的输出字段。您还可以通过单击上移或下移按钮。这会将字段移动到行的左侧或右侧。

默认情况下，示例 CDR 文件如下所示：

CDR Logs

CDR记录文档

以下是支持的输出字段及其含义：

  • historyid & callid - Can be used to find the first CDR record of the call in the database and fetch all other records - for more information read here.
  • duration - Call Duration time.
  • time-start - Call Start time.
  • time-answered - Answered time.
  • time-end - Call terminated time.
  • reason-terminated - Why the call was terminated.
  • from-no - Source caller number.
  • to-no - Destination To Number.
  • from-dn - Distinguished name of caller - this is 3CX Specific Can be omitted by 3rd party developers.
  • to-dn - Distinguished name of To - Destination - this is 3CX Specific Can be omitted by 3rd party developers.
  • dial-no - Dialled number.
  • reason-changed - The Reason why a change occurred in a call - example in a transfer you will see "ReplacedDst" which means that the destination was replaced with something else.
  • final-number - Final Number - the final number which was replaced (In a transfer this will be the final connected number).
  • final-dn - The Distinguished name of the final number entity - this is 3CX Specific and can be omitted by 3rd party dev.
  • bill-code - Billing code dialed after the destination (for example: **Sales).
  • bill-rate  - The billing rate that matched the prefix of the rate. This is used to apply a cost calculation variance.
  • bill-cost - The Cost of the call calculated with simple proportion / minute.
  • bill-name - The rate name of the billing variance.
  • chain - All endpoints which were involved in the call.
  • from-type - Source type.
  • to-type - Destination type.
  • final-type - Final destination type.
  • from-dispname - Source Display Name.
  • to-dispname - Destination Display Name.
  • final-dispname - Final destination Display Name.
  • missed-queue-calls - A list of queue agents that were polled during a queue call that didn’t answer the call.

上次更新

本文件最后更新于 2025 年 10 月 31日

https://www.3cx.cn/docs/cdr-call-data-records/