Skip to main content

Overview

TalkifAI provides two separate analytics pages:
  1. Analytics (/analytics) — Usage metrics, credit tracking, and quota monitoring
  2. Call Logs (/call-logs) — Detailed call records with transcripts, recordings, and post-call analysis
Navigate via Studio → Analytics or Studio → Call Logs to access your metrics.

Analytics Page

URL: /analytics The Analytics page shows high-level usage metrics and credit consumption.

Summary Cards

Four key metrics displayed at the top:
CardDescriptionColor
Total SessionsTotal number of voice/chat interactionsPurple gradient
Total Usage TimeCumulative duration of all sessionsGray gradient
Tier / CreditsYour plan tier and remaining creditsWhite
Active AgentsNumber of unique agents usedBlack gradient

Credit System

TalkifAI uses a credit-based billing system (not minute quotas). Free Tier:
  • 300 credits per month
  • Resets on the 1st of each month
  • Shown as progress bar with percentage used
Developer Tier:
  • Custom credit limit (e.g., 3,000 credits)
  • Per-user, per-organization
  • Shown as “X% of Developer quota used”
Credit Consumption:
  • Voice calls: ~$0.073/minute average
  • Chat sessions: ~$0.001/message average
  • Deducted automatically after each session
Credits vs Minutes: The system now uses credits instead of minute quotas. One credit = $1.00 USD.

Check Credit Balance

Via UI:
  • View remaining credits on Analytics page
  • Green bar = healthy balance
  • Red bar = low balance warning
Via API:
GET /api/call-logs/check-usage
Authorization: Bearer YOUR_SESSION_TOKEN
Response:
{
  "canProceed": true,
  "remaining": 250.50,
  "balanceData": {
    "balance": 250.50,
    "gracePeriodLimit": 5.00
  },
  "hasSufficientBalance": true,
  "organizationId": "org_abc123",
  "role": "user"
}
Response Fields:
FieldTypeDescription
canProceedbooleanWhether user has sufficient credits
remainingnumberRemaining credit balance
hasSufficientBalancebooleanIncludes grace period logic
balanceDataobjectFull balance details
rolestringUser role (user/developer/owner/admin)

Low Balance Alerts

Automatic Warnings:
  • < 20% remaining: Dashboard warning appears
  • < $5.00: Low balance toast notification
  • $0.00: Cannot initiate new calls (grace period may apply)
Grace Period:
  • Default: $5.00 grace period
  • Allows completing ongoing calls even at $0.00
  • Must add credits to restore positive balance

Call Logs Page

URL: /call-logs The Call Logs page shows detailed records of every voice and chat session.

Summary Cards

CardDescription
Total CallsTotal number of calls
Successful CallsCalls completed successfully
Success RatePercentage of successful calls
Avg DurationAverage call length
Active AgentsUnique agents used

Call Log Fields

Every session is automatically logged with:
FieldDescription
Session IDUnique identifier (click to view details)
AgentWhich agent handled the call
Source TypeVoice, Phone, or Chatbot
DurationTotal call length in seconds
Start TimeWhen the call began (with timezone)
End TimeWhen the call ended
DirectionInbound or outbound
Phone NumberCaller/destination number
StatusCompleted, failed, abandoned
CostTotal cost in credits

Filtering Call Logs

Filter your call logs by:
FilterOptions
Date RangeCustom start/end dates
AgentSelect specific agent
Source TypeVoice / Phone / Chatbot
StatusCompleted / Failed / Abandoned
SearchSearch by phone number or session ID
Pagination:
  • Default: 50 calls per page
  • Options: 25, 50, 100 per page
  • Shows: “Showing X to Y of Z calls”

Session Detail Panel

Click any call in the list to open the Session Detail Panel.

Panel Tabs

The panel has three tabs:

Tab 1: Transcript

Displays:
  • Full conversation transcript
  • Speaker labels (User / Agent)
  • Timestamps for each segment
  • Confidence scores (if available)
Features:
  • Scrollable transcript
  • Timezone-aware timestamps
  • Copy to clipboard option
Example:
[00:00] Agent: Hello! How can I help you today?
[00:03] User: I need help with my billing.
[00:05] Agent: Of course. Can you give me your account number?
Accessing Transcripts:
  1. Go to Call Logs page
  2. Click on any call session
  3. Select Transcript tab
  4. View or copy transcript

Tab 2: Recording

Displays:
  • Audio player for call recording
  • Playback controls (play, pause, speed)
  • Download button
  • Recording metadata (duration, format)
Features:
  • Variable playback speed (0.5x - 2x)
  • Download recording as MP3
  • Waveform visualization
Recording Requirements:
  • Must be enabled per-agent in Agent Settings → Recording
  • Ensure compliance with local recording consent laws
  • Recordings stored securely with access control
Accessing Recordings:
  1. Go to Call Logs page
  2. Click on any call session
  3. Select Recording tab
  4. Play or download recording

Tab 3: Analysis

Displays:
  • Post-call analysis results (if configured)
  • QA form responses
  • Sentiment analysis
  • Custom metrics
