Skip to main content

Scheduled reports

A scheduled report is a standard report that the PBX e-mails to you on a repeating schedule, as a CSV, Excel or PDF file. Use it for the Monday morning queue summary or the monthly service level that you would otherwise open and export by hand. This page covers creating, pausing and deleting schedules and what happens when a delivery does not work. The reports themselves are described in Reports.

What you need​

  • The reports:read permission. The same permission lets you see the report on screen.
  • An e-mail provider set up for the PBX under Admin, Email provider (see System and operations). Without one the schedule exists but nothing can be sent.
  • An e-mail address on your own user account. The file goes there.

Who receives it​

A scheduled report belongs to the person who created it. Only that person sees it in the list and changes it, and the file is sent to that person's own address only. There is no list of recipients, because reports contain who called whom. If a colleague needs the same report, they create their own schedule, and each one gets exactly the rows their role lets them see.

The rows are decided at the moment the report is sent, not when you create the schedule. A supervisor of one department receives only the rows of that department. If your permission is taken away, or your account is disabled, nothing is sent.

Create a schedule​

  1. Open Contact center, Reports and choose Scheduled reports (/admin/reports/schedules).
  2. Under Report, pick one of: Extension statistics, Queue performance, Agent activity, Service level, Abandoned calls and callbacks, Trunk usage, Ring groups or Calls by outcome code.
  3. For Queue performance, Service level and Abandoned calls and callbacks, Count by lets you choose Event time or Joined in the period, as on the report page.
  4. File is CSV, XLSX or PDF.
  5. Repeats is Daily, Weekly or Monthly.
    • Weekly adds On, the day of the week.
    • Monthly adds Day of the month, from 1 to 28 so that every month has that day.
  6. Time is the hour of the day, on the hour, from 00:00 to 23:00.
  7. Choose Schedule. The new row appears in the table (The report is scheduled.).

You can have up to 20 scheduled reports.

Time zone and period​

The schedule takes the time zone of the browser you created it in and keeps it. The table shows the time with its offset from UTC, for example Every Monday at 07:00 (UTC-05:00). The offset is fixed when you create the schedule. If it is no longer right, for example after a daylight saving change, delete the schedule and create it again.

The report covers the previous complete period in that time zone:

RepeatsPeriod in the file
DailyThe day before
WeeklyThe seven days before
MonthlyThe previous calendar month

If the server was down at the scheduled time, the report is sent when it is back and still covers the period it was meant for. Each schedule is sent once; the server checks for due reports every minute.

Read the list​

The table shows, for each schedule, the Report, when it is Sent (for example Every day at 07:00), the File type, the Next run (or Paused) and the Last run with its result and time.

Pause, resume and delete​

Use the ... menu at the end of a schedule's row.

  • Pause stops sending and the Next column shows Paused. Resume starts it again from the next due time.
  • Delete removes the schedule for good (The schedule is deleted.).
  • To change the report, file, day, hour or frequency, delete the schedule and create a new one. The console has no edit form.

When delivery does not work​

The Last run column tells you what happened at the latest attempt:

ResultMeaning and what to do
SentThe e-mail was handed to the provider. If it does not arrive, check spam and the address on your account.
FailedThe provider refused or could not be reached. The next regular run tries again; nothing is retried in a burst. Check Admin, Email provider.
No e-mail providerThe PBX has no e-mail provider. Ask an administrator to configure one.
Not allowed any moreYou no longer have reports:read or your account is disabled. Ask for the permission back, or delete the schedule.

A run that fails does not stop the schedule. Every send is written to the audit log with the report, file type, number of rows and period, but never the data.

  • Reports: the on-screen reports, their numbers and exports.
  • Users and roles: how department scope decides the rows you receive.