The Analytics dashboard gives you insights into how users interact with your agent, helping you identify opportunities to improve responses and increase engagement.
Accessing Analytics
Go to Agents in the sidebar
Select your agent
Click Analytics in the agent menu
Overview Metrics The summary section shows key performance indicators:
Metric Description Total Conversations Number of chat sessions Total Messages All messages exchanged Avg Messages/Conversation Engagement depth Thumbs Up Positive feedback count Thumbs Down Negative feedback count Feedback Ratio Positive / total feedback %
Date Range Filter analytics by time period:
Last 7 days — Recent performanceLast 30 days — Monthly trendsLast 90 days — Quarterly viewCustom range — Select specific dates
Daily Trends The daily chart shows:
Conversations — Chat sessions per dayMessages — Total messages per dayFeedback — Thumbs up/down per day
Use this to identify:
Peak usage times
Trends over time
Impact of changes you make
Channel Breakdown See where conversations originate:
Channel Description Widget Embedded chat on your website API Programmatic API calls Test Dashboard test conversations
Geographic Distribution View conversations by country to understand your audience:
See which regions use your agent most
Identify localization opportunities
Understand timezone patterns
Track how your tools are performing:
Metric Description Execution Count Times the tool was called Success Count Successful executions Failure Count Failed executions Success Rate Success percentage Avg Execution Time Average response time (ms)
Identifying Issues
Low success rate — Check API credentials, endpoint availabilityHigh execution time — Optimize external API or add cachingLow usage — Improve tool description or agent prompts
For form tools, track the conversion funnel:
Metric Description Impressions Times form was shown Started Users who began filling Submitted Completed submissions Conversion Rate Submitted / Impressions Completion Rate Submitted / Started
Field-Level Analysis See which fields have the highest drop-off:
Field Completion Rate Email 98% Name 95% Phone 45% Message 85%
High drop-off on a field? Consider making it optional or moving it later in the form.
Trigger Analytics Measure automation effectiveness:
Metric Description Fired Times trigger activated Converted User engaged after trigger Conversion Rate Engaged / Fired
Access via Agents → Triggers tab.
Feedback Analysis User feedback helps identify areas for improvement:
Viewing Feedback
Go to Conversations
Filter by Has Feedback
Review conversations with thumbs down
Common Issues
Wrong answers — Update knowledge baseMissing information — Add relevant documentsTool failures — Check tool configurationTone issues — Adjust system prompt
Exporting Data Export analytics data for external analysis:
Select date range
Click Export button
Choose format (CSV or JSON)
Best Practices Weekly Review
Check feedback ratio trend
Review negative feedback conversations
Identify top-performing tools
Monitor form conversion rates
Monthly Analysis
Compare month-over-month trends
Analyze geographic patterns
Review tool success rates
Assess trigger effectiveness
Continuous Improvement
Low feedback ratio?
Review negative feedback conversations
Update knowledge base with missing info
Improve system prompt clarity
Declining conversations?
Check widget installation
Review trigger configurations
Assess content freshness
Poor form conversion?
Simplify form fields
Improve form timing (triggers)
Add better context/descriptions
Tool failures increasing?
Check external API status
Verify credentials
Review error logs
API Access Access analytics programmatically:
# Get summary metrics curl "https://api.ansa.so/analytics/summary?agentId=xxx&startDate=2024-12-01" \ -H "Authorization: Bearer $ANSA_API_KEY " # Get daily data curl "https://api.ansa.so/analytics/daily?agentId=xxx" \ -H "Authorization: Bearer $ANSA_API_KEY " # Get channel breakdown curl "https://api.ansa.so/analytics/channels?agentId=xxx" \ -H "Authorization: Bearer $ANSA_API_KEY " # Get country data curl "https://api.ansa.so/analytics/countries?agentId=xxx" \ -H "Authorization: Bearer $ANSA_API_KEY " # Get tool performance curl "https://api.ansa.so/analytics/tools?agentId=xxx" \ -H "Authorization: Bearer $ANSA_API_KEY "
Next Steps
Confidence Scores Understand response confidence
Conversation History Review past conversations
