> ## Documentation Index
> Fetch the complete documentation index at: https://hellotars.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Read the Analytics cards
> Read every card on the Analytics page, choose which outcomes count, and change the card layout for your organization.
export const Browser = ({url, children}) =>
{url ? {url} : null}
{children}
;
export const img = {
activity: {
activityTimeline: "/docs/guides/activity/images/activity-timeline.png",
capturedVariablesPanel: "/docs/guides/activity/images/captured-variables-panel.png",
dataViewCards: "/docs/guides/activity/images/data-view-cards.png",
exportDataDialog: "/docs/guides/activity/images/export-data-dialog.png",
tasksPanelExportReady: "/docs/guides/activity/images/tasks-panel-export-ready.png"
},
analytics: {
analyticsOverview: "/docs/guides/analytics/images/analytics-overview.png",
exploreGallery: "/docs/guides/analytics/images/explore-gallery.png",
exploreTab: "/docs/guides/analytics/images/explore-tab.png",
outcomesDialog: "/docs/guides/analytics/images/outcomes-dialog.png"
},
billing: {
billingOverview: "/docs/guides/billing/images/billing-overview.png",
buyConversationsDialog: "/docs/guides/billing/images/buy-conversations-dialog.png",
buySeatsDialog: "/docs/guides/billing/images/buy-seats-dialog.png",
livechatSeatsTab: "/docs/guides/billing/images/livechat-seats-tab.png",
organizationDeletionLifecycle: "/docs/guides/billing/images/organization-deletion-lifecycle.svg",
organizationSwitcher: "/docs/guides/billing/images/organization-switcher.png",
rolesAndAccessMatrix: "/docs/guides/billing/images/roles-and-access-matrix.png"
},
building: {
agentBehaviorGuardrails: "/docs/guides/building/images/agent-behavior-guardrails.png",
agentCardMenu: "/docs/guides/building/images/agent-card-menu.png",
agentConfigure: "/docs/guides/building/images/agent-configure.png",
agentExitRoutesDialog: "/docs/guides/building/images/agent-exit-routes-dialog.png",
agentLibrary: "/docs/guides/building/images/agent-library.png",
agentModelParameters: "/docs/guides/building/images/agent-model-parameters.png",
aiAgentGambitLoop: "/docs/guides/building/images/ai-agent-gambit-loop.svg",
builderBasics: "/docs/guides/building/images/builder-basics.png",
builderConnectHandlePanel: "/docs/guides/building/images/builder-connect-handle-panel.png",
builtInToolsDialog: "/docs/guides/building/images/built-in-tools-dialog.png",
bundledEdgeMenu: "/docs/guides/building/images/bundled-edge-menu.png",
configureDebugTab: "/docs/guides/building/images/configure-debug-tab.png",
configureLanguage: "/docs/guides/building/images/configure-language.png",
configureNotifications: "/docs/guides/building/images/configure-notifications.png",
createAgentDialog: "/docs/guides/building/images/create-agent-dialog.png",
draftPublishRollbackPinning: "/docs/guides/building/images/draft-publish-rollback-pinning.svg",
draftSwitcherChip: "/docs/guides/building/images/draft-switcher-chip.png",
duplicateAgentDialog: "/docs/guides/building/images/duplicate-agent-dialog.png",
flowConditions: "/docs/guides/building/images/flow-conditions.png",
gambitPalette: "/docs/guides/building/images/gambit-palette.png",
gambits: {
autoSuggestionFromVariable: "/docs/guides/building/gambits/images/auto-suggestion-from-variable.png",
buttonAutoPopulate: "/docs/guides/building/gambits/images/button-auto-populate.png",
buttonOverflow: "/docs/guides/building/gambits/images/button-overflow.png",
gambitAiAgent: "/docs/guides/building/gambits/images/gambit-ai-agent.png",
gambitApiCall: "/docs/guides/building/gambits/images/gambit-api-call.png",
gambitAutoSuggestion: "/docs/guides/building/gambits/images/gambit-auto-suggestion.png",
gambitButton: "/docs/guides/building/gambits/images/gambit-button.png",
gambitCard: "/docs/guides/building/gambits/images/gambit-card.png",
gambitChannel: "/docs/guides/building/gambits/images/gambit-channel.png",
gambitCustomCode: "/docs/guides/building/gambits/images/gambit-custom-code.png",
gambitDateTime: "/docs/guides/building/gambits/images/gambit-date-time.png",
gambitGeoLocation: "/docs/guides/building/gambits/images/gambit-geo-location.png",
gambitLanguage: "/docs/guides/building/gambits/images/gambit-language.png",
gambitLiveChat: "/docs/guides/building/gambits/images/gambit-live-chat.png",
gambitMediaUpload: "/docs/guides/building/gambits/images/gambit-media-upload.png",
gambitNoInput: "/docs/guides/building/gambits/images/gambit-no-input.png",
gambitRedirect: "/docs/guides/building/gambits/images/gambit-redirect.png",
gambitStarRating: "/docs/guides/building/gambits/images/gambit-star-rating.png",
gambitStartAndEnd: "/docs/guides/building/gambits/images/gambit-start-and-end.png",
gambitText: "/docs/guides/building/gambits/images/gambit-text.png",
gambitTrigger: "/docs/guides/building/gambits/images/gambit-trigger.png"
},
languagesTranslateGambit: "/docs/guides/building/images/languages-translate-gambit.png",
languageSystemMessages: "/docs/guides/building/images/language-system-messages.png",
newDraftDialog: "/docs/guides/building/images/new-draft-dialog.png",
outputComponentsGrid: "/docs/guides/building/images/output-components-grid.png",
publishDialog: "/docs/guides/building/images/publish-dialog.png",
systemPromptDialog: "/docs/guides/building/images/system-prompt-dialog.png",
testModeEventLog: "/docs/guides/building/images/test-mode-event-log.png",
testModePanel: "/docs/guides/building/images/test-mode-panel.png",
validationProblemsPanel: "/docs/guides/building/images/validation-problems-panel.png",
variablePickerPanel: "/docs/guides/building/images/variable-picker-panel.png",
variablePillInserted: "/docs/guides/building/images/variable-pill-inserted.png",
versionsDraftsPanel: "/docs/guides/building/images/versions-drafts-panel.png"
},
campaigns: {
campaignFlavorsTriggers: "/docs/guides/campaigns/images/campaign-flavors-triggers.svg",
campaignReplyRouting: "/docs/guides/campaigns/images/campaign-reply-routing.svg",
campaignSendAnatomy: "/docs/guides/campaigns/images/campaign-send-anatomy.svg",
createACampaign: "/docs/guides/campaigns/images/create-a-campaign.png",
walletReserveSettleRefund: "/docs/guides/campaigns/images/wallet-reserve-settle-refund.svg",
webhookCampaignContractLocking: "/docs/guides/campaigns/images/webhook-campaign-contract-locking.svg",
webhookCampaignLifecycleStates: "/docs/guides/campaigns/images/webhook-campaign-lifecycle-states.svg",
webhookCampaignOneCallOneDelivery: "/docs/guides/campaigns/images/webhook-campaign-one-call-one-delivery.svg"
},
channels: {
distributeWhatsappConnect: "/docs/guides/channels/images/distribute-whatsapp-connect.png",
whatsappConnectDialogWaiting: "/docs/guides/channels/images/whatsapp-connect-dialog-waiting.png",
whatsappEmptyState: "/docs/guides/channels/images/whatsapp-empty-state.png"
},
deploy: {
bridgeEventGambitSection: "/docs/guides/deploy/images/bridge-event-gambit-section.png",
deploymentSurfacesAndChannels: "/docs/guides/deploy/images/deployment-surfaces-and-channels.svg",
designAgentTab: "/docs/guides/deploy/images/design-agent-tab.png",
designLauncherTab: "/docs/guides/deploy/images/design-launcher-tab.png",
embedIframeTab: "/docs/guides/deploy/images/embed-iframe-tab.png",
embedTheWidget: "/docs/guides/deploy/images/embed-the-widget.png",
launcherCalloutSettings: "/docs/guides/deploy/images/launcher-callout-settings.png",
mobileAppIntegration: "/docs/guides/deploy/images/mobile-app-integration.png",
onYourDomain: "/docs/guides/deploy/images/on-your-domain.png",
shareYourAgentLink: "/docs/guides/deploy/images/share-your-agent-link.png",
widgetCallout: "/docs/guides/deploy/images/widget-callout.png"
},
developer: {
api: {
channelSendTemplateVsMessage: "/docs/developer/api/images/channel-send-template-vs-message.svg",
endUsers: {
endUsersListCursorPagination: "/docs/developer/api/end-users/images/end-users-list-cursor-pagination.svg"
},
triggerCallConversationLifecycle: "/docs/developer/api/images/trigger-call-conversation-lifecycle.svg"
},
developerSurfacesMap: "/docs/developer/images/developer-surfaces-map.svg",
embed: {
embedConfigToWidgetContext: "/docs/developer/embed/images/embed-config-to-widget-context.svg",
hostPageBridgeFlow: "/docs/developer/embed/images/host-page-bridge-flow.svg",
identitySigningFlow: "/docs/developer/embed/images/identity-signing-flow.svg",
scriptVsIframeEmbed: "/docs/developer/embed/images/script-vs-iframe-embed.svg"
},
mobile: {
bridgeMessageProtocol: "/docs/developer/mobile/images/bridge-message-protocol.svg",
webviewBridgeArchitecture: "/docs/developer/mobile/images/webview-bridge-architecture.svg"
}
},
endUsers: {
anonymousToIdentifiedProfile: "/docs/guides/end-users/images/anonymous-to-identified-profile.svg",
bulkActionBar: "/docs/guides/end-users/images/bulk-action-bar.png",
campaignConsentGate: "/docs/guides/end-users/images/campaign-consent-gate.svg",
consentPerChannelStates: "/docs/guides/end-users/images/consent-per-channel-states.svg",
dynamicVsStaticSegments: "/docs/guides/end-users/images/dynamic-vs-static-segments.svg",
endUserDirectory: "/docs/guides/end-users/images/end-user-directory.png",
endUserProfileAcrossChannels: "/docs/guides/end-users/images/end-user-profile-across-channels.svg",
endUserProfilePanes: "/docs/guides/end-users/images/end-user-profile-panes.png",
profileMergeAndTakeoverProtection: "/docs/guides/end-users/images/profile-merge-and-takeover-protection.svg",
segmentBuilder: "/docs/guides/end-users/images/segment-builder.png",
segmentsPage: "/docs/guides/end-users/images/segments-page.png"
},
getStarted: {
agentStates: "/docs/get-started/images/agent-states.svg",
buildToLivePath: "/docs/get-started/images/build-to-live-path.svg",
dashboardSidebarMap: "/docs/get-started/images/dashboard-sidebar-map.png",
organizationOwnershipAndRoles: "/docs/get-started/images/organization-ownership-and-roles.svg",
quickstart: {
step1CreateYourAccount: "/docs/get-started/images/quickstart/step-1-create-your-account.png",
step3ConnectTheAiAgent: "/docs/get-started/images/quickstart/step-3-connect-the-ai-agent.png",
step4TestMode: "/docs/get-started/images/quickstart/step-4-test-mode.png"
},
quickstartCanvas: "/docs/get-started/images/quickstart-canvas.png"
},
knowledge: {
addASource: "/docs/guides/knowledge/images/add-a-source.png",
addRetrieverPicker: "/docs/guides/knowledge/images/add-retriever-picker.png",
attachKnowledgeGambit: "/docs/guides/knowledge/images/attach-knowledge-gambit.png",
configureARetriever: "/docs/guides/knowledge/images/configure-a-retriever.png",
createKnowledgeBaseDialog: "/docs/guides/knowledge/images/create-knowledge-base-dialog.png",
createTestQuestions: "/docs/guides/knowledge/images/create-test-questions.png",
customRetrieverDialog: "/docs/guides/knowledge/images/custom-retriever-dialog.png",
datasetTab: "/docs/guides/knowledge/images/dataset-tab.png",
documentChangeReindexLifecycle: "/docs/guides/knowledge/images/document-change-reindex-lifecycle.svg",
documentsTabPreview: "/docs/guides/knowledge/images/documents-tab-preview.png",
importAWebsite: "/docs/guides/knowledge/images/import-a-website.png",
kbList: "/docs/guides/knowledge/images/kb-list.png",
manageMedia: "/docs/guides/knowledge/images/manage-media.png",
retrieverIndexStates: "/docs/guides/knowledge/images/retriever-index-states.svg",
retrieverQueryPipeline: "/docs/guides/knowledge/images/retriever-query-pipeline.svg",
standardVsParentChildChunking: "/docs/guides/knowledge/images/standard-vs-parent-child-chunking.svg",
testRetriever: "/docs/guides/knowledge/images/test-retriever.png"
},
liveChat: {
agentWorkspace: "/docs/guides/live-chat/images/agent-workspace.png",
assignedAgentPicker: "/docs/guides/live-chat/images/assigned-agent-picker.png",
automaticAssignmentRouting: "/docs/guides/live-chat/images/automatic-assignment-routing.svg",
availabilityDropdown: "/docs/guides/live-chat/images/availability-dropdown.png",
cannedResponses: "/docs/guides/live-chat/images/canned-responses.png",
composerPreferences: "/docs/guides/live-chat/images/composer-preferences.png",
copilotPanel: "/docs/guides/live-chat/images/copilot-panel.png",
filterConversationsDialog: "/docs/guides/live-chat/images/filter-conversations-dialog.png",
inboxAnalyticsTab: "/docs/guides/live-chat/images/inbox-analytics-tab.png",
inboxAvailabilityTab: "/docs/guides/live-chat/images/inbox-availability-tab.png",
inboxesSettings: "/docs/guides/live-chat/images/inboxes-settings.png",
inboxRoutingTab: "/docs/guides/live-chat/images/inbox-routing-tab.png",
labelsSettings: "/docs/guides/live-chat/images/labels-settings.png",
newAttributeDialog: "/docs/guides/live-chat/images/new-attribute-dialog.png",
newCannedResponseDialog: "/docs/guides/live-chat/images/new-canned-response-dialog.png",
notificationPreferences: "/docs/guides/live-chat/images/notification-preferences.png",
notificationsPage: "/docs/guides/live-chat/images/notifications-page.png",
pickupTargetCard: "/docs/guides/live-chat/images/pickup-target-card.png",
resolveMenu: "/docs/guides/live-chat/images/resolve-menu.png",
searchDialog: "/docs/guides/live-chat/images/search-dialog.png",
seatGateConversation: "/docs/guides/live-chat/images/seat-gate-conversation.png",
seatsSettings: "/docs/guides/live-chat/images/seats-settings.png",
workTheInbox: "/docs/guides/live-chat/images/work-the-inbox.png"
},
security: {
addOpenRouterKeyDialog: "/docs/guides/security/images/add-open-router-key-dialog.png",
auditChainVerified: "/docs/guides/security/images/audit-chain-verified.png",
auditEventDrawer: "/docs/guides/security/images/audit-event-drawer.png",
auditExportDialog: "/docs/guides/security/images/audit-export-dialog.png",
auditLogViewer: "/docs/guides/security/images/audit-log-viewer.png",
auditRecordLifecycle: "/docs/guides/security/images/audit-record-lifecycle.svg",
logPrivacyRedactionEnabled: "/docs/guides/security/images/log-privacy-redaction-enabled.png",
modelProviderEmptyState: "/docs/guides/security/images/model-provider-empty-state.png",
privacyMaskReveal: "/docs/guides/security/images/privacy-mask-reveal.png",
privacySettings: "/docs/guides/security/images/privacy-settings.png",
siemConnectWizard: "/docs/guides/security/images/siem-connect-wizard.png",
supportActorMasking: "/docs/guides/security/images/support-actor-masking.svg"
},
tools: {
addToolModal: "/docs/guides/tools/images/add-tool-modal.png",
addToolsPanel: "/docs/guides/tools/images/add-tools-panel.png",
codekitActionEditor: "/docs/guides/tools/images/codekit-action-editor.png",
codekitConnectToolkitsDialog: "/docs/guides/tools/images/codekit-connect-toolkits-dialog.png",
codekitSchemaDialog: "/docs/guides/tools/images/codekit-schema-dialog.png",
codekitToolkit: "/docs/guides/tools/images/codekit-toolkit.png",
codekitToolkitAnatomy: "/docs/guides/tools/images/codekit-toolkit-anatomy.svg",
createActionDialog: "/docs/guides/tools/images/create-action-dialog.png",
createCodekitDialog: "/docs/guides/tools/images/create-codekit-dialog.png",
responseFilteringDialog: "/docs/guides/tools/images/response-filtering-dialog.png",
toolGambitEditorAgentMode: "/docs/guides/tools/images/tool-gambit-editor-agent-mode.png",
toolGambitEditorWorkflowMode: "/docs/guides/tools/images/tool-gambit-editor-workflow-mode.png",
toolkitDetail: "/docs/guides/tools/images/toolkit-detail.png",
toolsConnected: "/docs/guides/tools/images/tools-connected.png",
toolsDirectory: "/docs/guides/tools/images/tools-directory.png",
viewActionsModal: "/docs/guides/tools/images/view-actions-modal.png",
workflowModeResponse: "/docs/guides/tools/images/workflow-mode-response.png"
}
};
export const urls = {
app: "https://dashboard.hellotars.com",
site: "https://hellotars.com",
support: "mailto:support@hellotars.com",
status: "https://status.hellotars.com"
};
At the end of this page, you can read every card on the **Analytics** page and explain what drives each number.
## Before you start
Before you start, sign in to the dashboard and select the organization you want to work in.
* You need a role with analytics access. To choose outcomes or change the layout, you need the Admin role.
* You need at least one deployment that has handled a conversation. Until then the page shows **Waiting for first events**.
* Read [Analytics overview](/docs/guides/analytics/analytics-overview) for the scope bar and the **Conversations** drawer. This page does not repeat them.
## Open Analytics and set the scope
The page opens with its cards in the order your organization saved.
Every card follows the scope bar. For example, choose **28d**, then **Support agent**, then **All channels**, then **Live**.
## Outcomes
The **Outcomes** card shows totals for the period, each with its change from the previous period.
| Number | What it counts |
| - | - |
| **Widget Impressions** | Browsers that loaded a page where the widget is installed, each counted once in the range. It counts the page load, not that the launcher was seen. A visit to the agent link also counts. |
| **Widget Opens** | Widget impressions that opened the widget. It also shows **Open rate**, and **CTR** when click data is available. |
| **Conversations** | Conversations started in the period, on every channel. |
| **Outcome** | Conversations with at least one outcome you ticked. With one ticked outcome, the card shows that outcome alone. |
After these, the card shows one number for each outcome you ticked. Select a number to list its conversations in the drawer.
A click on a phone link counts as the **Phone link** result, which you can tick as an outcome. The number is not recorded.
Selecting either the launcher or its callout message counts as a click-open for **CTR**. Dismissing the callout does not count as an open.
* **Open rate** also includes automatic opens and visits to the agent link.
* **CTR** leaves out browsers that loaded only the agent link, because that page has no launcher.
A number shows no change when the previous period starts before the first recorded event or widget visit of the selected deployment and channel.
### Choose which outcomes count
The **Outcomes** dialog opens with a **Search actions, fields and buttons** field. Before any outcome exists, **Choose which outcomes count** on the card opens the same dialog.
Results are grouped under **Actions**, **Fields captured**, **Buttons clicked**, and **Gambits**. Each row shows how many conversations reached it in the period.
Ticked outcomes show on the **Outcomes** card and end the **Funnel**.
If the dialog reads **Nothing to count yet**, no conversation has recorded an action, a field, or a button click yet.
## Funnel
The **Funnel** card follows every widget impression from the page load to a conversation with an outcome. The steps are **Impressions**, **Widget opens**, **Conversations**, and **Outcome**. Between steps, the funnel shows what dropped out, such as **No open**, **No conversation**, and **No outcome**.
The web funnel counts browsers linked to a recorded widget open. Its conversation count can differ from the **Outcomes** total, even with **Web** selected.
Select a step to open its conversations. This works on these steps:
* **Conversations**, one step for each channel when there is more than one
* Each step you added, and **Dropped**
* Each outcome, and **No outcome**
**Impressions**, **Widget opens**, **No open**, and **No conversation** count browsers, not conversations. They do not open a list.
* **Add step** adds a gambit or an outcome that conversations must reach before they count. A gambit with buttons is always its own step.
* A gambit belongs to one deployment. When you add one with **All deployments** selected, the scope changes to that deployment. A step for a gambit in another deployment shows when you select that deployment in **Scope**.
* **Narrow** counts only end users who saw a page or site, or arrived from a referrer or campaign. It also sets which kinds of traffic count, under **Bots and crawlers**.
If the card reads **No widget impressions or conversations in this window**, nothing has run in the selected scope yet.
## Trends
The **Trends** card charts **Widget impressions**, **Conversations**, and **Outcome** over time. The **Period** control switches between three views:
| View | What it shows |
| - | - |
| **Week on week** | Weekly totals for each metric. |
| **Month on month** | Monthly totals for each metric. |
| **By version** | **Rates by version**: CTR, interaction, and outcome rates for each published version, with what changed. |
**By version** needs one deployment in **Scope**. Until the agent is published a second time, it reads **Available after the second publish**.
## Topics
The **Topics** card lists the topics your customers talk about, with each topic's share of conversations. See [Find topics in conversations](/docs/guides/analytics/topics).
## Busy hours
The **Busy hours** card is a grid of weekdays by hour in your timezone. Pick the metric from **Widget impressions**, **Widget opens**, **Conversations**, or **Outcome**. A line under the grid names the busiest hour.
If the deployment has working hours, the grid marks **Business hours** and states the share of activity outside them. Working hours are set on the inbox. See [Set up inboxes](/docs/guides/live-chat/set-up-inboxes). On **Conversations** and **Outcome**, select a cell to open its conversations.
## Fields captured
The **Fields captured** card lists each field that a form, a button, or the AI Agent gambit saved. The columns are **Field**, **Asked**, **Answered**, and **No reply**.
**No reply** counts the conversations where the field was asked and the end user did not answer it. An empty card reads **No fields captured in this period**.
## Sources
The **Sources** card ranks where widget impressions and conversations come from. A page path with and without a trailing slash is one page. Switch the view with **Pages**, **Sites**, **Referrers**, **Campaigns**, and **Bots and crawlers**.
The **Pages**, **Sites**, **Referrers**, and **Campaigns** views show **Widget impressions**, **Conversations**, **Outcome**, and **Rate**. On **Sites**, a **Since** column shows the first day the widget was seen on that site.
The **Bots and crawlers** view shows **Kind**, **Widget impressions**, **Widget opens**, **Conversations**, and **Share**. **Share** is the kind's impressions divided by all impressions.
## Campaigns
The **Campaigns** card lists outbound campaigns in the period. The columns are **Campaign**, **Sent**, **Delivered**, **Replied**, and **Reply rate**. Select a row to open the conversations that the campaign started. Select the campaign name to open the campaign.
## Reply time
The **Reply time** card has two panels: **AI reply**, and **Human pickup after a handoff**. Each panel leads with the median reply time for the period. When enough data is available, a small chart shows medians at hourly or daily intervals, depending on the selected range. Below, **Slow** is the time that 90% of replies beat, and **Slowest** is the time that 95% beat.
Until a human agent accepts a handoff, the human panel reads **No human pickups yet**.
## Handled by
The **Handled by** card splits ended conversations into **Handled by the AI alone** and **Human joined**. Select either part to open its conversations.
## CSAT
The **CSAT** card leads with the average rating and its change from the previous period. A line beside it counts the ratings given after the AI and after a human. The table below has the columns **Rating**, **Ratings**, and **Share**.
Select a row to open the conversations with that rating. An empty card reads **No ratings in this window**.
## Countries and Devices
**Countries** ranks where people are by conversations. **Devices** compares phone with desktop. Neither card is on the page by default. An Admin adds them with **Add chart**.
## Change the layout
The menu offers **Move up**, **Move down**, and **Remove**.
The **Add a chart** dialog lists every card that is not on the page.
Every member of the organization now sees the new layout. Select **Discard** to drop your changes instead.
## Verify
Change the range in the scope bar. Every card refreshes to the new window, and each number shows a new change from the previous period.
## Related pages
* [Analytics overview](/docs/guides/analytics/analytics-overview)
* [Find topics in conversations](/docs/guides/analytics/topics)
* [Build reports in Explore](/docs/guides/analytics/explore)
* [Deployments explained](/docs/guides/deploy/deployments-explained)
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.