Ir para o conteúdo

Guia

Consultar os logs de execução das automações

Automações e integrações · 7 min de leitura

Cada vez que uma regra de automação é executada, o Mateflow registra isso nos logs de execução (histórico de automações, registro de execuções). Use os testes e os logs para confirmar que uma regra faz o que você espera, descobrir por que uma execução falhou ou foi ignorada e executá-la de novo.

Quem pode fazer isso: proprietários e administradores. Os moderadores não veem Automações. · Onde: web (console de administração). · Plano: as automações dependem do seu plano da plataforma.

Testar uma regra de automação antes de ativá-la

As regras novas são salvas desativadas, então você pode testá-las primeiro. Clique em Testar regra na página da regra ou no formulário, antes de salvar. Um teste é uma simulação: ele verifica o gatilho e as condições e preenche os textos, mas nunca executa ações.

  1. Em Dados do gatilho, escolha Dados de exemplo ou o Último evento real da sua comunidade.
  2. Se quiser, escolha um Membro (opcional). As condições de membro, como pontos, tags e dias desde a entrada, são verificadas para essa pessoa. Com dados de exemplo e sem membro, elas não são atendidas.
  3. Clique em Testar regra.

O resultado é desenhado sobre a regra: cada condição mostra Atendida ou Não atendida, e as ações que não seriam executadas mostram Não será executada. Os testes ignoram Com que frequência, então um teste pode passar para um membro para quem a regra já foi executada. Quando um evento real não executaria a regra por esse motivo, uma nota no topo do resultado informa isso e diz quando a regra foi executada.

Executar uma regra de automação agora

Executar agora, na página de uma regra, executa a regra de verdade. Escolha um Membro para executá-la como se ele a tivesse acionado, ou deixe vazio e use dados de exemplo. Ela envia notificações, pontos, tags, alterações de espaço e webhooks reais.

Sem membro selecionado, revise o JSON do gatilho antes de executar. Ele deve ser um objeto como {}; arrays, null e valores simples são recusados. O log abre após entrar na fila, se disponível. Gatilhos do ciclo do evento não permitem execução imediata.

Abrir os logs de execução das automações

Acesse Admin → Automações → Logs de Execução. A página lista as execuções de todas as suas regras, das mais recentes para as mais antigas. Cada linha mostra o Horário, a Regra, o Membro, o Gatilho que a iniciou e o Status. Para ver as execuções de uma regra, abra a regra em Admin → Automações → Regras.

No topo, Visão geral mostra execuções, taxa de sucesso e duração das Últimas 24h, dos Últimos 7 dias ou dos Últimos 30 dias, com Tendência de execuções, Falhas e Erros por tipo. Clique em uma regra em Regras mais ativas ou Regras com mais erros para abri-la.

Os logs de execução são mantidos por 30 dias. As execuções ainda em andamento, ou aguardando uma ação com atraso, nunca são removidas.

Filtrar os logs de execução das automações

  • Buscar por nome da regra ou gatilho.
  • Todas as regras: escolha uma regra.
  • Todos os membros: escolha um membro, por exemplo para ver por que alguém não recebeu uma notificação de boas-vindas.
  • Status e um intervalo de datas.
  • Incluir logs de teste: as execuções de teste ficam ocultas, a menos que você ative esta opção. Elas têm o rótulo Teste.

Clique em Limpar para voltar à lista completa. Clique em Carregar mais no final para ver execuções mais antigas.

O que significa cada status de execução de automação

Status Significado
Sucesso Todas as ações foram executadas.
Falha parcial Algumas ações foram executadas e pelo menos uma falhou.
Falhou A execução falhou.
Ignorado A regra não agiu, por exemplo porque as condições dela não foram atendidas.
Pendente A execução está na fila.
Em execução A execução está em andamento. Uma execução com ações com atraso fica aqui até a última ser executada.

Em uma execução Ignorado, Detalhes do log mostra o Motivo de ignorado, como Condições não atendidas ou Seu plano não inclui automações, então as regras estão pausadas. No navegador do celular, a linha também mostra isso.

Por que um evento não aparece nos logs de automação

