Skip to content

Create and edit a campaign

Requires the "Campaigns" permission.

A campaign is created with a guided, step-by-step procedure. It opens with + New campaign from the Campaigns page; the same screen, titled Edit campaign, opens when you click an existing campaign in the list.

Step New campaign Edit campaign
Basic data 1 1
Contact filters 2 Not present
Ordering 3 2
Modules and operators 4 3

You move between the steps with Next and Back: what you have filled in is not lost. Saving happens only at the last step, with Create campaign (or Save changes). With ← Campaigns at the top you go back to the list without saving.

The campaign starts suspended

After Create campaign you return to the list and the new campaign has the Status switch off. No operator can work it until you turn it on from the campaign list.

1. Basic data

Under Title and Database there are Client and Outcome profile. For a Predictive campaign, further down you also find Phone number to use, Percentage and the table of the Working time slots.

Main fields

Field What to enter Notes
Title The name of the campaign, the one operators see Required
Database The database to take the contacts from Required. It is chosen before the work group. Cannot be changed after creation. If your account has only one database it is selected right away and the field is shown disabled
Work group The work group of the campaign (optional, No group if you do not choose one) Appears under Database only if the chosen database has at least one group you can assign, and offers only the groups of that database. A database without groups gives a campaign without a group. Under the field: "It is chosen among the database's groups and cannot be changed later. Only operators, agents and the client of the group can be assigned to the campaign." If you change database and the chosen group is no longer among those of the new database, the field goes back to No group. Cannot be changed after creation: when editing, the field is read-only (and appears only if the campaign has a group)
Client The customer on whose behalf the campaign runs (optional, No client if you do not choose one) Appears only if at least one client exists in General settings. In the list, clients are sorted by last name and first name. With a Work group chosen, the list contains only the clients of that group
Outcome profile The outcome details the operator picks from a menu while working (optional, No profile if you do not choose one). Under the field: "Outcome details the operator picks from a menu (profiles in Configuration → Outcome profiles)." Appears only if at least one profile exists. Profiles are created in Outcome profiles
Start First day on which the campaign can be worked Default: today
End Last day on which the campaign can be worked (valid until the end of the day; the end day is also included in Predictive and VoiceAI automatic calls) Default: today. Must be equal to or later than Start. Disabled if you choose No end date
No end date The campaign never expires
Type Preview, Predictive, Progressive, VoiceAI Only the types enabled for your account appear (see Campaign types). Default: Preview. For VoiceAI see VoiceAI campaigns

Next becomes active only when you have filled in Title and Database, the end date is not before the start date and, for Preview, Predictive and VoiceAI campaigns, you have chosen Trunk and Numbering (if your account has a phone system). For VoiceAI campaigns you also need Max simultaneous calls (at least 1), the Bot and at least one time slot.

Watch out for the default dates

Start and end are both pre-filled with today's date: if you do not change them, the campaign lasts only one day and from tomorrow it shows as "Ended" to operators. Set an end date or turn on No end date. If the end date is before the start date, "The end date must be on or after the start date." appears in red and you cannot go forward or save.

Database subject to the Public Opposition Register

If the chosen Database is marked as Public Opposition Register (RPO), the campaign cannot be worked until you have extracted the list of numbers, had it checked by the Register and imported the response, and it must be renewed when it expires. You do this from the campaign's RPO tab: see Public Opposition Register (RPO). How to mark a database as RPO is described in Databases.

Predictive and VoiceAI settings

When you choose Predictive or VoiceAI, more fields appear.

