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

# Simulator

> Simulate conversations and validate configuration

The [Simulator](https://platform.typewise.app/simulator) lets you test AI chat,
email, and WhatsApp conversations. It has three tabs: the **Playground** for
ad-hoc manual conversations,
**[Tests](https://docs.typewise.app/documentation/testing-and-feedback/tests.md)** for automated test
scenarios, and **Simulated customers** for the
[test customers](https://docs.typewise.app/documentation/testing-and-feedback/tests.md#test-customers) you
reuse in both.

You can also use the simulator to test changes to your AI Agent's behavior,
knowledge, and actions before [publishing](https://docs.typewise.app/documentation/behavior/publishing.md)
them.

## Start a new conversation

**1. Click New conversation**

Click **New conversation** in the Playground.

**2. Pick a channel**

Choose **Chat**, **Email**, or **WhatsApp**.

**3. Pick a simulated customer**

Choose **Anonymous visitor**, a saved customer, or **New customer** to enter
a name, email, phone, and context variables. Tick **Save to reuse in other
tests and conversations** to keep a new customer.

**4. Add email details (Email only)**

Enter a **Subject** and, optionally, **CC Addresses**.

**5. Include unpublished changes**

Toggle **Include unpublished changes** to test your drafts, or turn it off
to test the live configuration.

**6. Start**

Click **Start** to open the conversation.

Email conversations need a customer with an email address: **Start** stays
disabled until the customer has one, so pick a saved customer with an email or
enter one under **New customer**. Without a phone number, WhatsApp messages come
from a test number.

![New conversation dialog with Chat selected, the Simulated customer picker, and Include unpublished changes turned on](https://mintcdn.com/typewise/I1f8iY7DWGfLoSdg/images/documentation/testing-and-feedback/simulator/simulator-create-chat.png?fit=max\&auto=format\&n=I1f8iY7DWGfLoSdg\&q=85\&s=b1257a7dc62f36e960b01b041e0424dd)

![New conversation dialog with Email selected, showing Subject and CC Addresses](https://mintcdn.com/typewise/I1f8iY7DWGfLoSdg/images/documentation/testing-and-feedback/simulator/simulator-create-email.png?fit=max\&auto=format\&n=I1f8iY7DWGfLoSdg\&q=85\&s=e8b02584690c16217bae9926ba6a4c54)

## In the Playground

Once inside the Playground, you can:

* Send test messages as the customer and watch how the AI Agent responds.
* Test handoff conditions, response logic, and conversation flow.
* Click **Restart** to start the same conversation again, or **New
  conversation** to begin another.
* Click **Turn into test** to have [Nova](https://docs.typewise.app/documentation/nova/what-nova-can-do.md)
  draft an automated test from the conversation. Nova creates and runs it once
  you confirm. The button is enabled once the AI Agent has replied, and needs
  Nova.

> [!TIP]
>
> The Playground is ideal for validating Specialist behavior and fine-tuning
> instructions before going live.

> [!NOTE]
>
> Tickets created via the simulator will not be shown inside your inbox.

## See also

* [Automated Tests](https://docs.typewise.app/documentation/testing-and-feedback/tests.md): Create automated
  test scenarios with checks and evaluation
* [Specialists](https://docs.typewise.app/documentation/behavior/specialists.md): Create topic-specific AI
  behavior
* [Knowledge](https://docs.typewise.app/documentation/knowledge/overview.md): Add knowledge sources for the
  AI
* [Actions](https://docs.typewise.app/documentation/actions/overview.md): Configure automated and manual
  actions
* [Publishing](https://docs.typewise.app/documentation/behavior/publishing.md): Publish changes to your AI
  Agent's behavior, knowledge, and actions


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.