Skip to main content
Toda vez que uma automação é acionada, ela grava um registro completo do que aconteceu: quem disparou, qual projeto foi afetado, quais componentes rodaram, o resultado de cada um e quanto tempo levou. É o primeiro lugar para olhar quando algo não sai como esperado.

​
Onde encontrar

Abra a automação e vá em Registro de execuções. A lista mostra as 20 execuções mais recentes, da mais nova para a mais antiga.
O histórico não é permanente. Cada automação guarda cerca de 100 registros; conforme novas execuções acontecem, as antigas são descartadas. Em automações de alto volume, isso pode significar poucas horas de histórico. Não conte com o log como arquivo de auditoria.
Excluir uma automação apaga o histórico dela. Se você precisa preservar a evidência de uma execução, desative em vez de excluir.

​
O que cada registro mostra

O identificador da execução, a data, a automação e o Causado por — a pessoa, o agendamento, a aplicação ou o sistema que originou o disparo.Quando o disparo veio de agendamento, não há usuário associado. Isso é normal.
Nome, código e descrição do projeto afetado.Dependendo do gatilho, um projeto pode ou não estar presente.
Quantos componentes tiveram sucesso, quantos deram erro e o tempo total.É a leitura de dois segundos: se o número de erros é zero e mesmo assim nada mudou no projeto, o problema não é falha — é uma ação que rodou sem ter o que fazer.
A lista dos componentes na ordem em que rodaram. Cada um mostra:
Todos os dados disponíveis no fim da execução. É onde você confere o que uma variável realmente continha na hora — a forma mais rápida de descobrir por que uma expressão gerou o texto errado.

​
Diagnóstico em quatro passos

Existe registro de execução?

Não existe nenhum: o gatilho não chegou a casar com o evento. O problema está antes da execução — automação inativa, gatilho apontando para outra etapa, evento diferente do configurado. Reveja Gatilhos.Existe: siga para o próximo passo.

O componente rodou?

Procure o componente no fluxo de execução. Se ele não aparece, o fluxo não chegou nele: uma condição anterior bloqueou o fluxo, um erro inesperado interrompeu tudo, ou ele está dentro de um ramo que não foi executado.

Rodou com sucesso ou com erro?

Erro: procure o código na tabela abaixo.Sucesso, mas sem efeito: leia a mensagem do componente. Ações que não têm o que fazer registram sucesso e explicam o motivo — “já existe status e a configuração não sobrescreve”, “não está na etapa”, “formulário já existe”.

A condição decidiu o que você esperava?

Se o fluxo tomou o caminho errado, abra a condição e veja o resultado registrado. Compare com o estado do projeto no momento do disparo — não com o estado atual, que pode ter mudado depois.

​
O que cada erro significa

​
Sintomas comuns

O gatilho nunca casou com o evento. Confira, nesta ordem:
  1. A automação está ativa?
  2. O evento provocado é exatamente o do gatilho? Entrar em uma etapa é diferente de sair dela.
  3. O gatilho aponta para a etapa, etiqueta ou formulário corretos — e do funil correto?
  4. Há alguma restrição extra configurada, como “vindo da etapa” ou campos obrigatórios no formulário?
Três causas possíveis, e o log distingue as três:
  • Uma condição com bloquear o fluxo deu falso.
  • Um erro inesperado interrompeu a execução — o registro fica marcado com erro.
  • A cadeia de automações atingiu o limite de cinco níveis.
Praticamente sempre é uma opção de “não sobrescrever” ou um pré-requisito não atendido. Leia a mensagem de cada componente — ela explica o motivo em texto.Os campeões: status do funil que já existia sem a opção de substituir, data já preenchida sem a opção de sobrescrever, etiqueta de um funil ao qual o projeto não está vinculado.
Verifique se o gatilho é de alto volume — formulário editado, projeto ocioso com repetição — ou se existe uma cadeia entre automações em que uma aciona a outra de volta.A coluna Execuções da lista de automações mostra o acumulado e ajuda a identificar a responsável.
Quase sempre é permissão. No seu teste, quem disparou tem acesso amplo; na operação, não. Procure por permission_required_exception no log da execução que falhou.

​
Por onde continuar

Como o fluxo é executado

Entender a ordem ajuda a interpretar o registro.

Variáveis

Conferir no contexto final o que a expressão realmente recebeu.

Gatilhos

Quando não existe registro nenhum, o problema está aqui.

Receitas prontas

Montagens já testadas para cenários comuns.