Features:
  • Structured analysis data
  • Export analysis results
  • View by question type
Accessing Analysis:
  1. Go to Call Logs page
  2. Click on any call session
  3. Select Analysis tab
  4. View post-call analysis results

Chat Sessions

For text-based chat sessions (Chat API):

Chat Messages Viewer

Displays:
  • Full message history
  • User and assistant messages
  • Timestamps for each message
  • Token counts (input/output)
Features:
  • Scrollable message list
  • Message-by-message breakdown
  • Total token count

Chat Session Costs

Pricing:
  • Per-message billing
  • Input tokens: ~$0.0001/100 tokens
  • Output tokens: ~$0.0003/100 tokens
Cost Display:
  • Total cost shown in session details
  • Cost per message breakdown
  • Cumulative session cost

Post-Call Analysis

Configure custom QA forms to automatically analyze calls after they end.

Setting Up Forms

Location: Agent Settings → Post-Call Analysis Steps:
  1. Go to your agent → Settings
  2. Scroll to Post-Call Analysis section
  3. Click Add Field
  4. Configure each field:
    • Field Name: Internal identifier
    • Label: Display name
    • Type: Text / Yes-No / Rating (1-5) / Number
    • Required: Yes/No
    • Order: Drag to reorder fields
Example Form:
1. Was the customer's issue resolved? (Yes/No) ✅ Required
2. Customer sentiment: (Positive / Neutral / Negative) ✅ Required
3. Follow-up required? (Yes/No)
4. Notes: (Text)

Analysis Model Selection

Available Models:
  • GPT-5 Mini (default)
  • GPT-5 Nano
  • Gemini 2.5 Flash
  • Gemini 2.5 Flash Lite
Model Settings:
  • Select model from dropdown
  • Different models for different agents
  • Balance cost vs accuracy

Viewing Results

Per-Call Results:
  1. Go to Call Logs
  2. Click on a call session
  3. Select Analysis tab
  4. View completed form responses
Aggregate Results:
  • Export all analysis data
  • Filter by date range
  • Analyze trends over time
Via API:
GET /api/post-call-analysis/room/{roomName}
Authorization: Bearer YOUR_SESSION_TOKEN
Response:
{
  "success": true,
  "analysis": {
    "roomName": "agent_xyz_1705320000_user123",
    "agentId": "agent_xyz",
    "agentName": "Customer Support Bot",
    "analysisData": {
      "issueResolved": true,
      "sentiment": "positive",
      "followUpRequired": false,
      "notes": "Customer satisfied with resolution"
    },
    "createdAt": "2024-01-15T10:35:00Z"
  }
}

Export Data

Export Call Logs

Location: Call Logs → Export Logs button Format: CSV file Includes:
  • All call log fields
  • Filtered by current filters
  • Date range selection
  • Transcript option (if enabled)
  • Post-call analysis option (if enabled)
Steps:
  1. Apply desired filters
  2. Click Export Logs button
  3. Select export options
  4. Download CSV file

Export Transcripts

Location: Session Detail Panel → Transcript tab Format: Text file or JSON Includes:
  • Full conversation transcript
  • Speaker labels
  • Timestamps
  • Confidence scores

Usage Monitoring

Real-Time Updates

Auto-Refresh:
  • Analytics page updates every 30 seconds
  • Call Logs page updates every 30 seconds
  • Manual refresh button available
Cross-Tab Sync:
  • Changes sync across browser tabs
  • Uses CustomEvent for communication
  • No manual refresh needed

Cost Tracking

Per-Session Costs:
  • Voice calls: Duration-based pricing
  • Chat sessions: Message-based pricing
  • Real-time cost calculation
Cost Breakdown:
  • Base cost (infrastructure)
  • LLM cost (AI processing)
  • STT cost (speech-to-text, voice only)
  • TTS cost (text-to-speech, voice only)
View Costs:
  • Session detail panel → Cost section
  • Call Logs → Cost column
  • Analytics → Total usage card

Troubleshooting

Problem: No transcript shown for a call.Check:
  1. Was transcription enabled on the agent?
  2. Did the call complete successfully?
  3. Is the session type “chat” (uses ChatMessages instead)?
Fix: Enable transcription in agent settings for future calls.
Problem: Recording player shows error.Check:
  1. Was recording enabled on the agent?
  2. Is the recording file still available?
  3. Try downloading and playing locally
Fix: Contact support if recording is missing.
Problem: Analysis tab is empty.Check:
  1. Is post-call analysis configured for this agent?
  2. Has analysis completed processing? (takes 10-30 seconds)
  3. Check agent’s analysis model selection
Fix: Configure post-call analysis in agent settings.
Problem: Red balance warning appears.Solution:
  1. Add credits via Billing → Add Credits
  2. Review usage in Analytics page
  3. Set up auto-recharge (coming soon)
Problem: Export button doesn’t work.Solution:
  1. Reduce date range (export less data)
  2. Apply filters to reduce result set
  3. Try again in a few moments