> For the complete documentation index, see [llms.txt](https://docs.borndigital.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.borndigital.ai/digital-agent/campaigns.md).

# Campaigns

Campaigns let your voicebot call a list of contacts automatically - with business hours, retries and per-contact personalisation.

A **campaign** is a list of phone numbers that your voicebot calls on its own. You upload the contacts (optionally with extra data such as name or contract number), define *when* and *how often* the bot may call, and launch it. The platform then dials every contact, runs your conversation flow and records the result of each call.\
\ <br>

<figure><img src="https://4261467870-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6iQTvxgRZRwPS1NgIGEb%2Fuploads%2F2yiSpLsSiM1ieYZcSCsx%2Fimage.png?alt=media&amp;token=be89997b-5e96-40ca-9b8f-3b85cc3a9a61" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Campaigns are available in projects with outbound calling enabled. You find them in the left menu under **Campaigns**.
{% endhint %}

## Campaign types

| Type           | When to use it                                                                                                                          | How it ends                                                                                                                                       |
| -------------- | --------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Batch**      | You have a fixed list of contacts known in advance (e.g. a daily list of 200 leads). Upload all numbers, launch, get a complete report. | Automatically, once every contact has been attempted - or when you stop it. A finished batch campaign cannot be launched again (copy it instead). |
| **Continuous** | Contacts arrive over time - from a CRM, a web form or another integration. New numbers are called as soon as they are added.            | Never on its own - it runs until you stop it.                                                                                                     |

The type is chosen when the campaign is created and cannot be changed later.

## How a campaign works

1. **Create** the campaign and configure the calling line, business hours and retry rules. A new campaign is always *inactive*.
2. **Upload contacts** - an Excel file with a phone number column and any number of extra columns (metadata).
3. **Launch** - all contacts are put into the call queue.
4. **Dialling** - the platform picks the next contact whenever all of the following allow it:
   * the current time is within the campaign's **business hours** (in the campaign timezone),
   * today is not a public holiday (unless *Call on holidays* is on),
   * the **max. parallel calls** limit of the campaign and of your organisation is not reached,
   * the retry delay of the contact has passed.
5. **The call is answered** - your conversation flow runs. The flow can load the contact's metadata with [`get_campaign_call_metadata`](/digital-agent/campaigns/campaign-smart-functions.md) and store the outcome with [`update_campaign_call_result`](/digital-agent/campaigns/campaign-smart-functions.md).
6. **The call is not answered** (busy, no answer, disconnected) - the contact is scheduled for another attempt according to the [retry rules](/digital-agent/campaigns/creating-a-campaign.md#call-again-retries). The flow can additionally react in the Start node - see [Unsuccessful calls](/digital-agent/campaigns/unsuccessful-calls.md).
7. **Result** - each contact ends up as **Processed** (successful) or **Failed** (all attempts used up).

## Pages in this section

* [Creating a campaign](/digital-agent/campaigns/creating-a-campaign.md) - all campaign settings explained
* [Contacts and metadata](/digital-agent/campaigns/contacts-and-metadata.md) - file format for uploading contacts
* [Running and monitoring](/digital-agent/campaigns/running-and-monitoring.md) - launching, stopping, call statuses and exports
* [Unsuccessful calls](/digital-agent/campaigns/unsuccessful-calls.md) - the *Call unsuccessful* section of the Start node
* [Campaign smart functions](/digital-agent/campaigns/campaign-smart-functions.md) - working with campaign data inside the flow