> 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/running-and-monitoring.md).

# Running and monitoring

Launching and stopping a campaign, following its progress and exporting results.

## Launch and stop

* **Launch** puts all contacts into the queue and the campaign becomes **Active**.
* **Stop** deactivates the campaign. Contacts that were not called yet are moved to *Failed* (status `Not_called`); calls already in progress are finished normally.
* A **batch** campaign is **finished** when you stop it or when all its contacts have been attempted. A finished campaign cannot be launched again and no contacts can be uploaded - use **Copy campaign** instead.
* A **continuous** campaign can be stopped and launched again at any time but all the phone number will be dialed again

### Launch or stop several campaigns

In the campaign list, tick the campaigns (or **Select all**) and click **Launch campaigns** or **Stop campaigns**. Studio lists the campaigns it will change and skips the ones that are **Already running**, **Already finished** or **Not running**. Confirm, and Studio reports how many campaigns were launched or stopped and which failed. Stopped batch campaigns cannot be launched again.

<figure><img src="https://4261467870-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6iQTvxgRZRwPS1NgIGEb%2Fuploads%2Fk87IWFAvLgcXS5ngeoUX%2Fcampaigns-running-bulk-select.png?alt=media" alt="The campaign list with two campaigns ticked and the bar Launch campaigns and Delete campaigns highlighted"><figcaption><p>Tick campaigns, then Launch campaigns or Stop campaigns</p></figcaption></figure>

<figure><img src="https://4261467870-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6iQTvxgRZRwPS1NgIGEb%2Fuploads%2FEBvFpiwcaR1CFbVUeD58%2Fcampaigns-running-bulk-launch.png?alt=media" alt="The Launch campaigns dialog: two not running continuous campaigns ticked, and 2 selected campaigns will be skipped because one is Already finished and one is Already running"><figcaption><p>Campaigns that are already running or finished are skipped</p></figcaption></figure>

{% hint style="warning" %}
Changes to an active campaign (settings, contacts, metadata) never affect calls that are already ringing or in progress. Avoid editing an active campaign in a hurry - review the change first.
{% endhint %}

## Campaign detail

| Panel              | What you see                                                                                                                                                                                                                                                                                  |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Details**        | Campaign type, calling line (trunk account), number of contacts, max. call trials and retry delay.                                                                                                                                                                                            |
| **Statistics**     | Number of contacts per status and its share of all contacts, for example 432 (43.2%). Tick a status to filter the list.                                                                                                                                                                       |
| **Numbers**        | All contacts with **Status**, **Phone number**, **Called at** (time first, then date), **Next call** and **Trials** (attempt number). **Search numbers** finds a contact by phone number. The data loads when you open the page; click **Refresh** to see the progress of a running campaign. |
| **Contact detail** | Click a contact to see its Call ID, Trace ID, attempts, status, next call time and **Metadata**. Use **Play** in the row menu to listen to the recording and read the transcript.                                                                                                             |

Every contact belongs to one of three groups:

* **Queued** - waiting for the first call or for a retry.
* **Processed** - the call was successful.
* **Failed** - all attempts were used up, or the campaign was stopped before the contact was called.

## Call statuses

| Status                       | Meaning                                                                                                                                                                                    |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `waiting`                    | Campaign not launched yet.                                                                                                                                                                 |
| `Created` / `Locked`         | Queued for the first call / call is running.                                                                                                                                               |
| `busy`                       | The contact rejected the call or the line was busy.                                                                                                                                        |
| `no-answer`                  | The phone rang but nobody picked up.                                                                                                                                                       |
| `disconnected`               | The call ended before it was answered (e.g. unreachable number, network issue).                                                                                                            |
| `error`                      | The call could not be placed - e.g. a configuration problem with the calling line.                                                                                                         |
| `Not_called`                 | The campaign was stopped before this contact was called.                                                                                                                                   |
| `Max call duration exceeded` | The call did not report any result for 60 minutes.                                                                                                                                         |
| *custom status*              | Any status your flow sends with [`update_campaign_call_result`](https://docs.borndigital.ai/digital-agent/campaigns/campaign-smart-functions.md), e.g. `interested`, `callback-requested`. |

## Export

Click **Export** and choose **XLSX**, **CSV** or **JSON**. The file contains:

* **Campaign Info** - all settings of the campaign.
* **Calls List** - every call with Call ID, phone number, status, attempt, timestamps, trace ID, category (Queued / Processed / Failed) and one column per metadata key - including metadata stored by your flow. For a campaign that has not been launched yet, the file contains the uploaded **Phone List** instead.

{% hint style="info" %}
The call history is kept only for a limited period. Export the results you need to keep.
{% endhint %}

## Handling complaints

If someone complains about being called, open the campaign, search the **Numbers** list for their number and open the contact detail - you will see every attempt, its result and the recording.
