> For the complete documentation index, see [llms.txt](https://docs-convai.wavy.global/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs-convai.wavy.global/channels/phone-and-voice.md).

# Phone & voice

We see a voice bot as nothing more than an extra layer on top of your chatbot. You can reuse your existing chatbot, and Chatlayer will handle the speech-to-text (STT) and text-to-speech (TTS). Configuring voice in Chatlayer.ai is a matter of minutes, and we've created some custom components to make configuration easier.

Activate your Chatlayer.ai phone channel by going to the Channels tab, and clicking the + icon next to Phone.

![](/files/-MFgE7qSbdQjGT4H7A0g)

## Architecture

### Testing

If you want to test out a first version of your voice bot, before going to production, you can use the Chatlayer.ai test number. Before you can use this test number to call your bot, you have to your number to the bot, so Chatlayer.ai knows which bot you're trying to talk to.

Click the Create Configuration button to set this up. The Chatlayer.ai test number will be shown on top of the Phone configuration screen.

![](/files/-MFgE7qTEY3PRKvjo1kz)

### Production

When you're ready to move your bot to production, [get in touch](broken://pages/-MFgE12uxTDjHAezfQse) with us. We will set up a phone number for your bot specifically which can be used to forward calls to or be called directly. A typical phone architecture looks like this:

![](/files/-MFgE7qUj0Vs5BoFf69k)

## Voice-specific Chatlayer.ai components

### Silence detected event

If you want to trigger a certain flow when the user is silent for a set time, use the event described [here](/bot-answers/events.md#silence-detected-event).

### Voice message format type for input validation

You can save whatever it is the user is saying as a variable by using the voice message format type in an input validation. Read more [here](/bot-answers/dialog-state/user-input-bot-dialog.md#voice-message).

### Actions: forward call & close call

These actions are available when you configure the voice channel and will allow you to:

* Forward a call to a number of your choosing, often used to handover a customer from the bot to a live agent,
* Close the call by hanging up.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs-convai.wavy.global/channels/phone-and-voice.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.