Testes e histórico de execuções

Antes que uma automação trabalhe para os seus membros, você quer vê-la funcionar para você. Uma execução de teste a inicia uma vez, sob demanda. O histórico de execuções mostra então cada execução, real ou de teste, etapa por etapa, para que você veja o que aconteceu e por que uma execução falhou.

Abrir automações

O que uma execução de teste realmente faz

Uma execução de teste não é uma simulação. Ela executa a automação uma vez, na hora:

• As ações são executadas de verdade. E-mails são enviados, tags, grupos e acessos a cursos mudam, e webhooks e requisições externas são enviados. Teste com a sua própria conta ou com um membro de teste, não com um cliente real.
• Ela usa a última versão salva, mesmo que você ainda não a tenha publicado. Os eventos reais continuam usando a versão publicada até você publicar.
• Ela também funciona enquanto a automação está desativada.
• Quando o fluxo chega a uma etapa Atraso ou Aguardar até a data, a execução de teste aguarda como uma execução real. As etapas restantes são executadas de verdade quando a espera termina.
• Uma etapa Executar workflow inicia a outra automação de verdade. Essa execução aparece no histórico de execuções da outra automação com a origem Automático.
• Todas as integrações que o fluxo usa precisam estar conectadas. Caso contrário, o teste para com "Conecte primeiro estas integrações:" e os nomes que faltam.

As execuções de teste não contam na lista: Última execução, Execuções (7 d), Sucesso (7 d) e a visualização Falhou as ignoram. Um teste que falhou não marca a sua automação como falhada.

Criar uma automação

Iniciar uma execução de teste pela lista

Abra o menu de uma automação na lista e escolha Execução de teste. A caixa de diálogo explica: "Executa o rascunho atual uma vez com dados de teste vazios. As ações são executadas de verdade." Este teste começa sem dados de gatilho e sem membro. Ele serve para uma verificação rápida. Para testar com um membro ou com os seus próprios dados, inicie o teste no editor.

Se a automação tiver vários gatilhos, escolha um em Começar a partir do acionador. Depois clique em Iniciar execução de teste. O resultado aparece na mesma caixa de diálogo:

• Execução de teste concluída, com a duração.
• A execução de teste está aguardando em uma etapa de atraso ou espera quando o fluxo pausou em uma etapa Atraso ou Aguardar até a data. O resto vem depois.
• A execução de teste falhou, com a mensagem de erro da execução.

Executar novamente inicia outro teste. Se a automação não tiver gatilho, a caixa de diálogo mostra "Esta automação não tem um acionador para começar."

Iniciar uma execução de teste no editor

Clique em Execução de teste no cabeçalho do editor. A caixa de diálogo oferece mais controle:

• Se você tiver alterações não salvas, uma nota diz "Suas alterações não salvas são salvas antes da execução de teste." O teste salva primeiro e depois começa. Se o salvamento falhar, o teste não começa.
• Com um gatilho, a caixa de diálogo dá o nome dele. Com vários, escolha um em Gatilho.
• Payload são os dados que o gatilho entregaria. Ele começa como {}. Informe os campos que as suas etapas leem, por exemplo o campo que uma condição verifica ou que um marcador como {{order_id}} usa: {"order_id": 1042, "amount": 4900}. Enquanto o texto não for JSON válido, a caixa de diálogo mostra "JSON inválido. Verifique o payload e tente novamente." e não executa.
• UUID do membro é o membro a que a execução se refere. Ações que atuam sobre um membro, por exemplo adicionar uma tag ou conceder um curso, precisam de um. Deixe vazio para fluxos sem membro, como um agendamento ou um webhook. Você encontra o UUID no fim do endereço da web quando abre o membro na área de administração. Um UUID desconhecido para o teste com "Este membro não foi encontrado neste negócio."

Clique em Executar teste. A caixa de diálogo fecha, o histórico de execuções abre e a tela mostra a nova execução.

Estas mensagens impedem um teste antes de ele começar:

