call-log

name	call-log
description	Pull call detail records (CDR) from Voicenter using the Call Log API

Language. Reply in the user's language: detect what they write — Hebrew→Hebrew, English→English — and mirror it, switching if they switch mid-conversation. This shapes your prose, your questions, and your AskUserQuestion option labels only. It does not change the artifacts you produce — identifiers, JSON keys, BCP-47 language codes, API field names, and other data stay exactly as specified.

CRM integration context. When the user is building a full CRM integration — not just this API in isolation — always invoke the crm-onboarding skill alongside this one and frame the answer covering all three core services: Click2Call, Screen Pop, and Call History.

Help the developer query call history (CDR records) from the Voicenter Call Log API — filter by date, phone, extension, call type, and choose exactly which fields to return.

When to use this skill

Use this skill when the user wants to:

• Retrieve historical call records for reporting or analytics
• Find all calls to/from a specific phone number or extension
• Get recording URLs for past calls to display in a CRM
• Build missed-call reports (filter by DialStatus: ABANDONE or NOANSWER)
• Correlate a specific call by its ID (ivruniqueid / CALLID)
• Export call data to BI tools or billing systems
• Audit agent activity over a date range

Environment Variables

VOICENTER_API_CODE=your_api_token_here
# The server making requests must also have its IP authorized in Voicenter CPanel

Endpoint

https://api.voicenter.com/hub/cdr/

Accepts: POST-JSON or GET Response: JSON

Authentication

Send your code in the request body. The requesting server's IP must be authorized in the Voicenter CPanel under API Settings.

Request Structure

The request has two parts: search criteria (what to filter) and fields (what to return).

Search Criteria

Parameter	Type	Required	Description
code	String	✅	API authentication token
fromdate	ISO 8601	✅	Start date/time in GMT+0 (e.g. 2024-06-01T00:00:00)
todate	ISO 8601	✅	End date/time in GMT+0
phones	String[]	❌	Phone numbers to filter (with country code, e.g. "972501234567")
extensions	String[]	❌	SIP extension codes to filter
IdentityCriteria	String	❌	Account, Hierarchical, Department, or User
callID	String	❌	Filter for a specific call by ivruniqueid
cdrTypes	Integer[]	❌	Filter by call type IDs (see table below)
campaignID	Number[]	❌	Filter by dialer campaign IDs
queueID	Number[]	❌	Filter by queue IDs

CDR Type IDs

ID	Type Name
1	Incoming Call
4	Extension Outgoing
8	Queue
9	Click2Call leg1
10	Click2Call leg2
11	VoiceMail
13	XferCDR (transferred)
14	ProductiveCall Leg1
15	ProductiveCall Leg2
17	Click 2 IVR
18	Click 2 IVR Incoming
19	Click 2 Queue Incoming
21	Attended CDR leg1
22	Attended CDR leg2
23	Auto forward

Returnable Fields

Choose which CDR fields to receive:

CallerNumber, TargetNumber, Date, DateEpoch, Duration, CallID, Type, CdrType, DialStatus, Targetextension, Callerextension, DID, QueueName, RecordURL, RecordExpect, Price, RingTime, RepresentativeName, RepresentativeCode, UserName, UserId, DTMFData, CustomData, DepartmentName, DepartmentId, TargetPrefixName

Sort

"sort": [
  { "field": "date", "order": "desc" },
  { "field": "Duration", "order": "asc" }
]

Full POST-JSON Request Example

{
  "code": "xxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "fields": [
    "CallerNumber", "TargetNumber", "Date", "Duration", "CallID",
    "Type", "CdrType", "DialStatus", "DID", "QueueName",
    "RecordURL", "RingTime", "RepresentativeName", "RepresentativeCode",
    "DTMFData", "CustomData", "DepartmentName"
  ],
  "search": {
    "fromdate": "2024-06-01T00:00:00",
    "todate": "2024-06-30T23:59:59",
    "cdrTypes": [1, 8, 9, 10],
    "phones": ["972501234567"],
    "extensions": ["SIPSIP1"],
    "IdentityCriteria": "Account"
  },
  "sort": [{ "field": "date", "order": "desc" }]
}

Response

{
  "ERROR_NUMBER": 0,
  "ERROR_DESCRIPTION": "OK",
  "STATUS_CODE": 200,
  "TOTAL_HITS": 2,
  "RETURN_HITS": 2,
  "CDR_LIST": [
    {
      "CallerNumber": "0722776772",
      "TargetNumber": "972501234567",
      "Date": "2024-06-10T09:04:58Z",
      "Duration": 2,
      "CallID": "202406101204550233243ghff3189e5c",
      "CustomData": {},
      "Type": "Extension Outgoing",
      "CdrType": 4,
      "DialStatus": "ANSWER",
      "CallerExtension": "SIPSIP1",
      "DID": "",
      "RecordURL": "https://cpanel.voicenter.co.il/CallsHistory/PlayRecord/2024061043950926.mp3",
      "RingTime": 10,
      "RepresentativeName": "John Doe",
      "RepresentativeCode": "87654321",
      "DTMFData": [],
      "DepartmentName": "Sales"
    }
  ]
}

