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/messaging/ai-agents.md.
  • Português

      • Crie um agente de IA com a sua chave

      Em Configurações → Central de Contas → Meus agentes — ou, pelo caminho do CRM, em Contatos & Comercial → Configurações do CRM → Meus agentes, que abre a mesma lista — clique em Novo agente, cadastre a chave de API do seu provedor (OpenAI ou Anthropic), escolha o modelo, escreva a persona e teste a conversa. O agente nasce como rascunho; Publicar alterações cria a primeira versão e o deixa Ativo.

      Quer um SDR atendendo no WhatsApp sem montar cada parte? Use Configurar SDR de IA: veja Como configurar o SDR de IA do zero?.

      Papel: qualquer membro do workspace com acesso às Configurações pode criar agentes e cadastrar chaves.

      Antes de começar

      • Uma conta na OpenAI ou na Anthropic com uma chave de API ativa e crédito disponível. As chamadas do agente são cobradas pelo provedor, na sua conta.
      • O Clickmax valida a chave no provedor antes de salvar. A chave fica cifrada e nunca é exibida de novo: a tela mostra só os 4 últimos dígitos.

      Passos

      1. Abra Configurações e, no grupo Central de Contas da lateral, clique em Meus agentes. Clique em Novo agente.
      2. No passo Provedor, escolha OpenAI ou Anthropic, cole a chave em Chave de API e clique em Validar e salvar chave. Se o workspace já tem uma chave cadastrada, use Usar uma chave já cadastrada e selecione-a. Clique em Continuar.
      3. No passo Modelo, abra a lista e escolha um modelo entre os disponíveis na sua conta: os Recomendados vêm primeiro e, abaixo, os Outros modelos da sua conta (os que a conta não enxerga aparecem desabilitados). Abaixo do campo aparecem a descrição e o perfil do modelo escolhido. Ajuste a Temperatura.
      4. No passo Identidade, escolha a Foto do agente: ele já vem com um rosto sorteado; clique em outro rosto da galeria ou em Enviar foto para usar uma imagem sua (PNG, JPG ou WebP, até 5 MB — a foto é recortada ao centro em formato redondo). Depois, informe o Nome e o Objetivo. O objetivo é só um rótulo que aparece no card do agente para o time saber para que ele serve; o que o agente faz na conversa vai na persona. A Persona e instruções começa com um exemplo genérico; reescreva como quiser ou use Voltar ao exemplo.
      5. Em Revisão, confira o resumo e clique em Criar agente. Você é levado à tela do agente. Ele nasce sem regras de escalonamento: crie as suas na aba Escalonamento (veja abaixo).
      6. Na aba Testar, envie mensagens como se fosse o cliente. O teste usa as mesmas instruções do atendimento como SDR de IA — persona, regras de escalonamento ligadas e base de conhecimento — e, quando o agente decide consultar a agenda, criar uma tarefa ou passar para o time, a ação aparece no chat como Ação simulada (com o motivo, quando há um), sem ser executada. O teste usa a versão publicada. Cada mensagem usa a sua chave no provedor.
      7. Quando estiver satisfeito, clique em Publicar alterações. O agente fica Ativo e passa a exibir a versão publicada. Use o botão Ativo para pausar e reativar sem perder a configuração.

      Ajustes posteriores (persona, modelo, escalonamento) ficam marcados como Alterações não publicadas até você clicar em Publicar alterações de novo.

      Na aba Escalonamento, clique em Adicionar regra e preencha o Gatilho (quando passar, por exemplo "Pede desconto acima de 10%") e a Ação (o que fazer, por exemplo "Passar para o time comercial com o valor pedido"). Os dois campos são obrigatórios e aceitam até 255 caracteres; o agente aceita até 20 regras. Use a chave de cada regra para ligar ou desligar e a lixeira para excluir. Com alguma regra incompleta, Publicar alterações fica bloqueado e o cabeçalho avisa.

      As regras da aba Escalonamento (cada uma no formato "quando X → faça Y") valem onde o agente conversa com o contato: no atendimento como SDR de IA, as regras ligadas entram nas instruções que ele segue para decidir quando passar a conversa para uma pessoa — e, ao passar, ele registra o motivo e um resumo. Elas também valem em Perguntar à IA e na aba Testar. Sem nenhuma regra, o agente ainda passa a conversa quando o contato pede uma pessoa ou quando não sabe responder. Regras desligadas são ignoradas, e mudanças nas regras só valem depois de Publicar alterações. Veja o que o agente faz enquanto conversa.

      A Persona e instruções aceita até 20.000 caracteres. Na aba Configuração, o contador abaixo do campo mostra quanto você já usou desse limite. Acima dele, Publicar alterações fica bloqueado e aparece o aviso As instruções passam do limite de 20.000 caracteres. Reduza o texto para publicar. Escreva as instruções em texto corrido: o campo não substitui variáveis como {nome} ou {canal}.

      A foto do agente — um dos rostos padrão do Clickmax ou uma foto enviada — aparece no card da lista, no detalhe, em Chaves de API e no bloco SDR de IA das automações, na parte de quem conduz a conversa. Para trocar, abra o detalhe do agente e clique na foto ao lado do nome: escolha outro rosto, envie uma foto (Enviar foto/Trocar foto) ou use Remover foto para voltar ao rosto padrão, e clique em Salvar foto. A foto é salva na hora, sem precisar de Publicar alterações. A galeria tem 32 pessoas ilustradas — as mesmas fotos prontas do convite de membro e da foto do perfil. Agente sem foto enviada e sem rosto escolhido recebe automaticamente um desses rostos; se ele guardava um rosto que saiu da galeria, passa a mostrar esse rosto automático.

      Para remover um agente, abra o detalhe e clique em Excluir. Ele sai da lista e para de responder; a chave do provedor continua cadastrada e as conversas ficam registradas.

      As chaves cadastradas aparecem em Chaves de API, abaixo da lista de agentes. Cada chave mostra Usada por com os rostos dos agentes que a usam. Remover tira a chave do workspace; se algum agente ativo ainda a usa, troque a chave desse agente primeiro.

      Fontes de conhecimento

      Na aba Conhecimento, clique em Adicionar fonte e escolha o Tipo de fonte:

      • Documento: PDF, TXT, MD, CSV, JSON ou HTML até 20 MB. DOCX e PPTX só na OpenAI.
      • Página web: cole o Endereço e lemos o texto da página na hora.
      • FAQ: pares de Pergunta e Resposta que você escreve na tela (Adicionar pergunta para incluir mais; de 1 a 200 itens).

      O conteúdo fica na sua conta do provedor (OpenAI ou Anthropic), não no Clickmax. O agente consulta as fontes antes de responder; se a resposta não estiver nelas, ele diz que vai confirmar com o time em vez de inventar. Limite de 20 fontes por agente.

      Cada fonte aparece na lista com o status Sincronizado, Sincronizando ou Erro (em Erro, o motivo aparece abaixo do nome). Sincronizar de novo aparece em páginas web (relemos o endereço na hora, útil quando a página mudou), em fontes Sincronizando e em FAQs com Erro. Documento com Erro precisa ser removido e enviado de novo.

      Com Anthropic, cada mensagem envia todas as fontes ao modelo (e o provedor cobra como entrada); mantenha a base enxuta — até 10 MB somados. Com OpenAI, os arquivos viram vetores num Vector Store da sua conta e o modelo busca só os trechos relevantes (até 8 por mensagem).

      O quadro Onde ficam os arquivos, no topo da aba, mostra a conta do provedor (a chave do agente), o ID do Vector Store (só OpenAI, com atalho para o painel da OpenAI), quantas das 20 fontes já foram usadas e o tamanho total (na Anthropic, contra o teto de 10 MB). Clique numa fonte para ver o ID do arquivo no provedor, o formato e o tamanho enviados, o endereço (páginas web) e as perguntas (FAQs). Com várias fontes de tipos diferentes, filtre a lista por tipo.

      O agente usa as fontes em todo lugar onde conversa: na aba Testar, no atendimento como SDR de IA e quando outra parte do Clickmax pede uma resposta a ele (copiloto de reuniões, automações). Em todos, ele é instruído a consultar os arquivos antes de falar de produto, preço, prazo ou condição.

      Trocar o modelo não mexe nas fontes. Trocar a credencial para outro provedor, ou para uma chave de outra conta do mesmo provedor, é bloqueado enquanto houver fontes: os arquivos ficam na conta atual. Uma chave nova da mesma conta (rotação de chave) é aceita.

      Fontes não passam por Publicar alterações: valem assim que aparecem como Sincronizado, mesmo com o agente em rascunho.

      Onde acompanhar

      • Meus agentes: no topo, o resumo do time mostra quantos agentes existem, quantos estão ativos agora, o total de Conversas, quanto o time de IA Resolveu sozinho, quantas conversas Passou para o time e quantos agentes estão Pausados. Cada agente aparece num card com rosto, nome, objetivo, status (Ativo, Pausado ou Rascunho) e três números: Conversas, a métrica do papel dele e Passou para o time. A métrica do papel é Agendou quando o agente atende como SDR e Resolveu no suporte ou enquanto ele ainda não atende em nenhum número. Abaixo, o placar mostra quanto o agente resolveu sozinho e quanto passou para o time, entre as conversas que já terminaram. O rodapé traz o modelo em Cérebro e a versão publicada. No card, a chave liga e pausa o agente (rascunho só liga depois de publicado), Testar abre a aba Testar e Editar abre o detalhe. Com muitos agentes, clique em Carregar mais no fim da lista para ver os seguintes.
      • Placar: conta como resolvida sozinha a conversa que terminou resolvida ou com reunião agendada, e como passada para o time a que o agente escalou para uma pessoa. Conversas em andamento ou sem resposta do contato ficam de fora. Os números somam todas as conversas do agente, inclusive as da aba Testar.
      • Logs: todas as conversas do agente, com filtros por resultado, canal e período. Ver transcrição abre as mensagens; com muitas conversas, Carregar mais no fim da tabela traz as seguintes. Uma pergunta sem resposta na transcrição indica que o provedor falhou naquele envio (por exemplo, chave inválida ou limite de uso).
      • Métricas: conversas, taxa resolvida pelo agente, escalonadas e duração média dos últimos 30 dias.

      Relacionados

      Se não funcionou

      • "O provedor recusou a chave": a chave está errada, expirada ou sem permissão. Gere uma nova no painel do provedor e cadastre de novo. Chaves da OpenAI começam com sk-; da Anthropic, com sk-ant-.
      • "O provedor limitou as chamadas desta conta": sua conta no provedor atingiu o limite de uso. Aguarde alguns minutos ou aumente o limite no provedor.
      • O modelo que eu queria não aparece: a lista mostra só os modelos que a sua conta no provedor enxerga. Habilite o modelo no provedor e recarregue a página.
      • "Publique o agente antes de ativar ou pausar": o botão Ativo só funciona depois da primeira publicação.
      • Não consigo remover uma chave: há agentes usando essa chave. Troque a credencial deles antes de removê-la.
      • "Este provedor não aceita esse tipo de arquivo": converta para PDF ou TXT. A Anthropic não lê DOCX/PPTX.
      • "Não conseguimos ler essa página. Confira o endereço.": o endereço precisa ser público (http ou https), ter até 5 MB e responder em até 10 segundos. Se aparecer "A página não respondeu. Tente de novo.", o site demorou ou está fora do ar.
      • "Remova as fontes de conhecimento antes de trocar de provedor": os arquivos estão na conta do provedor atual. Use Remover em cada fonte na aba Conhecimento, troque a credencial e cadastre as fontes de novo.
      • "A chave nova é de outra conta e não enxerga os arquivos de conhecimento": a chave escolhida é de outra conta do provedor. Use uma chave da mesma conta ou remova as fontes, troque a credencial e cadastre as fontes de novo.