• "Salve a automatização uma vez antes de iniciar uma execução de teste."
• "Adicione um gatilho e salve antes de iniciar uma execução de teste."
• "Este gatilho ainda não está na versão salva. Salve e tente novamente."
• "Esta automatização não tem gatilhos para testar."

O histórico de execuções

Clique em Execuções no cabeçalho do editor. O botão funciona depois que a automação foi salva. O painel lista as 50 execuções mais recentes que correspondem aos seus filtros, da mais nova para a mais antiga, e se atualiza a cada poucos segundos. Cada entrada mostra o estado, a origem, o gatilho, quando a execução começou e, depois de terminada, quanto tempo levou. Para uma execução que está aguardando, ela também mostra quando será retomada.

Estado

• Em execução: a execução está em andamento.
• Aguardando: a execução aguarda em uma etapa Atraso ou Aguardar até a data. A entrada mostra Retoma com a data e a hora, no seu horário local, em que ela continua. Se vários caminhos estiverem aguardando, é o horário mais cedo.
• Concluído: a execução chegou ao fim.
• Falhou: uma etapa falhou ou a execução atingiu um limite. Abra a execução para ver por quê.
• Cancelado: a execução estava aguardando e foi interrompida porque a automação foi desativada, arquivada ou excluída. Mais sobre isso mais abaixo.

Origem

• Automático: algo na sua plataforma iniciou a execução, por exemplo um novo membro ou um pedido. Execuções iniciadas por uma etapa Executar workflow de outra automação também mostram essa origem.
• Agendador: o relógio da plataforma iniciou a execução. Isso abrange os gatilhos Por agendamento (cron), Membro inativo, Evento prestes a começar e Renovação em breve.
• Manual: uma execução de teste ou uma repetição.
• Webhook: um webhook de entrada ou uma chamada de um serviço externo.
• Outro: qualquer outro início.

Filtros

Acima da lista, você pode filtrar por estado (Qualquer status), por origem (Qualquer origem) e por uma data e hora de início em Desde. Não há um filtro de estado separado para execuções que estão aguardando: elas aparecem em Em execução. Limpar filtros redefine todos os filtros e mostra quantos estão ativos. Quando nada corresponde, o painel diz "Nenhuma execução corresponde aos seus filtros" com um link Mostrar tudo. Antes da primeira execução, ele diz "Nenhuma execução ainda".

Ver uma execução

Clique em uma execução na lista. A tela passa para essa execução e mostra o fluxo como estava na versão que a execução usou. Um banner no topo mostra quando a execução começou, o estado dela e "A repetição é somente leitura." Você não pode editar enquanto vê uma execução. Sair da repetição traz de volta o seu rascunho atual.

Cada etapa que a execução alcançou recebe um anel colorido e um pequeno selo:

• Verde: Concluído.
• Vermelho: Falhou.
• Azul: Em execução.
• Roxo com uma ampulheta: Aguardando. A etapa é uma etapa Atraso ou Aguardar até a data e a execução continua depois.
• Cinza: Ignorado. A etapa foi pulada, por exemplo porque um filtro parou esse caminho ou a execução foi cancelada durante a espera.

Etapas sem anel não foram alcançadas.

Clique em uma etapa para abri-la no painel à direita. Configurações mostra a configuração dela, somente leitura. Execução mostra o que aconteceu:

• Status, Iniciado e Concluído. Uma etapa que está aguardando mostra Retoma com o horário em que a execução continua.
• Entrada e Saída: os dados que a etapa recebeu e repassou.
• Uma caixa vermelha com o erro, se a etapa falhou. Mostrar rastreamento abre detalhes técnicos que você pode enviar ao suporte.
• Uma Observação amarela em uma etapa concluída significa que a etapa foi executada mas não mudou nada, por exemplo "The member already has this badge."

Uma etapa que a execução nunca alcançou diz "Nenhum rastreamento disponível". Se a execução inteira falhou, o banner também mostra o erro da execução em vermelho.

Repetir uma execução

