# Outbound calls

> Place a single call, run a campaign over a list of contacts, start calls from a link, and set the do-not-call and consent rules every call passes.

Source: https://docs.vlayers.ai/build/outbound-calls

Kind: How-to guide

## What you'll learn

How to have an agent call people: one call, a campaign over a list, or a call started by your own system. Every call spends money (calls are billed per minute) and every call is checked against your do-not-call and consent rules first.

Open **Outbound calls** in the sidebar. The tabs are **Campaigns**, **Single call**, **Triggers** and **Do-not-call and consent**.

## Prerequisites

- A live agent. See [Your first voice agent](https://docs.vlayers.ai/build/first-voice-agent).
- A phone number to call from. See [Phone numbers](https://docs.vlayers.ai/build/numbers).

## Place a single call

1. Open **Single call**.
2. Enter **Number to call**, including the country code.
3. Choose **From number**, one of your active numbers, and the **Agent**. If you leave the agent alone, the number's own agent is used.
4. Optionally turn on **Voicemail** handling, and add **Details for the agent (optional, JSON)**, such as `{"customer_name":"Sam"}`. Every value must be text. The agent can use them as [variables](https://docs.vlayers.ai/build/variables).
5. Choose **Place call**.

**The call dials immediately and is billed.** If the number is on your do-not-call list, or breaks a calling rule, it is refused and the reason is recorded.

## Run a campaign

A campaign calls a list of contacts, a few at a time, and retries the ones who do not answer.

1. Open **Campaigns** and choose **New campaign**.
2. Fill in:

| Field | What it does |
|---|---|
| **Name** | Required, up to 200 characters. |
| **From number** | Required. The number the calls come from. |
| **Agent** | Optional. Leave it to use the number's agent. |
| **Concurrency** | How many calls run at the same time. |
| **Max attempts** | How many times one contact is tried. |
| **Retry delay (sec)** | How long to wait before trying a contact again. |
| **Dial timeout (sec)** | How long a call rings before giving up. |
| **Calls / minute** | Optional cap on how fast calls start. |
| **Initial directive (optional)** | What the agent should say or do first. |

3. Save. **Creating a campaign does not dial anyone.**
4. Open the campaign and choose **Add contacts**: paste phone numbers (with country codes) or upload a CSV with a header row.
5. Choose **Start**. A confirmation says how many contacts will be dialled; choose **Start dialing**. **This places calls and bills per answered minute.** Spend appears in [Billing](https://docs.vlayers.ai/build/billing) as calls complete.

While it runs you see progress and rates, and a contacts table that links each contact to their last call. **Pause** stops new calls and **Resume** continues. **Cancel campaign** stops it: calls not yet placed are cancelled and completed calls are unaffected.

## Start calls from your own system

A trigger is a private link that places a call when your system calls it.

1. Open **Triggers** and choose **New trigger**.
2. Enter a **Name** and the phone number it calls from. Optionally choose an **Agent** and an opening prompt, which can use variables.
3. Choose **Create trigger**. The **Call URL** and **Token** are shown once, so copy them now.

Anyone who has the URL can place calls from your number. Keep it secret, and **Delete** the trigger to stop it working.

## Do-not-call and consent

Open **Do-not-call and consent**. It has two parts.

**Do-not-call list.** Choose **Add number**, enter the number in international format and an optional reason. **Remove** deletes it from the list immediately, with no confirmation. A table of recent decisions shows which calls were allowed or refused.

**Calling rules.** These apply to every outbound call, from a campaign, a single call or a trigger:

| Setting | What it does |
|---|---|
| **Never call numbers on the do-not-call list** | Refuses listed numbers. |
| **Only call within calling hours, in the person's local time** | Uses **Calls start at (hour)** and **Calls end at (hour)** (quiet hours outside them). |
| **Only call people whose consent is on file** | Refuses anyone without recorded consent. |
| **Calls per person per day (0 = no limit)** | Caps repeat calls to one person. |
| **Time zone when the person's is unknown** | The fallback for calling hours. |

Choose **Save** to apply them. Phone calling is regulated and the rules differ by country; check what applies to you before you call people at volume.

## Common problems

| Problem | Fix |
|---|---|
| **Place call** is greyed out | A field is missing or invalid. The form says which, once you leave the field. |
| A call was refused | Open **Do-not-call and consent** and check the decisions table for the reason. |
| A campaign will not start | It needs contacts and an active **From number**. |

## Next steps

- [Conversations](https://docs.vlayers.ai/build/conversations): Read the calls once they happen.
- [Billing](https://docs.vlayers.ai/build/billing): See what calls cost and set a spending limit.
