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

# Test Conversation

> Turn real conversations into Test Conversations, run tests, review results, and compare versions.

The Test Conversation feature allows you to turn real conversations into repeatable tests. This guide walks you through the steps to create, run, and analyze test conversations.

***

## 1. Start from the Conversation page

* Open the conversation you want to test: `/conversation/:id`
* In the **Conversation Messages** header (top-right), click the three-dots button
* What you'll see:
  * If a test already exists: **Go to Test Conversation** (opens in new tab)
  * If no test exists: **Turn Into Test Conversation**

<img src="https://mintcdn.com/uservox/0AMKXIM3AjOcDIjX/images/con-turn-test.png?fit=max&auto=format&n=0AMKXIM3AjOcDIjX&q=85&s=9ec0886e7cc7c6423795e1e4e711305e" alt="Conversation Messages" width="1027" height="621" data-path="images/con-turn-test.png" />

> **Tip**: The menu briefly shows "Checking..." while verifying test existence

***

## 2. Create a Test Conversation (first time)

When you click **Turn Into Test Conversation**, a setup window appears:

<img src="https://mintcdn.com/uservox/0AMKXIM3AjOcDIjX/images/test-conv-create.png?fit=max&auto=format&n=0AMKXIM3AjOcDIjX&q=85&s=686c3094ec56983078f33752557b46ee" alt="Create Test Conversation" width="1582" height="1553" data-path="images/test-conv-create.png" />

1. **Review/Edit messages** - Adjust wording or add checks if needed
   <img src="https://mintcdn.com/uservox/0AMKXIM3AjOcDIjX/images/test-conv-turn-edit.png?fit=max&auto=format&n=0AMKXIM3AjOcDIjX&q=85&s=4e33bc6d34f364075993c9a6dfc32230" alt="Edit Messages" width="982" height="891" data-path="images/test-conv-turn-edit.png" />
2. **Add goals** - Define success criteria:
   * "Customer's name is captured"
   * "Offer is explained clearly"
3. **Confirm AI settings** (optional) - Model/provider/temperature
4. Click **Create Test**

**What happens next**:

* Test space is created
* New tab opens to the Test Conversation dashboard (`/test-conversation/:id`)

***

## 3. Test Conversation dashboard

Your control center for testing and learning:

<img src="https://mintcdn.com/uservox/0AMKXIM3AjOcDIjX/images/test-conv-dashboard.png?fit=max&auto=format&n=0AMKXIM3AjOcDIjX&q=85&s=ba9adca1f5477ab61430c363df15326e" alt="Test Conversation Dashboard" width="2183" height="1466" data-path="images/test-conv-dashboard.png" />

### A) Version controls

<img src="https://mintcdn.com/uservox/0AMKXIM3AjOcDIjX/images/test-conv-version-controls.png?fit=max&auto=format&n=0AMKXIM3AjOcDIjX&q=85&s=1e8d0246b234f43f3acf402878cf4f22" alt="Version Controls" width="2076" height="221" data-path="images/test-conv-version-controls.png" />

* **Choose Version**: Select which conversation version to test
* **Create New Version**: Duplicate existing or rebuild from original
* **Compare Versions**: View 2-3 versions side-by-side
* **View Results**: Access saved test runs

### B) Goals view

<img src="https://mintcdn.com/uservox/0AMKXIM3AjOcDIjX/images/test-conv-goal-view.png?fit=max&auto=format&n=0AMKXIM3AjOcDIjX&q=85&s=46052f0571a4941a9831c0bcfa2f14f7" alt="Goals View" width="2106" height="165" data-path="images/test-conv-goal-view.png" />

* **What Should This Conversation Achieve?** - Expand to see goals
* **Edit Goals**: Refine success criteria anytime

### C) Test controls

<img src="https://mintcdn.com/uservox/0AMKXIM3AjOcDIjX/images/test-conv-run-controls.png?fit=max&auto=format&n=0AMKXIM3AjOcDIjX&q=85&s=6d0e3dd3638beb5f75d55421e4e9baeb" alt="Test Controls" width="1014" height="135" data-path="images/test-conv-run-controls.png" />

* **Auto-play toggle**: ON = automatic advancement, OFF = manual Continue button
* **Start Test**: Begin simulation
* **Stop Test**: End early (saves gathered results)
* **Connection Status**: System readiness indicator

### D) Conversation view

* Messages appear as the test runs
* Auto-play shows reminder when enabled

***

## 4. Run a test

1. Select version
2. Toggle Auto-play ON/OFF
3. Click **Start Test**
4. Watch conversation:
   * Auto-play OFF: Click **Continue** at your pace
   * Auto-play ON: Advances automatically
