Criou sua automatização corretamente, viu que o gatilho dela foi acionado e que ela já está capturando e processando eventos, mas por algum motivo, as informações não estão chegando na ferramenta de destino?
Provavelmente, seus eventos estão com falha!
Não sabe o que fazer? Relaxa, esse artigo vai te mostrar:
- Como encontrar, analisar e corrigir um evento com falha;
- Possíveis motivos de falha e como corrigir cada um deles;
Vale deixar claro que todas as falhas são retornadas pela ferramenta de destino, ou seja, a ferramenta que recebeu os dados. Por isso, na maioria dos casos é importante entender o que a falha retornada significa para a ferramenta de destino.
Como encontrar, analisar e corrigir um evento com falha
1. Encontrando eventos com falha
O primeiro passo para analisar e corrigir um evento com falha é saber onde encontrá-lo!
Para isso vá no “Histórico (Log)” da sua automatização, em “Minhas automatizações”.
No “Histórico (Log)” é onde ficam todos os seus eventos processados nos últimos três meses, seja os com “sucesso”, “falha” e/ou “guardado”.
Como você pode ver, alguns eventos foram processados com sucesso, mas outros tiveram falhas. E é justamente sobre eles (os com falha) que nós vamos falar agora!
Para saber mais sobre o “Histórico (Log)”, você pode dar uma olhada no artigo "O que é exatamente o Histórico (Log) e como acessá-lo?".
Ah, caso você chegue no “Histórico (Log)” e não encontre nenhum evento, esse artigo aqui pode te ajudar: “Criei minha automatização, mas ainda não tive eventos”.
2. Analisando eventos com falha
O segundo passo para corrigir um evento com falha é analisar o motivo dela.
Clique no botão “Ver detalhes” para ver o motivo da falha. AO clicar, a mensagem de falha deve aparecer no retângulo vermelho no topo da página:
Te explicando mais sobre essa tela, ao selecionar a primeira ferramenta do fluxo (que é a ferramenta de origem), e clicar na aba de "Dados de saída", você encontra todas as informações que nós recebemos da ferramenta de origem e enviamos para a ferramenta de destino. Sempre vale dar uma olhada nessas informações!
Ao selecionar a segunda ferramenta ou outras, você encontra as informações enviadas e de que forma elas foram enviadas. Inclusive, a mensagens de falha são sempre retornadas a partir dessa segunda ferramenta.
De acordo com a mensagem de falha, você consegue identificar qual foi o motivo da falha e qual campo pode ser ajustado para que o evento seja reprocessado com sucesso.
3. Corrigindo um evento com falha
Agora que você já sabe onde encontrar e como analisar a falha, vamos mostrar como corrigi-las!
Como já falamos, o motivo das falhas é retornado pela ferramenta de destino dos dados e, por isso, podem existir diversos motivos para que ela seja retornada.
Algumas falhas podem ser corrigidas diretamente no Histórico (Log). Outras, deverão ser corrigidas no mapeamento, alterando os atributos mapeados.
É fundamental entender a falha para corrigi-la da melhor maneira e evitar que ela ocorra novamente. Abaixo, temos uma lista com as possibilidades de falha e como você pode corrigir cada uma delas.
Possíveis motivos de falha e como corrigir cada uma delas
Os campos obrigatórios não foram preenchidos na ferramenta de destino
É importante considerar que, ao enviar as informações para a ferramenta de destino dos dados, o preenchimento de alguns campos é obrigatório. Por isso, quando esses campos não são preenchidos, a ferramenta de destino retorna falha.
Para corrigir essa falha:
-
Acesse a página “Minhas automatizações" e o seu “Histórico (Log)”;
-
Encontrar o evento com falha e clique em “Corrigir”;
-
Preencha corretamente o campo obrigatório que retornou a falha;
-
Clique em “Salvar e reenviar”, no final da página;
Nesse vídeo você vê na prática como corrigir essa falha:
Importante: Fique sempre atento ao preenchimento das informações ainda na ferramenta de origem dos dados! Assim, você garante que todos os campos obrigatórios serão preenchidos corretamente e essa falha não será retornada.
As informações enviadas não foram preenchidas corretamente
Assim como o preenchimento de alguns campos na ferramenta de destino é obrigatório, outros ainda exigem um formato específico e possuem mecanismos de validação de dados. Por exemplo, validam se o CEP existe, se o CPF é válido, etc.
Com isso, caso uma falha referente ao formato da informação seja retornada, você deve corrigir o devido campo diretamente no Histórico (Log):
-
Acesse a página "Minhas automatizações" e, em seguida, o "Histórico (Log)" da sua automatização;
-
Encontre o evento com falha e clique em “Corrigir”;
-
Verifique o formato da informação do campo que retornou a falha;
-
Preencha com a informação correta;
-
Clique em “Salvar e reenviar” no final da página.
Mapeamento incorreto: muitos atributos inseridos em um mesmo campo
Imagine que você já verificou o preenchimento em sua ferramenta de origem, ele está sendo feito corretamente e que as informações estão sendo preenchidas no formato correto. Mas, ainda assim o seu evento continua com falhas.
Se isso estiver acontecendo, acesse o seu mapeamento e verifique se a seleção de atributos está correta.
Ao abrir o mapeamento de sua automatização, você vai perceber que há campos específicos para receber cada uma das informações. Com isso, é fundamental que você faça o mapeamento correto, selecionando cada atributo em seu devido campo.
Autenticação de conta está expirada
Sua automatização estava funcionando perfeitamente e “do nada” ela deixou de processar seus eventos com sucesso?
Pode ser que a autenticação da sua ferramenta de destino tenha expirado!
Para conferir essa informação, você deve simular a criação de uma nova automatização e verificar se harevá uma mensagem comprovando se a conta está devidamente conectada ou não. Assim, olha:
Caso você encontre uma mensagem como a da imagem, basta clicar em "Reconectar" e fazer a reconexão ali mesmo! Ou, se preferir fazer em outro momento, você pode seguir os passos deste artigo: Como reconectar a conta da sua ferramenta autenticada.
Caso você tenha verificado todos os pontos acima e nenhum deles se encaixa ao seu evento com falha, entre em contato com o nosso time de suporte pelo e-mail suporte@pluga.co.
Dúvidas?
Caso ainda tenha dúvidas, é só solicitar um atendimento que nosso time de suporte entrará em contato dentro de algumas horas ;)