Repetir no banner inicia a execução de novo. Depois da pergunta Repetir esta execução?, a caixa de diálogo avisa: "Executa o rascunho atual novamente com o mesmo payload. As ações são executadas de verdade." A repetição usa os mesmos dados de gatilho e o mesmo membro da execução original, mas a última versão salva do seu fluxo. Isso a torna a forma mais rápida de verificar uma correção: encontre a execução que falhou, corrija a etapa, salve, repita.

A repetição é uma nova execução com a origem Manual, e a tela passa para ela na hora. Se você substituiu o gatilho desde a execução original, a repetição para com "O gatilho desta execução não existe mais na versão atual. Inicie uma nova execução de teste."

Identificar falhas na lista

Você não precisa abrir cada automação para encontrar problemas. A lista os mostra, com base apenas em execuções reais:

• A visualização Falhou ao lado das suas pastas lista cada automação cuja última execução falhou. Quando não há nenhuma, ela mostra Nenhuma automação falhada.
• A coluna Última execução mostra Nunca, ou o horário da última execução com um ponto colorido: verde para concluída, azul para em execução, cinza para cancelada. Uma última execução que falhou aparece como um selo vermelho com a dica A última execução falhou.
• Sucesso (7 d) é a proporção de execuções concluídas entre as execuções finalizadas dos últimos sete dias. Execuções ainda em andamento não contam. Execuções que falharam e execuções canceladas a reduzem. Execuções (7 d) conta todas as execuções dos últimos sete dias e fica oculta por padrão.
• O filtro Estado da última execução encontra automações por Concluído, Falhou, Em execução, Cancelado ou Nunca.

A partir daí, abra a automação, abra Execuções, filtre por Falhou e clique na execução para ver qual etapa falhou e por quê.

Atividade: quem mudou o quê

Atividade no menu de uma automação lista as últimas 50 alterações dela, cada uma com a pessoa e o horário: Criado, Salvo, Publicado, Revertida, Ativado, Desativado, Arquivado, Desarquivada, Excluído, Duplicado, Importado para uma automação criada a partir de um modelo, e Segredo do webhook renovado. Alterações feitas em várias automações de uma vez aparecem em cada uma delas. Execuções de teste e repetições não fazem parte da atividade; você as encontra no histórico de execuções. Uma automação nova sem alterações mostra "Ainda sem atividade."

Visão geral das automações

O que acontece com as execuções que estão aguardando

Uma execução que aguarda em uma etapa Atraso ou Aguardar até a data verifica a automação de novo quando a espera termina:

• Desativada: uma execução real cuja hora chega enquanto a automação está desativada é cancelada. As etapas restantes dela não são executadas. Se você ativar a automação de novo antes de a espera terminar, a execução continua normalmente. Execuções de teste e repetições continuam mesmo com a automação desativada.
• Arquivada: a execução é cancelada, incluindo execuções de teste. Arquivar também desativa a automação.
• Excluída: a execução é cancelada.
• Nova versão publicada: uma execução que já começou termina com a versão com que começou. Só as execuções que começam depois da publicação usam a nova versão. O mesmo vale para uma reversão.

Uma execução cancelada mostra Cancelado no histórico de execuções, e a etapa em que estava aguardando passa para Ignorado. O erro da execução diz por quê: "A automação foi pausada enquanto a execução aguardava.", ou o mesmo com arquivada ou excluída.

Condições, ramificações e atrasos

Por quanto tempo as execuções são mantidas

O histórico de execuções mantém as execuções por 90 dias. Uma vez por dia, as execuções mais antigas são excluídas junto com a entrada e a saída das etapas delas. Execuções que ainda estão aguardando são mantidas até terminarem.

Erros comuns e o que significam

Problemas que o editor sinaliza

O editor marca etapas com problemas antes de você executar qualquer coisa. Salvar continua funcionando, mas a automação pode não se comportar como você espera:

