Analytics
The Analytics section of the sidebar holds the pages that show your call data: calls in progress, queue views, call history and webhook delivery, plus the API keys that give other systems access to it.
OPBX has no single "Reports" page. Each kind of call data has its own page: the Dashboard, live views, call history, queue reports and campaign analytics. This page tells you which one to open for a given question, and who can see it.
Pages in this section
In the order of the sidebar:
- Live Calls — monitor, disconnect and coach active calls in real time
- Queues Dashboard — how long callers are waiting in each queue, and which agents are free
- Queue Reports — how each queued call ended (answered, abandoned, overflow), with CSV export
- Call Logs — who called whom, when, for how long and with what result, with CSV export
- Call Notifications — webhook notifications for call events, and their delivery log
- API Keys — Owner-managed scoped API keys with per-resource read/write permissions
Purpose
Use this page to find:
- the report that answers your question;
- which roles can open it;
- which reports can be exported to CSV.
Which report answers which question
| Question | Open | Sidebar section |
|---|---|---|
| What is happening right now, in numbers? | Dashboard | Top level |
| Which calls are up right now, and on which extension? | Live Calls | Analytics |
| Who called whom, when, for how long, with what result? | Call Logs | Analytics |
| How long are callers waiting in each queue, and which agents are free? | Queues Dashboard | Analytics |
| How did each queued call end (answered, abandoned, overflow)? | Queue Reports | Analytics |
| How is an outbound campaign progressing? | Auto Dialer Real Time Monitor | Apps and Security → Auto Dialer |
| Were our call events delivered to our webhook? | Call Notifications, delivery log | Analytics |
| How often was a blocked caller turned away? | Inbound Blacklist, Blocked Count column | Apps and Security → Security |
Who can see what
| Report | Owner | PBX Admin | PBX User | Reporter | Supervisor |
|---|---|---|---|---|---|
| Live Calls | Yes | Yes | No | Yes, read-only | Assigned scope |
| Call Logs | Yes | Yes | Own calls only, read-only | Yes, read-only | Assigned scope, read-only |
| Call Logs CSV export (button) | Yes | Yes | No | No | No |
| Queues Dashboard, Queue Reports | Yes | Yes | No | Yes | No |
| Auto Dialer Real Time Monitor | Yes | Yes | No | Yes | No |
| Call Notifications delivery log | Yes | Yes | No | No | No |
| Inbound Blacklist counts | Yes | Yes | No | No | No |
Every role can see the Dashboard; see Dashboard → Who can see it.
"Assigned scope" means calls to or from the users and ring groups assigned to the Supervisor. See Supervisors.
"Own calls only" means calls of the PBX User's own extension(s) or to them, whatever Caller ID the call presented; the server enforces it on the list, single call, statistics and CSV export. See Call Logs.
The table shows what each role reaches through the sidebar. Several of these endpoints are readable by more roles through the API; the module pages describe the exact server rules.
Workflows
Export a report to CSV
Who can do this: Owner and PBX Admin for call records (the Export button is hidden for other roles); Owner, PBX Admin and Reporter for queue calls.
- Open the report page and apply the filters you need.
- Click Export (Call Logs) or Export CSV (Queue Reports). The browser downloads the CSV file.
The step-by-step workflows are on Call Logs and Queue Reports.
| Data | How to export | Format |
|---|---|---|
| Call records | Call Logs → apply filters → Export | CSV, produced in chunks of 1000 rows |
| Queue calls | Queue Reports → apply filters → Export CSV | CSV |
Exports use the same filters as the list on screen. Call records older than 6 months are not in Call Logs; see Call Logs → Retention and archive.
Call statistics
The call statistics are available through the API only (GET /v1/call-detail-records/statistics); the app has no screen for them. They cover the from_date to to_date range (default: the last 30 days) and the Supervisor scope for a Supervisor:
| Metric | Meaning |
|---|---|
| Total calls | Number of call records |
| Total duration | Sum of call durations, in seconds |
| Total billable seconds | Sum of answered (billed) seconds |
| Average duration | Average over calls with a duration above zero |
| Total cost | Sum of the sell cost reported by Cloudonix |
| By disposition | Count per final disposition, for example CONNECTED, NO_ANSWER, BUSY, FAILED |
Queue statistics (waiting and handling times, answered, abandoned and overflow counts) are on each queue's Statistics tab. See Call Queues.
Data retention
| Data | Kept |
|---|---|
| Call records (Call Logs) | 6 months in the main database, then 6 more months in an archive reachable by API key, then 7 years in compressed files for the platform owner |
| Live-call events | 30 days |
| Queue calls, auto-dialer call sessions | 6 months |
| Call notification and blocked-call logs | 90 days |
Every period can be changed by environment variables. See the Configuration Reference.
Related API endpoints
| Method | Endpoint | Purpose |
|---|---|---|
| GET | /v1/call-detail-records | Call records |
| GET | /v1/call-detail-records/export | CSV export |
| GET | /v1/call-detail-records/statistics | Totals and counts by disposition |
| GET | /v1/session-updates/active | Active calls |
| GET | /v1/session-updates/active/stats | Active-call counts and durations |
| GET | /v1/queue-calls | Queue call rows |
| GET | /v1/queue-calls/export | Queue call CSV export |
| GET | /v1/dashboard/supervisor | Supervisor dashboard data |
Scoped API keys can be limited to just these resources (for example call-detail-records and dashboard read-only). See API Keys.
See the OPBX REST API reference for full schemas.
Related modules
- Dashboard — the counters and last calls you land on after signing in
- Call Logs — call history, filters, recordings and export
- Live Calls — calls in progress
- Call Queues — queue live views, statistics and reports
- Supervisors — scoped reporting for team leads