Skip to content
Supportqutee.aiOpen app

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.

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.

  • 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 [email protected].
  • 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.
  • Only a Company Admin of your own company can start the campaign.
  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.
  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.

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.

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.
  • 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.

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

  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.
  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.

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.

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.

  • 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.

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.

Was this page helpful?