O Mateflow não registra todos os eventos que uma regra ignora, então um membro pode não aparecer nos logs mesmo com a regra ativada. Estes casos não deixam registro:

  • O evento não corresponde às configurações do gatilho da regra, como o espaço, o evento ou o limite de pontos.
  • O evento não atende a uma condição de Espaço do gatilho ou Tipo de conteúdo.
  • A regra está definida como Uma vez por Membro ou Apenas uma vez e já usou essa execução. Procure a execução anterior com Sucesso ou teste a regra com esse membro.

As condições sobre o membro, como tags, pontos e dias desde a entrada, registram uma execução Ignorado.

Ver os detalhes de uma execução de automação

Clique em uma linha para abrir Detalhes do log. Ele mostra:

  • O Membro e o objeto da execução, como uma publicação, um evento ou um curso.
  • Somente se (Condições): cada condição com Atendida ou Não atendida e o valor real. Depois que uma falha, as demais mostram Não verificada (uma condição anterior já não foi atendida).
  • Dados do gatilho e Resultados das ações, incluindo Enviado para um número de membros e quando uma ação com atraso está Prevista.
  • Duração e, em uma execução com falha, a Mensagem de erro, a Etapa da falha e um código de erro em cada ação que falhou.

Os códigos de erro comuns incluem Tempo esgotado, Requisição rejeitada (4xx), Erro no servidor (5xx), Destino não encontrado, Nenhum membro alvo, Os pontos estão desativados nesta comunidade, O curso está lotado e, para uma ação com atraso cuja regra mudou, Regra editada durante a espera.

Executar de novo uma automação que falhou

As ações que falharam não são repetidas automaticamente, então você pode executar de novo as execuções Falhou e Falha parcial a partir dos Detalhes do log. As execuções de teste não podem ser executadas de novo.

  • Executar de novo as ações com falha: só as ações que falharam são executadas de novo, na hora e sem o atraso delas.
  • Executar a regra inteira de novo: todas as ações são executadas de novo com os dados originais do gatilho. As notificações e os webhooks são enviados de novo, mas os pontos já concedidos não são concedidos duas vezes.

Confirme em Executar novamente esta execução?. Você vê Reexecução enfileirada, e a nova execução fica marcada como Reexecução de uma execução anterior. Corrija a causa primeiro, como as configurações da regra ou o endereço do webhook. Se uma regra falhar 5 vezes seguidas, o proprietário e os administradores são notificados, e a regra continua ativada até você desativá-la. Veja Automatizar tarefas com regras.

Se a regra mudou ou um log antigo não permite identificar as ações com segurança, a repetição parcial pode ser recusada. Revise a regra antes de repeti-la inteira, pois mensagens podem ser enviadas de novo. Datas usam dias UTC; a duração inclui espera e as distribuições podem usar amostras limitadas.

Recuperar uma execução de automação ignorada

Uma execução ignorada por causa do seu plano ou das condições dela pode ser executada mesmo assim, por exemplo depois que você faz upgrade ou adiciona a tag que faltava ao membro. Clique na execução para abrir Detalhes do log, clique em Recuperar e confirme em Recuperar esta execução?. As execuções de teste não podem ser recuperadas.

O evento é executado agora com os dados originais do gatilho: as condições são verificadas de novo e, se forem atendidas, as ações são executadas. Com que frequência continua valendo, então, se a regra já usou essa execução, você vê um erro e nada é enviado.

No ciclo do evento, a recuperação verifica novamente horário, regra, acesso, público e preferências. Não força avisos expirados nem ignora um lembrete pessoal que já ocupa aquele horário.

Confira a entrega de e-mails nos registros

Uma ação de e-mail tem estado de entrega próprio, separado do resultado da regra. Aceito pelo serviço não significa entregue. Abra os detalhes para conferir destinatário, tentativas e resultado e atualize se estiver pendente ou incerto. Reexecutar não submete novamente e-mails já aceitos. A recuperação só é oferecida quando o serviço confirma que permite nova tentativa; corrija primeiro a causa. Veja Envie e-mails de marketing automatizados.

Artigos relacionados

Este guia foi útil?

Voltar aos guias

Não encontra o que precisa?

Se você é membro de uma comunidade, fale com os administradores dela. Se está criando ou gerenciando uma comunidade no Mateflow, nossa equipe pode ajudar.