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/settings/ai-keys.md.
  • Português
  • Como usar a minha própria chave de IA no Clickmax?

    Em Configurações > Central de contas > Chaves de IA, adicione a chave de API do seu provedor de IA e ligue essa chave a um dos modelos do Clickmax (Max Basic, Max Pro, Transcrição ou Imagem). Daí em diante, a IA da plataforma que usa esse modelo roda na sua chave, e o provedor cobra as chamadas na sua conta. Um modelo sem chave ligada continua rodando pela IA do Clickmax.

    Antes de começar

    • Permissão: as chaves e os modelos do workspace aparecem para quem tem a permissão Ver do recurso Chaves de IA. Adicionar, renomear, testar, remover e ligar modelos pede a permissão Gerenciar do mesmo recurso. Sem Gerenciar, a aba Workspace fica só para consulta. A aba Minhas chaves funciona para qualquer membro do workspace.
    • Provedores aceitos: OpenRouter, OpenAI, Anthropic, Google Gemini, Groq, Mistral, DeepSeek, xAI e Outro provedor, que é um endereço próprio compatível com a API da OpenAI.
    • A chave fica cifrada e nunca é exibida de novo: a tela mostra só os 4 últimos caracteres.

    A tela tem duas abas, cada uma com a contagem de chaves: Workspace, com as chaves que valem para todo o workspace, e Minhas chaves, com as suas chaves pessoais. Em cada aba, o bloco Chaves lista uma chave por linha (nome e provedor, final da chave, último teste, o que usa a chave e o estado) e o bloco Modelos lista um modelo do Clickmax por linha.

    Adicionar uma chave

    1. Abra Configurações > Central de contas > Chaves de IA.
    2. Abra a aba Workspace para uma chave do workspace, ou Minhas chaves para uma chave só sua, e clique em Adicionar chave, no topo da tela. A chave é criada na aba aberta.
    3. Escolha o provedor e clique em Continuar. A nota abaixo da lista mostra quais provedores atendem Transcrição de áudio e Geração de imagem; os outros atendem só texto. Na tela seguinte, Voltar troca o provedor.
    4. Cole a chave em Chave de API. A dica abaixo do campo mostra como as chaves desse provedor começam, e o campo avisa quando a chave não começa assim.
    5. Se quiser, dê um Nome para reconhecer a chave na lista.
    6. Em Outro provedor, preencha também o Endereço da API (só https://, com um domínio público) e, se o seu servidor espera a chave num header próprio, o Header da chave. Em branco, a chave vai como Authorization: Bearer.
    7. Clique em Adicionar chave. O Clickmax confere a chave no provedor antes de salvar.

    A chave entra na lista com um destes estados:

    • Ativa: o provedor confirmou a chave.
    • Não verificada: o provedor não confirmou nem recusou (acontece com chaves restritas que não podem listar modelos). Ela é testada quando você liga um modelo a ela.
    • Recusada: o provedor recusou a chave. Abaixo da linha, Ver resposta do provedor mostra o que o provedor respondeu. Corrija a chave na conta do provedor e use Testar de novo no menu da chave.

    Ligar um modelo a uma chave

    Cada modelo do Clickmax atende um tipo de IA da plataforma:

    • Max Basic: relatório, perguntas e memória das reuniões sem agente; copiloto de ligações e de playbooks; sugestões, resumos e classificação do chat ao vivo; Raio-X do contato; triagem do contato no agendamento e a classificação do SDR de IA; propostas; importação de contatos; Pauta do Studio; sugestão de tom do produtor; respostas a comentários; relatórios de webinário e de ligação; leitura de imagens anexadas ao Max e melhoria de pedidos ao Max. Para ler as imagens anexadas ao Max, escolha um modelo que entenda imagens.
    • Max Pro: capítulos do brandbook e o desafiante do Teste A/B dos funis.
    • Transcrição: áudios do chat ao vivo, ligações, áudio do simulador de playbooks e o ditado por voz no Max.
    • Imagem: imagens que o Max, o Max Design e o Studio geram.
    1. No bloco Modelos, clique em Ligar a uma chave na linha do modelo (ou em Trocar, se ele já tem uma chave). A escolha abre numa janela.
    2. Em Chave, escolha uma das suas chaves. Só aparecem chaves de provedores que atendem esse modelo: transcrição e imagem não estão em todos os provedores, e a linha diz quais atendem quando nenhuma chave sua serve.
    3. Em Modelo, busque e escolha um modelo da lista da sua conta no provedor. Com muitos modelos, a lista mostra os primeiros que casam com a busca: continue digitando para achar outro. Se o modelo não está na lista, digite o ID dele e escolha a opção Usar com o ID digitado. Se o provedor não lista os modelos, digite o ID do modelo como aparece na documentação do provedor.
    4. Clique em Salvar. O Clickmax faz uma chamada de teste com a chave e o modelo, o que leva alguns segundos.

    Uma linha ligada mostra a chave e o modelo. Uma linha sem chave continua rodando pela IA do Clickmax.

    Se o teste falhar, nada é salvo. A janela diz o que fazer e mostra, à parte, a resposta do provedor (por exemplo, um modelo que a chave não pode usar).

    Se o provedor recusar a chave de um modelo já ligado, a linha do modelo avisa: a IA desse modelo falha até você testar a chave de novo ou ligar outra chave.

    Para voltar um modelo para a IA do Clickmax, clique em Remover na linha dele.

    Minhas chaves

    As chaves e os modelos da aba Minhas chaves valem só para o que você dispara, como regenerar o relatório de uma reunião ou fazer uma pergunta sobre ela. Para essas ações, o seu modelo ligado passa na frente do modelo do workspace. Ninguém mais do workspace vê as suas chaves pessoais.

    O que roda sozinho, sem uma pessoa clicando (como o relatório gerado no fim da reunião), usa só as chaves do workspace.

    O que nunca roda numa chave cadastrada

    O aviso Sempre na IA do Clickmax, no topo da tela, resume o que roda sempre na IA do Clickmax, mesmo com uma chave ligada. Clique em Ver lista para ver tudo:

    • as Conversas com o Max e o Resumo de conversas longas com o Max;
    • os títulos das conversas com o Max e a leitura do primeiro pedido de cada conversa com o Max;
    • o roteiro e a voz do treino de reuniões;
    • as legendas de posts nas redes sociais;
    • as variações de mensagens das campanhas de WhatsApp Web e as conversas amigas entre os seus números de WhatsApp Web.

    Quando a chave falha

    O Clickmax não troca a sua chave pela IA da plataforma quando ela falha: a ação para e a tela avisa que a chave de IA falhou, com o botão Abrir Chaves de IA. Confira a chave na lista (o estado aparece na linha, e a resposta do provedor em Ver resposta do provedor), corrija o que for preciso na conta do provedor e use Testar de novo.

    A conta do provedor está sem créditos. Se o aviso disser que a conta da chave no provedor de IA está sem créditos, a chave está certa, mas a conta da OpenAI ou da Anthropic não tem saldo para pagar as chamadas. Esperar não resolve: adicione saldo no painel de cobrança do provedor e tente de novo. A chave volta a funcionar sozinha, sem Testar de novo. Uma chave de conta sem saldo pode aparecer como Ativa na lista, porque a conferência só consulta os modelos, e isso o provedor permite mesmo sem saldo.

    Quando a IA do Clickmax para no workspace

    As ações cujo modelo está ligado a uma chave sua não dependem da IA do Clickmax: se ela parar no seu workspace, essas ações continuam funcionando na sua chave. As conversas com o Max rodam sempre na IA do Clickmax e param junto, mesmo com uma chave ligada.

    Remover uma chave

    1. No menu de ações da chave (os três pontos no fim da linha), clique em Remover.
    2. A janela lista os agentes que usam a chave e os modelos ligados a ela. Os modelos ligados voltam para a IA do Clickmax quando a chave sai.
    3. Se algum agente ativo usa a chave, o botão Remover chave fica travado. Clique no nome do agente para abrir o detalhe dele. Em Modelo e parâmetros, troque a chave em Chave do agente por outra chave do mesmo provedor (a troca vale na hora, sem publicar), ou pause o agente na chave No ar. Depois volte.
    4. Clique em Remover chave.

    Para chaves usadas por agentes de IA, veja também Como remover uma chave de API usada por agentes de IA?.