Campaign contacts¶
Requires the "Campaigns" permission.
A campaign's contacts are chosen when it is created, with the filters on the database (see Create and edit a campaign). From that moment the campaign is a "snapshot": contacts added to the database later do not enter by themselves. This page explains how to add more contacts to an existing campaign and how to search for a contact among those of the campaign.
How new contacts enter a campaign¶
| Way | When to use it |
|---|---|
| Add contacts from the campaign list | The contacts are already in the database and you want to widen the campaign (e.g. add a province) |
| During the import of a file into the database | You are uploading new contacts and want them to also go straight into one or more campaigns (see Import) |
| Entry by the operator | Operators with the "Insert contacts" permission can create a new contact directly in the campaign (see Contact search and entry in the operator manual) |
There is, however, no command to remove contacts from a campaign. To temporarily exclude some from calls, without removing them, use Contact blocks; to make them start again after an outcome, Clean up campaign.
Adding contacts¶
In the campaign list click the person-with-+ icon (Add contacts) on the campaign's row.
The page shows the Current filters on this campaign, that is those chosen at creation (or after the last addition). There is only one rule: you can only widen, never narrow.
- You cannot add or remove filter fields.
- In list fields, the values already present are ticked and locked; below you find the other values present in the database and you can tick new ones. To find one you do not see, type it in the search field and press Enter or the magnifying glass.
- In range fields (Number or Date) you can only widen the From / To ends: next to them you see the Current range. If you type a value that would narrow the range, it is immediately brought back to the current limit.
If the campaign was created without filters, "This campaign has no filters: all contacts in the database not yet in the campaign will be proposed." appears: in this case the addition inserts in one go all the contacts of the database that are not yet in the campaign, for example those imported after its creation. With a filtered campaign, the current filters to widen appear here instead.
Procedure¶
- Tick the new values or widen the ranges.
- Check the box "… new matching contacts": it counts only the contacts that are not yet in the campaign.
- Press Add contacts. The button stays disabled until there is at least one new contact to add.
- Done appears with "… contacts added to the campaign." Press Back to return to the campaign list.
With Cancel you return to the list without adding anything. If the addition fails, "Unable to add the contacts." (or the reason given by Thelgo) appears as a red message at the bottom.
After the addition:
- the campaign's filters are updated with the new values: the next time you open Add contacts you will start from these;
- no contact already present is touched or removed, nor are its outcomes or callbacks;
- the new contacts are immediately available to operators, as never-called contacts, except those that match an active block on the campaign: they are born already blocked;
- if the database is subject to the Opposition Register, remember that the new numbers must be checked: see Public Opposition Register (RPO).
Position of the new contacts in the queue
After the addition Thelgo recalculates the campaign's ordering in the background (you see it in the Operations page as "Ordering recalculation"): the new contacts are put in their place according to the ordering chosen for the campaign, no longer at the bottom. If the ordering is Random, the recalculation randomly reshuffles the order of all the campaign's contacts, the old ones included. Until the recalculation is finished the new contacts stay at the bottom. The Contact picking in General settings keeps periodically inserting a never-contacted contact.
Searching for a contact in the campaign¶
In the campaign list click the magnifying glass icon (Search) on the campaign's row. The Contact search page opens with the subtitle "Search among the contacts enrolled in this campaign": the search is limited to the contacts of this campaign.
The criteria are the same as in the general search:
| Field | What it searches |
|---|---|
| Name / Surname / Company name | The text in any of the three fields |
| Phone | The number in any of the contact's nine phones |
| Other field + Search text | Another field of your choice, fixed or dynamic, of the campaign's database |
Fill in at least one criterion and press Search (or Enter). If you fill in more than one, the contact must match all of them. In the results (500 at most) you see Company name, First name, Last name, Phone, Email and City; with Filter results… you narrow the list without repeating the search. Clicking a result opens the Contact details, where you also find the contact's status in each campaign (current outcome, calls made, attempts).
The whole operation of the search and of the contact details is described in Contacts. The Email in the results is a clickable link (it opens the mail program).
Changing or removing a contact's outcome¶
If you open a contact from a campaign's search (not from the general search nor from a database's search), in the Contact details, next to the name of that campaign in the list of campaigns, the Edit outcome button appears. It lets you record, change or remove by hand the outcome of that contact in that campaign, without going through an operator.
- Press Edit outcome: the Edit outcome — window opens, followed by the campaign name.
- If the campaign has Quality Check, choose the level, First level or Quality Check. Below you see the Current outcome (or "No outcome").
- Choose the New outcome among the buttons.
- If the campaign has an outcome profile with details for the chosen outcome, the Outcome detail drop-downs appear and, if the chosen detail has second details, Second detail. For the administrator they are always optional; when you change outcome the choice is reset. If the campaign has no profile, or the profile has no details for that outcome, the drop-downs do not appear.
- Choose the Operator (required): the outcome is attributed to them. Only the operators enabled for the campaign are offered ("The selected operator is not enabled for this campaign." otherwise).
- Write the Notes if needed. For the outcomes that require it (Call back) enter Callback date and time (not in the past: "The callback date cannot be in the past.") and, if the campaign provides for it, the Callback type, Private or Public.
- With the Positive outcome, if the campaign has the Agenda Management module, you can press Schedule appointment and fill in Title, Start, End, Agent and Notes. If the campaign requires the appointment on Positive, "Scheduling an appointment is required for a Positive outcome." appears; you cannot schedule it at a date that has already passed ("You cannot schedule an appointment at a date/time already in the past.").
- Press Save: "Outcome saved successfully." appears.
To remove the outcome press Remove outcome and confirm "Remove the last outcome recorded for this level? This rolls back the outcome and the attempts, but not the other statistics, and cannot be undone.": the last call recorded for that level is deleted and the current outcome goes back to that of the previous call (or to "no outcome" if there are none). The Attempts (or the Quality Check attempts) also go back to the value they had after that call, or to 0 if none remain. If there is nothing to remove, "There is no outcome to remove for this level." appears.
The window shows the level, the Current outcome ("No outcome"), New outcome, Operator, Notes and the Remove outcome, Cancel and Save buttons. With a Negative outcome chosen, the Outcome detail and Second detail drop-downs appear below, before the Operator field.
What to keep in mind
- The outcome follows the same rules as an outcome given by an operator (callbacks, appointment, email to the agent, webhook), but it does not correspond to a phone call: it does not generate a real call and is left out of the Predictive/Voice AI report.
- Remove outcome cannot be undone. The Attempts counter is realigned: it goes back to the value of the most recent remaining call, or to 0 if none remain. The confirmation text says so: it rolls back the outcome and the attempts, but not the other statistics. If the previous attempts did not come from recorded calls, after the removal Attempts can go back to 0 even if it was higher before. The other statistics are not recalculated.
- The confirmation of Remove outcome is the browser's confirmation window. If you press Remove outcome when there is no outcome, "There is no outcome to remove for this level." appears at the top of the window.
- In the Audit log the lines read "Esito "NEGATIVO" (PrimoLivello) impostato da amministratore sulla campagna
, attribuito all'operatore …" (Outcome "NEGATIVO" (PrimoLivello) set by administrator on campaign , attributed to operator …) and "Esito di livello PrimoLivello rimosso da amministratore sulla campagna." (PrimoLivello-level outcome removed by administrator on campaign .) . Nothing appears in the Operations page: they are not background operations. - Both actions are recorded in the Audit log ("Outcome set by administrator", "Outcome removed by administrator").
The Back button
From this search, Back takes you to the campaign's edit page, not to the campaign list. From there you return to the list with ← Campaigns, without saving anything.