> ## Documentation Index
> Fetch the complete documentation index at: https://docs.toolzz.dev/llms.txt
> Use this file to discover all available pages before exploring further.
# Voice
> O recurso Voice no ToolzzAI permite a configuração e criação de Agentes de voz Inteligentes, oferecendo ao usuário total controle sobre a gestão do Agente e suas interações.
Com esse módulo, é possível ajustar o quais palavras o Agente pode falar, conectar credenciais de voz, personalizar respostas e configurar diversos parâmetros como tempo de ligação entre outros conforme sua necessidade
O recurso de voz está em fase beta, funcionando com chaves da OpenAI e modelos **GPT-4-O, GPT-4-O Mini, GPT-4.1 Mini e GPT-4.1 Nano**. Outros LLMs serão lançados ainda neste semestre.
## Pré-Requisitos
1. Possuir registro na plataforma e uma [Instituição](/ai-reference/endpoint/institution/introduction) criada com sucesso!
2. Possuir o adicional Voice no plano utilizado.
3. Para integrar a voz, é necessário ter uma conta no Eleven Labs, onde é possível clonar sua voz.
4. Possuir chave de API ElevenLabs ou OpenAI para geração da voz do agente
5. Possuir agentes suficientes dentro do plano da instituição.
6. Possuir [unidades](/ai-reference/endpoint/unity/introduction) suficientes dentro do plano da instituição.
## Configuração do Voice
### Primeiros Passos
1. Ao entrar nas configurações dos agente o usuário irá ativar o recurso "Voice" e irá encontrar uma nova aba no setup mágico
2. Caso não possua o adicional em seu plano, será exibido uma tela onde clicando em "Fazer upgrade" poderá comprá-lo
3. Após o sucesso da compra terá acesso as configurações do voice
### Informações Básicas
Na aba de informações básicas é onde é realizada as principais configurações da voz e comportamente da ligação e do Agente de voz.
#### Configurações de voz
1. **Credencial:** Ao entrar nas informações básicas o usuário deve conectar sua credencial [*ElevenLabs*](https://elevenlabs.io/docs/overview?_gl=1*ucwdot*_up*MQ..*_gs*MQ..\&gclid=CjwKCAjw7fzDBhA7EiwAOqJkh-z2GZAU41pcQETJeBLI8x7GngGMXHm0MTzeQ2MwSs_rWcKkTOjhvBoCCqcQAvD_BwE). [Veja como criar uma credencial aqui](/ai-reference/endpoint/credential/introduction)
2. **Idioma:** Escolha qual idioma seu Agente deverá ter como principal idioma
3. **Voice ID:** Campo onde após selecionada a voz, é exibido o Id da voz. O id da voz pode ser inserido diretamente.
4. **Clonar Voz:** Aqui o usuário é capaz de clonar a própria voz ou inserir um áudio externo para treinar a voz.
5. **Selecionar Voz:** Campo onde o usuário poderá selecionar as vozes disponíveis na credencial
6. **Modelo:** Campo onde usuário poderá selecionar qual modelo de voz elevenlabs disponíveis para utilizar
A clonagem de voz não funciona com os **planos gratuitos** da ElevenLabs
#### Configurações da Chamada
1. **Comportamento do Voice:** O Comportamento do Voice tem a funcionalidade de complementar o "Comportamento do Bot" no Cérebro do seu agente. Você deve instruir como o seu agente deve se comportar durante uma chamada de voz.
2. **Primeria mensagem:** Campo que define qual será a primeira fala do Agente na chamada. Caso vazio, utilizará o padrão.
3. **Tempo máximo de espera (Em minutos):** Usuário será desconectado da chamada assim que o tempo limite configurado for atingido
4. **Tempo máximo de ligação (Em minutos):** Usuário será desconectado assim que o tempo limite for atingido
### Estilo da Interface
Aba que permtite a configuração visual do Agente de voz
#### Avatar
* Campo onde poderá ser realizado o upload da imagem no Agente de voz
* Recomendado upload de imagem de proporção 1:1
#### Widget
* Campo onde usuário poderá selecionar qual widget será utilizado.
* Os widget disponíveis são: **Compactado; Expandido; Completo, Vertical e Microfone**
* Widget Vertical **não funciona** modo Padrão e modo Dark e não é afetado pelas cores
### Cores
* Campo onde é configurado as cores do Widget do Agente de Voz.
* Podendo também escolher entre o modo **Padrão** e **Dark**
* **Cor primária do Web:** Altera a cor do botão de ligação no modo Web
* **Cor do texto do botão do Web:** Altera a cor do ícone de microfone no balão no modo Web
* **Cor primária:** Altera a cor do botão de ligação nos Widgets
* **Cor do texto do botão:** Altera a cor do texto do botão de ligação nos Widgets
* **Tema** Usuário pode selecionar se a cor de fundo vai ser o Branco (Padrão) ou Preto (Dark)
### Textos
* Configure e personalize os textos da Interface
* **Título do chat:** Campo para configurar o título exibido no Agente
* **Descrição do chat:** Campo para configurar a descrição que será exibido no Agente
## Receber Ligação e Curl da ligação
* **Código CURL:** Com o código os usuários que gerenciam o Voice poderão utilizar a API para realizar ligação da forma que preferir. [Também disponível aqui](/ai-reference/endpoint/voice/call-phone)
* **Receber Ligação:** Pode ser utilizado para testar a funcionalidade, **recebendo uma ligação** diretamente no número inserido. Podendo verificar a qualidade da conexão e garantir que o sistema está funcionando corretamente para suas futuras necessidades.
