---
title: Dialer Campaign
slug: engage/dialer-campaign
createdAt: 2025-10-06T06:07:24.249Z
---

:::Iframe{iframeHeight="0" code="<!-- <p>paste ifram<div&#xA;              style=&#x22;&#xA;                position: relative;&#xA;                padding-bottom: 56.25%;&#xA;                height: 0;&#xA;                border-radius: 0;&#xA;                box-shadow: 0 15px 40px rgba(63,58,79,.3);&#xA;                overflow: hidden;&#xA;                min-width:320px&#x22;><iframe&#xA;              src=&#x22;https://learn.exotel.com/share/27731ba9-a171-46ac-86da-bd80a7716d80/embed?autoplay=false&#x22;&#xA;              frameborder=&#x22;0&#x22;&#xA;              webkitallowfullscreen&#xA;              mozallowfullscreen&#xA;              allowfullscreen&#xA;              allow=&#x22;autoplay; fullscreen&#x22;&#xA;              style=&#x22;position: absolute; top: 0; left: 0; width: 100%; height: 100%;&#x22;></iframe></div>e code here</p> -->"}

:::

The **Auto-Dialer** feature is Exotel's outbound dialer (OBD) solution. It automates outbound calling by connecting available agents to customers from a list, removing the need for agents to manually dial. When an agent starts a dialer campaign, the system calls the agent first (leg1) and then dials the next contact (leg2), significantly improving agent productivity and throughput.

***

## Key benefits

1. **Agent-first connection** — The agent is called first and then connected to customers from the list.
2. **Higher agent productivity** — Removes manual dialing and list management overhead.
3. **Retry options** — Configure retry logic for unsuccessful attempts.
4. **Campaign-level reporting** — Download reports after campaign completion.
5. **Supervisor and agent workflows** — Separate supervisor and agent views and permissions.
6. **Integration with New Campaigns address book** — Use Lists & Contacts created under New Campaigns.
7. **Per-campaign settings** — Caller ID, IVR, popup URLs, and passthru URLs for CRM integration.

***

## Prerequisites

- Active Exotel account with **Campaigns (Auto-Dialer)** enabled.
- A valid **Exophone** number.
- Address-book entries (Lists & Contacts) in **New Campaigns**.
- A group of agents in **Co-workers (Agents) and Groups**.
- Sufficient prepaid credits (if using a prepaid account).

:::hint{type="info"}
Create lists and groups before creating a Dialer campaign. The Dialer campaign uses the same Address-book (Lists & Contacts) as other New Campaign features.
:::

***

## Access Dialer Campaigns

1. In the dashboard left-hand panel, go to **Tools → Campaigns (New)**.
2. Open the **Campaigns** tab and select **Dialer Campaigns**.

***

## Create a Dialer Campaign

Click **Create Dialer Campaign** to open the campaign creation popup. Provide all required fields; the popup enforces mandatory inputs.

**Required fields:**

- Campaign Name (min 3 characters)
- Dial Numbers (List or Dial Whom URL)
- Campaign Participants (Agent or Group)
- Start Date & Time and End Date & Time
- Caller ID (Exophone)
- Number of Retries and Retry settings
- Retry-on statuses (e.g., busy, no-answer, failed)
- Call Type (default: Transactional)

### Dial numbers (choices)

- **List:** Select a pre-created list of numbers from Address-book.
- **Dial Whom URL:** Provide an endpoint that returns numbers to call. See *Working With Connect (Dial Whom)* for details on URL format and expected response.

:::hint{type="info"}
All lists must be created before starting the campaign. If you use a list, a copy of the list is taken at campaign creation time; subsequent changes to the original list are not applied to the running campaign.
:::

### Campaign participants

- **Group/Agents:** Choose a single agent or a group of agents who will be connected to calls. Groups must be pre-created in Co-workers (Agents) and Groups.

### Optional integration fields

- **Popup URL (optional):** URL to display live call details in agent CRM.
- **Call Completed Passthru URL (optional):** Exotel will POST call completion data to this URL.
- **Call No Answer Passthru URL (optional):** Exotel will POST no-answer events to this URL.
- **Get Contacts URL (optional):** URL to fetch contact metadata (name, order id, address, etc.).

:::hint{type="info"}
Refer to the Passthru and Connect support articles for payload formats and implementation details.
:::

### Content options

1. **Type text:** Enter the text to be played to customers. Use `@@` to map CSV variables for dynamic text.
2. **Select a Flow:** Choose a pre-built flow from the App Bazaar.
3. **Create an IVR:** Build a simple IVR inline. Configure prompts, DTMF mappings, and no-input repeats (default repeat after 5 seconds).

### Scheduling and caller ID

- **Start Date & Time:** Must be >= current time. Default trigger delay up to 2 minutes.
- **End Date & Time:** Defaults to 30 days after start. Minimum end time is 2 minutes after start.
- **Caller ID:** Select the Exophone number displayed to recipients.

