> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/maiagent-user-guide/en/serve/voice.md).

# Voice Customer Service: From Setup to Launch

Voice support from zero to go-live: confirm voice is enabled for your organization, get the Agent answering correctly in text first, turn on the voice assistant, try speaking on the web, then connect

Voice support lets an Agent serve customers by listening and speaking. There are two entry points, both using the same Agent and the same voice settings:

* **Web voice**: Customers click the headset icon in the Web Chat input bar to talk with the Agent by voice.
* **Phone**: A SIP line from your carrier or your own PBX is connected to the Call Center, and calls to the support hotline are answered by the Agent.

This page lists the steps in go-live order. The details of each step are on the corresponding MaiAgent Build feature page.

## Before You Start <a href="#before-you-start" id="before-you-start"></a>

| Item                  | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Deployment type       | Available on MaiAgent cloud (SaaS). For private cloud, it must be enabled in the deployment settings and the real-time voice components must be deployed. On-premises deployment does not provide the voice assistant or the Call Center. For a comparison of features by deployment type, see [Deployment Types and Feature Comparison](https://docs.maiagent.ai/tech/platform-development/onprem-deployment-types#feature-availability) in the technical manual. |
| Organization features | Under <mark style="color:blue;">Advanced Features</mark> in the [Organization Overview](https://docs.maiagent.ai/maiagent-user-guide/en/org/overview/organization-overview.md#advanced-features), <mark style="color:blue;">AI Voice Assistant</mark> must be enabled. Answering phone calls also requires <mark style="color:blue;">Call Center</mark>. If they are not enabled, contact your MaiAgent representative.                                            |
| Permissions           | Enabling voice requires permission to edit the Agent. Setting up a phone line requires the Call Center <mark style="color:blue;">Inbound Call Settings</mark> permission. See [Phone Support (Call Center)](https://docs.maiagent.ai/maiagent-user-guide/en/build/choose-channel/call-center.md#permissions).                                                                                                                                                      |

## Go-Live Flow <a href="#setup-flow" id="setup-flow"></a>

{% stepper %}
{% step %}

### Prepare an Agent that answers questions well <a href="#prepare-agent" id="prepare-agent"></a>

First tune the role instructions and knowledge base in text and confirm the answers are correct, and then add voice. For how, see steps 1–2 of [Text Support: From Zero to Go-Live](https://docs.maiagent.ai/maiagent-user-guide/en/serve/text-service.md).
{% endstep %}

{% step %}

### Enable voice <a href="#enable-voice" id="enable-voice"></a>

In the Agent settings, find <mark style="color:blue;">Voice Assistant Settings</mark> under <mark style="color:blue;">Reply Mode Settings</mark>, turn on <mark style="color:blue;">Enable Voice Assistant</mark>, and select the <mark style="color:blue;">Voice Assistant Mode</mark> and the provider. For the differences among the three modes, interruption control, and tool limitations, see [Voice Assistant (Voice Agent)](https://docs.maiagent.ai/maiagent-user-guide/en/build/agent/voice-agent.md).
{% endstep %}

{% step %}

### Set the voice greeting <a href="#set-voice-greeting" id="set-voice-greeting"></a>

Set the <mark style="color:blue;">Voice Greeting</mark> in the conversation platform's [Interaction Settings](https://docs.maiagent.ai/maiagent-user-guide/en/build/conversation-settings/platform-settings/interaction-settings.md#voice-greeting). Web voice uses the settings of the web platform where the customer is. Phone uses the default greeting of this Agent's API conversation platform.
{% endstep %}

{% step %}

### Try speaking on the web <a href="#test-on-web" id="test-on-web"></a>

After voice is enabled, a <mark style="color:blue;">Voice Mode</mark> button appears below the public access URL in the web platform's [Basic Settings](https://docs.maiagent.ai/maiagent-user-guide/en/build/conversation-settings/platform-settings/basic-settings.md#public-url-and-embed), which opens a voice conversation directly. The headset icon also appears in the input bar of Web Chat embedded in your website. Confirm that the Agent understands you, answers correctly, and has a suitable speaking speed and tone.
{% endstep %}

{% step %}

### Connect a phone line <a href="#connect-phone-line" id="connect-phone-line"></a>

If you only offer web voice, you can skip this step. In the <mark style="color:blue;">Call Center</mark>, add a SIP trunk and a number, bind the number to this Agent, and wait until the <mark style="color:blue;">Sync Status</mark> changes to <mark style="color:blue;">Synced</mark>. See [Phone Support (Call Center)](https://docs.maiagent.ai/maiagent-user-guide/en/build/choose-channel/call-center.md#setup-flow).
{% endstep %}

{% step %}

### Make a test call <a href="#test-call" id="test-call"></a>

Call the number from a mobile phone and confirm that the Agent answers and responds correctly. Then go to <mark style="color:blue;">Call History</mark> to view the record of this call and its voice transcript. See [Call History](https://docs.maiagent.ai/maiagent-user-guide/en/build/choose-channel/call-center.md#call-history).
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
The Call Center currently has no setting for transferring calls to a human agent or extension. If you need to transfer calls to an existing contact center system, contact your MaiAgent representative to evaluate an integration approach.
{% endhint %}

## After Go-Live <a href="#after-launch" id="after-launch"></a>

* **Check calls**: Call records and status are in [Call History](https://docs.maiagent.ai/maiagent-user-guide/en/build/choose-channel/call-center.md#call-history). Each call is also a conversation, which you can view in [All Conversations](https://docs.maiagent.ai/maiagent-user-guide/en/serve/daily-operations/reply.md).
* **Check usage**: STT seconds, TTS characters, and voice model token counts are on the <mark style="color:blue;">Voice Assistant</mark> tab of [Usage Statistics](https://docs.maiagent.ai/maiagent-user-guide/en/others/usage-statistics.md#tabs).
* **Adjust how it speaks**: If replies are too long or are often interrupted, go back to [Voice Assistant (Voice Agent)](https://docs.maiagent.ai/maiagent-user-guide/en/build/agent/voice-agent.md) and adjust the interaction mode and interruption control.

## Use Cases <a href="#use-cases" id="use-cases"></a>

For other applications of voice data, such as IVR intent recognition, call summaries, and call quality inspection, see [Use Case: Voice Support](https://docs.maiagent.ai/maiagent-user-guide/en/serve/voicecs.md).


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.maiagent.ai/maiagent-user-guide/en/serve/voice.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
