Testar workflows (test runner) e ver logs de execucao

Use o test runner para executar um workflow passo a passo e confira o Timeline e o Trace para ver logs e payloads de cada no.

Jun 26, 2026

Veja este passo no vídeo · Testar o fluxo

Por que testar um workflow antes de ativa-lo

O test runner permite executar um workflow de forma controlada para ver, passo a passo, quais nos rodam, em que ordem e com qual resultado, sem esperar o evento real acontecer. E a maneira mais rapida de detectar uma condicao mal configurada, uma variavel vazia ou um ramo que nunca e tomado.

Lancar um teste

  1. Abra Automacoes no menu lateral e entre no seu workflow.
  2. Na barra superior, clique em Probar (Testar). A janela Testar workflow abre.
  3. Conforme o gatilho, escolha o contexto:
    • Gatilhos de conversa ou de contato pedem uma conversa ou um contato de referencia. Use a busca para escolher um recente (sem precisar memorizar IDs).
    • Gatilhos sinteticos (por exemplo template aprovado/rejeitado, canal desconectado) mostram um formulario Dados do gatilho para preencher os valores do evento.
  4. Clique no botao para disparar a execucao.

Ha dois modos conforme o gatilho:

  • Disparo sintetico: o motor executa o workflow imediatamente com o contexto informado. Util para gatilhos que nao tem contraparte em tempo real.
  • Armar / escutar: o workflow fica aguardando o proximo evento real (por exemplo, a proxima mensagem recebida) e dispara quando ele ocorre.

Acompanhar a execucao ao vivo

Ao lancar o teste, a janela fecha e dois elementos aparecem sobre o canvas:

  • Um chip de status flutuante que indica se a execucao esta armada, em andamento, em espera, concluida, falhou ou cancelada. Dali voce pode clicar em Ver detalhes / Ver resultados.
  • O painel Timeline no rodape do canvas, com uma pilula por passo: nome do no, status (✓ concluido, ✕ falhou, • ignorado, ⏳ em espera, ⏱ delay) e duracao. Clique numa pilula para centralizar esse no no canvas.

Se uma execucao ficar em espera (por um no Delay, Wait ou Ask question), voce pode Deter (parar) a execucao pelo chip.

Revisar execuções anteriores: o Histórico

  1. Na barra superior do editor clique em Histórico. Abre Execuções recentes.
  2. Filtre se precisar: Status (Todos, Falhou, Terminou bem, Em andamento ou em espera, Cancelada), Fluxo (Este fluxo ou Todos os fluxos do espaço) e De / Até. Limpar filtros volta à vista completa.
  3. Selecione uma execução para ver os passos, com status e duração; se falhou, o erro aparece no passo exato.
  4. Numa execução que falhou, depois de corrigir a causa, clique em Tentar novamente: o fluxo inteiro roda outra vez com os mesmos dados do gatilho e a versão atual. Atenção: os passos que já tinham dado certo se repetem.

Detalhes em Histórico de execuções: filtros e Tentar novamente.

Se nao funcionar

  • Nao consigo lancar o teste: verifique se o workflow esta salvo e se o gatilho tem o contexto exigido (conversa ou contato). O botao fica desabilitado enquanto outra execucao de teste esta em andamento.
  • A execucao fica "armada" e nao dispara: no modo escutar ela aguarda o evento real; gere esse evento (por exemplo envie uma mensagem recebida ao canal) ou troque para um disparo sintetico.
  • Um no aparece como ignorado (•): a condicao dele nao foi atendida. Abra o passo no Histórico para ver com quais valores foi avaliado.
  • Um passo falha (✕): abra o payload dele para ler o erro; costuma ser uma variavel vazia ou uma chamada HTTP que retornou erro.

Dica: teste primeiro com um disparo sintetico para validar a logica, e so depois use o modo escutar para confirmar que o evento real entra como voce espera.

Dica: o Histórico guarda as últimas 50 execuções; use-o como registro para comparar antes/depois de uma mudanca.

Artigos relacionados

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp