Acompanhar execuções e consertar uma automação
Veja o que rodou, leia o motivo de cada falha em português, tente de novo um passo e pause, retome ou cancele uma execução em andamento.
Guias do Automações 10
- Automações: o que roda sozinho entre os apps
- O que dá para automatizar hoje
- Criar a sua primeira automação
- Organizar automações em pastas
- Editar uma automação na bancada
- Condição, espera e caminhos diferentes no mesmo fluxo
- Acompanhar execuções e consertar uma automação
- Descobrir que uma automação falhou
- Automação que roda em horário, não em evento
- Acompanhar o painel de Automações
Etapa 1 de 4
Encontre a execução
Os filtros do topo levam à execução que você procura.
-
Na barra lateral do app, abra Execuções.
-
Em Situação, escolha Precisam de atenção. Aparece o filtro Motivo, que separa o caso.
-
Em Automação, escolha uma automação só, ou Todas as automações.
-
Em Período, escolha Últimas 24h, Últimos 7 dias, Últimos 30 dias ou Qualquer período.
-
Para achar a execução de um registro, use Buscar por registro.
-
Cada linha mostra o Status, a Automação, o Registro, o Gatilho, o Início e a Duração.
Etapa 2 de 4
Leia o relatório
O gatilho, os passos e o motivo da falha numa tela só.
-
O relatório abre no passo que falhou, quando há um.
-
À esquerda ficam o gatilho e os passos, na ordem, com o status de cada um. À direita, a Entrada e a Saída do passo escolhido.
-
Clique no passo que falhou para ver a Entrada e a Saída dele.
-
O relatório diz o motivo numa frase e o que fazer. Quando o conserto está no próprio passo, Abrir o passo leva direto a ele no editor.
-
O texto técnico completo fica em Detalhes técnicos.
-
Para ver o registro de origem, use Abrir o registro.
Etapa 3 de 4
Tente de novo um passo
Corrigida a causa, só aquele passo volta para a fila.
-
Depois de corrigir a causa, abra o passo no relatório.
-
O botão aparece nos passos que falharam, esgotaram as tentativas ou ficaram com dados inválidos.
-
A confirmação diz O passo vai rodar de novo. Acompanhe o status aqui. Só aquele passo volta para a fila, não o fluxo inteiro.
-
O status do passo passa por Na fila e Executando até Concluído.
Etapa 4 de 4
Pause, retome ou cancele uma execução
Para uma execução em andamento, como a que está num passo Esperar.
-
Uma execução em andamento, como a que está num passo Esperar, tem no relatório os botões Pausar e Cancelar execução.
-
Pausar segura os passos que faltam. Uma execução pausada por 7 dias é cancelada sozinha.
-
Retomar devolve os passos à fila.
-
Cancelar execução pede confirmação e encerra o que faltava.
Precisa de mais? Abra um chamado dentro do Hub.
Ler este passo a passo em texto
“A automação não fez nada” quase nunca significa que nada aconteceu. Significa que alguma coisa aconteceu e ninguém olhou onde ficou registrado. As execuções respondem três perguntas: rodou, por qual caminho passou e o que deu errado.
Antes de começar
- Acesso ao app Automações. Leitura basta para consultar; tentar de novo, pausar ou cancelar exige permissão de gerenciar.
- Ser membro da automação. Você só vê as execuções das automações de que participa.
- Saber mais ou menos quando o acontecimento deveria ter ocorrido. O filtro de período organiza a busca.
Encontre a execução
- Abra Execuções na barra lateral do app.
- Use os filtros do topo:
- Situação: Em andamento, Concluídas, Precisam de atenção ou Canceladas. Em Em andamento e Precisam de atenção, um segundo filtro, Motivo, separa o caso. Em Em andamento: Na fila, Em execução, Aguardando espera e Pausada. Em Precisam de atenção: Parciais, Falhas, Não entraram na automação, Paradas (loop), Paradas (limite), Paradas (acesso perdido) e Paradas (registro mudou).
- Automação: uma automação só, ou Todas as automações.
- Período: Últimas 24h, Últimos 7 dias, Últimos 30 dias ou Qualquer período.
- Para achar a execução de um registro, use Buscar por registro.
Cada linha mostra o Status, a Automação, o Registro, o Gatilho, o Início e a Duração.
O nome na coluna Registro. Quando o gatilho é de um registro (um negócio, uma tarefa), a coluna mostra o nome dele. Quando a execução não tem registro, ela mostra de onde veio: Chamada do webhook, Execução agendada ou Execução manual. No webhook, dá para dar um nome a cada chamada, como o nome do lead, em Nome da execução.
Dentro de cada automação, a aba Execuções mostra só as execuções dela, ao lado do canvas.
Leia o relatório
- Clique na execução. O relatório abre no passo que falhou, quando há um.
- À esquerda ficam o gatilho e os passos, na ordem, com o status de cada um. À direita, a Entrada e a Saída do passo escolhido.
- Num passo que falhou, o relatório diz o motivo numa frase e o que fazer. Quando o conserto está no próprio passo, Abrir o passo leva direto a ele no editor. O texto técnico completo fica em Detalhes técnicos.
- Para ver o registro de origem, use Abrir o registro.
Entenda o status de cada passo
| Status | O que significa |
|---|---|
| Na fila | O passo foi aceito e aguarda execução |
| Executando | Está rodando agora |
| Aguardando | Um passo Esperar está contando o tempo |
| Concluído | Terminou com sucesso |
| Falhou, vai tentar de novo | Deu erro e será tentado de novo sozinho |
| Esgotou as tentativas | Falhou em todas as tentativas e parou |
| Dados inválidos | A configuração do passo não é aceita, então ele nem chegou a executar |
| Pulado pelas condições | As condições barraram este passo. Não é erro |
| Pulado, com o motivo | O passo não tinha o que fazer, e o motivo vem escrito: Pulado: passo desligado, Pulado: automação arquivada ou Pulado: a skill terminou sem resultado |
| Não executado: limite por hora | A execução parou no teto por hora antes de chegar a este passo |
| Recusado: a skill pode ter gravado | Um passo Executar skill do Marvin falhou depois de gravar algo. Confira o que ele gravou antes de rodar de novo |
| Pausado | A execução foi pausada, e o passo espera a retomada |
| Cancelado | A execução foi cancelada antes de chegar aqui |
Um passo que falha é tentado três vezes, com espera crescente entre as tentativas. Só depois disso ele aparece como Esgotou as tentativas.
Tente de novo um passo
Depois de corrigir a causa, abra o passo no relatório e clique em Tentar de novo. A confirmação diz O passo vai rodar de novo. Acompanhe o status aqui. Só aquele passo volta para a fila, não o fluxo inteiro.
O botão aparece nos passos que falharam, esgotaram as tentativas ou ficaram com dados inválidos. No passo Executar skill do Marvin, ele vale quando a skill caiu antes de gravar qualquer coisa. Se a skill já gravou algo, o passo aparece como Recusado: a skill pode ter gravado e não é repetido, para não duplicar a tarefa ou a nota que ela criou.
Pause, retome ou cancele uma execução
Uma execução em andamento, como a que está num passo Esperar, tem no relatório os botões Pausar, Retomar e Cancelar execução.
- Pausar segura os passos que faltam. O passo que já estava rodando termina antes de parar. Uma execução pausada por 7 dias é cancelada sozinha.
- Retomar devolve os passos à fila.
- Cancelar execução pede confirmação e encerra o que faltava. A confirmação, Cancelar esta execução?, tem Manter execução e Cancelar execução: os passos que ainda não começaram não rodam, e o passo em andamento termina o que já começou.
Desligar a automação impede novas execuções. As que já estão em andamento terminam normalmente, a não ser que você marque, na confirmação, para cancelar também.
Como saber que deu certo
- Depois da correção, a execução seguinte aparece com todos os passos em Concluído.
- Na lista de automações, a barra de Últimos 7 dias fica verde nas próximas execuções.
- O resultado existe no app de destino, e não só no relatório.
Problemas comuns
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| Nenhuma execução no período | O acontecimento não ocorreu, ou a condição do gatilho barrou tudo | Confira se o gatilho descreve o que a equipe faz de verdade e teste a condição |
| A execução existe, mas o passo está pulado | As condições daquele passo não bateram, ou o motivo está escrito no status | Leia o motivo. Sem motivo, revise as regras do passo, não as do gatilho |
| Tentar de novo não aparece | A execução está pausada, ou o passo não falhou | Retome a execução antes. Passo concluído ou pulado não se repete |
| O passo de skill aparece como Recusado: a skill pode ter gravado | A skill gravou algo antes de falhar | Confira no app de destino o que ela gravou e rode de novo pelo gatilho, se for o caso |
| Toda chamada do webhook aparece como Chamada do webhook | O gatilho não tem Nome da execução | Preencha o campo no gatilho. As chamadas antigas continuam sem nome |
| A execução aparece como Parada (limite) | O mesmo registro rodou mais vezes do que o limite por hora | Confira se o fluxo está alimentando o próprio gatilho |
| Execuções antigas sumiram | Existe prazo de retenção | Execuções concluídas ficam 30 dias e as que falharam ficam 90 dias |
Próximo passo
- Descobrir que uma automação falhou: o aviso que chega aos Donos e a rotina de conferência.
- Editar uma automação na bancada: corrigir o passo e voltar para uma versão anterior.
- Precisa de ajuda? Abra e acompanhe chamados: quando o erro não é de configuração.
Não resolveu?
Abra um chamado pelo botão de suporte dentro do Hub. Nosso time responde e, quando é problema de produto, ele vira uma correção rastreável.