Field Types Meaning
Phone number to use Predictive, VoiceAI Which of the contact's numbers the engine calls: from Phone1 to Phone9, or All. Default: Phone1. With a specific phone the engine calls only that number; if that number is missing on the contact, the contact is excluded from automatic calls as unreachable (the note appears in the Predictive/Voice AI report) and goes back on the list after you enter the number (see Clean up campaign). With All it calls the first number that is filled in (Phone 1, if missing Phone 2, and so on)
Percentage Predictive How many more calls to launch compared with the free operators (see below). Default: 50. Under the field you see "Maximum allowed for this account: …%"
Max simultaneous calls VoiceAI Maximum number of calls handled together by the bot (minimum 1)
Bot VoiceAI The phone system bot that handles the calls. The language is set on the bot, not in the campaign
Group for operator forwarding VoiceAI Phone system group to which the bot passes the call when a person is needed: chosen from a menu of the groups made available to your account
Welcome message VoiceAI Opening sentence, with the contact's data and the greetings {{SalutoIT}}, {{SalutoEN}}, …

The meaning of the VoiceAI fields, the placeholders of the welcome message, the bot's Email and SMS templates and the error messages are in the VoiceAI campaigns page.

Check the contacts' phones

With a specific phone (for example Phone2) the contacts that do not have it are not called. If your list has numbers only in some columns, use All.

The Predictive percentage

In a Predictive campaign, at each cycle the system counts the free operators (waiting on the Predictive page) and launches as many calls as there are free operators plus the percentage you set. For example, with 4 free operators and a percentage of 50 it keeps up to 6 calls in progress: since many do not answer, operators wait as little as possible.

The higher the percentage, the more likely it is that two contacts answer together and one of them does not find a free operator (a "silent" call). The maximum value is set by whoever manages the Thelgo platform for your account: the field does not accept higher values and saving is refused with a message if you exceed it. If the Silent call control is active in General settings and the threshold is exceeded, the system temporarily ignores the percentage and launches only one call per free operator.

Working time slots

For Predictive and VoiceAI you must indicate when the system may call. Without slots, "No time slot added, this campaign will not make any calls." appears in red.

Without time slots the campaign does not call

A Predictive campaign with no slot is never "within hours" and the engine does not launch any call, even if the campaign is on. So always add at least one slot. Operators do not see any warning: the campaign appears in their list with the normal Access button and the waiting page is the usual one, but no call arrives.

  1. Press + Add time slot.
  2. Tick one or more days (or Select all).
  3. Enter From and To (defaults: 08:00 and 18:00).
  4. Press Add: one slot is created for each ticked day.

You can add several slots for the same day, for example 09:00-13:00 and 14:30-19:00 to leave the lunch break free. The table shows them sorted by day and time; the trash can removes a slot. The times are the local times of your account.

Outside the slots (and therefore also when there are none) the campaign stays active and operators can enter the waiting page, but the system does not launch calls. In the campaign list the switch is yellow.

Other settings

The Other settings box appears only if your account has a phone system connected to Thelgo. It applies to all campaign types.

Field Meaning
Record calls Records the audio of all the campaign's calls. The message "Recordings will be kept for 30 days." appears
Call transcription In addition to the recording, produces the transcript of the speech. It can be turned on only with Record calls on (turning off recording also turns off transcription). If your account does not include it, it stays disabled with the message "Call transcription is not available for this account."
Trunk The outgoing phone line to use. Required for Preview, Predictive and VoiceAI campaigns. If there is only one, it is already set and cannot be changed; trunks without numberings are not offered
Numbering The number the calls start from, among those of the chosen trunk. Required for Preview, Predictive and VoiceAI campaigns. If there is only one, it is already set. When you change the trunk, the numbering is reset
Prefix Text placed before the contact's number when it is dialed, for example +39. Optional

Trunk and numbering are essential

For Preview, Predictive and VoiceAI campaigns, if your account has a phone system, you cannot save the campaign without Trunk and Numbering: under the fields "Trunk and numbering are required for Preview, Predictive and VoiceAI campaigns: without them no call can start." appears in red and Next stays disabled. If saving is refused anyway, the same message appears at the top of the page. The Progressive campaign does not have this requirement.

Campaigns created earlier without trunk or numbering stay in the list, but, if the account has a connected phone system, with a warning icon next to the name ("Missing trunk or numbering: no call can start until they're set."): for those the operator still gets the error "Trunk e numerazione non sono configurati per questa campagna." (Trunk and numbering are not configured for this campaign.) and the Predictive engine skips the launches. Open it, choose trunk and numbering and save (from now on saving, even just to change the name, requires choosing them). The same happens if the chosen trunk or numbering is later deleted from the phone system: in that case reopen the campaign and choose others.