5. Click **Stop Test** anytime to end early

**Completion**: Toast appears - "Test completed! Results saved successfully"

<img src="https://mintcdn.com/uservox/0AMKXIM3AjOcDIjX/images/test-conv-run-progress.png?fit=max&auto=format&n=0AMKXIM3AjOcDIjX&q=85&s=adfcf0bac28eb0601961c3663dc458c0" alt="Test in Progress" width="2056" height="1447" data-path="images/test-conv-run-progress.png" />

*Test conversation running with Auto-play enabled*

***

## 5. Create new versions

<img src="https://mintcdn.com/uservox/0AMKXIM3AjOcDIjX/images/test-conv-create-new-version.png?fit=max&auto=format&n=0AMKXIM3AjOcDIjX&q=85&s=8525502e054e27a0d90f409836338d8d" alt="Create New Version" width="1579" height="811" data-path="images/test-conv-create-new-version.png" />

After initial setup, create variants:

* **Duplicate existing version**: Copies all messages/goals
* **Create from conversation**: Start from original messages
  * Edit message content
  * Adjust goals
  * Confirm AI settings

***

## 6. Compare versions

<img src="https://mintcdn.com/uservox/0AMKXIM3AjOcDIjX/images/test-conv-compare-versions.png?fit=max&auto=format&n=0AMKXIM3AjOcDIjX&q=85&s=47b089d6f00f34f5fea645fc5d3b91fe" alt="Compare Versions" width="982" height="891" data-path="images/test-conv-compare-versions.png" />

1. Click **Compare Versions**
2. Choose 2-3 versions
3. Select different versions per column
4. Click **Compare**

**Split view shows**:

* Full conversation flow per version
* Synchronized scrolling

<img src="https://mintcdn.com/uservox/0AMKXIM3AjOcDIjX/images/test-conv-compare-versions-view.png?fit=max&auto=format&n=0AMKXIM3AjOcDIjX&q=85&s=4c49073a2719584acfc32fa11aa59b2f" alt="Version Comparison" width="2040" height="886" data-path="images/test-conv-compare-versions-view.png" />

*Side-by-side comparison of conversation versions*

***

## 7. Edit goals

Refine success criteria anytime:

<img src="https://mintcdn.com/uservox/0AMKXIM3AjOcDIjX/images/test-conv-edit-goals.png?fit=max&auto=format&n=0AMKXIM3AjOcDIjX&q=85&s=461eb2c3a794a3c4f40c39d4d8b3cadf" alt="Edit Goals Interface" width="1569" height="1451" data-path="images/test-conv-edit-goals.png" />

1. Review messages (jump to specific steps)
2. Adjust per-message checks
3. Confirm AI model settings (optional)
4. **Add New Goal**: Specify data to capture
5. Click **Save Changes**

> **Note**: Changes apply immediately to future tests

***

## 8. View test results

<img src="https://mintcdn.com/uservox/0AMKXIM3AjOcDIjX/images/test-conv-view-results.png?fit=max&auto=format&n=0AMKXIM3AjOcDIjX&q=85&s=d01d816bb718517d8b184069b171ce01" alt="View Results" width="982" height="922" data-path="images/test-conv-view-results.png" />

1. Click **View Results**
2. Select 1-3 runs
3. Click **Show**
   <img src="https://mintcdn.com/uservox/0AMKXIM3AjOcDIjX/images/test-conv-results.png?fit=max&auto=format&n=0AMKXIM3AjOcDIjX&q=85&s=017220285b6665edad0fc12cc95185c4" alt="Test Results View" width="2051" height="1139" data-path="images/test-conv-results.png" />

* **Results include**:
  * Version label and run number
  * Pass-rate badge (e.g., "82% pass rate")
  * Progress bar
  * Summary (when available)
  * Goals table (Goal | Pass/Fail | Explanation)
  * Message checks table
  * AI model details (expandable)

***

## 9. Common messages

* **Creating Test...**: After initiating test creation
* **Test completed!**: Run finished successfully
* **Choose at least 2 versions**: Comparison requirement
* **Select different versions**: Comparison constraint
* **Failed to load results**: Temporary issue
* **Auto-play is on**: Turn advancement reminder

***

## 10. Best practices

* **Define clear goals** - Enables pass/fail results with explanations
* **Use Auto-play** - For uninterrupted testing
* **Review after each run** - Learn what worked/didn't
* **Compare versions** - Spot impact of conversation tweaks
* **Iterate and improve** - Saved results remain available

***

## Summary

With Test Conversations, you can:

* Turn real conversations into repeatable tests
* Measure performance against defined goals
* Compare different conversation versions
* Continuously improve based on clear metrics

Start testing today to optimize your conversation flows!