Skip to main content
Track how your agent is performing with built-in analytics. Understand user behavior, identify improvement opportunities, and measure business impact.

​
Dashboard Overview

Your agent dashboard provides at-a-glance metrics:

Total Messages

Total messages sent and received across all conversations.

Total Sessions

Number of unique conversation sessions.

Active Conversations

Currently active conversation threads.

Response Time

Average time for your agent to respond.

​
Key Metrics

​
Engagement Metrics

MetricDescriptionWhy It Matters
Messages per SessionAverage messages in a conversationHigher = more engagement
Session DurationHow long conversations lastIndicates value delivery
Return UsersUsers who start multiple sessionsMeasures stickiness
Icebreaker UsageWhich quick replies are clickedShows user interests

​
Performance Metrics

MetricDescriptionWhy It Matters
Response TimeTime to generate responseAffects user experience
Error RateFailed tool calls or responsesIdentifies issues
Tool UsageWhich tools are called mostGuides optimization
Handoff RateConversations transferredShows automation limits

​
Business Metrics

MetricDescriptionWhy It Matters
Conversion RateFree → paid usersMeasures monetization
RevenueTotal earningsBottom line
Credits UsedCredit consumptionUsage patterns
Paywall HitsUsers reaching limitsPricing optimization

​
Viewing Analytics

1

Access Dashboard

Click on your agent from the main dashboard.
2

Navigate to Analytics

Click the Analytics tab in the agent view.
3

Select Time Range

Choose a date range to analyze:
  • Today
  • Last 7 days
  • Last 30 days
  • Custom range
4

Explore Metrics

Use the dashboard to explore different metric categories.

​
Conversation Logs

Review actual conversations to understand user behavior:
1

Go to Conversations

In your agent, click the Conversations tab.
2

Filter Conversations

Filter by:
  • Date range
  • Status (active/inactive)
  • Country
  • User
3

View Details

Click any conversation to see:
  • Complete message history
  • Tool calls made
  • Context and memory
  • User information

​
Understanding User Behavior

​
Common Patterns to Look For

Where do users stop responding?
  • After a specific question type
  • When a tool fails
  • At the paywall
Action: Improve these friction points.
When does your agent struggle?
  • “I don’t understand” responses
  • Tool errors
  • Handoff triggers
Action: Add training data or tools for these scenarios.
What leads to conversions?
  • Session length before purchase
  • Tools used by converting users
  • Common paths to payment
Action: Optimize the conversion funnel.

​
Improving Based on Analytics

​
Low Engagement

Symptoms: Short sessions, few return users Solutions:
  • Make the welcome message more engaging
  • Add better icebreakers
  • Improve response quality
  • Reduce response time

​
High Drop-off at Paywall

Symptoms: Many users hit paywall but don’t convert Solutions:
  • Increase free message limit
  • Lower pricing
  • Improve value demonstration before paywall
  • Test different CTA messages

​
Tool Errors

Symptoms: High error rate on specific tools Solutions:
  • Check API endpoint health
  • Improve error handling
  • Add fallback behaviors
  • Update tool descriptions

​
Slow Response Times

Symptoms: Response time > 5 seconds Solutions:
  • Optimize tool API performance
  • Reduce document size
  • Simplify system prompt
  • Check for infinite loops

​
Exporting Data

Export analytics for further analysis:
  1. Go to Analytics
  2. Click Export
  3. Choose format (CSV, JSON)
  4. Select date range
  5. Download file

​
SDK Analytics Access

Retrieve metrics programmatically: 
// List conversations with filters
const conversations = await client.conversations.list({
  botId: agentId,
  active: true,
});

// Get conversation details
const conversation = await client.conversations.get(conversationId);

console.log(`Credits remaining: ${conversation.credits}`);
console.log(`Messages: ${(await client.conversations.getMessages(conversationId)).length}`);

​
Setting Up Alerts

Get notified of important events:
  1. Go to Settings → Notifications
  2. Configure alert thresholds:
    • Error rate exceeds X%
    • Response time exceeds X seconds
    • Daily message volume below/above threshold
  3. Choose notification method (email, webhook)

​
Best Practices

Set aside time each week to review analytics. Look for trends, not just snapshots.
Compare this week to last week. Did changes improve metrics?
Numbers tell part of the story. Reading actual conversations reveals the full picture.
When you make changes, give them time to show impact. Wait at least a week before judging.

​
What’s Next

Optimize Your Agent

Use insights to improve performance.

Tune Monetization

Optimize your pricing strategy.