Recordings for 30 days

Recordings (and transcripts) remain available for 30 days. If you need them for longer, download them beforehand from the calls report. Operators can listen to them only with the "Download recordings/transcripts" permission.

2. Contact filters

Only when creating a new campaign.

Here you decide which contacts of the database go into the campaign. This step is optional: without filters the whole database goes in.

  1. Tick the fields you want to filter on. Only the fields that have at least one value in the database appear: postal code, municipality, province and the database's dynamic fields. Company name, names, phones, address, email, website and reference ID are not offered.
  2. For each chosen field:
    • text fields: tick the values to include. The list shows up to 200 values; to find others, type in the search field and press Enter or the magnifying glass. Below you see the Selected values;
    • dynamic fields of type Number or Date: enter a range From / To (ends included, both optional).
  3. Check the box "… contacts matching the filters", which updates with every choice.

Several values of the same field add up (Municipality = Milan or Monza); different fields combine (Municipality = Milan and Province = MI). For this reason, once a value is chosen in one field, the lists of the other fields narrow down to the values that are still possible.

The campaign is a snapshot of the database

Contacts are inserted into the campaign when it is created. Contacts imported later into the same database do not enter by themselves: you can add them during the import (see Import) or with Add contacts (see Campaign contacts). When editing, filters can no longer be changed.

3. Ordering

The ordering decides in which order operators (Preview) or the engine (Predictive) receive the never-called contacts.

Option Effect
Random (default) Random order, set once only
A field (e.g. Province) First the contacts with the first value in the list, then those with the second, and so on

When you choose a field, the list of its values appears, taken from the campaign's contacts (when creating: those that match the filters of the previous step). Put them in the order you want by dragging them or with the ↑ ↓ arrows. Contacts without a value, or with a value not in the list, are called last.

This order applies only to contacts to be called for the first time: expired callbacks always take precedence, and the Contact picking of the General settings can periodically insert a never-contacted contact even if it is at the bottom of the list (see also In what order contacts arrive in the operator manual).

Changing the ordering on a running campaign

If you change the ordering of an existing campaign, Thelgo recalculates the order of all its contacts in the background: progress appears in the Operations page as "Ordering recalculation". In the meantime operators can keep working. The same recalculation starts every time you add contacts with Add contacts (see Campaign contacts). With the Random ordering the recalculation assigns a new random order to all the campaign's contacts, not only to the new ones.

4. Modules and operators

This step is number 3 when editing a campaign and 4 when creating one. It contains the Agenda Management module, the Preset Email module and the Preset SMS module, followed by the Enabled operators, the Enabled agents and the Call script.

Agenda Management module

Turn it on if operators must schedule appointments for agents during calls. In the operator's working screen the Schedule appointment section appears (see Scheduling an appointment in the operator manual).

On wide screens the options are grouped in three columns: Appointments, Agent notifications and Customer reminder. The Appointments column has Average appointment duration (minutes), Appointment outcome profile and Appointment required for Positive Outcome; Agent notifications has the Emails to agents about appointments choice; Customer reminder has the reminder options.

Option Effect
Average appointment duration (minutes) Duration proposed when the operator chooses a slot: the end time is calculated automatically. Default: 60
Appointment outcome profile The outcome details the agent picks from a menu when closing an appointment (optional, No profile). Under the field: "Appointment outcome details the agent picks from a menu (profiles in Configuration → Appointment outcome profiles)." Appears only if at least one profile exists (see Appointment outcome profiles)
Appointment required for Positive Outcome The operator cannot save a Positive outcome without having scheduled an appointment
Emails to agents about appointments What to send to the campaign's agents, chosen among three options (the first two are mutually exclusive): Do not email appointments to agents; Email agents when an appointment is assigned: the agent receives a notification email when an operator schedules an appointment for them and when an administrator reassigns an appointment to them from the Calendar, with the hint "The email format is set in Email → New agent appointment." (see Emails to agents); Send agents the daily summary of their appointments: one email per day per agent with all their appointments, with the hint "The format and sending time are set in Email → Agent appointment summary." (see Appointment summary to agents). Both require a configured mail server (see SMTP configurations)
Appointment reminder Sends a message to the contact on the day of the appointment (see below)

