Skip to main content

Reports: how to download

A report is a table of calls (one row per call) for offline analysis in Excel or a BI tool, as a CSV or XLSX file. You can download one in two places:
  • In History — with the Export button above the table. The file holds the calls of the current selection, and the export has no period of its own: what you filtered is what you get. How the export panel works is on the History & reports page.
  • On a campaign page — with the Download report button. The Campaign field is set to this campaign; you can pick another one or All campaigns. The period is set right in the report dialog. Built reports are in the Reports window next to it. See A report for one campaign.
The XLSX format includes a summary sheet with totals by status, sentiment and success by default. You can turn it off with the Add a summary sheet checkbox in the export panel (format Excel) or with the Summary sheet setting in the report dialog and in the report template. If no calls match the filters, the export button in the export panel is inactive and the panel says No calls match these filters, so there’s nothing to export. Change the filters first. If the selected period includes today, calls made before the file is ready are included too.

File name

The file name comes from the File name field in the file options. It can use the placeholders {campaign_id}, {campaign_name}, {date} and {template}. The campaign placeholders are filled when the report has one campaign — both in a report from the campaign page and in History when the filter is a single campaign. {template} is the report template name; if the template was edited right in the export window, the placeholder stays empty. Every character other than Latin letters, digits, ., _, - and space becomes _, so a name in Cyrillic turns into underscores. The extension is added automatically. Without a name, the file is named by the report ID.

Report queue

Reports are generated in the background so large exports don’t block the page. In History, created exports are listed in the Recent exports tab of the export panel; on a campaign page, in the Reports window. The list shows the last 100 reports.
  • A report’s status goes Queued → Generating → Ready or Failed. After an ordinary failure the build is retried automatically, and the report shows as Queued again.
  • Reports don’t wait for analytics to finish — calls whose analytics aren’t ready yet are included with empty analytics columns.
  • In Recent exports each export shows the file name, the number of calls, the column set and the creation time. The Reports window on a campaign page also shows Started, Finished, Duration, Rows and Stored until — so you can see whether a report is slow or the queue is stuck.
  • In the Reports window a report that stays in Generating for more than 30 minutes is marked taking longer than usual and keeps going.
  • After 6 hours the build stops with the error The report exceeded the generation time limit — narrow the period or the filter and generate it again: the queue slot is freed and the half-built file is not saved. In History, Change and export on a failed report restores its filters and settings so you can adjust them and export again.
  • Download a ready report with Download in the list. You don’t have to wait with the list open: for your own reports the cabinet shows pop-up notifications. A ready report — for a few seconds, with a Download button; a failure — with the reason and a Try again button. While the Recent exports tab is open there are no notifications — the status is visible in the list. Notifications only reach an open cabinet tab; if the cabinet is closed, the report is still built.
  • The file is kept for 3 days (Files stay available for 3 days.), the exact date is in the Stored until column. After that the file is deleted and the report gets the Expired status. In History, Export again builds it again with the same settings.

Who sees and deletes reports

Admins and developers see all reports of the organization with their authors; managers and members see only their own. Admins and developers can delete a report before its retention period ends. The file disappears for everyone who can see it.

Which period is exported

In History the export period is the period of the Date filter. If none is set, calls for all time are exported. To export a different period, click Change filters in the export panel — the panel closes and you are back at the History filters. On a campaign page there is no History filter, so the period is set in the report dialog with the Period row of two dates. If no period is set, the report takes the last 30 days — a line under the field says so. The Whole history checkbox, visible while no period is set, exports calls for all time.
As soon as the period is edited in the dialog, or the 30-day default is in effect, the dialog doesn’t show the estimated number of calls: it was computed for a different selection.
Heavy reports can occupy the queue. Reports are built in a shared pool with a small number of slots: if large unfiltered reports take them, even a one-row report waits its turn. The time thresholds limit that situation without removing it — the most reliable way to get a file quickly is a narrower period and fewer columns.