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/manage-automation-runs-with-ai.md.
  • Português

      • Como pedir ao Max para testar, executar e acompanhar uma automação?

      Abra uma conversa com o Max e diga o que quer saber ou fazer com a automação, pelo nome: "teste a automação Boas-vindas com o meu contato", "execute a automação Black Friday para a lista Clientes", "por que a automação Carrinho abandonado está falhando?", "em que mensagem da cadência a Maria está?". O Max faz o mesmo que você faria nos botões Testar e Executar manualmente e na aba Execuções do editor, e responde com nomes de contatos e de blocos, sem códigos.

      Antes de começar:

      • Papel: qualquer membro com acesso ao workspace. O Max age com as suas permissões. Executar, cancelar ou adiantar uma rodada exige acesso de edição às automações.
      • Sua própria IA (Claude, Cursor, Codex…) também faz esses pedidos: veja Conectar sua IA à Clickmax (MCP).
      • O Max está em fase Beta: confira o resultado nas telas de Automações antes de decidir.

      Testar a automação com um contato

      Peça o teste dizendo a automação e o contato: "rode a automação Boas-vindas para o contato Maria". O Max confirma quem vai receber as mensagens e só então roda.

      O teste é o mesmo do botão Testar do editor, e executa de verdade:

      • envia WhatsApp, e-mail e SMS ao contato, aplica tags e chama integrações;
      • respeita as esperas: um passo "aguardar 2 dias" segura o teste por dois dias;
      • conta nas métricas da automação e aparece na aba Execuções com o selo Teste;
      • funciona com a automação em rascunho e roda a versão salva.

      Prefira um contato seu. O teste começa direto no contato escolhido e não prova que o evento real dispara a automação; para isso é preciso publicar. Veja Como testar uma automação antes de publicar?.

      Depois de rodar, peça "mostre passo a passo o que aconteceu no teste": o Max diz por qual caminho a execução seguiu, o que cada passo fez e por que uma condição deu falso. Para reusar os dados de um disparo real, peça "use como base a última vez que a automação disparou".

      Executar a automação para uma lista, tag, segmento ou contatos

      Peça dizendo a automação e quem deve entrar: "execute a automação Black Friday para a lista Clientes", "rode a Reativação para a tag Inativos amanhã às 9h", "dispare a Boas-vindas para o segmento Leads de outubro". É o mesmo Executar manualmente do editor: cada pedido vira uma rodada. Veja Como executar uma automação para um contato, lista, tag ou segmento?.

      1. O Max confere a automação. Ela precisa estar publicada; se estiver em rascunho, ele pergunta se você quer testar com um contato ou publicar antes, e não publica por conta própria.
      2. Antes de executar, ele diz quantos contatos vão entrar e quantos estão no cooldown (passaram pela automação há pouco e ficam de fora).
      3. Ele pergunta se quem está no cooldown deve entrar mesmo assim e se é para começar agora ou agendar para uma data e hora.
      4. Você aprova e a rodada começa (ou fica Agendada).

      A rodada executa de verdade para todo mundo da origem: envia as mensagens, aplica tags e chama integrações. O público é fechado no momento em que a rodada começa: quem entra na lista, na tag ou no segmento depois não recebe. No agendamento, isso acontece na data marcada.

      Para acompanhar, pergunte "como está a rodada da automação Black Friday?": o Max diz o status (Agendada, Em andamento, concluída, Cancelada ou Falhou, com o motivo), quantos contatos entraram, quantos o cooldown pulou e quantos falharam, e quem executou. Pergunte "quando termina?" para ver a previsão do último ciclo, "quem falhou nessa rodada?" para a lista de contatos, e "adiante o próximo ciclo" para colocar um ciclo pendente na fila agora.

      Para cancelar, peça "cancele a rodada da automação Black Friday". O que ainda não saiu não sai; quem já entrou segue o fluxo normalmente, e a automação continua publicada. O Max pede a sua aprovação antes de executar, adiantar ou cancelar.

      Limites que valem também pelo Max: uma rodada por vez por automação (uma rodada agendada também conta), até 500 contatos escolhidos um a um, e automações com passos que dependem do evento do gatilho (como responder um comentário do Instagram) não podem ser executadas.

      Entender por que execuções falharam

      Pergunte "quantas execuções da automação Carrinho abandonado falharam e por quê?". O Max resume:

      • quantas execuções estão em cada situação (em andamento, concluídas, falhadas, interrompidas);
      • os principais erros, do mais frequente ao menos, com a quantidade de contatos em cada um;
      • para uma execução específica, em qual passo ela parou e o motivo, ou se está esperando um prazo ou uma resposta do contato.

      Dá para filtrar no pedido: "só as que falharam no passo de WhatsApp", "a execução do contato Maria", "só os testes". Sem pedir, o Max olha as execuções reais e deixa os testes de fora. Veja Como acompanhar uma execução passo a passo e Quem falhou com cada erro.

      Na execução de teste o Max mostra o detalhe completo de cada passo. Numa execução real ele mostra a ordem dos passos e o erro do passo que falhou.

      Tentar de novo ou interromper

      • Tentar de novo uma execução: "tente de novo a execução do contato Maria". Ela volta a rodar a partir do passo em que falhou.
      • Tentar de novo todas de um erro: "tente de novo tudo que falhou com esse erro". O Max diz quantos contatos isso atinge e retenta em lotes de até 1000; se sobrarem, ele avisa e pergunta antes do próximo lote.
      • Interromper uma execução: "pare a execução do contato Maria". Nenhum passo seguinte roda e ela não pode ser retomada; um passo que já estava em andamento pode terminar o que começou.

      O passo que falhou é executado de novo: se ele envia uma mensagem, ela sai outra vez. Por isso o Max pede a sua aprovação antes de cada uma dessas ações e conserta a causa antes, quando ela é conhecida. Retentar sem corrigir a causa repete a falha. Interromper uma execução não pausa a automação: novos contatos continuam entrando; para isso peça para pausá-la. Veja Como tentar de novo uma execução que falhou? e Como interromper uma execução que está em andamento?.

      Automação arquivada não aceita tentar de novo. Automação pausada aceita.

      Conferir antes de publicar

      Peça "confira a automação Boas-vindas antes de publicar". O Max lista os problemas por gravidade, cada um apontando o bloco:

      • Erros: sem gatilho de entrada, bloco sem destino, canal sem número ou remetente, template de WhatsApp não aprovado, tag, etapa, oferta ou lista que foi apagada, e número de envio arquivado, desativado ou sem automações liberadas.
      • Avisos: bloco sem ligação, fluxo que termina num bloco, ramo de condição vazio, gatilho sem o filtro obrigatório e mensagem que usa uma variável que o gatilho não fornece (ela sairia vazia).

      Aviso não impede publicar. Erros de número, template e referência apagada não bloqueiam a publicação, mas o envio falha depois: corrija antes. Veja O que a automação aponta como problema antes de publicar?.

      Ver quais automações se ligam a uma tag, etapa ou mensagem

      Pergunte "quais automações começam quando aplico a tag VIP?" ou "quem aplica a tag que inicia a automação Boas-vindas?". O Max lista as automações do outro lado do elo, com o status de cada uma (rascunho, ativa ou pausada) e quantas execuções já teve.

      Vale para tag aplicada ou removida, entrada em etapa, oportunidade ganha ou perdida, e e-mail entregue, aberto, clicado ou com falha, link clicado, resultado de ligação e webhook. Só aparecem os elos com escolha fixa (uma tag ou etapa específica): se o passo escolhe a tag de outro jeito, o Max não enxerga o elo. Rascunho e automação pausada aparecem na lista, mas não rodam. É a mesma leitura dos cartões tracejados do editor: Por que aparece um cartão tracejado ao lado de um passo ou do gatilho?.

      Saber em que mensagem da automação um contato está

      Pergunte "em que mensagem da automação o contato Maria está?" ou "qual a próxima mensagem da cadência da oportunidade Empresa X?". O Max responde, para cada automação com mensagens pela qual o contato passou:

      • a mensagem em que ele está agora (por exemplo, esperando uma resposta) ou a última que recebeu, com a entrega (enviada, entregue, lida, clicada ou falhou);
      • a próxima mensagem e quando ela sai;
      • as que ainda vêm depois e as que ficaram de fora porque o contato seguiu outro caminho.

      Quando a próxima mensagem depende do contato (respondeu ou não respondeu, botão escolhido), o Max diz os dois caminhos. A resposta mostra até as 50 execuções mais recentes e não inclui testes, como a aba Cadências da oportunidade: Em que mensagem da automação o contato da oportunidade está?. Para tirar o contato da sequência, peça para interromper a execução dele.

      Se não funcionou

      • O Max diz que não encontrou a automação ou o contato: use o nome exato, ou o e-mail ou telefone do contato. Contatos de outro workspace não são encontrados.
      • "Não há o que interromper": a execução já terminou ou já foi interrompida. "Não é possível tentar de novo": a execução não falhou (só dá para retentar execuções que falharam) ou a automação está arquivada.
      • O teste não começa: a automação precisa ter ao menos o bloco de gatilho.
      • A rodada não começa: a automação não está publicada, já tem uma rodada agendada ou em andamento (cancele-a ou espere terminar), a origem não tem contatos, o número de WhatsApp está fora do ar ou um bloco de mensagem está sem remetente.
      • A rodada agendada aparece como Falhou ou Cancelada: algo impediu o envio na data marcada (por exemplo, a automação foi pausada). Pergunte ao Max o motivo, corrija e peça uma nova rodada.
      • Uma ação foi bloqueada por um erro: veja os Códigos de erro.