Getting started with the Crisp Analytics
Use Crisp Analytics to understand your support activity, team performance, customer behavior, knowledge base usage, campaigns, and automation impact.
Analytics gives you prebuilt reports for common support questions and lets you create custom Dashboards when your team needs a more focused view. Open Crisp, then go to Analytics from the left navigation bar to review your reports.
This guide covers:
- Getting started → where Analytics lives and how reports are organized
- Default reports → the main report categories available in Crisp
- Customize Analytics reports → preferences, actions, configuration, filters, and aggregation methods
- How metrics are calculated → the most important calculation rules to know
- Frequently Asked Questions → common Analytics questions and edge cases
Getting started
Analytics is split into categories such as Messaging, Visitors, Knowledge Base, Contacts, Status Page, and Dashboard. Each category contains reports that help you monitor a specific part of your workspace activity.

Most reports are already configured with useful default metrics, time periods, and aggregation methods. You can scroll through them directly, export report data when needed, or customize charts with filters, office hours, date splits, and aggregation options.
The quickest way to start is to review the default reports first, then build a custom Dashboard once you know which metrics your team checks regularly.
Default reports
Default reports are prebuilt views available in Analytics. From the top bar, you can usually select the time period and timezone used to generate the data. Many reports can also be exported as CSV from the report action menu.
Messaging
The Messaging category focuses on Inbox activity, response performance, ratings, operators, automation, channels, SLAs, segments, and shortcuts.

Overview
The Overview section gives you quick access to the most common Inbox metrics:
- Conversations → total active conversations created or reopened during the selected period
- Visitors → unique visitors detected on pages where the chatbox is installed
- Ratings → average customer rating left on conversations
- Conversations over Time → evolution of conversation volume across the selected period
- Conversations per Period → heatmap of conversation volume by time period
- Conversations per Operator → treemap of conversations handled by each operator
- Conversations per Response Origin → first response origin, such as human operator, automation, AI, or auto-responder
- First Response Time → first response delay for new or reopened conversations
Responsiveness
Responsiveness reports help you measure how quickly conversations are handled:
- First Response Time → average delay between the first user message and the first response, including automations and human agents
- Human First Response Time → same logic, but only for the first human agent response
- Time to Handle → time between an operator’s first and last message before resolution
- Response Time per Period → heatmap showing response time patterns across days or hours
- Time to Handle — During Office Hours → handle time calculated with office hours applied
Ratings
Ratings reports help you monitor customer feedback:
- Overall Rating → average rating across all rated conversations
- Automation Rating → average rating for conversations handled only by automations or AI
- Ratings Evolution → rating trend over time
- Ratings → detailed report with the visitor, note, comment, assigned agent, and conversation link
If a user leaves a new rating for the same conversation, the previous one is updated instead of counted as a separate rating.
Operators
The Operators report shows individual performance for each operator, including conversations handled, average response time, average resolution time, and average rating on conversations assigned to that operator.
Automation
Automation reports help you measure how much work is handled before humans step in:
- Automated Conversations → conversations first replied to by an automation or AI
- Fully Automated Conversations → conversations resolved without human intervention
- Automated Conversations over Time → evolution of conversations first handled by automation
Use these reports to understand whether Hugo, workflows, and other automations are reducing repetitive work.
Channels
Channels reports show where conversations come from:
- Chat Conversations → conversations initiated from the chatbox
- Email Conversations → conversations initiated by email, including outbound emails created from the Inbox
- Others → conversations from other connected channels such as WhatsApp, forms, or social messaging
- Most Used Messaging Channels → comparison of conversation volume by channel
SLAs
SLA reports help you monitor conversations that exceed a response-time threshold. The default examples focus on conversations above 1 hour, but the filter can be adjusted to track the threshold that matters to your team.
You can also combine SLA-style reports with Office Hours to exclude periods when your team is not expected to reply.
Segments
Segments reports show how often conversation segments are used:
- Most Used Segments → number of times each segment was added to conversations
- Segments Used Over Time → segment usage trends across the selected period
Segments are counted when they are added to a conversation, not simply when a conversation already contains them.
Shortcuts
Shortcuts reports show how agents use saved replies:
- Most Used Shortcuts → number of times each shortcut was selected by agents
- Shortcuts Used Over Time → shortcut usage trends across the selected period
Visitors
The Visitors category helps you monitor website visits and trigger activity on pages where the Crisp chatbox is installed.

