Workflow Travado ou em Loop? Como Debugar Rápido

Quando um workflow para de funcionar como esperado — contatos ficam presos em um passo, ações não são executadas ou o mesmo e-mail é enviado repetidamente — o instinto é deletar tudo e recomeçar do zero. Mas na maiória dos casos, o problema tem uma causa específica e identificável que pode ser resolvida em minutos com o processo correto de debugging.

Neste guia, você vai aprender a diagnosticar e corrigir os problemas mais comuns em workflows da Marketek de forma rápida e sistemática.

Problema 1: Contatos Presos em um Passo

Sintoma: Ao verificar o log de execução, você vê diversos contatos parados no mesmo passo há horas ou dias, sem avançar.

Causas Possíveis:

Wait sem Timeout

Se o passo é um Wait do tipo “Esperar até condição” e a condição nunca se torna verdadeira, o contato fica preso indefinidamente.

Diagnóstico: Verifique se o Wait tem um timeout configurado. Abra o passo e procure o campo de limite de tempo.

Solução:
1. Edite o passo Wait
2. Ative o Timeout com um limite razoável (ex.: 7 dias)
3. Configure o que acontece no timeout: continuar no fluxo ou seguir caminho alternativo
4. Republique o workflow

Condição If/Else Impossível

O contato está em um If/Else cuja condição depende de um evento que nunca vai acontecer para aquele contato específico.

Diagnóstico: Abra o perfil do contato preso e verifique manualmente se ele pode satisfazer a condição do If/Else.

Solução: Ajuste a condição ou adicione um caminho padrão (Else) que cubra contatos que não atendem nenhuma condição.

Problema 2: Loop Infinito

Sintoma: Um contato recebe o mesmo e-mail ou SMS repetidamente, ou aparece múltiplas vezes no log de execução passando pelos mesmos passos.

Causas Possíveis:

GoTo sem Condição de Saída

Um GoTo que volta a um passo anterior sem um If/Else que interrompa o loop após um número definido de iterações.

Diagnóstico: Mapeie visualmente o workflow e identifique onde o GoTo aponta. Verifique se existe um If/Else antes do GoTo que eventualmente direcione o contato para fora do loop.

Solução:
1. Adicione um If/Else antes do GoTo
2. Use uma tag de contagem (ex.: wf_loop-1, wf_loop-2, wf_loop-3)
3. A cada iteração, adicione a próxima tag de contagem
4. No If/Else, verifique: “Contato possui tag wf_loop-3?” → Sim: sair do loop → Não: GoTo para repetir

Alternativa com campo numérico:
1. Crie um campo personalizado numérico “Contagem de Follow-ups”
2. A cada iteração, incremente o campo em +1
3. No If/Else: “Contagem de Follow-ups é maior que 3?” → Sim: sair → Não: GoTo

Workflow Disparando a Si Mesmo

O workflow tem um trigger que é ativado por uma ação dentro do próprio workflow. Exemplo: trigger “Tag Adicionada” com ação que adiciona exatamente essa tag.

Diagnóstico: Verifique se alguma ação no workflow pode disparar o trigger do mesmo workflow ou de outro workflow que faz referência circular.

Solução: Desative o re-enrollment no trigger ou use tags diferentes para trigger e ação.

Problema 3: Ações Não São Executadas

Sintoma: O contato avança pelos passos (visível no log), mas as ações não produzem efeito — e-mails não são enviados, tags não são aplicadas, tarefas não são criadas.

Causas Possíveis:

E-mail Não Enviado

• Contato não tem e-mail válido: verifique o campo de e-mail no perfil do contato
• Contato está em DND (Do Not Disturb): verifique o status de DND
• Template de e-mail com erro: abra o template e verifique se há variáveis não resolvidas ou formatação quebrada
• Limite de envio atingido: verifique se há limites diários configurados

Tag Não Aplicada

• Tag não existe no sistema: a tag pode ter sido digitada incorretamente na ação do workflow
• Tag já existe no contato: se a tag já está aplicada, a ação é executada mas sem efeito visível

Tarefa Não Criada

• Responsável não encontrado: o usuário atribuído pode ter sido desativado ou removido
• Campo obrigatório vazio: verifique se todos os campos obrigatórios da tarefa estão preenchidos

Como Usar o Log de Execução

O log de execução é sua principal ferramenta de debugging. Veja como acessá-lo e interpretá-lo.

Acessando o Log

1. Abra o workflow em Automações > Workflows
2. Clique na aba Execuções ou Histórico
3. Filtre por contato, data ou status

Interpretando o Log

Cada entrada no log mostra:

• Contato: quem está passando pelo workflow
• Passo atual: em qual etapa o contato está
• Status: executado com sucesso, aguardando, erro
• Data/hora: quando cada passo foi executado
• Detalhes do erro: se houve falha, a mensagem de erro específica

O que Procurar

• Passos com status “Erro”: indicam falha na execução da ação
• Passos com status “Aguardando” há muito tempo: indicam wait sem timeout ou condição impossível
• Múltiplas execuções para o mesmo contato: indicam loop ou re-enrollment indesejado

Processo de Debugging em 5 Passos

Quando um workflow apresenta problemas, siga este processo:

1. Identifique o sintoma: contatos presos, loop, ação não executada
2. Consulte o log de execução: encontre o passo problemático
3. Análise a configuração do passo: abra e revise todas as configurações
4. Teste com um contato novo: crie um contato de teste e execute o trigger
5. Corrija e republique: faça a correção, salve, republique e monitore

Dica final: Antes de publicar qualquer workflow com lógica complexa, desenhe o fluxo em papel ou em uma ferramenta visual. Isso ajuda a identificar caminhos sem saída, loops sem condição de parada e cenários não cobertos pela lógica.

Artigos Relacionados:

• If/Else, Wait e GoTo: Domine a Lógica dos Workflows
• Como Criar um Workflow com Ramificações Condicionais