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 “Corrigir” para ver o motivo da falha, que fica no retângulo vermelho no topo da página. Veja no gif abaixo:
Na coluna do lado esquerdo, estão todas as informações que recebemos da ferramenta de origem.
Na coluna do lado direito, estão as informações que foram enviadas para a ferramenta de destino, de acordo com o seu mapeamento.
É nessa coluna também que você verifica de que forma as informações estão sendo enviadas pela Pluga e qual é o campo que retornou a falha.
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 a validação da conta está “verde” ou “vermelha”. Assim, olha:
Se ficar vermelho, nós já temos um artigo pronto para você! Dá uma olhada: 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 ;)