Website Visits
Website visit reports include:
- Visits Yesterday → visits to your website on the previous day
- Visits Today → visits to your website on the current day
- Visitors per Country → geographical heatmap based on detected visitor location
- Daily Visits → evolution chart of daily website visits
Triggers
Trigger reports include:
- Triggers Yesterday → triggers fired on the previous day
- Triggers Today → triggers fired on the current day
- Daily Triggers → evolution chart of trigger usage over time
Knowledge Base
The Knowledge Base category helps you understand how visitors use your articles, which locales are viewed most, what users search for, and which articles receive feedback.

Knowledge Base Visits
Knowledge Base visit reports include:
- Visits Yesterday → visits to your Knowledge Base on the previous day
- Visits Today → visits to your Knowledge Base on the current day
- Knowledge Base Visits → visit evolution across the selected period
- Visits per Knowledge Base Locale → visits grouped by language or locale
Search
Search reports include:
- Searches Yesterday → search queries performed on the previous day
- Searches Today → search queries performed on the current day
- Popular Searches → most searched terms in your Knowledge Base search input
Use these reports to find content gaps, unclear article titles, and topics that users expect to solve through self-service.
Articles
The Articles report shows per-article data such as visits, reactions, usefulness, rating details, comments, and visit trends. Select the relevant Knowledge Base locale from the report controls before analyzing article performance.
Contacts
The Contacts category shows data about contact creation and campaign activity.

Contacts Saved
Contact reports include:
- Contacts Saved Yesterday → contacts created on the previous day
- Contacts Saved Today → contacts created on the current day
- Contacts Saved → contact creation trend across the selected period
Campaigns Reached
Campaigns Reach shows the number of recipients reached by automated or one-shot email campaigns during the selected period.
Campaigns Activity
The Campaigns report shows global campaign performance, including delivered, opened, bounced, clicked, and unsubscribed counts.
Status Page
The Status Page category helps you monitor downtime for the nodes you track in Crisp.
Downtimes
Downtime reports include:
- Total Downtimes → total duration during which monitored nodes were detected as down
- Downtimes → individual downtime duration for each monitored node
Dashboard
The Dashboard category lets you build custom reports from scratch. Dashboards are useful when you want a focused view that combines the metrics your team checks most often.
Once a dashboard is selected, click Add chart to add a report. You can choose chart types such as Summary, Chart, Articles, Map, Heat Map, Operators, and Rating.

Dashboards can be configured with the same types of preferences, filters, date splits, and aggregation methods as default Analytics reports.
Useful resources: build a custom dashboard and import or export a dashboard.
Customize Analytics reports
Most reports can be adjusted from the Analytics interface. This lets you focus on a specific period, compare channels, isolate segments, or change how data is grouped.