Error Codes

ERROR_NUMBER	STATUS_CODE	Description
0	200	OK
1	403	Rate limit exceeded — wait 5 seconds between requests
2	403	Authorization failed — invalid code
4	403	IP not authorized — add server IP in CPanel
5	404	Date range invalid

TypeScript Implementation

const CALL_LOG_URL = 'https://api.voicenter.com/hub/cdr/';
const CODE = process.env.VOICENTER_API_CODE!;

interface CdrRecord {
  CallerNumber: string;
  TargetNumber: string;
  Date: string;
  Duration: number;
  CallID: string;
  Type: string;
  CdrType: number;
  DialStatus: string;
  DID: string;
  QueueName?: string;
  RecordURL: string;
  RingTime: number;
  RepresentativeName: string;
  RepresentativeCode: string;
  DTMFData: Array<{ LayerName: string; DTMF: number; LayerNumber: string }>;
  CustomData: Record<string, unknown>;
}

interface CallLogResponse {
  ERROR_NUMBER: number;
  ERROR_DESCRIPTION: string;
  TOTAL_HITS: number;
  RETURN_HITS: number;
  CDR_LIST: CdrRecord[];
}

async function getCallLog(
  fromdate: string,
  todate: string,
  options?: {
    phones?: string[];
    extensions?: string[];
    cdrTypes?: number[];
    callID?: string;
    fields?: string[];
    sort?: Array<{ field: string; order: 'asc' | 'desc' }>;
  }
): Promise<CallLogResponse> {
  const body = {
    code: CODE,
    fields: options?.fields ?? [
      'CallerNumber', 'TargetNumber', 'Date', 'Duration', 'CallID',
      'Type', 'CdrType', 'DialStatus', 'DID', 'QueueName',
      'RecordURL', 'RingTime', 'RepresentativeName', 'CustomData',
    ],
    search: {
      fromdate,
      todate,
      IdentityCriteria: 'Account',
      ...(options?.phones && { phones: options.phones }),
      ...(options?.extensions && { extensions: options.extensions }),
      ...(options?.cdrTypes && { cdrTypes: options.cdrTypes }),
      ...(options?.callID && { callID: options.callID }),
    },
    sort: options?.sort ?? [{ field: 'date', order: 'desc' }],
  };

  const res = await fetch(CALL_LOG_URL, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify(body),
  });

  if (!res.ok) throw new Error(`HTTP ${res.status}`);
  const data: CallLogResponse = await res.json();
  if (data.ERROR_NUMBER !== 0) throw new Error(`Call Log error ${data.ERROR_NUMBER}: ${data.ERROR_DESCRIPTION}`);
  return data;
}

// Example: get all missed incoming calls today
const { CDR_LIST } = await getCallLog(
  '2024-06-01T00:00:00',
  '2024-06-01T23:59:59',
  {
    cdrTypes: [1, 8],
    fields: ['CallerNumber', 'Date', 'DialStatus', 'QueueName', 'DID'],
  }
);

const missed = CDR_LIST.filter(r => r.DialStatus === 'ABANDONE' || r.DialStatus === 'NOANSWER');
console.log(`Missed calls: ${missed.length}`);

Service Limits

• Maximum 10,000 CDR records per request — break large date ranges into daily chunks
• Maximum 30 requests per minute — add a 2-second delay between sequential requests
• CDRs appear a few minutes after a call ends — not suitable for real-time use
• Only authorized IP addresses can call this API (set in CPanel under API Settings)

Tips

• Use cdrTypes: [9, 10] to get only Click2Call records and correlate Leg1/Leg2 by CallID.
• CustomData.OriginalIvrUniqueID links a transferred call back to the original call.
• RecordURL is a direct MP3 link — store it in your CRM for playback.
• All dates in requests must be GMT+0. Israeli time is GMT+2 (or GMT+3 in summer).
• DialStatus values: ANSWER, NOANSWER, BUSY, CANCEL, ABANDONE, TIMEOUT, VOICEMAIL.

Related Skills

• CDR Notification — Receive CDRs in real time via webhook instead of polling
• Click2Call — The CALLID returned by Click2Call is the same as CallID in CDR records
• Productive Dialer — Filter dialer call records with cdrTypes: [14, 15]
• Active Calls — For live call state; Call Log is for historical records only