### Retry settings

- **Number of retries:** 0–3 (default 0).
- **Retry interval (minutes):** Required when retries > 0.
- **Retry mechanism:** `Linear` (equal spacing) or `Exponential` (doubling intervals).
- **Retry-on statuses:** Choose which outcomes mark a call for retry (e.g., `busy`, `no-answer`, `failed`).

***

## Personas and permissions

### Supervisors

- Create and assign campaigns.
- View live campaign status and call details.
- Archive campaigns, mark as complete, and download reports.
- Can act as agents if added to a group.

### Agents

- Cannot create or assign campaigns.
- Can view and start campaigns assigned to them.
- See live callee details and call controls.
- Start/stop behavior governed by campaign state and availability.

***

## Starting and stopping an Auto-Dialer campaign (agent flow)

- Agents start a campaign from their Auto-Dialer Campaign page by clicking **Start** (disabled until campaign start time).
- When Start is clicked:
  1. The agent is called first (leg1).
  2. Once agent connects, the system dials the next contact (leg2).
  3. Agent remains nailed on leg1 for subsequent calls.
- Agent can hang up to stop; clicking **Start** resumes from the next available number.

:::hint{type="info"}
If a Supervisor is also in the agent group, they can switch between **Supervisor** and **Agent** views using the switch at the top of the campaign screen.
:::

***

## Manage Campaign

The Dialer Campaigns list displays Campaign Name, Campaign Type, Date Created, Schedule Time, Status, and Performance.

**Action menu (state-dependent):**

- **Pause** — Stop further dialing (scheduled & in-progress).
- **Resume** — Continue dialing remaining numbers (paused only).
- **Complete** — Mark paused campaign completed; remaining numbers become `Failed_NoAttempt`.
- **Archive** — Archive completed or scheduled campaigns.
- **Download** — Download completed campaign reports.

**List tools:** Filter by status, search by campaign name (min 3 characters), sort by campaign name, date created, or status.

***

## Campaign summary & stats (Supervisor view)

Click a campaign to open the summary/stats page. The page has two main sections: campaign-level metadata and call-level details.

### Campaign Details

Provides an overview of all campaign-level settings and identifiers:

- Campaign name and status
- Dial numbers source (list or Dial Whom URL)
- Campaign participants (agent/group)
- Caller ID
- Start and end times
- Number of retries, retry interval, and retry mechanism
- Retry-on statuses
- Call type and duplicate-number behavior
- Popup & passthru URLs
- Per-campaign throttle (if applicable)

### Campaign Stats

Real-time number-level call data (refresh updates; up to 5-minute delay).

**Number states:**

- **Scheduled** — Pending dial.
- **In progress** — Currently dialing/connected.
- **Retry** — Queued for retry after a failed attempt.
- **Retrying** — Actively retrying the number.
- **Failed** — Invalid/unreachable numbers.
- **Failed DND** — Blocked due to NDNC registry.
- **Failed Balance** — Not dialed due to insufficient account balance.
- **Failed No-Attempt** — Not dialed because campaign completed or timed out (30-day limit).
- **Completed** — Successfully connected.
- **Invalid** — Unknown or malformed number state.

***

## Call details (Supervisor and Agent views)

Lists each call with:

- Contact number and name (if in Contacts)
- Date created and call duration
- Call status and detailed status
- DTMF selection and call recording (link)
- Action menu with start/end times, direction, and Call SID

**Search** by number (min 3 characters) | **Filter** by call status | **Sort** by created date

Call statuses include: **Completed**, **Failed**, **No answer**, **Busy**.

***

## Ending the Auto-Dialer campaign

### Supervisor / Admin

- Admins can **Mark as Complete** at any time.
- If marked complete while agent calls are in-progress, those calls will finish uninterrupted but no new calls will be placed.
- If no new or retry numbers remain, the campaign is automatically complete.

### Agent

- Agents can stop the campaign by hanging up.
- Agents can later resume by clicking **Start** (if new or retry numbers exist).
- Start is disabled when no new or retry numbers are available.

***

## Auto-Dialer limitations and compliance

- **Allowed time frame (India):** Calls permitted only between **9 AM and 9 PM** per TRAI regulations.
- **Maximum duration:** Campaigns run up to **30 days**. After 30 days the campaign is marked **Completed** and remaining numbers become `Failed_NoAttempt`.
- **List immutability:** Once a campaign starts, changes to the source list do not affect the running campaign (a copy is used at creation).
- **Group flexibility:** Agents can be added or removed from the selected group even after campaign start.
- **List limit:** Only **one list** allowed per Dialer campaign. Maximum contacts per list: **1 lakh**.

:::hint{type="info"}
For high-volume operations, coordinate with your Account Manager to ensure compliance with regional regulations and to confirm account throttling or capacity settings.
:::