Appointment reminder

When you turn on Appointment reminder, the reminder options appear:

Field What to enter
Reminder channel SMS or Email. Appears only if SMS is available for your account (see SMS); otherwise the channel is always Email
Reminder template The template to use, chosen among those prepared in Configuration → SMS or Configuration → Email (Appointment reminder template tab). Each entry shows description and sending time, for example "Reminder (09:00)". It is required: until you choose it you cannot save the campaign

The option stays disabled, with the hint "No reminder template available: create one in Configuration → SMS/Email.", until at least one usable template exists. When you change the channel, the template choice is reset. For SMS reminders the campaign must also have the Preset SMS module active, otherwise sending fails with "The SMS module is not active for this campaign." When and to whom the message is sent, the text and the errors are described in Appointment reminder.

With the module active, the Enabled agents section also appears (see below). When you turn the module off, on saving the agents and the options above are also removed from the campaign.

Preset Email module

Turn it on if operators must be able to send the contact ready-made emails during the call (see Sending an email in the operator manual).

The module can be turned on only if at least one SMTP configuration exists; otherwise the switch is disabled and the message "You need to set up an SMTP (Email → SMTP configuration) to create an email format." appears (see SMTP configurations). SMTP configurations are in the SMTP tab of the Email page (menu CONFIGURATION → Email).

With the module active:

  • tick the email templates the operator will be able to choose. Templates are shared among campaigns and are managed in the Email template for campaign tab of the Email page (see Email templates); if there are none, "No email templates yet. Create one to enable sending email in this campaign." appears;
  • next to each template, the eye icon (Preview) opens a Template preview window with the Subject and the Text of the template (in HTML format if the template is written in HTML), without leaving the campaign;
  • the + New template button is at the top right of the module header, on the row of the switch, and appears only if the module is on. When you press it the form opens above the list of templates and you can create one on the fly without leaving the page: Description (required), SMTP configuration to use, Subject, Text (with the HTML switch the text is sent as HTML code exactly as it is), the placeholders to insert in the text and the Attachments (10 MB maximum each). Press Save: the template is created and ticked right away for this campaign.

The placeholders offered for emails are those common to all databases ({{Nominativo}}, {{RagioneSociale}}, {{Nome}}, {{Cognome}}, {{Email}}, {{Telefono1}}, address, etc.) and the operator's data ({{Operatore.Nome}}, {{Operatore.Cognome}}, {{Operatore.Username}}, {{Operatore.Email}}). {{Nominativo}} becomes the contact's first and last name or, if missing, the company name.

The placeholder box also offers the agent's data ({{Agente.Nome}}, {{Agente.Cognome}}, {{Agente.Username}}, {{Agente.Email}}) and the appointment's data ({{Appuntamento.DataOra}}, {{Appuntamento.Data}}, {{Appuntamento.Ora}}), useful for a confirmation to send during the call. Under the buttons you read "The agent and appointment placeholders are only filled in when the appointment is already booked: operators will be able to send a template that contains them only after booking it." A template that uses them therefore stays grey in the operator's menu until the appointment is scheduled (see Sending an email); in a campaign without the agenda module it cannot be used.

In VoiceAI campaigns, under the ticked templates there is also Email template sent by the bot, to choose which template the bot can send during the call (see VoiceAI campaigns).

Preset SMS module