• "O gatilho não tem nenhum tipo de evento selecionado.": escolha a que o gatilho reage.
• "O gatilho não deve ter uma conexão de entrada.": um gatilho sempre inicia o fluxo. Remova a conexão que leva até ele.
• "A ação não tem nenhum tipo selecionado.": escolha o que a ação faz.
• "A ação precisa de uma integração, mas nenhuma foi escolhida." e "A integração necessária não está conectada.": conecte o serviço em Integrações e selecione a conexão na etapa.
• "“Dias de inatividade” deve ser 1 ou mais.", "“Dias antes da renovação” deve ser 1 ou mais." e "“Horas antes do início” deve ser 1 ou mais.": os gatilhos Membro inativo, Renovação em breve e Evento prestes a começar nunca são iniciados sem esse número. Informe um número inteiro igual ou maior que 1.
• "O atraso não tem duração.": informe uma duração maior que zero.
• "Nenhum fluxo de trabalho selecionado em “Executar fluxo de trabalho”.": escolha a automação que a etapa deve iniciar.
• "Nenhuma conexão de entrada. Este nó não pode ser alcançado.": conecte a etapa ao fluxo ou exclua-a.
• "O fluxo não tem nenhum nó de gatilho.": adicione um gatilho.
• "Responder ao webhook é executado após uma etapa de atraso ou espera. Quem chamou o webhook recebe a resposta padrão.": mova a resposta para antes da espera.

Erros em uma execução que falhou

O erro de uma execução que falhou identifica a etapa e o tipo, por exemplo "A etapa "Enviar e-mail" (Ação) falhou." ou "A etapa "Enviar e-mail" (Ação) parou com um erro.", seguido do motivo. Gatilhos e ações aparecem com o nome da biblioteca, e as demais etapas com o nome mostrado na tela. Clique na etapa vermelha na tela para ler a mensagem completa. Esses erros aparecem no idioma padrão da sua plataforma, também em execuções de teste e repetições. Causas frequentes:

• "… parou com um erro.": a etapa encontrou um erro, muitas vezes um serviço externo que recusou a requisição ou uma conexão que precisa ser renovada.
• "A solicitação retornou HTTP …", "Não foi possível enviar a solicitação: …" ou "A URL "…" não é válida ou não é permitida.": uma etapa Fazer requisição externa recebeu um erro do seu servidor, nenhuma resposta a tempo, um redirecionamento ou um endereço que ela não pode chamar.
• "O fluxo de trabalho a executar não foi encontrado.", "O fluxo de trabalho a executar não tem versão publicada." ou "O fluxo de trabalho a executar não tem gatilho.": a automação que uma etapa Executar workflow inicia foi excluída, nunca foi publicada ou não tem gatilho.
• "Um fluxo de trabalho não pode executar a si mesmo." e "Os fluxos de trabalho estão aninhados profundamente demais (no máximo 5 níveis).": etapas Executar workflow chamam umas às outras em círculo ou com profundidade demais.
• "O fluxo de trabalho "…" falhou.": a outra automação falhou. Veja o histórico de execuções dela.
• "O limite de 500 etapas foi atingido.": uma execução executa no máximo 500 etapas de uma vez. Isso geralmente vem de uma repetição sobre uma lista longa com várias etapas dentro.
• "A execução demorou demais e foi interrompida.": a execução levou mais tempo do que a plataforma permite, por exemplo porque um serviço externo respondeu devagar demais.

Notas em etapas concluídas

Uma nota amarela marca uma etapa que foi concluída sem fazer o seu trabalho:

• "No member of this business could be resolved for this run.": a execução não tem membro. Teste de novo com um UUID do membro, ou verifique se o membro foi excluído durante uma espera.
• "The configured course no longer exists.", ou o mesmo para um grupo ou um distintivo: escolha um novo na etapa.
• "The course is not published, so no access was granted.": publique o curso primeiro.
• "Nenhuma data encontrada em "…". O fluxo continuou sem aguardar." ou "Não foi possível ler a data "…". O fluxo continuou sem aguardar.": uma etapa Aguardar até a data não encontrou uma data utilizável e continuou sem aguardar.
• "O fluxo de trabalho "…" está pausado. O fluxo continuou sem ele.": ative a automação que a etapa Executar workflow inicia.

Nem toda ação deixa uma nota. Se uma etapa de membro mostra Concluído mas nada mudou, verifique se a execução tinha um membro em Entrada.