Predictive/Voice AI report¶
Requires the "Predictive/Voice AI report" permission.
The Predictive/Voice AI report (menu REPORT → Predictive/Voice AI) shows the calls launched automatically by the engine in Predictive and Voice AI campaigns: how many were launched, how many were answered, how many were passed to an operator, how many were lost and, for VoiceAI campaigns, how many were handled by the bot.
Work groups: choose a campaign
If your account has work groups and you do not have the All work groups permission, you cannot choose All campaigns: you must choose a campaign. The All campaigns item stays in the selector, but if you choose it the page shows only "Unable to load the report.": choose a campaign.
The menu item appears only if your account has enabled at least one of the two campaign types, Predictive or Voice AI. In the report you find only the campaigns of these two types: Preview campaigns do not launch automatic calls and never appear.
The Campaigns permission is also required
The report loads the account's campaign list: without the "Campaigns" permission as well (Operations group) the page shows "No Predictive or Voice AI campaign present.".
How an automatic call is classified¶
Every call launched by the engine ends up in one of these categories:
| Category | What happened |
|---|---|
| Transferred | The contact answered and was passed to an operator |
| Lost | The contact answered but there was no operator to pass them to (none free, or extension not reachable): for the contact it is a "silent" call |
| No answer | The contact did not answer or was busy |
| Unreachable | The number does not exist or the call was rejected, or the phone system never reported the outcome |
| Error | The launch failed before reaching the phone system (for example because of a missing phone configuration) or the contact does not have the number chosen for the campaign and the engine excluded it (the Detail starts with "Numero di telefono mancante" (Phone number missing); to put it back in the list see Clean up campaign) |
| In progress | The call has not ended yet |
| Handled by the bot | Only VoiceAI campaigns: the contact answered and the conversation was handled by the bot, which recorded an outcome, without an operator intervening |
| No outcome from the bot | Only VoiceAI campaigns: the contact answered but the call ended without the bot recording an outcome (and the VoiceAI call answered but with no outcome setting is on Busy/No answer) |
Answered are the calls the contact really answered: Lost + Transferred. No answer and Unreachable count only in the total of calls.
Bot calls: a call passed to an operator stays Transferred
If in a VoiceAI campaign the bot passes the call to a person, the row is Transferred (as in Predictive) and the Detail shows the outcome saved by the operator. Handled by the bot and No outcome from the bot are the calls in which no human operator intervened. If in the general setting you chose Not interested (Negative outcome), a call answered but with no outcome appears as Handled by the bot with a Negative outcome, not as No outcome from the bot.
A transferred call stays Transferred
When an answered call has been passed to an operator, the call closure reported by the phone system does not reclassify it as No answer.
Outcomes set by an administrator do not appear
An outcome recorded without a real phone call (by an administrator with Edit outcome, see Campaign contacts, or through the public APIs) does not go through the engine and is excluded from this report, so it does not appear as a "Transferred" call that never happened. The exception is the outcome recorded by the bot of a VoiceAI campaign, because in that case the phone call really happened: it appears as Handled by the bot.
Filters¶
- Choose the view: Time slots (default) or Calls.
- Campaign: All campaigns (default) or just one.
- Period:
- Today and Yesterday cover only the Working hours set in General settings, not the whole day, so as not to fill the chart with empty night hours. The hours are read with the "Calendar" permission: if you do not have it, the 08:00–20:00 band is used;
- This week goes from Monday to today, whole days;
- Set date lets you choose date and time for From and To.
- Only in the Time slots view: Detail, the width of each slot, from 10 min to 24 h. The default value is 1 h; choosing This week it switches by itself to 24 h (one slot per day), choosing Today or Yesterday it goes back to 1 h.
- Press Filter.
Time slots view¶
At the top is a bar chart with, for each slot, Calls, Answered, Transferred and Error. Below is the table, with the % lost column. At the end of the table are the Total row and the note on Provvedimento 83/2014 (Order 83/2014).
| Column | Content |
|---|---|
| From / To | Start and end of the slot |
| Calls | Calls launched in the slot |
| Answered, Lost, Transferred, Error | Number and, in brackets, percentage of the total calls of the slot |
| % lost | The lost call rate (see below). "—" if nobody answered in the slot |
Bot calls in the Time slots view
This view has no columns for Handled by the bot and No outcome from the bot. A No outcome from the bot call counts only in the total of the slot's Calls. A Handled by the bot call counts in the total and, as with transferred ones, has an associated system operator (VoiceAI (system)): in the slot's Transferred and Answered columns it can therefore appear together with the calls passed to an operator. To tell them apart use the Calls view.
All the period's slots are shown, even those with no calls. The last row, Total, sums the whole period. If there are no slots to show you read "No calls in the selected period.".
The lost call rate (silent calls)¶
The % lost column is calculated as Lost / (Lost + Transferred), that is on only the calls the contact answered. It is the indicator required by the Italian Privacy Authority Order no. 83/2014 on telemarketing "silent" calls, with an attention threshold of 3%: values above 3% are highlighted in red, both per slot and in the total.
Keep an eye on the 3%
A high percentage of lost calls means the engine launches more calls than the connected operators can handle: too many contacts answer and find silence. Increase the operators connected to the campaign, turn on Silent call control (see below) and, if the problem persists, contact the Thelgo provider.
The automatic silent call control uses a different calculation
In General settings, Silent call control slows the engine down when the Maximum silent call percentage is exceeded in the last hour. That control calculates the lost calls on the total calls launched by the campaign in the last hour, not on only the answered ones: the two values may therefore not match the % lost column of this report.
Calls view¶
One row for each call launched by the engine, with outcome badges (for example Unreachable, Transferred, In progress), the Detail column, the total and the Back/Next buttons at the bottom (the buttons are on the left and the total next to them).
One row for each call launched by the engine, 100 per page:
| Column | Content |
|---|---|
| Contact | Company name or first and last name |
| Phone | Number called |
| Campaign | Campaign of the call |
| Start / End | Date and time, with seconds |
| Outcome | The call's category (see the first table), with a different color for each |
| Detail | For transferred calls and those handled by the bot, the saved outcome; otherwise the call end cause reported by the phone system, or the reason for the error |
At the bottom you find the Back and Next buttons to scroll through the pages and, next to them, the Total of calls (the buttons are on the left, because on the right there is the chatbot bubble).
Export the calls¶
The Download button appears at the top right only in the Calls view:
- Set campaign and period.
- Press Download and choose CSV or XLSX (Excel).
- The green notice "Export started: the file will be downloadable shortly from the Operations page." appears at the bottom (there is no link: open Operations yourself from the LOGS menu). If it does not start, the red notice "Unable to start the export." appears.
- Download the file from the Operations page.
The file includes all the calls of the period, not only the page displayed, with the columns Id Nominativo, Nominativo, Telefono, Rif. 1, Rif. 2 (Contact ID, Contact, Phone, Ref. 1, Ref. 2: the Reference ID 1 and 2 fields of the contact), Campagna, Inizio, Fine, Esito and Dettaglio (Campaign, Start, End, Outcome and Detail). The Outcome column shows the call's category with the same label you see on screen (Unreachable, No answer, Lost, Transferred, Error, In progress, Handled by the bot, No outcome from the bot).