# Como adicionar uma voz para os seus agentes de IA

No SyBox, isso é feito em Definições > IA e automação > Agentes de IA. Um modelo de voz transforma a resposta de um agente de IA em uma mensagem de voz com a voz que você escolher. Quando um cliente envia uma mensagem de voz, o agente responde com outra. 1) Vá em Configurações > IA e automação > Agentes de IA e abra a aba "Vozes". 2) Clique em "Novo modelo de voz". Escolha o "Provedor" e cole a "Chave de API" dele. 3) Escolha o "Dialeto" e depois a "Voz" (em "Vozes femininas" ou "Vozes masculinas"). ▶ reproduz a amostra do próprio provedor, sem custo. Para usar uma voz sua, escolha "Outra voz: cole o ID" e cole o "ID da voz". 4) Opcional: em "Uma voz para cada…

## Como adicionar uma voz para os seus agentes de IA

1. Vá em Configurações > IA e automação > Agentes de IA e abra a aba "Vozes".
2. Clique em "Novo modelo de voz". Escolha o "Provedor" e cole a "Chave de API" dele.
3. Escolha o "Dialeto" e depois a "Voz" (em "Vozes femininas" ou "Vozes masculinas"). ▶ reproduz a amostra do próprio provedor, sem custo. Para usar uma voz sua, escolha "Outra voz: cole o ID" e cole o "ID da voz".
4. Opcional: em "Uma voz para cada país", clique em "Adicionar um país" e escolha uma voz para ele. Um cliente do WhatsApp ouve a voz do país do número dele; qualquer outro cliente ouve a voz escolhida acima. Assim, um único agente responde a cada cliente no próprio dialeto.
5. Dê um "Nome" e salve.

Cada cartão mostra a voz, "Fala por:" com os agentes que a utilizam e "Tempo restante:" na sua conta do provedor (nunca um preço). No cartão você pode ouvir ("Ouvir"), desativar, editar ou excluir a voz. Ao excluir, o sistema pede confirmação primeiro; os agentes que falavam com ela voltam a responder por texto. As palavras a serem faladas são enviadas a esse provedor para gerar a mensagem de voz.

## Perguntas

**Q: Quais provedores de IA posso utilizar?**

A lista "Tipo" ao cadastrar um "Novo agente de IA" traz as opções: Gemini, ChatGPT, Claude, DeepSeek e OpenRouter (uma chave para múltiplos modelos). É necessário ter sua própria chave de API emitida pelo provedor.

**Q: Quem paga pelo consumo da IA?**

Você paga diretamente ao seu provedor, através da sua chave de API. O SyBox exibe o volume de tokens consumidos no cartão do agente e na tabela de Uso, mas não apresenta valores monetários.

**Q: Criei um agente, mas ele não responde aos clientes. O que pode ser?**

Um agente só envia respostas se estiver integrado a uma automação. Vá em Definições > IA e automação > Automações e crie uma automação contendo a ação "Responder com IA" apontada para o seu agente. Verifique se o Estado da automação é "Ligada" e se a chave principal "As automações estão ativas" no topo da página está ligada. Verifique também se:
- a conversa não está marcada com "Parar respostas de IA"
- o contato não está bloqueado, marcado como spam ou arquivado (arquivamentos temporários não impedem o envio)
- ninguém da sua equipe respondeu manualmente a essa conversa (o agente silencia até que ela seja Concluída, até que passem as horas de "Voltar a responder após" ou até que alguém clique em "Passar para a IA" na barra inferior ao nome do cliente).

**Q: O agente pode combinar retorno de ligação, prometer descontos ou prazos de entrega?**

Não por iniciativa própria. O agente só promete ações em nome da sua equipe se você autorizar isso expressamente nas instruções dele.

**Q: Recebo a mensagem "[Provedor] recusou a chave: …"**

O provedor rejeitou a chave de API inserida. Confira se você copiou o código completo, se a chave continua ativa e se a sua conta no provedor possui saldo ou plano de faturamento configurado. Depois tente salvar novamente.

**Q: Aparece "Esta chave do [provedor] não oferece nenhum dos modelos suportados por este agente."**

A chave utilizada não tem permissão para acessar os modelos compatíveis com o SyBox. Revise o plano e os privilégios da sua conta no provedor ou utilize outra chave.

**Q: O cartão do agente exibe "Último erro". O que significa?**

Trata-se da última falha reportada pelo provedor, como chave expirada ou cota esgotada. Corrija a pendência diretamente no painel do provedor ou clique em Editar para atualizar a chave.

**Q: Posso ter agentes separados para números ou canais diferentes?**

Sim. Crie um agente para cada finalidade. Depois, crie uma automação para cada um deles usando a condição "Canal" para filtrar os números ou páginas desejados.

**Q: Enviar um novo arquivo adiciona o conteúdo ao que já estava salvo?**

Não. Cada envio ou colagem de texto substitui completamente a base de conhecimento do agente. Reúna todo o conteúdo daquele agente em um único arquivo ou envio.

**Q: O agente falou algo indevido ou respondeu errado. Como consertar?**

Atualize os dados na base de conhecimento ou inclua uma instrução corretiva em "Suas instruções". Em seguida, abra a aba "Chat" do agente para testar a nova resposta.

**Q: O agente consegue atribuir conversas ou marcar etiquetas?**

Sim, através de regras em suas instruções. Mencione os identificadores exibidos logo abaixo de "Suas instruções", como "atribua ao usuário 3" ou "adicione o rótulo 1".

Source: https://www.smartsybox.com/pt/help/add-a-voice-for-your-ai-agents