Como Identificar e Notificar Erros no Power Automate Cloud

Este artigo é baseado no vídeo acima, onde mostramos passo a passo como transformar erros inesperados em automações do Power Automate Cloud em notificações claras e úteis para você e sua equipe. O objetivo? Que ninguém descubra um problema só no dia seguinte, no susto, quando o prejuízo já pode ter acontecido.

Por que falhas acontecem nos fluxos?

Você já teve aquela sensação de que criou um fluxo perfeito… até que um detalhe passa despercebido? Imagine um fluxo de automação simples, mas que em algum momento executa uma divisão. Se, por acaso, o divisor for zero, pronto: erro na certa.

E ainda que o Microsoft Power Automate envie automaticamente um e-mail de erro ao criador do fluxo, essa mensagem chega de forma genérica, só para quem fez o fluxo e geralmente só horas depois. Não é difícil pensar em casos em que isso não é suficiente. Em fluxos críticos, o melhor é uma notificação rápida, acionando as pessoas ideais no momento certo.

Falhas são partes do caminho; respostas rápidas mudam o jogo.

Organizando fluxos para capturar erros

No projeto Power, sempre buscamos práticas que ajudam nossos alunos e clientes a identificar e responder rápido às falhas. E um jeito claro de começar é usando escopos – aquelas “caixas” que agrupam várias ações dentro de um fluxo.

• Escopos servem para executar várias tarefas sob uma mesma lógica.
• Quando algo dá errado dentro do escopo, conseguimos “ouvir” esse erro de forma centralizada.

Isso resolve um grande problema: sem escopos, precisaríamos verificar cada etapa do fluxo para definir o que fazer em caso de falha. Assim, basta configurar tudo em um único local.

Configurando notificações após o escopo

Na prática, trabalhamos assim:

1. Projetamos o fluxo, incluindo todas as etapas relevantes dentro de um escopo.
2. Logo após esse escopo, adicionamos uma etapa de notificação – pode ser um envio de e-mail ou uma mensagem no Microsoft Teams, por exemplo.
3. O truque: configuramos a etapa de notificação para ser executada apenas se o escopo anterior falhar.

É simples de ajustar. Na ação que envia a notificação, abrimos o menu dos três pontinhos e escolhemos Executar após – Somente em caso de falha. Pronto, agora só vamos avisar sobre o erro se realmente for necessário.

Conhecendo a função Workflow

A notificação deve ser clara, e não só dizer: “algo deu errado”. Por isso, outro recurso útil do Power Automate é a função Workflow(). Com ela, conseguimos buscar detalhes técnicos do fluxo, como:

• Nome do fluxo que falhou
• ID único da execução
• Data e hora do erro

Essas informações podem ser incluídas na mensagem destinada à equipe. Imagina receber uma notificação direto no Teams com:

Fluxo ‘Atualizar Relatório Comercial’ falhou às 15:22. ID da execução: 1234abcd5678. Clique aqui para ver o detalhe.

Isso reduz o tempo para localizar a falha. Não é exagero dizer que já evitamos horas de investigação, só por ter os detalhes à mão.

Criando links diretos para a análise de erro

Com os dados do Workflow, também podemos montar um link que leva direto à execução do fluxo no Power Automate. Assim, o responsável pode clicar e conferir rapidamente onde e por que o erro aconteceu.

O link geralmente segue este formato:

• https://make.powerautomate.com/environments/{ambiente}/flows/{id_do_fluxo}/runs/{id_da_execução}

Basta coletar o ID do fluxo (também disponível na URL do Power Automate) e o ID da execução atual, usando workflow().run.name. Desse jeito, a notificação fica muito mais útil, pronta para a ação.

Capturando e exibindo detalhes do erro

Mas o que realmente aconteceu? Para isso, outra função interessante entra em cena: actions(). Ela permite acessar o código e a mensagem de erro da etapa que falhou dentro do escopo.

Dá para incluir na mensagem de notificação, por exemplo:

Erro: ‘Ação ‘Dividir Valor’ retornou – Division by zero’.

• Use actions(‘Nome_da_Acao’).outputs.body.error.code para buscar o código de erro.
• Use actions(‘Nome_da_Acao’).outputs.body.error.message para coletar a mensagem detalhada do erro.

Incluir tudo isso pode até parecer exagero, mas, na prática, elimina boa parte da incerteza na hora de resolver o problema. Se a etapa ‘Enviar para Planilha’ falhou por falta de permissão, a mensagem vai explicar, e o solucionador já parte com meio caminho andado.

Por que usar escopos simplifica o controle

Seria possível tratar erros individualmente para cada ação? Sim, mas imagine o caos num fluxo com 12 etapas importantes. O escopo agrupa e centraliza a tratativa, facilitando a configuração e mantendo o fluxo limpo e compreensível.

Escopos organizam, clareiam e economizam seu tempo.

No projeto Power, sempre defendemos que fluxos bem estruturados também ajudam futuros ajustes, alterações e até treinamentos de novos colaboradores. Um padrão de controle de erros deixa todos mais seguros e diminui o risco daquela pane silenciosa que só aparece lá na frente.

Exemplos práticos de notificações no Teams

Vamos a situações reais: imagine que o setor financeiro depende de um fluxo para atualizar relatórios diários. Um erro pode comprometer toda a tomada de decisão do dia seguinte.

Ao usar notificações automáticas no Teams, o alerta já chega configurado assim:

• Título: Falha no fluxo: Atualizar Relatório Comercial
• Mensagem: “A etapa ‘Buscar Vendas’ retornou erro: Falha de conexão com o banco de dados.”
• Data/hora da falha: 16/08/2024 às 18:43
• Link para análise: clique e vá direto para o detalhe da execução

Como resultado, a equipe já recebe o contexto – e pode agir na hora. Isso evita aquele “telefone sem fio” de repassar mensagens incompletas e garante que o problema chegue logo à pessoa certa.

Como interpretar rapidamente a notificação?

Agora, basta ler os campos enviados. Se o código do erro indica falta de permissão, alguém do setor de TI pode resolver. Se a mensagem indica problema de conexão, talvez seja hora de revisar os acessos ou falar com o fornecedor de banco de dados.

Em poucos minutos, o cenário pode mudar. Imagine um cenário sem esta automação: talvez a falha só seja percebida horas depois ou causando sequelas maiores para os envolvidos e para o próprio negócio.

Conclusão: automatizar o alerta é agir rápido

Falhas em fluxos são inevitáveis, mas ignorá-las não precisa ser regra. Com automações bem pensadas, escopos, uso das funções Workflow e Actions, é possível trazer clareza para sua equipe e evitar impactos maiores.

No projeto Power, ensinamos tudo isso do zero ao avançado. Nossa missão é descomplicar o uso das ferramentas Microsoft 365 e Power Platform – de Power Apps Canvas a fluxos complexos no Automate, passando por relatórios no Power BI e muito mais.

Se quiser garantir qualidade nas suas automações, conhecer nossas consultorias ou se aprofundar nos treinamentos, fique à vontade para conhecer o projeto Power. E compartilhe este artigo e vídeo com colegas – talvez seja a notificação que alguém precisa para evitar o próximo susto!