# Call Log

> Pull call detail records (CDR) from Voicenter using the Call Log API

- **Type:** Skill
- **Install:** `agentstack add skill-voicenterteam-claude-marketplace-call-log`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [VoicenterTeam](https://agentstack.voostack.com/s/voicenterteam)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [VoicenterTeam](https://github.com/VoicenterTeam)
- **Source:** https://github.com/VoicenterTeam/claude-marketplace/tree/main/plugins/voicenter-api/skills/call-log

## Install

```sh
agentstack add skill-voicenterteam-claude-marketplace-call-log
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

> **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

```env
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

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

## Full POST-JSON Request Example

```json
{
  "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

```json
{
  "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

```typescript
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;
  CustomData: Record;
}

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;
  }
): Promise {
  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

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [VoicenterTeam](https://github.com/VoicenterTeam)
- **Source:** [VoicenterTeam/claude-marketplace](https://github.com/VoicenterTeam/claude-marketplace)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-voicenterteam-claude-marketplace-call-log
- Seller: https://agentstack.voostack.com/s/voicenterteam
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.