Operations¶
Requires the "Operations" permission.
Some activities on large amounts of data do not happen instantly: Thelgo runs them in the background and records them as operations. On the Operations page you follow their progress, check their result row by row and download the export files.
You open the page from the menu LOGS → Operations. You also get there from the View operation log button at the end of an import, and from the reports when you start an export.
The page can be filtered on a date range chosen with Set date (Date column). It lists imports (Completed and Completed with errors) and ordering recalculations, with total, imported, discarded and errors. Click a row to open its log.
Operation types¶
| Type | When it arises | What the figures count |
|---|---|---|
| Contact import | You confirm an import | Rows of the file: imported, discarded as duplicates, in error |
| Database deletion | You delete a database | Contacts deleted (Imported column) out of the total |
| Campaign deletion | You delete a campaign | Campaign contacts processed (Imported column) |
| Campaign cleanup | You start Clean up campaign | Contacts cleaned (Imported column); the Total is an overestimate |
| Database correction | You start Correct database | Rows of the correction file: Imported are the contacts updated, Discarded the rows skipped, not found or in conflict, Errors the invalid rows |
| Database export | You export a database from the Databases page | Contacts exported (the Total is the number of contacts in the database) |
| RPO list extraction | You press Extract list in the Public Opposition Register section of a campaign (see RPO) | Phone numbers extracted. The file is a zip with the list to upload to the Register's portal |
| RPO list import | You import the validated list received from the Register for a campaign | Rows of the Register's file: Imported are the contacts updated (blocked or unblocked for the campaign), Discarded those not found in the database or no longer in the campaign, Errors the invalid rows |
| Legacy migration | The super admin (whoever manages the platform) transfers into Thelgo the data of an account from the previous software; you do not start it | Items processed by each phase of the migration |
| Contact anonymization | You start the anonymization from a list of numbers (Databases → Anonymize) | Rows of the file: Imported are the rows that found one or more contacts, Discarded the rows not found, Errors the rows with an invalid number |
| Ordering recalculation | You create a campaign, change the ordering of its contacts (see Campaign configuration) or add contacts with Add contacts (see Campaign contacts) | Campaign contacts reordered |
| Campaign contacts export | You export contacts from the Campaigns report | Contacts exported. The file includes the Id Nominativo column |
| Calls export | You export the Calls report | Calls exported |
| Predictive/Voice AI calls export | You export the Predictive/Voice AI report | Calls exported |
For operations other than the import, the Imported column simply indicates how many rows were processed.
The list¶
Under the title you see how many operations are recorded in total (e.g. "48 operations recorded"). The list starts from the most recent.
| Column | What it shows |
|---|---|
| Date | Start date and time |
| Type | The type of operation (see above) |
| File / Database | The name of the file (imported or exported), followed by "→" and the destination database for imports. For deletions, the name of the database or campaign deleted |
| Total | Rows or contacts to process |
| Imported | Rows imported (or processed) |
| Discarded | Rows discarded as duplicates (imports only) |
| Errors | Rows in error (imports only) |
| Status | See below |
| Download button, for exports with the file ready |
Click a column header to sort the list.
The statuses¶
| Status | Meaning |
|---|---|
| In progress | The operation is still working. Reload the page to update the figures |
| Completed | Finished without errors |
| Completed with errors | Finished, but some rows were not imported because they were not valid: check the log |
| Failed | Interrupted by an unexpected problem. What was processed up to that moment stays (e.g. the contacts already imported, or already deleted) |
Filtering the list¶
When you open the page you only see today's operations
The default period is Today. If you are looking for an operation from yesterday or from previous days, change the period and press Filter: the count under the title, instead, includes all operations.
| Filter | Options |
|---|---|
| Type | All or one of the types present in the list |
| Status | All or one of the statuses present in the list |
| Period | Today, Yesterday, This week (from Monday to today) or Set date, which shows the From and To dates |
The choices only apply when you press Filter.
Downloading an export¶
Report exports are not downloaded immediately: the report shows "Export started: the file will be downloadable shortly from the Operations page." Then:
- Open Operations (if needed, reload the page until the status is Completed).
- Press Download on the export's row.
The file is a CSV or an Excel, depending on the format chosen in the report, with a name that contains the date and time of the export in the account's time zone (e.g. chiamate-20261023093015.csv). Dates and times written in the file of the Calls and Predictive/Voice AI reports are also in the account's time zone, the same as the ones you see on screen. Exports remain downloadable on the following days too (just change the period), until they are deleted by the automatic cleanup (see Automatic cleanup).
Exports and permissions
To download the file you need the "Operations" permission. An administrator who can export a report but does not have this permission starts the export but cannot download its file. For the file of a Database export you also need the "Download databases" permission: without it, the Download button does not appear on those rows (even for exports already generated).
Report exports that contain personal data are also recorded in the Audit log.
The log of an import¶
Click an operation to open the Operation log: one row for each row of the file, with:
| Column | Content |
|---|---|
| Row | The row number in the file, counting the first row of the file (header included) as row 1. This way you find it right away in Excel |
| Outcome | Imported, Discarded (duplicate) or Error |
| Message | The reason for the discard or error (e.g. "Telefono '0212345678' già presente nel database." (Phone '0212345678' already present in the database.), "Numero di telefono mancante." (Phone number missing.)) |
At the top you can filter the log with All, Errors and Discarded (in brackets the number of rows of each group). Discarded contains only the Discarded (duplicate) rows of the imports: the rows skipped, not found or in conflict of a database correction and those of the RPO lists are only seen in All. With Download log (CSV) you download the rows currently visible: for example, filter on Errors and download, so you have the list of only the rows to fix. The CSV opens directly in Excel. For an import filtered on Errors, the log shows for each row in error the file row number and the message.
The meaning of the discards and errors of an import is explained in Importing contacts.
Database correction, RPO list import and Contact anonymization also have a row-by-row log. For the correction the outcomes are Updated, Skipped (empty check field), Not found, Discarded (phone conflict) and Error (see Correct database). For the RPO list the outcomes are Not found, Error, Blocked (RPO) (the contact was blocked for the campaign) and Unblocked (RPO) (unblocked). For the anonymization the outcomes are Updated, Not found and Error (see Anonymization).
The other operations (deletions, recalculations, exports, RPO extraction) do not have a row-by-row log: opening them shows "No rows recorded.".
Correct and re-import only the wrong rows
- Filter the log on Errors and press Download log (CSV).
- In the original file, fix the rows indicated and delete all the others (keep the header row).
- Import the corrected file into the same database. Even if you miss some row already imported, no duplicates are created: it will be discarded as a duplicate.
Automatic cleanup¶
To avoid accumulating operations and files forever, Thelgo deletes every night the finished operations older than a number of days. This number cannot be set from the General settings: it is decided by whoever manages the platform, with a single value for all accounts.
- If the cleanup is active, at the top of the page, under the title, you read "Completed operations older than N days are automatically deleted every night, together with their files." If you do not see this line, the cleanup is disabled and operations have no expiry.
- The finished operations (Completed, Completed with errors, Failed) are deleted, together with their row-by-row logs and the export files: after the cleanup you can no longer download them.
- The day count starts from the end of the operation. Operations In progress are never deleted.
- No trace of the cleanup is left (not even in the Audit log).