For AI agents: the complete documentation index is available at https://docs.clickmax.io/llms.txt, the full documentation bundle is available at https://docs.clickmax.io/llms-full.txt, and this page is available as Markdown at https://docs.clickmax.io/features/max/train-ai-voice.md.
  • Português
  • Como treinar uma voz com IA?

    Em Max > Vozes, no quadro Clonar uma voz real?, clique em Enviar gravação, dê um nome, envie de 1 a 3 gravações da mesma pessoa e confirme que você tem a autorização dela. A voz entra na biblioteca com o filtro Minhas vozes e pode ser usada em qualquer áudio gerado pelo Max, pelos agentes de IA e pela API.

    Antes de começar:

    • Papel: treinar, apagar e trocar a voz padrão exigem a permissão de gerenciar Voz com IA. Ouvir e usar as vozes exige só a permissão de gerar áudio.
    • O recurso Voz com IA precisa estar ligado nos módulos do workspace, no módulo IA.
    • Cada workspace tem até 3 vozes próprias, somando as treinadas e as criadas por descrição. Para treinar outra, apague uma.
    • Só treine a voz de quem autorizou por escrito. O Clickmax guarda quem confirmou a autorização, quando e o texto aceito.

    1. Prepare as gravações

    • Uma pessoa falando sozinha, sem música e sem outras vozes.
    • Somando pelo menos 1 minuto. Mais tempo, na mesma qualidade, deixa a voz mais parecida.
    • Formatos MP3, WAV, M4A, OGG ou WEBM, até 8 MB cada.
    • Gravações do celular servem. O ruído de fundo é reduzido no treino.

    2. Treine a voz

    1. Abra Max > Vozes.
    2. No quadro Clonar uma voz real?, clique em Enviar gravação. O treino abre em três etapas.
    3. Em Gravações, arraste os áudios para a área indicada ou clique em Do computador. Para usar áudios que já estão no Drive, clique em Do Drive, marque de 1 a 3 áudios e confirme. Toque cada gravação para conferir e acompanhe a barra Áudio somado até chegar a 1 minuto. Clique em Continuar.
    4. Em Identidade, preencha Nome da voz e, se quiser, a Descrição. Ao lado aparece como a voz vai ficar na biblioteca. Clique em Continuar.
    5. Em Autorização, confira o resumo, leia a declaração e marque Tenho autorização da pessoa dona desta voz.
    6. Clique em Treinar voz.

    Os áudios enviados pela galeria do Drive ficam em Meu drive > Vozes, que só você vê. A opção Do Drive aparece para quem tem acesso ao Drive.

    A voz aparece na biblioteca em alguns segundos, com o selo Do seu time. Clique no botão de tocar do card para escutar uma frase de exemplo.

    3. Use a voz

    • Para usar a voz em todo áudio que não escolhe voz, selecione-a na barra Padrão do workspace e clique em Salvar padrão.
    • Para um agente de IA falar com ela, clique em Usar no agente no card e escolha o agente (Como fazer o agente de IA responder com áudio no WhatsApp?).
    • Pela API ou pelo MCP, passe o id da voz no campo voice de speech_generate. O id aparece em speech_voices_list, na lista workspace.

    Apagar uma voz

    No card da voz, clique em Apagar e confirme. A voz deixa de existir para todo o workspace, e quem a usava como padrão passa a usar a primeira voz do Clickmax.

    Relacionados

    Se não funcionou

    • O botão Enviar gravação está desligado: o workspace já tem 3 vozes próprias. Apague uma.
    • Aviso de gravações recusadas: o treino volta para a etapa Gravações. Troque por áudios mais limpos, com uma pessoa só falando, e tente de novo.
    • Arquivo não aceito: confira o formato e o tamanho (até 8 MB). Vale também para áudios do Drive.
    • A opção Do Drive não aparece: o Drive está desligado no workspace ou falta a permissão de ver o Drive no seu papel.
    • O quadro Clonar uma voz real? não aparece: falta a permissão de gerenciar Voz com IA no seu papel.