Preferences
Preferences apply across Analytics as you browse reports. Use Time Period to select the period you want to analyze, and Timezone to align reports with your local time.
Some reports may not be available for every period depending on their purpose.
Actions
The report action menu lets you perform contextual actions such as Add to Dashboard or Export Data. CSV exports are useful when you want to run additional analysis outside Crisp.
Configuration
Configuration controls how an individual report is displayed and calculated.
Common configuration options include:
- Chart Type → line, bar, treemap, or other supported visual formats depending on the metric
- Office Hours → include only data generated during your configured business hours
- Date Split → group data hourly, daily, weekly, monthly, yearly, or across all selected time
- Aggregation Type → calculate values using average, moving average, median, minimum, maximum, or sum
Not every option is compatible with every report. When a setting does not apply, it may be hidden or disabled.
Aggregation example
For the dataset 50, 60, 70, 80, 90, 200, 100, 110, 120, 130, the aggregation changes the way the report is summarized.
Here is how common aggregation types would read that dataset:
- Average → total divided by the number of values: 101
- Moving average → rolling average across a chosen number of periods, useful to smooth short-term spikes
- Median → middle value after ordering the dataset: 95
- Minimum → smallest value: 50
- Maximum → largest value: 200
- Sum → total value: 1010
Filters
Filters isolate a subset of data before the report is generated. You can include or exclude conversations based on segments, country, rating, visitor origin, first or last operator, response time, handle time, and other compatible attributes.
Adding multiple values inside the same filter condition usually works as an OR condition. To apply an AND condition, add another filter condition.
How metrics are calculated
Metrics use different calculation rules depending on what they measure. Understanding these rules helps you interpret reports more accurately, especially when conversations are reopened, resolved, automated, or filtered.
Conversation
A conversation is counted when an actual message, file, image, or voice message is exchanged. Private notes, reminders, and system messages are not counted as conversation messages.
Total
Total conversations can be counted again when a resolved conversation is reopened. A reopened conversation can be counted again during the selected period, with a maximum of once per day.
Unique
Unique conversations are counted once for the selected period. If the same conversation is reopened later, it is not counted again in that unique total.
Response Time
Response time is the delay between a user message and the next response sent to the user. The response can come from a human agent, automation, AI, or another operator origin. If a conversation is resolved without a response, no response time is calculated.
Resolution Time
Resolution time is the delay between the first user message and the moment the conversation is resolved. If a conversation is reopened and resolved several times, Crisp can calculate resolution time again for that conversation.
Handle Time
Handle time is the delay between the first operator message and the last operator message before resolution. If only one operator message is sent before resolution, the first and last message are the same, so handle time is 0.
Messages
Messages count user and operator messages, including files and automation messages. Private notes and system messages are excluded.
Visitor Messages
Visitor Messages count messages sent by users. This includes regular messages and files sent from the user side.
Operator Messages
Operator Messages count messages sent by operators or operator origins. You can filter by origin, for example to focus on human-only messages or exclude automations.
Rating
Rating is the note left by users on conversations. Ratings are between 1 and 5 stars. Learn more here: monitor user ratings.
Conversation Assigned
Conversation Assigned counts assignments or reassignments to agents. Assignments can happen manually or through routing rules, and each assignment event can be counted.
Conversation Segment
Conversation Segment counts when a segment is added to a conversation. It does not simply count conversations that already contain a segment. A segment can be counted again for the same conversation only if it is removed and added again.
Conversation Shortcut
Conversation Shortcut counts when an agent selects a shortcut. It can be counted even if the agent edits the text or does not send the message, and several shortcuts can be counted inside the same conversation.
Campaign Activity
Campaign Activity counts individual email campaign messages sent. It covers automated and one-shot campaigns.
Campaign Sent
Campaign Sent shows overall email campaign performance. It can include delivered, opened, bounced, clicked, and unsubscribed metrics.
Knowledge Base Read
Knowledge Base Read counts article reads. A visitor opening the same article multiple times during the same session is counted once.
Knowledge Base Search
Knowledge Base Search shows frequently used search keywords. Generic terms such as the or how may be excluded from the report.
People Created
People Created counts contacts created in Crisp during the selected period. Contacts may be created when an email address is set in a conversation, imported from CSV, synchronized from an integration, or pushed through an API.
Status Downtime
Status Downtime measures how long monitored nodes were detected as down. Learn more here: configure Status Page.
Visitor Trigger
Visitor Trigger counts how many times triggers fired for visitors during the selected period. A trigger fires once per visitor, which helps you review trigger usage and adjust your strategy.
Learn more here: configure Triggers.
Visitor Visit
Visitor Visit counts unique visitors on pages where the chatbox is installed. Visitors are identified through sessions, so opening multiple tabs or browsing multiple pages during the same session does not count the same visitor again.
Frequently Asked Questions
Still have questions which were not covered in this article? Here is a collection of the most frequently asked questions on this topic.
How can I track which URLs users are contacting me from?
Use segments or custom data to group conversations by page URL. You can add a segment automatically when a visitor contacts you from a specific page, or use the JavaScript SDK to set custom data based on the current page.
Once the segment or custom data exists, you can monitor it in Analytics through compatible filters or use custom Inbox filters to review matching conversations.
Can I track specific Crisp events in Google Analytics?
Yes, but Analytics and Google Analytics are used for different things. Crisp Analytics helps you review Inbox, conversation, operator, knowledge base, visitor, and campaign data inside Crisp. If you want to track specific events in Google Analytics, use the GTM and GA4 setup.
Follow this guide: use Google Tag Manager to monitor Crisp events in Google Analytics 4.
Why did the Dashboard I created disappear?
Some Dashboard display preferences are stored locally in your browser. Clearing browser storage, switching browsers, or using another device can reset local Dashboard preferences or display settings.
When you need to reuse a Dashboard reliably, export it as a .json file and import it again later. See import or export a dashboard.
How can I compare New and Existing conversations?
Use the Conversation Type split or filter. When configuring a report, use Split by → Conversation Type to compare New and Existing conversations in the same chart, or use Conversation Type as a filter to focus on only one of them.
This is useful when you want to separate first-contact volume from reopened or recurring conversations.
Can Analytics export all conversation messages?
No, Analytics is not a full conversation export tool. Analytics can export report data and may include conversation IDs depending on the report, but it does not export full conversation messages and metadata.
To export conversation content or metadata programmatically, use the Crisp REST API.
Updated on: 03/05/2026
Thank you!