Clean up campaign¶
Requires the "Campaigns" permission.
Clean up campaign puts back among the contacts to be called those that have a certain outcome or status, without deleting them from the campaign and without losing the history of the calls already made. It is useful, for example, to restart a campaign: contacts with the outcome "No answer" from a month ago become contactable again, as if they had never been called.
How to open it¶
In the campaign list click the icon with the sparkles (Clean up campaign) on the campaign's row. The Clean up campaign page opens, which shows for each category how many contacts of the campaign it currently covers.
The page is full width with three columns side by side (on narrow screens they stack one below the other): the first with First-level outcomes, the Options and the Cancel and Clean up buttons; the second with Quality Check outcomes; the third with Other. Next to each item there is the number of contacts it covers. Not authorized has only the number (for example 1) and the text "Cannot be cleaned: the block applies to all campaigns", without a switch. When you choose one or more items, the box "N contacts in this campaign will be cleaned up." appears.
What you can clean up¶
Each item has a switch and, on the right, the number of the campaign's contacts it covers. You can select several items together.
First-level outcomes¶
"Contacts with the selected outcomes become callable again: outcome, attempts and status are reset. The call history remains available at all times."
A switch appears for each active outcome of the account (including the custom outcomes), with the number of contacts that currently have it as their current outcome.
\"Not authorized\" cannot be cleaned up
The Not authorized outcome appears in the list only with the number of contacts and the text "Cannot be cleaned: the block applies to all campaigns", without a switch, and is not included in the "will be cleaned up" total. The "Not authorized" block is on the contact and applies in all campaigns: it is removed only from the contact's details. If the cleanup request included it anyway, the server refuses it with "The "Not authorized" outcome cannot be cleared: the block applies to all campaigns."
The contact goes back to never contacted as far as the first level is concerned: the outcome, the attempts, the date of the next attempt, the operator who gave the outcome, the counters of "Busy / No answer", "Unreachable" and "Call back", and the "no answer" and "unreachable" markings are reset. A private or public callback that is pending is cancelled.
Quality Check outcomes¶
"Independent from the first level: only cleans the quality-check outcome and attempts."
One switch for each Quality Check outcome: it resets the check's outcome, its attempts and its callback date. The contact's first-level outcome (for example Positive) does not change.
Other¶
| Item | What it does |
|---|---|
| No-answer threshold reached | Contacts that have reached the maximum number of "Busy / No answer" attempts and have been marked as no longer contactable (see Automatic callback rules). Full reset of the first level, as for the outcomes |
| Unreachable threshold reached | As above for the contacts marked as unreachable: both those that have reached the maximum number of "Unreachable" outcomes and those excluded because they have no phone number (see below). It appears only for Predictive and VoiceAI campaigns |
| Contact attempts | "Contacts already reached at least once by the system but not yet unreachable or pending: only clears the attempt counter, the outcome stays unchanged." It applies to both the first level and Quality Check |
| Pending callbacks | "Contacts waiting for a scheduled callback (callback, courtesy delay, busy/no-answer wait), first level or Quality Check: only clears the date, the outcome stays unchanged." The contact becomes callable immediately, without waiting for the date |
Putting contacts without a number back on the list¶
In Predictive and VoiceAI campaigns a contact that does not have the number chosen in Phone number to use cannot be called: the engine excludes it as unreachable and continues with the others. In the Predictive/Voice AI report, Calls view, you find for each excluded contact a line with the outcome Error and in the Detail one of these notes:
- "Numero di telefono mancante (il campo Telefono1 è vuoto): il nominativo è stato escluso dalle chiamate automatiche." (Phone number missing (the Phone1 field is empty): the contact was excluded from automatic calls.) (with the campaign's number in place of Phone1);
- "Numero di telefono mancante (nessuno dei numeri di telefono del nominativo è valorizzato): il nominativo è stato escluso dalle chiamate automatiche." (Phone number missing (none of the contact's phone numbers is filled in): the contact was excluded from automatic calls.) (with All).
To put it back on the list:
- Enter the missing number: from the contact's details press Edit and fill in the phone in the Phone numbers section.
- Open Clean up campaign and turn on Unreachable threshold reached.
- Press Clean up and confirm.
The item puts back on the list all the campaign's contacts marked as unreachable, not only those without a number: if there are truly unreachable contacts, they also go back on the list. A contact put back on the list without having entered the number first is excluded again on the engine's next pass.
The options¶
In the Options box, in the first column under the First-level outcomes:
| Option | What it does |
|---|---|
| Only clean up contacts processed before | A date: only the contacts whose last change in the campaign is earlier than or equal to that day are cleaned up. "Leave empty to apply no date limit." It applies to all selected items |
| Clean outcomes only | On (default): "Linked appointments and emails stay untouched." Off: "Linked appointments and emails are also deleted (calls always stay in history)." |
With \"Clean outcomes only\" off, appointments disappear
When you turn the option off, for the contacts cleaned up with the first-level outcomes (and with the threshold items) the scheduled appointments and the linked emails sent are deleted: they disappear from the Calendar and cannot be recovered. Calls always stay in the history and in the call reports, whatever the option. For the Quality Check outcomes, Contact attempts and Pending callbacks items, appointments and emails are never touched.
Starting the cleanup¶
- Turn on the items to clean up and, if needed, set the date limit.
- Check the box "… contacts in this campaign will be cleaned up.": it is the sum of the numbers of the selected items. It appears only if you have selected something.
- Press Clean up. The button stays disabled until you have selected at least one item with contacts. With Cancel you return to the campaign list.
- Confirm the request "Confirm cleanup of … contacts? This cannot be undone."
The cleanup starts in the background: in place of the items "Cleaning up…" appears with a progress bar, the percentage and the count "… / … contacts cleaned up". When it finishes you see "Cleanup completed" and, at the bottom, the message "Cleanup completed: … contacts are callable again."; if something goes wrong "Cleanup failed" and the message "The cleanup failed." appear. With Back you return to the campaign list.
The number in the preview is an overestimate
The "will be cleaned up" box (and the number in the confirmation request) adds up the numbers of the chosen items: a contact that falls in more than one item (for example an outcome and also "Contact attempts") is counted several times. The cleanup applies the items one after the other and counts how many contacts it really touches in each step: what one step has already reset is not found again by the next. The final number "callable again" is therefore usually lower than the estimate and the progress bar can stop below 100% even when the cleanup is complete (for example with Positive, Busy / No answer and Contact attempts together: estimate 10, final "7 / 10 contacts cleaned up", bar at 70%). A contact can be counted twice only if after the first step it still falls in another item (for example it has a Quality Check outcome and contact attempts).
After the cleanup¶
- Cleaned-up contacts are immediately available to operators (and to the Predictive engine) according to the campaign's normal rules, like never-called contacts.
- Thelgo recalculates the ordering of the campaign in the background (you see it in Operations): for example never-contacted contacts go back to the position given by the chosen ordering.
- The operation is recorded in Operations (type Campaign cleanup) and in the Audit log (action Campaign cleaned up, detail "Campagna '…' pulita: … nominativi tornati contattabili." (Campaign '…' cleaned up: … contacts are callable again.)).
- They do not change: the call history, the general Not authorized block (a contact who asked not to be called again stays blocked: the Not authorized outcome cannot be cleaned up from here, the block is removed from the contact's details) and the campaign's contact blocks.
Contacts being worked on are not touched
Pending contacts that an operator is working on at that moment (a call in progress or a contact opened with the lock still valid) are neither counted nor cleaned up by the Pending callbacks item, by the Attempts items and by the cleanup by date. However, Thelgo does not prevent cleaning up the campaign while someone is working on it (unlike deletion): if you can, suspend it and wait for operators to leave it.
The operation cannot be undone
Outcomes, attempts and callbacks that have been reset cannot be recovered. If you are not sure, use the date limit to clean up a restricted group, or a block to exclude contacts without touching their outcome.