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/automations/debug-execution-steps.md.
  • Português
  • Como acompanhar uma execução passo a passo?

    Abra a automação e, na aba Execuções, clique na execução que quer investigar e depois em Depurar no canvas. O painel Execução passo a passo abre sobre o canvas e o caminho percorrido acende no desenho do fluxo.

    Papel: qualquer membro com acesso ao workspace.

    Os contadores de cada passo respondem quantos passaram por ali. Este painel responde outra coisa: o que aconteceu com esta execução — e é a diferença entre "a automação não funcionou" e "parou no passo X porque a condição não bateu".

    Passo a passo

    1. Abra a automação e vá até a aba Execuções.
    2. Clique na execução do contato que você quer investigar.
    3. No painel lateral, clique em Depurar no canvas.
    4. O painel abre no canto da tela. Clique em qualquer passo da lista para o canvas centralizar no bloco correspondente.

    O painel também abre sozinho logo depois de um teste — veja Como testar uma automação antes de publicar.

    Onde parou e por quê

    No topo do painel, antes da lista, fica a conclusão:

    • Em execução — ainda rodando.
    • Parada em uma espera — dormindo num passo de espera ou temporizador; vai continuar sozinha.
    • Aguardando resposta do contato — parada num passo de captura, esperando alguém responder. Pode ficar assim para sempre se a resposta não vier.
    • Concluída — percorreu o fluxo até o fim.
    • Falhou — parou com erro; a mensagem aparece logo abaixo.
    • Cancelada — interrompida antes de terminar.

    Por que foi para este ramo

    Em cada passo de condição, o painel mostra a linha que responde a pergunta mais comum de quem investiga:

    origem era "Instagram", comparou is com "Google"

    Em verde quando a condição bateu, em cinza quando não. Abaixo, Seguiu pelo caminho "false" diz qual ramo foi tomado.

    Quando o campo não existia na execução, o valor aparece como vazio — que é diferente de existir e estar em branco.

    O que cada passo fez

    Em execuções de teste, cada passo de ação mostra o efeito que executou — por exemplo, Executou addTag.

    No passo SDR de IA

    O bloco SDR de IA manda a primeira mensagem e entrega a conversa à IA. Ao selecionar esse passo, o painel mostra a seção Conversa da IA:

    • Em andamento ou Encerrada, e a saída por onde a conversa terminou, com o motivo (por exemplo, "Teto de 8 mensagens do agente").
    • Quantas falas a IA usou do limite do bloco, como 8 de 8 falas da IA.
    • Enquanto a conversa está em andamento, até quando o contato tem para responder antes de a conversa sair por Sem resposta.
    • Campos: cada campo do bloco com o valor que o contato tem agora e quem o preencheu (pela IA, pela equipe, por formulário…). Campo sem valor aparece como não apurado. No topo, quantos obrigatórios estão preenchidos e com quantos a conversa qualifica.
    • O que a IA fez: cada ferramenta que a IA usou nessa conversa, com o horário e o resultado. Em Gravou campos, a linha diz o que foi gravado, o que ela não achou (o nome não bate com nenhum campo da conta) e o que ficou com o valor da equipe. Em Detalhes, o que a IA mandou e o que voltou.
    • Perguntas feitas: as perguntas que a IA fez, na ordem.

    Se a IA perguntou mas o campo ficou vazio, olhe O que a IA fez: sem nenhuma linha Gravou campos, a IA não tentou gravar; com a linha, ela diz qual nome não bateu.

    A seção só aparece quando a conversa chegou a começar. Se o bloco saiu antes, por exemplo porque um atendente já estava na conversa, a execução segue pela saída correspondente sem a seção.

    O que entrou e o que saiu de cada passo

    Abaixo do detalhe do passo ficam as abas Entrada, Saída e Erro. Aparecem só as que têm conteúdo, e o botão de copiar leva o conteúdo da aba aberta.

    • Entrada: os dados da execução no momento em que ela chegou ao passo (contato, dados do gatilho, variáveis já gravadas).
    • Saída: o que o passo gravou para os passos seguintes, como a resposta de um Aguardar resposta ou as variáveis de uma requisição HTTP.
    • Erro: o motivo da falha, quando o passo falhou. É a aba que abre primeiro nesse caso.

    No passo de requisição HTTP, a Entrada é a requisição que saiu de fato, com as variáveis já trocadas pelos valores (método, endereço, cabeçalhos e corpo). A Saída é a resposta recebida (status e corpo).

    Os dados aparecem como passaram pelo fluxo, inclusive senhas e tokens que vierem numa resposta. Só a credencial configurada no próprio passo HTTP (cabeçalho de autenticação) aparece como ***. Conteúdo muito longo é mostrado só no começo.

    De quem é cada ID

    Os IDs que aparecem na Entrada, na Saída e nos Dados da execução (como tagId, leadId, offerId, transactionId, funnelId) viram uma etiqueta com o nome da entidade no lugar do código: a tag com a cor dela, o nome do contato, a oferta, a venda com o valor.

    • Passe o mouse na etiqueta para ver o ID.
    • Clique no ícone de copiar ao lado para copiar o ID. O ícone vira um check quando o ID é copiado.
    • Clique no nome para ver o tipo, os detalhes principais (e-mail e telefone do contato, preço da oferta, status e valor da venda, etapa e pipeline da oportunidade…) e o ID completo. Quando a entidade tem tela própria, o botão Abrir leva até ela.

    O botão de copiar da aba continua copiando o conteúdo original, com os IDs.

    O ID aparece como código, sem etiqueta, quando:

    • a entidade foi apagada;
    • o ID é de outro workspace (por exemplo, o de um afiliado ou coprodutor);
    • o campo não é de uma entidade que a plataforma conhece.

    A etiqueta aparece em contatos, tags, listas, segmentos, campos personalizados, empresas, oportunidades, pipelines, etapas, atendentes, times, tarefas, reuniões, propostas, ofertas, produtos, vendas, assinaturas, compradores, cupons, projetos, funis, páginas, formulários, quizzes, links, webinários, automações, passos, gatilhos, canais, conversas, mensagens, disparos, ligações e área de membros (áreas, turmas, cursos, módulos e aulas).

    Reexecutar uma etapa do teste

    Num teste, dá para rodar de novo uma etapa com a mesma entrada que ela recebeu, sem refazer o fluxo desde o começo. Serve para conferir uma correção: você ajusta a etapa no canvas (um nome de variável, o corpo de uma requisição) e roda só ela de novo.

    1. Com o teste aberto no painel, selecione a etapa que quer rodar de novo.
    2. No detalhe da etapa, clique em Reexecutar etapa.
    3. Escolha como rodar:
      • Só esta etapa — roda a etapa e para. A barra mostra Etapa reexecutada.
      • Continuar daqui — roda a etapa e segue o fluxo até o fim.
    4. Clique em Reexecutar.

    A reexecução abre no painel como um teste novo, com os passos anteriores copiados do original e o aviso Reexecução a partir do passo N. Clique em Ver teste original para voltar e comparar.

    O que muda e o que fica igual:

    • A etapa usa a configuração atual dela no canvas, com as edições que você acabou de fazer.
    • Os dados que vieram dos passos anteriores e do gatilho são os mesmos do teste original.
    • Os dados do contato são lidos de novo, então uma correção feita no cadastro já vale.

    A etapa roda de verdade outra vez: se ela envia mensagem ou chama uma integração, isso acontece de novo. Numa requisição que cria um cadastro em outro sistema, por exemplo, o cadastro é criado de novo.

    O botão aparece só em testes parados (concluídos, com falha ou cancelados) e não aparece em execuções reais. Ele também não aparece em etapas de testes feitos antes de o recurso existir. Se a etapa foi apagada do fluxo depois do teste, a reexecução é recusada.

    Acompanhamento ao vivo

    Enquanto a execução está em andamento, o painel se atualiza sozinho. Quando ela termina, falha ou é cancelada, a atualização para.

    O que aparece em execuções antigas

    O detalhe de cada condição, de cada efeito e a entrada e saída de todos os passos são gravados para execuções de teste. Guardar isso em todos os passos de toda execução real pesaria demais no volume da plataforma.

    Numa execução real, o painel mostra o caminho percorrido, a ordem dos passos e onde parou. O gatilho traz na Saída os dados que chegaram com ele (por exemplo, o corpo inteiro de um webhook), e cada passo que entrega dados para os seguintes mostra na Saída o que entregou, como a resposta de uma requisição HTTP. Se a execução falhou, o passo que falhou traz também Entrada e Erro, e é o que responde "por que falhou para esse contato?". Para ver a avaliação das condições de um caso específico, rode um teste com aquele contato.