Turn it on if operators must be able to send the contact ready-made SMS during the call (with Send SMS in the working screen). It behaves like the email module, but with the SMS templates prepared in the SMS page.

  • The switch can be turned on only if the SMS service is active for your account. Otherwise it stays disabled and "No SMS service has been activated yet for this account." appears below; if the module turns out to be on anyway when saving, saving is refused with "The SMS module cannot be enabled: no SMS service has been activated for this account yet."
  • If the switch turns on but the SMS page still says the service is not active, the service was activated after you logged in: the SMS page uses the situation read at login. Log out and back in to Thelgo.
  • With the module active you tick the SMS templates the operator will be able to choose. If there are none, "No SMS templates yet. Create one to enable sending SMS in this campaign." appears.
  • As with emails, the + New template button at the top right of the module header (visible only with the module on) opens a quick-creation form above the list: Description, Sender alias (if the chosen alias is not verified a warning appears), Text with the character and SMS counter and the placeholders to insert. Press Save: the template is created and ticked right away for this campaign. If no sender alias exists the button is greyed out and, when you hover over it, you read "You must first create a sender alias (even if not yet verified) before you can create an SMS template." (aliases are created in the SMS page).
  • The eye icon (Preview) next to each template opens Template preview, with the Sender alias and the Text (with the placeholders still written out, not replaced; for example {{Nominativo}}).
  • When you turn the module off, on saving the SMS templates are removed from the campaign.
  • In VoiceAI campaigns SMS template sent by the bot also appears, to choose which template the bot can send (see VoiceAI campaigns).

The SMS is sent only if the template's sender alias is Verified; otherwise the operator gets "The sender alias of this template has not been verified yet." (see SMS).

Survey module

It does not appear for VoiceAI campaigns.

Turn it on if operators must ask the contact a survey during the call. With the Survey module switch on:

  • choose the Survey from the "Choose a survey" drop-down. The surveys offered are those without a dynamic-field schema and those tied to the schema of the campaign's database. If there are none, "No survey is available for this campaign's database." appears with the Go to the Surveys page link (visible only with the Surveys permission). With the module on, a survey must be chosen;
  • turn on Survey required for positive outcome if you want the operator to be unable to save a Positive outcome until the survey is completed (see Outcomes and callbacks).

The survey of a campaign cannot be changed after the first recorded answer ("The survey cannot be changed once the first answer has been recorded."). If you turn the module off, operators no longer see the survey, but the answers remain and the survey stays assigned to the campaign. If you save the campaign with the module off, Survey required for positive outcome is switched off too: when you turn the module back on, switch it on again.

Refusal message When
"Choose the survey to use: the survey module is enabled." Module on without a survey chosen
"The survey module is not available for VoiceAI campaigns." Module on for a VoiceAI campaign
"The survey cannot be required for positive outcomes if the survey module is not enabled." Requirement on with the module off
"The selected survey uses a dynamic fields schema that is different from the one of the campaign database." Survey schema different from the database one
"The survey of the campaign cannot be changed because some contacts already have answers." Survey changed after the first answers

Enabled operators

Tick the operators who can work the campaign: only they see it in the "Your campaigns" page. The list contains the users with the Operator role (deleted users do not appear).

In VoiceAI campaigns the enabled operators are those who can receive and work the calls the bot transfers to a person: under the list the note "For VoiceAI campaigns, these are the operators who can receive and work the calls transferred by the bot." appears (see VoiceAI campaigns).

With Select all, all operators are enabled and, in addition, every new operator created in the future will be automatically associated with this campaign. Unticking it goes back to the previously saved selection (empty for a new campaign). If you remove a single operator, Select all turns off. If the campaign has a work group, the operators and agents offered (and enabled by Select all) are only those of the group.

Without operators nobody can work

You can save a campaign without operators, but nobody will see it. For Predictive campaigns operators must also have a fixed extension on the phone system (see Users).

Enabled agents

Appears only with the Agenda Management module on.

Tick the agents for whom operators can schedule appointments: they are the ones offered in the "agent" menu of the Schedule appointment section. Select all works as for operators: it enables all current agents and those created in the future.

Under each ticked agent you find Associate contacts by database field: by opening it you can choose fields and values (for example Province = MI, or postal code) to link to the agent a part of the campaign's contacts, with the same logic as the filters in step 2. The number in brackets shows how many fields you have set.

