# Productive Dialer

> Manage auto-dialer campaigns via the Voicenter Dialer API — add/remove destinations, control campaigns, manage agents

- **Type:** Skill
- **Install:** `agentstack add skill-voicenterteam-claude-marketplace-productive-dialer`
- **Verified:** Pending review
- **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/productive-dialer

## Install

```sh
agentstack add skill-voicenterteam-claude-marketplace-productive-dialer
```

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.

Help the developer integrate the **Voicenter Productive Dialer API** — manage campaigns, upload call destinations, control campaign state, and manage agent assignments from their CRM.

## When to use this skill

Use this skill when the user wants to:
- Add leads or contacts to a dialer campaign from their CRM
- Upload a bulk list of numbers to dial (up to 100,000 at once)
- Start or stop a dialer campaign programmatically
- Schedule callbacks for specific times ("call this customer at 3 PM")
- Add or remove agents from a campaign
- Check how many calls are still pending in a campaign
- Clear all pending calls from a campaign
- Pass CRM lead data (lead ID, campaign source) into the call for reporting

## Environment Variables

```env
VOICENTER_API_CODE=your_api_token_here
```

## Base URL

```
https://api.voicenter.com/ForwardDialer/Dialer/
```

All methods use `POST-JSON`. Authentication via `Code` field.

## Workflow

1. Call **GetCampaignList** to get campaign codes.
2. Use the campaign `Code` (not the name) in all subsequent calls.
3. Upload destinations with **AddCall** or **AddCallsBulk**.
4. Control execution with **StartCampaign** / **StopCampaign**.

---

## GetCampaignList — Get all campaigns

```json
// Request
{ "Code": "MY_API_CODE" }
```

```json
// Response
{
  "ErrorCode": 0,
  "Description": "OK",
  "Data": [
    {
      "Name": "Campaign1",
      "StatusName": "Enabled",
      "TotalPendingCalls": 23,
      "TotalAwaitingCalls": 23,
      "MaxPriority": 1,
      "MinPriority": 1,
      "Code": "CAMPAIGN_CODE_HERE"
    }
  ]
}
```

`StatusName`: `"Enabled"` = active, `"Disabled"` = stopped.
- For **IVR/Predictive Dialer** campaigns: use `TotalAwaitingCalls` for queue depth.
- For **Agent Dialer** campaigns: use `TotalPendingCalls`.

---

## AddCall — Add a single destination

```
URI: https://api.voicenter.com/ForwardDialer/Dialer/AddCall
```

```json
{
  "Campaign": "CAMPAIGN_CODE",
  "Target": "972501234567",
  "CustomerName": "John Doe",
  "CallerID": "0722776772",
  "Priority": 42,
  "OriginateTime": 1702750000,
  "IsDateLocal": "true",
  "IgnoreDncStatus": "true",
  "CustomData": {
    "var_LeadID": 1234567,
    "var_LeadSource": "Facebook"
  }
}
```

| Field | Required | Description |
|---|---|---|
| `Campaign` | ✅ | Campaign code from `GetCampaignList` |
| `Target` | ✅ | Phone number (E.164 format; international prefix required for non-Israeli numbers) |
| `Code` | ✅ | API authentication token |
| `CustomerName` | ❌ | Customer name shown to agent |
| `CallerID` | ❌ | Outbound caller ID shown to customer — must be a number in your account |
| `Priority` | ❌ | Higher value = dialed first |
| `OriginateTime` | ❌ | Schedule for future dial (Epoch time). Must include `IsDateLocal`. |
| `IsDateLocal` | ❌ | `"true"` = use account's local timezone. `"false"` = GMT+0. Recommended: `"true"`. |
| `IgnoreDncStatus` | ❌ | `"true"` = bypass Do-Not-Call service |
| `CustomData` | ❌ | Key-value pairs passed to Pop-Up Screen and CDR records |

---

## AddCallsBulk — Upload up to 100,000 destinations

```
URI: https://api.voicenter.com/ForwardDialer/Dialer/AddCallsBulk
```

Send an array of destination objects (same fields as `AddCall`):

```json
[
  {
    "Campaign": "CAMPAIGN_CODE",
    "Code": "MY_API_CODE",
    "Target": "972501234567",
    "CustomerName": "John Doe",
    "Priority": 1,
    "CustomData": { "var_LeadID": 111 }
  },
  {
    "Campaign": "CAMPAIGN_CODE",
    "Code": "MY_API_CODE",
    "Target": "972501234568",
    "CustomerName": "Jane Doe"
  }
]
```

**Limits:**
- Up to 100,000 destinations per request
- Detailed per-destination results returned only for ≤ 3,000 destinations
- Add `"async": true` to force detailed response (max 3,000)

```json
// Response
{
  "ErrorCode": 0,
  "Description": "OK",
  "AddResult": [
    { "Target": "972501234567", "ErrorCode": 0, "Description": "OK" },
    { "Target": "972501234568", "ErrorCode": 0, "Description": "OK" }
  ]
}
```

---

## RemoveCall — Remove a specific destination

