What is a report?
A report is a named, saved layout of widgets. Each report has:- A name displayed in the sidebar
- A default time range between 1 and 90 days
- An ordered grid of widgets, each sized as a third, half, or full row width
Creating a report
Add widgets
The report opens as an empty canvas. Add widgets from the widget library to populate it.
Arrange and size
Position your widgets and set each one to third, half, or full width to build the layout you want.
Widget library
Reports support 14 widget types organized into three categories: stats, charts, and lists.Stat widgets
Headline numbers that each display the current value plus a trend indicator comparing against the prior equivalent period.| Widget | What it shows |
|---|---|
| Total conversations | All conversations in the selected period |
| Average sentiment | Weighted sentiment score with a human-readable label |
| Resolution rate | Percentage of conversations resolved (fully or partially) |
| Churn risk count | Conversations flagged with a churn risk signal |
| Buying signal count | Conversations flagged with a buying signal |
| Messages today | Real-time count of messages received so far today |
Chart widgets
Visualizations for time-series and distribution data.| Widget | Type | What it shows |
|---|---|---|
| Sentiment trend | Line chart | Daily average sentiment score over time |
| Conversation volume | Bar chart | Daily conversation count over time |
| Intent distribution | Bar or donut | Breakdown of intents by count and percentage |
| Sentiment distribution | Bar or donut | Count of each sentiment label |
| Flag distribution | Bar chart | Count of each flag type fired |
| Outcome distribution | Donut or bar | Resolution outcome breakdown |
List widgets
Ranked tables showing top items for the selected period.| Widget | What it shows |
|---|---|
| Top topics | Top 10 topics by conversation volume |
| Recent conversations | 8 most recent conversations with user and sentiment |
Full widget reference
Full widget reference
Each widget has a type key, a display category, and a sizing recommendation.
| Type key | Category | Recommended size |
|---|---|---|
stat_total_conversations | Stat | Third |
stat_avg_sentiment | Stat | Third |
stat_resolution_rate | Stat | Third |
stat_churn_risk_count | Stat | Third |
stat_buying_signal_count | Stat | Third |
stat_messages_today | Stat | Third |
chart_sentiment_trend | Chart | Half or full |
chart_conversation_volume | Chart | Half or full |
chart_intent_distribution | Chart | Half |
chart_sentiment_distribution | Chart | Half |
chart_flag_distribution | Chart | Half |
chart_outcome_distribution | Chart | Half |
list_top_topics | List | Half or full |
list_recent_conversations | List | Full |
Widget sizing
Each widget occupies a fraction of the report grid row.| Size | Width | Best for |
|---|---|---|
| Third | 1/3 of the row | Stat widgets, compact lists |
| Half | 1/2 of the row | Charts, medium tables |
| Full | Entire row | Wide charts, detailed tables |
Time range control
Every report stores a default time range set during creation. When viewing a report, a day-range selector lets you override the default on the fly without changing the saved configuration.- One report can serve as both a 30-day view and a 7-day view — just adjust the selector
- Sharing a URL with
?days=7overrides the default for that viewing session - The report’s saved default is never changed by URL overrides