> ## Documentation Index
> Fetch the complete documentation index at: https://docs.threetone.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Managing Conversations

> Track, monitor, and analyze voice agent conversations

## Conversation Lifecycle

### Starting Conversations

Conversations are automatically initiated when users interact with your voice agents through phone calls or other channels.

### Monitoring Active Conversations

Track real-time conversation status and metrics:

```bash cURL theme={null}
curl --request GET \
  --url https://api.threetone.in/v1/voiceai/conversations \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json'
```

### Conversation Details

Retrieve detailed information about specific conversations:

```bash cURL theme={null}
curl --request GET \
  --url https://api.threetone.in/v1/voiceai/conversations/{conversation_id} \
  --header 'x-api-key: YOUR_API_KEY'
```

## Conversation Analytics

### Key Metrics

Monitor important conversation metrics:

* **Duration**: Total conversation time
* **Turn Count**: Number of exchanges between user and agent
* **Resolution Status**: Whether the conversation was resolved successfully
* **User Satisfaction**: Sentiment analysis and feedback scores

### Performance Tracking

Track agent performance across conversations:

```json theme={null}
{
  "conversation_id": "conv_123",
  "agent_id": "agent_456",
  "duration_seconds": 180,
  "turn_count": 12,
  "resolution_status": "resolved",
  "satisfaction_score": 4.2,
  "topics": ["product_inquiry", "pricing", "support"]
}
```

## Conversation History

### Retrieving Transcripts

Access conversation transcripts for analysis:

```bash cURL theme={null}
curl --request GET \
  --url https://api.threetone.in/v1/voiceai/conversations/{conversation_id}/transcript \
  --header 'x-api-key: YOUR_API_KEY'
```

### Audio Recordings

Download conversation audio files:

```bash cURL theme={null}
curl --request GET \
  --url https://api.threetone.in/v1/voiceai/conversations/{conversation_id}/audio \
  --header 'x-api-key: YOUR_API_KEY'
```

## Real-time Monitoring

### WebSocket Integration

Monitor conversations in real-time using WebSocket connections for live updates on conversation status, transcription, and analytics.

### Alerts and Notifications

Set up alerts for:

* Long conversation durations
* Low satisfaction scores
* Escalation triggers
* System errors or failures

## Best Practices

### Conversation Quality

* Monitor average conversation duration
* Track resolution rates
* Analyze common conversation patterns
* Identify areas for agent improvement

### Data Management

* Implement proper data retention policies
* Ensure compliance with privacy regulations
* Regular backup of conversation data
* Secure storage of sensitive information

## Next Steps

* [Advanced Configuration](/guides/voice-agents/advanced-configuration)
* [Phone Integration Setup](/guides/phone-integration/setup)
* [Analytics and Reporting](/capabilities/conversation-management)