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
- Abra Configurações > Central de contas > Chaves de IA.
- 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.
- 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.
- 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.
- Se quiser, dê um Nome para reconhecer a chave na lista.
- 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 comoAuthorization: Bearer. - 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.
- 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.
- 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.
- 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.
- 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
- No menu de ações da chave (os três pontos no fim da linha), clique em Remover.
- 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.
- 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.
- 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?.