# Create and start a campaign

> How to create a call campaign, upload recipients as a CSV file, set call times, give the legal confirmation and start the campaign.

Source: https://docs.qutee.ai/en/kampagnen/kampagne-anlegen/

This guide shows you how to create a campaign in which an outbound agent calls a list of people, and how to start it. The **Create new campaign** wizard takes you through four steps: **Basics**, **Recipients**, **Settings** and **Confirmation**.

## Before you start

- You are signed in as a **Company Admin**. With the **User** role, you don't see **Campaigns**.
- Campaigns are enabled for your company (depending on your plan). If they aren't, **Campaigns** doesn't appear in the navigation. To enable them, write to [hey@qutee.ai](mailto:hey@qutee.ai).
- qutee has set up at least one outbound agent for you. You see it under **Campaigns** > **Outbound agents**.
- You have a list of the people to be called, and you are allowed to contact them by phone for this purpose. More in [Campaigns overview](https://docs.qutee.ai/en/kampagnen/kampagnen-ueberblick/#legal-responsibility).
- Only a **Company Admin** of your own company can start the campaign.

## Step 1: Set the basics

1. Open **Campaigns**.
2. Click **New campaign**. If you don't have a campaign yet, the button is called **Create campaign**.
3. Enter a name under **Campaign name**, for example "Customer satisfaction July". The name is internal; the agent doesn't read it out.
4. Choose the **Campaign type**, for example **Appointment reminder** or **Customer feedback**. What the types mean is explained in [Campaigns overview](https://docs.qutee.ai/en/kampagnen/kampagnen-ueberblick/#campaign-types).
5. Under **Outbound agent**, choose the agent that should make the calls. Its phone number is shown next to its name: the agent calls from this number, and callbacks to this number also reach it.
6. Under **Outbound instructions**, describe what the agent should achieve in the conversation. Example: "Ask how satisfied they were with the service appointment and whether they would like a callback."
7. Optional: Click **Add an internal description (optional)** and describe what the campaign is about under **Description**. The description is for your team only; the agent doesn't receive it. Anything the agent should know in the conversation belongs in **Outbound instructions**.
8. Click **Continue: Recipients**.

The campaign is now saved as a **Draft**. **Outbound agent** and **Campaign type** can't be changed after this. You can still change the name and instructions.

> **Caution:** If **Outbound agent** shows a note that no outbound agent has been set up yet, you can't create a campaign. Outbound agents are available depending on your plan. Contact [hey@qutee.ai](mailto:hey@qutee.ai).

## Step 2: Upload recipients

Recipients are added to the campaign with a CSV file. You can't enter individual recipients by hand.

1. Click **Download example CSV**. You get a template with all columns and two example rows.
2. Enter your contacts in the template and delete the example rows.
3. Save the file as CSV. In Excel or Numbers, export it as CSV with "Save as" or "Export".
4. Drag the file onto the **Drop a CSV file here** area or click **Choose CSV file**. The import starts right away.
5. Check the numbers under **Imported**, **Invalid**, **Duplicates** and **Do-not-call**. Rows with problems are listed below under **Issues found**, with the row number and reason.
6. Under **Review imported recipients**, check that names, numbers and additional information were imported correctly. You can search by name or number.
7. Click **Continue: Settings**. This only works once at least one recipient has been saved.

You can upload more files to the same draft. The recipients are added, and the list under **Review imported recipients** always shows all recipients of the campaign.

### Columns in the CSV file

The first row must contain the column names. Click **Expected columns** in the wizard to see them.

| Column | Required | Content |
| --- | --- | --- |
| `phone_number` | **required** | The person's phone number, ideally with country code, for example `+4930123456789`. `Telefon`, `Telefonnummer`, `Rufnummer` and `Phone` are also recognized as column names. |
| `name` | optional | The person's name. At the start of the call, the agent asks whether it is speaking to this person. |
| `context` | optional | Background for the conversation, for example "Service appointment on July 5". The agent uses this information in the conversation. |
| `external_id` | optional | Your own identifier, for example a customer number. It appears in the export later so you can match up the results. |
| `preferred_language` | optional | The language in which the agent starts the conversation, for example `de-DE` or `en-US`. If it's empty, the agent speaks its usual language. |

Any other columns are saved as additional information about the person and are also passed to the agent. So only include information the agent is allowed to know in the conversation.

About the format:

- Comma, semicolon or tab work as separators. Excel or Numbers files (`.xlsx`, `.numbers`) must be exported as CSV first.
- Numbers without a country code, for example `030123456789`, are read as German numbers.
- At most 10,000 recipients and 10 MB per file.
- Format the phone number column as text in Excel or Numbers. Otherwise the spreadsheet rounds long numbers or removes the `+`, and the number becomes invalid.

### Why recipients aren't imported

- **Invalid**: The phone number is missing or isn't a complete number.
- **Duplicates**: The number appears more than once in the file or is already in the campaign. Each number is called only once.
- **Do-not-call**: The number is on the [do-not-call list](https://docs.qutee.ai/en/kampagnen/sperrliste/).

Valid rows are still imported. Correct the other rows and upload them as a separate file.

## Step 3: Set the call settings

1. Under **Call window**, choose the **Weekdays** on which calls are made.
2. Set the **Start time** and **End time**. The call window must be between 07:00 and 20:00. The default is Monday to Friday, 08:00 to 16:00.
3. Under **Maximum attempts**, set how often a recipient is called at most (1 to 5, default 3).
4. Under **Retry interval**, choose how long to wait before the next attempt: **30 minutes**, **1 hour**, **2 hours** (default), **4 hours** or **24 hours**.
5. Optional: Open **More call settings** for time zone, voicemail and callbacks (see below).
6. Click **Continue: Confirmation**.

Under **More call settings** you find:

- **Timezone**: All call times apply in this time zone. The default is `Europe/Berlin`.
- **Voicemail behavior**: **Do not leave a message** (default) or **Leave a short message**. With the short message, the agent states its name, your company and the reason for the call in one sentence, without confidential details. Automatic voicemail detection keeps improving but doesn't recognize every voicemail.
- **Callback behavior**: Set what happens when someone calls the outbound agent's number back. With **Same agent with context**, the outbound agent answers the callback and knows the reason for the campaign. With **Forward to a human** and a **Forwarding number**, callbacks go straight to your team. If nobody answers there, the outbound agent takes the callback with the reason for the campaign.

## Step 4: Review, confirm and start

1. Under **Summary**, check the campaign name, type, agent, number of recipients, maximum attempts, call window and callback behavior. **Review recipients** takes you back to the recipient list.
2. Read the three statements under **Legal confirmation required** and tick each one:
   - that your company is authorized to contact these recipients by phone for the selected purpose,
   - that the phone numbers were lawfully collected and may be used for this campaign,
   - that qutee provides the technical calling infrastructure and your company is responsible for the purpose, the choice of recipients and the legal basis.
3. Click **Start campaign**.

The app opens the campaign's page with the status **Running**. If it's currently outside the call window, the campaign waits for the next window.

The confirmation is stored with your name, the time, the version of the texts and the number of recipients. You find it on the campaign's page in the **Settings** tab under **Legal confirmation**.

## Save as a draft and continue later

From step 2 on, you can click **Save as draft** at any time. The campaign then appears with the status **Draft** in the list under **Campaigns** and doesn't call anyone.

To continue:

1. Open **Campaigns** and click the campaign.
2. Click **Continue setting up draft**. The wizard opens with your saved details and recipients.
3. Go through the remaining steps and click **Start campaign** at the end.

To remove a draft you no longer need, click **Delete** on the campaign's page.

## Approve a campaign prepared for you

If qutee has prepared a campaign for you, the Company Admins of your company get an email with a link to the campaign. The list then shows **Waiting for confirmation**. Review the campaign, click **Continue setting up draft**, tick the three boxes in the **Confirmation** step and click **Start campaign**. The campaign doesn't start without your confirmation.

## Check that it works

- In the list under **Campaigns**, the campaign has the status **Running**.
- On the campaign's page, **Updates automatically** appears next to the status, and the numbers under **Overview** change as soon as calls are made.
- Every dial attempt appears in the **Log** tab, including unanswered ones.
- If the top of the page shows **The campaign is not calling anyone right now**, the app gives the reason below it, for example **Outside the call window.** with the next start time.

## Common problems

**Continue: Recipients is grayed out**: The campaign name or outbound agent is missing. Both fields are required.

**The CSV file isn't accepted**: The file isn't a CSV file, or the first row has no column for the phone number. Export the file as CSV (ideally "CSV UTF-8") and check the column names. The message in the app gives the exact reason.

**Many numbers are invalid**: The spreadsheet changed the numbers, for example by rounding them. Format the column as text, enter the numbers again and export the file again.

**Start campaign is grayed out**: Not all three boxes under **Legal confirmation required** are ticked yet. The campaign only starts once all three statements are confirmed.

**The call window isn't accepted**: Start time and end time must be between 07:00 and 20:00, and at least one weekday must be selected.

## Next steps

- [Track and control a running campaign](https://docs.qutee.ai/en/kampagnen/kampagne-steuern/)
- [Add numbers to the do-not-call list](https://docs.qutee.ai/en/kampagnen/sperrliste/)
