> 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/creating-a-campaign.md).

# Creating a campaign

All campaign settings explained - calling line, business hours, retries and scheduling.

Open **Campaigns** in the left menu and click **Create campaign**. Type the campaign name into the header of the dialog and fill in the sections below. Click **Save** - the campaign is created as **inactive**, so nothing is dialled until you [launch it](https://docs.borndigital.ai/digital-agent/campaigns/running-and-monitoring.md).\ <br>

<figure><img src="https://4261467870-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6iQTvxgRZRwPS1NgIGEb%2Fuploads%2FhTb0TCM5zoYHV6EdWfLz%2Fimage.png?alt=media&amp;token=9ce64bec-9b4a-4a0b-b29c-99bd3b139b2d" alt="" width="245"><figcaption></figcaption></figure>

{% hint style="info" %}
To reuse an existing configuration, open the menu of a campaign in the list and choose **Copy campaign**. You can also copy the original phone numbers and their metadata.
{% endhint %}

<figure><img src="https://4261467870-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6iQTvxgRZRwPS1NgIGEb%2Fuploads%2Ft4f0TVihrVDLueM5faEh%2Fimage.png?alt=media&amp;token=9abca1d8-8f15-4b81-bf7c-e6a397fc28d5" alt="" width="262"><figcaption></figcaption></figure>

## Settings

| Field                                  | Description                                                                                                                                                                                                                                                                                                                                                      |
| -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Type**                               | **Batch** or **Continuous** - see [Campaign types](https://docs.borndigital.ai/digital-agent/campaigns.md#campaign-types). Can only be selected when the campaign is created.                                                                                                                                                                                    |
| **Voicebot phone number** *(required)* | Phone number(s) the voicebot calls from. Only numbers assigned to a **deployed** configuration of this project are offered, and the flow that runs is the one deployed on that number. If you select more numbers, each call uses one of them at random - this increases throughput and reduces the risk of the number being marked as spam by mobile operators. |
| **Country**                            | Selects the public-holiday calendar. Pick the country of your **contacts**, not of your team.                                                                                                                                                                                                                                                                    |
| **Timezone**                           | All business hours and dates of the campaign are evaluated in this timezone.                                                                                                                                                                                                                                                                                     |
| **Max. parallel calls**                | How many calls the campaign may run at the same time. The maximum is the limit of your organisation. A good rule of thumb: do not exceed the number of human operators available to take over transferred calls.                                                                                                                                                 |
| **Call on holidays**                   | When off (default), no calls are placed on public holidays of the selected country; calling resumes on the next business day.                                                                                                                                                                                                                                    |

## Business hours

The time window in which calls may be **started**, for each day of the week. Contacts outside the window wait in the queue for the next available slot.

* By default, the business hours of your organisation are used. Change them to override them for this campaign, or click **Reset** to return to the defaults.
* A day that is switched off means no calls on that day.
* A call that starts inside the window is not interrupted when the window closes.

<figure><img src="https://4261467870-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6iQTvxgRZRwPS1NgIGEb%2Fuploads%2FLxcQDZGKi5SMGck0IHEk%2Fimage.png?alt=media&amp;token=2094f5ee-8fa6-4c69-9879-65afa8d27073" alt=""><figcaption></figcaption></figure>

## Call again (retries)

Defines what happens when a call attempt ends unsuccessfully.

| Field                           | Description                                                                                                                                                                                                                                     |
| ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Statuses**                    | Call results that count as unsuccessful and are retried. Type a status and press **Enter** to add it. Default: `busy`, `no-answer`, `paused`, `failed`, `error`, `disconnected`.                                                                |
| **Max repeated attempts**       | Total number of attempts per contact, including the first call (1-4). `1` = the contact is called only once. When all attempts are used up, the contact is marked as **Failed**.                                                                |
| **Attempt after**               | Delay before the next attempt: 10, 60, 90 or 120 minutes, or **Custom time** in minutes (1 minute - 1 week). The retry still respects business hours, holidays and parallel-call limits.                                                        |
| **Specify time** *(batch only)* | Instead of a delay, pick an exact date and time for every retry (**Attempt at**). Each time must be later than the previous one, and all of them must still be in the future when the campaign is launched. Times are in the campaign timezone. |

{% hint style="info" %}
**How the platform decides whether a call was successful**

* `busy`, `no-answer` and `disconnected` are **always** retried, even if you remove them from *Statuses*.
* Any other result is retried only if it is listed in *Statuses*.
* Every result that is **not** in the list counts as **success** and the contact is moved to *Processed*. This includes custom statuses sent by your flow - see [Campaign smart functions](https://docs.borndigital.ai/digital-agent/campaigns/campaign-smart-functions.md).
  {% endhint %}

<figure><img src="https://4261467870-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6iQTvxgRZRwPS1NgIGEb%2Fuploads%2FxtXC6gW3ZAeAWxl7RFT5%2Fimage.png?alt=media&amp;token=adf1e489-c094-4b37-ac07-aa3eeb3cae9c" alt=""><figcaption></figcaption></figure>

<figure><img src="https://4261467870-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6iQTvxgRZRwPS1NgIGEb%2Fuploads%2FlnjVEFJibtsR2CgLbXua%2Fimage.png?alt=media&amp;token=401792ab-b55c-4e4b-b863-9704162dc42e" alt=""><figcaption></figcaption></figure>

## Scheduling (batch only)

**Scheduled start** - the date and time (campaign timezone) from which the contacts may be called. Launch the campaign in advance; dialling begins at the scheduled time, within business hours.

<figure><img src="https://4261467870-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6iQTvxgRZRwPS1NgIGEb%2Fuploads%2FiJhRDcsFGnsPMvkwiJ9j%2Fimage.png?alt=media&amp;token=6fac124e-291c-4497-af5e-43c9312c5ae0" alt=""><figcaption></figcaption></figure>
