Interview Sessions

A session represents a single interview instance. Learn how sessions work, their lifecycle, and how to manage them effectively.

Session Lifecycle

1. Created

Session is initialized when participant clicks invite link.

What happens:

• Unique session ID generated
• Session linked to campaign and script
• Consent page displayed to participant

2. In Progress

Participant is actively conducting the interview.

Features available:

• Real-time transcript streaming
• Audio/video feed (if enabled)
• Pause/resume functionality
• Live monitoring dashboard

3. Paused

Participant temporarily stopped the interview.

Timeout behavior:

• Auto-resume prompt after 2 minutes of inactivity
• Session expires after 30 minutes of pause
• Can resume from exact point they left off

4. Completed

Interview successfully finished.

Post-completion:

• Full transcript available
• Audio recording stored
• Participant can view summary
• Webhooks triggered
• Data ready for export

5. Abandoned

Participant started but didn't complete.

Common reasons:

• Technical issues (audio problems, browser crashes)
• Participant lost interest
• Interview too long
• Unexpected interruption

Session Data

What's Captured

Each session stores:

Metadata:

• Session ID
• Campaign and Script IDs
• Start/end timestamps
• Duration
• Device and browser info
• IP address (optional, for fraud detection)

Content:

• Full transcript (AI and participant speech)
• Audio recording (WAV/MP3 format)
• Turn-by-turn conversation log
• Sentiment scores per turn
• Custom metadata from URL parameters

Analytics:

• Completion status
• Drop-off point (if abandoned)
• Response times
• Engagement metrics

Data Retention

• Transcripts: Stored indefinitely (unless manually deleted)
• Audio: Configurable retention (default: 90 days)
• Metadata: Stored indefinitely
• PII: Can be automatically redacted after configurable period

Viewing Sessions

Session Detail Page

Access comprehensive session information:

1. Navigate to Sessions
2. Click on any session
3. View transcript, audio, and metadata

Tabs available:

• Transcript: Full conversation with timestamps
• Audio: Playback with waveform visualization
• Analysis: Sentiment, topics, key insights
• Metadata: Technical details and custom data
• Exports: Download in various formats

Real-time Monitoring

Watch interviews as they happen:

1. Go to Live Sessions dashboard
2. See all active interviews
3. Click to view real-time transcript
4. Monitor for quality assurance

Managing Sessions

Pause and Resume

Participants can pause interviews:

Participant controls:

• Click Pause button during interview
• Close browser (auto-pauses)
• Navigate away from page

Resume process:

• Return to invite link
• Session automatically resumes from last point
• Context preserved

Limitations:

• 30-minute pause timeout
• Maximum 3 pauses per session (to prevent abuse)

Manual Intervention

Administrators can:

End session early:

• Useful if participant is stuck in a loop
• Marks session as "Admin Ended"
• Preserves transcript up to that point

Restart session:

• Issues new session for same participant
• Original session marked as "Restarted"
• Useful after technical issues

Delete session:

• Permanently removes all data
• Cannot be undone
• Used for test sessions or GDPR requests

Exporting Session Data

Individual Session Export

From session detail page:

PDF Transcript:

• Formatted, readable transcript
• Includes metadata header
• Ready for sharing with stakeholders

Raw JSON:

• Complete session data
• Turn-by-turn messages
• Timestamps and metadata
• For programmatic analysis

Audio File:

• MP3 or WAV format
• Full interview audio
• Separate tracks for AI and participant (if available)

Bulk Export

Export multiple sessions:

1. Navigate to Sessions
2. Apply filters (campaign, date range, status)
3. Select sessions to export
4. Choose format (CSV, JSON, ZIP of PDFs)
5. Download

CSV format includes:

session_id,campaign,started_at,completed_at,duration,status,transcript_url
ses_123,camp_456,2024-10-20T10:00:00Z,2024-10-20T10:08:32Z,512,completed,https://...

Session Analytics

Individual Metrics

Per session:

• Duration: Total time from start to completion
• Word Count: Total words spoken (AI + participant)
• Turn Count: Number of back-and-forth exchanges
• Sentiment: Overall emotional tone
• Engagement Score: How engaged the participant was

Aggregate Analytics

Across multiple sessions:

• Average Duration: Typical interview length
• Completion Rate: % of started sessions that finished
• Drop-off Analysis: Where participants quit
• Quality Scores: Based on response depth and engagement

Audio and Video

Audio Recording

All sessions are audio-recorded by default:

Settings:

• Enable/disable recording per script
• Choose audio quality (standard, high, or ultra)
• Separate tracks for AI and participant
• Background noise suppression

Storage:

• Stored in secure cloud storage
• Encrypted at rest and in transit
• Configurable retention period
• Can be disabled entirely for sensitive topics

Video (Coming Soon)

Optional video recording for visual interviews:

• Facial expression analysis
• Body language insights
• Screen sharing capability
• Higher storage costs

Privacy and Security

Consent Management

Before each interview:

• Participant must accept terms
• Informed about recording
• Option to decline participation
• Can request data deletion post-interview

Data Access Controls

Restrict who can view sessions:

• Campaign Owner: Full access to their campaigns
• Team Members: Configurable permissions
• Viewers: Read-only access
• Analysts: Export rights only

PII Handling

Automatically detect and handle PII:

• Redaction: Remove emails, phone numbers, SSN
• Masking: Replace with placeholders (e.g., [EMAIL])
• Encryption: Extra layer for sensitive fields
• Auto-deletion: Remove after retention period

Troubleshooting

Session Won't Start

Possible causes:

• Browser doesn't support WebRTC
• Microphone permission denied
• Ad blocker interference
• Firewall blocking WebSocket connections

Solutions:

• Test browser compatibility
• Guide participant through permission granting
• Whitelist your domain in ad blocker
• Use TURN server for restrictive networks

Audio Quality Issues

Common problems:

• Background noise
• Echo or feedback
• Low volume
• Distortion

Solutions:

• Recommend headphones
• Suggest quiet environment
• Check microphone quality
• Use noise cancellation feature

Session Stuck "In Progress"

If a session doesn't properly complete:

Admin action:

• Wait 30 minutes (may auto-complete)
• Manually mark as complete if transcript exists
• Mark as abandoned if minimal data captured
• Contact participant to restart if needed