How the agent-contact association works

The associations decide which agents the operator finds in the "agent" menu of the Schedule appointment section, depending on the contact they are calling:

  • an agent without associations always appears;
  • an agent with associations appears only if the contact matches all of them (different fields add up: Province = MI and postal code = 20100). For each field the contact must have one of the ticked values, written exactly the same way (upper case, lower case and spaces matter); for dynamic Number and Date fields the From / To range applies;
  • if the contact has no value in the chosen field, that agent does not appear;
  • if no agent matches the rules, the menu is empty and the operator cannot schedule the appointment.

The filter concerns only what the operator sees in the menu: it does not change the agents that can be selected from the administrator's Calendar.

Call script

Optional: the guide text shown to the operator at the bottom of the contact's record during the call, to remind them what to say and what to ask.

You can insert placeholders that will be replaced with the contact's and the operator's data: click one in the list under the field to insert it where the cursor is. For example:

Buongiorno, sono {{Operatore.Nome}} di Esempio Srl. Parlo con {{Nominativo}}? La chiamo per la sua sede di {{Comune}}…

The list offers the database fields used in the filters (including dynamic fields) and the operator's data. You can also type other placeholders by hand with the name of a field of the contact, for example {{Nome}}, {{Cognome}}, {{RagioneSociale}}, {{Nominativo}}. A placeholder that matches no field, or a field that is empty for that contact, stays written as it is.

Saving

Press Create campaign (when editing, Save changes). If all goes well you return to the campaign list; otherwise the reason appears at the bottom, as a red message that disappears after a few seconds, for example "The campaign title is required.", "The end date must be on or after the start date.", "Trunk and numbering are required for Preview, Predictive and VoiceAI campaigns: without them no call can start.", one of the VoiceAI campaign messages (see VoiceAI campaigns) or the Predictive maximum percentage being exceeded.

On creation Thelgo inserts into the campaign the contacts that match the filters and calculates the ordering in the background: for a very large campaign the chosen order may take a few moments to be applied to all contacts.

Editing a campaign

Click the campaign in the list. Before showing the form, Thelgo loads the campaign with a "Loading campaign… %" bar.

Compared with creation:

  • the Database cannot be changed;
  • the Contact filters step is not there: the contacts already in the campaign stay as they are. To add more use Add contacts (see Campaign contacts); there is no command to remove any;
  • in the Ordering and in the agents' filters you see only the values of the contacts already in the campaign;
  • the Type can be changed;
  • if the campaign is Preview, Predictive or VoiceAI and has no trunk or numbering you must choose them before you can save.

Changes apply immediately for operators: script, modules and enabled operators are applied from the next contact they receive.

Private and public callbacks

The campaign always leaves the choice to the operator: when they close with the Call back outcome, the operator indicates whether the callback is Private (theirs only) or Public (anyone working the campaign). See Outcomes and callbacks in the operator manual.

Settings common to all campaigns

Some rules that affect campaigns are not set campaign by campaign, but once for the whole account, in General settings:

Setting What it controls
Contact picking How often to propose a never-contacted contact even if it is at the bottom of the ordering (off, 25%, 33%, 50%, 100%)
Busy / No answer After how many hours (between a minimum and a maximum) to call back a contact that is busy or does not answer, and after how many consecutive attempts to stop
VoiceAI call answered but without an outcome Only with VoiceAI campaigns enabled: if a call the contact answered ends without the bot recording an outcome, it counts as Busy / No answer (with the attempts provided) or as Negative (see General settings)
Maximum attempts (unreachable) Predictive and VoiceAI: after how many consecutive "Unreachable" outcomes to stop calling a number
Courtesy delay (hours) Predictive and VoiceAI: after how many hours to call back a contact who answered when no operator was free
Provvedimento 83 of 20 February 2014 (silent calls) Predictive: Single call and Silent call control, the safeguards of the Privacy Authority against silent calls
Convert to public after After how many consecutive callbacks a private callback becomes public
Custom outcomes Up to three additional outcomes with a name you choose