> ## Documentation Index
> Fetch the complete documentation index at: https://docs.custral.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Calling sessions (power dialer)

> Call everyone on a list one after another, or ring up to three at once and talk to whoever answers first.

## Overview

A calling session works through a list for you. Press **Start calling** on a list and Custral
dials each person in order. After each call you press a key for how it went, and the next call
starts three seconds later. With more than one line, Custral rings several people at once and
puts you through to the first person who answers.

Every call in a session is an ordinary Custral call: it uses your line, records and transcribes
by your [recording policy](https://docs.custral.com/comms/voice/recording.md), and lands on the contact's timeline.

## How it works

* **Start from a list.** The **Start calling** button shows on a [list](https://docs.custral.com/data/collections/list.md)
  whose object has a phone property. A smart list is re-read from its filters when you press it.
  The session then keeps that copy of the list, up to 2,000 people. Anyone with no phone number
  stays in the count as skipped.

* **A session is yours.** Teammates can't open it, and each starts their own.

* **Skip rules** are checked as each call comes up, not at the start:

  | Switch | Default | What it does |
  | - | - | - |
  | **Only call during their 9–6** | On | Waits on anyone whose local time (read from their area code) is outside 9 AM–6 PM. They stay in the queue. |
  | **Skip if called in the last 24h** | Off | Skips anyone called in the last day, and says when ("Skipped: called 2h ago"). |
  | **Drop voicemail automatically** | On | Plays your [voicemail drop](https://docs.custral.com/comms/voice/voicemail-drop.md) when a machine answers. |

* **Outcomes** are keys you press after a call: **1 Talked**, **2 Voicemail**, **3 No answer**,
  **4 Bad number**. A dropped voicemail records Voicemail by itself. An outcome other than
  Talked is written onto the call as its disposition when it has none.

* **When a person answers**, the session becomes the [live call screen](https://docs.custral.com/comms/coaching/live-coach.md)
  (script, Transcript, Notes, Stella, Account) under a slim strip. **Q** swaps between the call
  and the queue. When the call's script reaches its end, the session records Talked after a few
  seconds unless you press **Change**.

### Parallel lines

The **Lines** picker sets how many people ring at once: **1**, **2**, **3** or **Auto**. Auto
picks from how often people answered your recent calls: one line when most answer, three when
few do.

With two or three lines, everyone rings together. The first person to answer is put straight
through with no pause. The others are hung up and go back in the queue, never counted as
called. A machine hears your voicemail drop at the beep.

If two people answer at once, the second hears who called and a number to call back, and is
counted as **abandoned**. The message is built for you: "Sorry we missed you. This was (your
first name) at (your workspace). Please call us back at (the number). Goodbye."

> [!WARNING]
>
> Calling consumers has a legal limit on dropped calls. Custral keeps the share of answered calls that were abandoned
> in the last 30 days under 3%. At or over it, the session runs on one line ("One line only. 4% of people who answered
> in the last 30 days were dropped (the limit is 3%). More lines come back once it's under."). The stat shows as
> "Abandoned · 30 days".

Admins set who the workspace calls under **Settings → Phone & SMS → Settings → Who you call**:

* **Consumers** (the default): more than one line only while under 3% of answered calls were
  dropped in the last 30 days.
* **Businesses**: up to 3 lines. Mobile numbers still count as consumers, so a call to someone's
  cell uses the 3% rule.

With parallel lines, the **Numbers you call from** card says how many numbers you need. Each
number makes up to 75 calls a day, and each line is counted as about 100 calls a day. When you
are short, **Buy N local numbers** opens Phone & SMS, where the price shows before you buy.
Custral picks a caller number per call: same area code first, then same state, then the least
used, never a number marked **Flagged**.

## Using it

**1. Open a list**

Open a list of contacts or companies with phone numbers.

**2. Start the session**

Press **Start calling**. The session opens at **Calling: (list name)** and says how many people there are to call.

**3. Set the rules and lines**

Set the three switches and, if you want, more **Lines**.

**4. Call**

Press **Start calling**. Talk, hang up, then press **1**–**4**. The next call starts in 3 seconds. With parallel
lines, **S** skips the ringing batch, **H** hangs up, and **V** drops your voicemail when Custral can't tell
whether a person answered.

**5. Pause or end**

**Pause** stops before the next call. **End** finishes the session. Either way, the summary reads "N called · N
talked · N voicemails".

> [!NOTE]
>
> Calling sessions are on the web only. Buying numbers stays in Phone & SMS.

## Troubleshooting

| Symptom | Likely cause | What to check |
| - | - | - |
| No **Start calling** button on a list | The list's object has no phone property | Add a phone property to the object, or use a list of an object that has one. |
| "That calling session isn't yours" | The link is a teammate's session | Sessions are personal. Start your own from the list. |
| "This list is too long to call in one go" | Over 2,000 people | Narrow the list, then start again. |
| "Nobody to call" | Nobody on the list is someone you can see | Check you have access to the records on the list. |
| "Nobody to call right now" | Everyone left is outside 9 AM–6 PM their time | Try later, or turn off **Only call during their 9–6**. |
| "The phone service wouldn't place these calls" | A calling permission on the phone account, not the numbers | Nobody was called and they're back in the queue. Ask a workspace admin to check calling permissions, then press **Try again**. |
| Only **1** is available in Lines | The 3% abandoned-call limit | The tooltip gives the rate. More lines come back once it's under 3%. |
| "You have no voicemail message, so nothing can play at the beep." | Automatic drop is on and you have no drop recorded | **Record one** in Settings → Account → Voicemail Drops, or speak your message live: the line shows "Beep · leave your message now". |
| "Couldn't tell if this is a person." | Voicemail detection didn't conclude | If you hear a greeting, press **Drop voicemail** (or **V**). |

> [!NOTE]
>
> When reporting an issue, include the request id shown in the error toast. It links the in-app error to the server
> logs.

## Related

> [card] [Dialer](https://docs.custral.com/comms/voice/dialer.md)
>
> Single calls, transfers and call outcomes.

> [card] [Voicemail drop](https://docs.custral.com/comms/voice/voicemail-drop.md)
>
> Record the message a session drops.

> [card] [Phone & SMS numbers](https://docs.custral.com/comms/voice/numbers.md)
>
> Buy the numbers a session calls from.

> [card] [Live coach](https://docs.custral.com/comms/coaching/live-coach.md)
>
> The live call screen a session opens on.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.