> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ringg.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Analytics

> Review call performance, connection rates, costs, and assistant results.

Use **Analytics** to understand how calls are performing across your workspace. It helps business teams answer questions like: Are people picking up? Which assistant is working best? Are calls too short? Are costs aligned with results?

***

## Open Analytics

1. Click **Analytics** in the left sidebar.
2. Review the default date range.
3. Use the date picker or filters to narrow the report.

***

## Set the Date Range

1. Click the date range picker.
2. Choose the period you want to review.
3. Apply the date range.
4. Click the clear icon to reset when needed.

Click **Filter** to narrow results by assistant, number, campaign, status, or other available fields.

***

## Read the Top Metrics

The top cards summarize performance for the selected filters.

| Metric                 | What It Means                                                     |
| ---------------------- | ----------------------------------------------------------------- |
| **Total Calls**        | All calls in the selected period                                  |
| **Calls Connected**    | Calls where a person answered                                     |
| **Connectivity**       | Connected calls divided by total calls                            |
| **Avg. Duration**      | Average call length                                               |
| **Total Cost**         | Credits spent in the selected period                              |
| **Registered**         | Contacts who completed the tracked business action, if configured |
| **Voicemail Detected** | Calls that reached voicemail                                      |
| **Workspace Numbers**  | Active phone numbers in the workspace                             |

***

## Review Call Status Distribution

The call status chart shows how calls ended.

Common statuses include:

* Completed.
* Failed.
* No answer.
* Voicemail.

Use this chart to spot delivery problems. For example, a high voicemail rate may mean you should change calling hours.

***

## Review Calls by Day

The calls-by-day chart shows volume over time.

Use it to find:

* Peak calling days.
* Drops in calling volume.
* Campaign schedule problems.
* The effect of changing numbers, prompts, or calling windows.

***

## Compare Assistants

The assistant table shows performance by assistant.

| Column              | What It Means                         |
| ------------------- | ------------------------------------- |
| **Agent Name**      | Assistant name                        |
| **Call Counts**     | Total calls handled by that assistant |
| **Total Connected** | Calls answered by a person            |

Sort the table to find assistants that need prompt changes, better numbers, or a different audience.

***

## What to Try Next

| If You See                    | Try This                                                                |
| ----------------------------- | ----------------------------------------------------------------------- |
| Low connectivity              | Review caller numbers, calling hours, and audience quality              |
| High voicemail rate           | Shift calls to hours when contacts are more likely to answer            |
| Very short calls              | Listen to recordings and improve the assistant opening line             |
| High cost with low conversion | Improve targeting, prompt logic, or follow-up rules                     |
| One assistant underperforms   | Compare its prompt, voice, and knowledge base against better performers |

***

## Developer Handoff

If engineers are building dashboards or investigating analytics, send them:

| Item                             | Why They Need It                                                     |
| -------------------------------- | -------------------------------------------------------------------- |
| Date range and timezone          | Ensures their report matches the dashboard                           |
| Assistant name and `agent_id`    | Filters analytics to one assistant                                   |
| Campaign name and `bulk_list_id` | Filters analytics to one campaign or uploaded list                   |
| Status filters                   | Explains which calls should be included                              |
| Business metric definition       | Clarifies what counts as registered, qualified, booked, or converted |

For live product dashboards, ask developers to combine analytics APIs with webhook events and call history exports.