```
URI: https://api.voicenter.com/ForwardDialer/Dialer/RemoveCall
```

```json
{ "Campaign": "CAMPAIGN_CODE", "Code": "MY_API_CODE", "Target": "972501234567" }
```

---

## ClearCampaignCalls — Remove ALL pending destinations

```
URI: https://api.voicenter.com/ForwardDialer/Dialer/ClearCampaignCalls
```

```json
{ "Campaign": "CAMPAIGN_CODE", "Code": "MY_API_CODE" }
```

---

## StartCampaign / StopCampaign

```json
// Start
// URI: https://api.voicenter.com/ForwardDialer/Dialer/StartCampaign
{ "Campaign": "CAMPAIGN_CODE", "Code": "MY_API_CODE" }

// Stop
// URI: https://api.voicenter.com/ForwardDialer/Dialer/StopCampaign
{ "Campaign": "CAMPAIGN_CODE", "Code": "MY_API_CODE" }
```

---

## Agent Management

### GetMembersList
```json
// Request: { "Campaign": "CAMPAIGN_CODE", "Code": "MY_API_CODE" }
// Response: { "Data": [{ "Member": "SIPSIP1", "DisplayName": "John Doe" }], "ErrorCode": 0 }
```

### AddMember
```json
// URI: /AddMember
{ "Campaign": "CAMPAIGN_CODE", "Code": "MY_API_CODE", "Member": "SIPSIP1" }
// Response: { "Data": { "TotalAdded": 1 }, "ErrorCode": 0 }
```

### RemoveMember
```json
// URI: /RemoveMember
{ "Campaign": "CAMPAIGN_CODE", "Code": "MY_API_CODE", "Member": "SIPSIP1" }
// Response: { "Data": { "TotalRemoved": 1 }, "ErrorCode": 0 }
```

---

## GetCampaignPendingCalls — List waiting destinations

```
URI: https://api.voicenter.com/ForwardDialer/Dialer/GetCampaignPendingCalls
```

```json
// Response
{
  "ErrorCode": 0,
  "Data": {
    "Campaign": { "Name": "Campaign1", "StatusName": "Enabled", "TotalPendingCalls": 4, "Code": "..." },
    "Calls": [
      {
        "Phone": "972501234567",
        "CustomerName": "John Doe",
        "Priority": 42,
        "OriginateTime": 1602819000,
        "CallStatus": { "Status": 1, "Description": "Pending" },
        "CustomData": { "var_LeadID": "1234567" }
      }
    ]
  }
}
```

---

## TypeScript Implementation

```typescript
const DIALER_BASE = 'https://api.voicenter.com/ForwardDialer/Dialer';
const CODE = process.env.VOICENTER_API_CODE!;

async function dialerRequest(method: string, body: object): Promise {
  const res = await fetch(`${DIALER_BASE}/${method}`, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ Code: CODE, ...body }),
  });
  if (!res.ok) throw new Error(`HTTP ${res.status}`);
  const data = await res.json();
  if (data.ErrorCode !== 0) throw new Error(`Dialer ${method} error: ${data.Description}`);
  return data;
}

// Full campaign workflow: get campaigns → upload leads → start
const { Data: campaigns } = await dialerRequest('GetCampaignList', {});
const campaignCode = campaigns[0].Code;

const leads = [
  { Campaign: campaignCode, Target: '972501234567', CustomerName: 'John', Priority: 1, CustomData: { var_LeadID: '101' } },
  { Campaign: campaignCode, Target: '972501234568', CustomerName: 'Jane', Priority: 2, CustomData: { var_LeadID: '102' } },
];
await dialerRequest('AddCallsBulk', leads);
await dialerRequest('StartCampaign', { Campaign: campaignCode });

// Later — stop and clear
await dialerRequest('StopCampaign', { Campaign: campaignCode });
await dialerRequest('ClearCampaignCalls', { Campaign: campaignCode });
```

## Error Codes

| ErrorCode | Description |
|---|---|
| 0 | OK |
| 1 | Invalid campaign code |
| 2 | Missing required field |
| -2 | Phone number format invalid |

## Tips

- **Always call `GetCampaignList` first** — the `Code` in the response is the campaign identifier, not the name.
- `OriginateTime` + `IsDateLocal: "true"` lets you schedule future callbacks — great for "call me back at 3 PM" CRM features.
- `CustomData` values flow through to the **Pop-Up Screen** and **CDR Notification** — use them to carry CRM lead IDs and source attribution.
- CDR records for dialer calls have `type: "ProductiveCall Leg1/Leg2"` — filter with `cdrTypes: [14, 15]` in the **Call Log API**.

## Related Skills

- **Extension List** — Get valid SIP codes to use as `Member` when adding agents to a campaign
- **Call Log** — Retrieve dialer call results using `cdrTypes: [14, 15]`
- **CDR Notification** — Receive dialer call CDRs in real time via webhook
- **Blacklist** — Blacklisted numbers are automatically skipped by the dialer

## 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:** no
- **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: flagged — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-voicenterteam-claude-marketplace-productive-dialer
- 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%.