Skip to content

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

  1. Choose the view: Time slots (default) or Calls.
  2. Campaign: All campaigns (default) or just one.
  3. 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.
  4. 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.
  5. 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:

  1. Set campaign and period.
  2. Press Download and choose CSV or XLSX (Excel).
  3. 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.
  4. 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).