> For the complete documentation index, see [llms.txt](https://docs.ixhello.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ixhello.com/ixhc2/campaign-management/agentic-reporting.md).

# Agentic Reporting

### Overview

Agentic Reporting provides a flexible and intelligent reporting experience that enables users to view, create, customize, and share dashboards and reports within their organization. It combines predefined dashboards, customizable reporting capabilities, AI-assisted report generation, and collaborative dashboard management to help users gain deeper insights into both inbound and outbound activities.

Unlike traditional reporting systems that are limited to a predefined set of reports, Agentic Reporting allows users to create tailored visualizations and reports that meet unique business requirements while maintaining organizational governance and security.

***

## Key Capabilities

### Standard Reporting Dashboards

Agentic Reporting includes a set of out-of-the-box dashboards that provide visibility into operational and campaign performance.

#### Inbound Reporting

Inbound dashboards provide insights into assistant and flow performance.

Key metrics and visualizations include:

* Total conversations
* Average conversation duration
* Transfers and transfer destinations

<figure><img src="https://4187494610-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFe4cpY1jy0FJ4kgC7wSx%2Fuploads%2FSsqcc4vvJF7DdZRsDo1N%2Fimage.png?alt=media&amp;token=e8a96797-7aaf-4bfa-9cfc-feae94749fb9" alt=""><figcaption></figcaption></figure>

* Conversation outcomes

<figure><img src="https://4187494610-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFe4cpY1jy0FJ4kgC7wSx%2Fuploads%2FCMwVtekDwaUbN9YYSx7M%2Fimage.png?alt=media&amp;token=36d5b51e-47a9-4ab3-b72c-73c113186c98" alt=""><figcaption></figcaption></figure>

* Channel distribution
* Contact volume by day
* Transfer volume over time

<figure><img src="https://4187494610-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFe4cpY1jy0FJ4kgC7wSx%2Fuploads%2FbJ80f1hsrXeNhY4bfVxc%2Fimage.png?alt=media&amp;token=038decda-8e2f-462b-a1ab-5cbf59a3e364" alt=""><figcaption></figcaption></figure>

* Heat maps showing activity by date and time

<figure><img src="https://4187494610-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFe4cpY1jy0FJ4kgC7wSx%2Fuploads%2FdbeMkn52yxMqcj5zdurt%2Fimage.png?alt=media&amp;token=287c073a-3b68-4776-95af-d52a7e38cd08" alt=""><figcaption></figcaption></figure>

* Outcome trends
* Performance comparison across assistants and flows

<figure><img src="https://4187494610-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFe4cpY1jy0FJ4kgC7wSx%2Fuploads%2FyjXSA4kimKBJBjt0IEDn%2Fimage.png?alt=media&amp;token=8ecd74b2-c900-4d5f-8f8e-ee39ed5f1dbf" alt=""><figcaption></figcaption></figure>

***

#### Outbound Reporting

Outbound dashboards focus on campaign execution and outcomes.

Key reporting views include:

* Campaign funnel analysis
  * Dialed
  * Reached
  * Conversation completed
  * Objectives achieved

<figure><img src="https://4187494610-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFe4cpY1jy0FJ4kgC7wSx%2Fuploads%2FtRgeqszb3TYnbqNB4UBw%2Fimage.png?alt=media&amp;token=e0e13556-2791-4660-85dc-83b03f73d967" alt=""><figcaption></figcaption></figure>

* Campaign outcome analysis
* Objective completion tracking

<figure><img src="https://4187494610-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFe4cpY1jy0FJ4kgC7wSx%2Fuploads%2FGYAiHCuy0BEdqIpl03Jv%2Fimage.png?alt=media&amp;token=b314669f-39b2-4a1a-a8fd-a47ae97c70c4" alt=""><figcaption></figcaption></figure>

* Transfer volume over time
* Reachability statistics

<figure><img src="https://4187494610-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFe4cpY1jy0FJ4kgC7wSx%2Fuploads%2FTDRD0I1psocRaDvHAbwb%2Fimage.png?alt=media&amp;token=d86dcd68-cadb-47eb-a2f1-9eacb14ee3af" alt=""><figcaption></figcaption></figure>

* Channel mix reporting
* Campaign performance trends

<figure><img src="https://4187494610-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFe4cpY1jy0FJ4kgC7wSx%2Fuploads%2FM0os1OKCYrk3x3x5b9ik%2Fimage.png?alt=media&amp;token=78f55539-ed9a-43a4-b2dc-9766df0ef8f6" alt=""><figcaption></figcaption></figure>

***

#### Campaign Export Reports

Campaign Export Reports allow users to generate tabular reports containing campaign-specific information.

Example report fields include:

* Customer Name
* Customer ID
* Customer Phone Number
* Time Zone
* Campaign Information
* Recording References
* Campaign Attributes

<figure><img src="https://4187494610-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFe4cpY1jy0FJ4kgC7wSx%2Fuploads%2F4xbAxxyT3ITqVtEHTBhW%2Fimage.png?alt=media&amp;token=d73eb30b-c61d-4e03-80e6-2145108fbf49" alt=""><figcaption></figcaption></figure>

Report data can be exported in CSV format for further analysis.

***

## How Agentic Reporting Works

### Dashboard-Based Architecture

Reporting is delivered through dashboards composed of individual widgets.

<figure><img src="https://4187494610-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFe4cpY1jy0FJ4kgC7wSx%2Fuploads%2FykBOGDslTxcYHeBujoCs%2Fimage.png?alt=media&amp;token=93b771d2-73c4-4bd8-8531-9ba88f692b2e" alt=""><figcaption></figcaption></figure>

Each widget defines:

* The data query to execute
* The visualization type to render
* Display formatting and presentation options

Common widget types include:

* KPI cards
* Charts
* Trend graphs
* Heat maps
* Funnel visualizations
* Tables

<figure><img src="https://4187494610-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFe4cpY1jy0FJ4kgC7wSx%2Fuploads%2FYzMqxvNoHzY0cXCnKANY%2Fimage.png?alt=media&amp;token=8a96acbc-3f24-4dda-9a50-65768885a28d" alt=""><figcaption></figcaption></figure>

Multiple widgets can be combined within a dashboard to provide a comprehensive view of business performance.

***

### Reporting Engine

The reporting engine serves as the central component responsible for:

* Executing report queries
* Rendering dashboard widgets
* Managing dashboard versions
* Enforcing organization-level data access controls
* Retrieving and combining report data

The reporting engine obtains data from:

#### Data Warehouse

The primary source for reporting metrics and operational analytics.

This is the same underlying reporting data used across the platform's reporting ecosystem.

#### Internal V2 Database

Used to supplement reporting with campaign-related information that is not currently available in the data warehouse.

Examples include:

* Contact details
* Campaign contact names
* Time-zone information
* Campaign-specific attributes

When required, the reporting engine combines data from both sources to provide a unified reporting experience.

***

## Organization-Based Reporting

All reports are organization scoped.

To ensure secure access:

* Every report query is automatically constrained to the user's organization.
* Users can only access data belonging to their organization.
* Reporting remains governed within platform-defined boundaries.

This provides a secure and controlled reporting environment while allowing reporting flexibility.

***

## User Roles

### Report Viewer

Report Viewers can consume reporting content but cannot modify reporting assets.

Capabilities include:

* View standard dashboards
* View shared dashboards
* Filter report data
* Export supported report results
* Ask questions about report data using AI-assisted insights

Accessible dashboards include:

* Inbound Dashboards
* Outbound Dashboards
* Campaign Export Reports
* Organization-shared dashboards

<figure><img src="https://4187494610-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFe4cpY1jy0FJ4kgC7wSx%2Fuploads%2FjLvTfmAHJMka16dlnSjy%2Fimage.png?alt=media&amp;token=58a21ddf-1bbe-4b00-81fd-614b35c947bd" alt=""><figcaption></figcaption></figure>

***

### Report Editor

Report Editors can create, modify, and manage reporting content.

Capabilities include:

* Create dashboards
* Create custom reports
* Configure widgets
* Modify layouts
* Share dashboards
* Export dashboards
* Use AI-assisted report generation
* View dashboard history
* Compare dashboard versions

<figure><img src="https://4187494610-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFe4cpY1jy0FJ4kgC7wSx%2Fuploads%2Fgd1JYCIfLYjiPPYeiCPr%2Fimage.png?alt=media&amp;token=455ab4b3-1449-4a2d-be7e-aa953df00fad" alt=""><figcaption></figcaption></figure>

***

## AI-Assisted Report Creation

One of the primary capabilities of Agentic Reporting is AI-assisted dashboard and report generation.

Rather than manually defining reports, users can describe their reporting requirements in natural language.

For example: Show a heat map of outbound calls by hour of day and day of week.

The AI assistant automatically determines:

* Required data sources
* Data query structure
* Appropriate visualization type
* Display configuration

The generated widget is then added to the dashboard for review and refinement.

<figure><img src="https://4187494610-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFe4cpY1jy0FJ4kgC7wSx%2Fuploads%2F1mzgMhwEF0cHD28VuJwf%2Fimage.png?alt=media&amp;token=84a09c96-b55d-46b3-b597-4df1c012a1e9" alt="" width="563"><figcaption></figcaption></figure>

***

## Refining AI-Generated Reports

After a report is generated, users can continue refining it through additional instructions.

Examples include:

* Change the chart type
* Show data by day instead of week
* Expand the reporting period
* Add additional metrics
* Adjust labels and descriptions

This iterative approach allows users to progressively improve reports without recreating them from scratch.

<figure><img src="https://4187494610-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFe4cpY1jy0FJ4kgC7wSx%2Fuploads%2FWb5n6EMHvJLmUqZqWtdz%2Fimage.png?alt=media&amp;token=b5b8cdbc-bd77-48b2-b120-c3463f5b30ea" alt="" width="563"><figcaption></figcaption></figure>

***

## Dashboard Editing

Report Editors can manually customize dashboards and widgets.

Supported customizations include:

### Layout Changes

* Resize widgets
* Rearrange dashboard components
* Add or remove widgets

### Visual Customization

* Modify titles and descriptions
* Change colors
* Update display settings
* Configure chart options

### Query Configuration

Advanced users can review and adjust widget query definitions to further customize report behavior.

<figure><img src="https://4187494610-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFe4cpY1jy0FJ4kgC7wSx%2Fuploads%2FB7shYDDGRtS6GXTX67bQ%2Fimage.png?alt=media&amp;token=07ad87a9-9d98-4608-bc76-4ef75826f646" alt="" width="563"><figcaption></figcaption></figure>

***

## Dashboard Versioning

All dashboard changes are tracked through version history.

Version management capabilities include:

* Automatic version creation
* Change tracking
* Version comparison
* User attribution
* Historical review

Users can identify:

* Who made a change
* What was changed
* When changes occurred

Changes generated by AI can also be distinguished from manually created updates, improving auditability and transparency.

<figure><img src="https://4187494610-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFe4cpY1jy0FJ4kgC7wSx%2Fuploads%2Fxr5ni5fVPumPs6G9f2E3%2Fimage.png?alt=media&amp;token=e44c5af1-ed65-4cc2-8bec-72c1b2748031" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="https://4187494610-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFe4cpY1jy0FJ4kgC7wSx%2Fuploads%2FBo2rv6J7H8Z1jeLN5IXp%2Fimage.png?alt=media&amp;token=a7693835-ed0f-4cd6-afda-9a1b44341b84" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="https://4187494610-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFe4cpY1jy0FJ4kgC7wSx%2Fuploads%2FdQx9SYqbzd7Cyvgrd95I%2Fimage.png?alt=media&amp;token=4c09f7fc-56e8-4116-8498-58eef6112911" alt="" width="485"><figcaption></figcaption></figure>

***

## Dashboard Sharing and Collaboration

Dashboards can be shared across the organization to support collaborative reporting.

Benefits include:

* Centralized reporting assets
* Consistent reporting standards
* Shared dashboards across teams
* Reduced effort through dashboard reuse

Shared dashboards become available to users based on their assigned reporting permissions.

***

## Ask Questions About Reports

Users can interact with report data using natural language.

Examples include:

* What happened on a specific day?
* Which flows generated the highest call volume?
* What were the most common outcomes?
* Which campaigns achieved the highest completion rates?

<figure><img src="https://4187494610-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFe4cpY1jy0FJ4kgC7wSx%2Fuploads%2F3mJaCwM81ot1QP6mk9X2%2Fimage.png?alt=media&amp;token=fb401e72-f255-4f54-a485-5a1be47e4246" alt="" width="426"><figcaption></figcaption></figure>

***

## Exporting Data

Supported report tables can be exported for offline analysis.

Supported export format:

* CSV

This enables users to:

* Share data externally
* Perform additional analysis
* Import results into third-party reporting tools
* Create customer-specific reporting packages.

<figure><img src="https://4187494610-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFe4cpY1jy0FJ4kgC7wSx%2Fuploads%2FzVGXtwhTLUYw3nvcR5vO%2Fimage.png?alt=media&amp;token=47a22df3-343e-41bc-bed9-b3568e0d1c96" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://4187494610-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFe4cpY1jy0FJ4kgC7wSx%2Fuploads%2FvLRudaQD4NQvhI7Q8RmT%2Fimage.png?alt=media&amp;token=9879a492-5ae9-4a25-9a6d-f5e3a2e310a0" alt="" width="563"><figcaption></figcaption></figure>

***

## Summary

Agentic Reporting extends traditional reporting by combining standard dashboards, customizable reporting, AI-assisted report generation, organizational governance, and collaboration capabilities. Users can analyze inbound and outbound performance, create custom dashboards using natural language, share reporting assets across teams, and export reporting data, all while maintaining secure organization-level access controls and complete version history tracking.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.ixhello.com/ixhc2/campaign-management/agentic-reporting.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
