Como adicionar uma voz para os seus agentes de IA

Atualizado em

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 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

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.

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.

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).
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.

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.

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.

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.

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.

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.

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.

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".

Mais sobre Agentes de IA.