Automatizando Notificações com Power Automate: Uma Jornada de Correção e Otimização

Cara Core Informática 10 de dezembro de 2025

Introdução

Já imaginou ter um sistema que avisa automaticamente seus clientes quando uma proposta está parada há 7 ou 14 dias? Que envia notificações no Microsoft Teams, atualiza registros no SharePoint e ainda registra cada interação para auditoria futura? Parece complexo, mas é exatamente isso que o Power Automate pode fazer quando configurado corretamente.

Esta é a história de como corrigimos e otimizamos um fluxo crítico de notificações no Power Automate, transformando um sistema funcional mas problemático em uma solução robusta, confiável e pronta para escala.

Se você trabalha com automação de processos, integração de sistemas Microsoft ou simplesmente quer entender como resolver problemas complexos em fluxos do Power Automate, esta história é para você.

PARTE I: O Desafio - Quando a Automação Causa Mais Problemas

O Cenário Inicial

Tínhamos um fluxo do Power Automate rodando em produção que deveria:

1. Monitorar propostas comerciais no SharePoint
2. Detectar quando uma proposta ficava parada por 7 ou 14 dias sem atualização
3. Enviar notificações automáticas ao responsável via Microsoft Teams
4. Registrar a resposta do responsável de volta no SharePoint
5. Atualizar o status da proposta quando necessário

Parece simples, certo? O problema era que o fluxo funcionava, mas com problemas críticos:

• Formatação HTML duplicada: Os comentários no SharePoint apareciam com tags <p> duplicadas, tornando o texto ilegível
• Conexões frágeis: Múltiplas referências de conexão ao SharePoint causavam instabilidade
• Falhas na publicação: Tentativas de atualizar o fluxo via API resultavam em erros
• Falta de resiliência: Não havia tratamento adequado de erros ou retry automático

Era como ter um carro que funciona, mas que range, vibra e pode parar a qualquer momento no meio da estrada.

Por Que Isso Importa?

Imagine você é um gerente comercial. Você tem 50 propostas abertas e precisa saber quais delas estão paradas há muito tempo. O sistema deveria:

• Avisar automaticamente quando uma proposta precisa de atenção
• Registrar sua resposta de forma clara e legível
• Atualizar o status sem você ter que fazer isso manualmente

Mas e se os avisos chegarem com textos embaralhados? E se o sistema falhar justamente quando você mais precisa? E se cada atualização manual no fluxo causar instabilidade?

A Decisão Estratégica

Precisávamos não apenas corrigir os bugs visíveis, mas criar uma base sólida para:

1. Estabilidade operacional: O fluxo não pode falhar
2. Manutenibilidade: Alterações futuras devem ser seguras
3. Observabilidade: Precisamos ver o que está acontecendo
4. Escalabilidade: Deve funcionar com 10 ou 1000 propostas

PARTE II: A Anatomia do Problema - Entendendo o Fluxo

Como Funciona um Fluxo de Notificações?

Vamos desmistificar o Power Automate usando uma analogia simples:

Imagine uma fábrica com esteiras transportadoras:

1. Trigger (Gatilho): Um novo item chega na esteira (item criado no SharePoint)
2. Etapa 1 - Coleta de dados: Robôs coletam informações sobre o item
3. Etapa 2 - Decisão: Um inspetor verifica condições (7 ou 14 dias? Status correto?)
4. Etapa 3 - Ação: Se aprovado, envia notificação e atualiza registros
5. Etapa 4 - Timeout: Se ninguém responder, encerra graciosamente

O Diagrama do Fluxo

Visão Geral da Arquitetura (Diagrama C4)

Para entender melhor como tudo funciona, veja o diagrama abaixo que mostra a arquitetura completa do sistema de notificações automatizadas:

Analogia do Mundo Real:
Pense neste sistema como um assistente pessoal que:

• Fica de olho em todas as suas propostas comerciais
• Te avisa quando algo está esquecido
• Anota suas respostas automaticamente
• Mantém tudo organizado sem você precisar fazer manualmente

É como ter alguém dedicado apenas a garantir que nenhuma oportunidade de negócio seja perdida por esquecimento!

Fluxo Técnico Detalhado

Para quem deseja ver os detalhes técnicos da implementação:

Trigger (SharePoint Notifications)
  └─> Obter item (Notifications)
       └─> Obter item relacionado (Leads)
            ├─> [SE status=9 E propostaEnviada7dias=Sim]
            │     ├─> Enviar e-mail (7 dias)
            │     ├─> Microsoft Teams: Pergunta ao responsável
            │     ├─> Obter perfil do usuário (O365)
            │     ├─> Compor comentário formatado
            │     ├─> Salvar em variável (varComentario)
            │     ├─> Atualizar SharePoint (Leads) - comentário
            │     └─> Atualizar SharePoint (Notifications) - resposta
            │        (Timeout após 3 dias: Terminate Succeeded)
            │
            └─> [SE status=9 E propostaEnviada14dias=Sim]
                  ├─> Enviar e-mail (14 dias)
                  ├─> Microsoft Teams: Pergunta ao responsável
                  ├─> Obter perfil do usuário (O365)
                  ├─> Compor comentário formatado
                  ├─> Salvar em variável (varComentario)
                  ├─> Atualizar SharePoint (Leads) - comentário + status
                  └─> Atualizar SharePoint (Notifications) - resposta
                     (Timeout após 3 dias: Terminate Succeeded)

Os Problemas Identificados

<!-- O que era gravado no SharePoint: -->
<p><p>Comentário do usuário</p></p>

<!-- O que deveria ser: -->
<p>Comentário do usuário</p>

Para Executivos e Leigos:
Imagine que você envia uma mensagem, mas ela chega com cada palavra repetida duas vezes (Problema 1). Ou pense em ter duas chaves para a mesma porta, mas ninguém sabe qual usar (Problema 2). E ainda, quando você tenta atualizar o sistema, ele simplesmente não aceita suas mudanças porque está "falando um idioma diferente" (Problema 3). Era exatamente isso que acontecia: mensagens confusas, caminhos duplicados e impossibilidade de fazer melhorias com segurança.

PARTE III: A Solução - Correção Cirúrgica e Segura

Princípios da Correção

Adotamos uma abordagem conservadora e incremental:

Ação 1: Padronização do Comentário

// A variável recebia HTML com wrapper duplicado
varComentario = "<p>" + outputs('Compose_comentario') + "</p>"

// Remove wrapper externo, mantém apenas conteúdo
varComentario = outputs('Compose_comentario')

Para Executivos e Leigos:
Pense em enviar uma carta. Antes, estávamos colocando a carta dentro de um envelope, e depois colocando esse envelope dentro de outro envelope. Quando chegava no destinatário, ele via dois envelopes em vez de um, ficando confuso. A solução foi simples: usar apenas um envelope. Agora a mensagem chega limpa, direta e legível. É como remover embalagens desnecessárias de um produto - fica mais simples e funcional.

Ação 2: Normalização de Conexões

{
  "PatchItem_Leads": {
    "connection": "shared_sharepointonline"
  },
  "PatchItem_Notifications": {
    "connection": "shared_sharepointonline_1"  // ← Inconsistente
  }
}

{
  "PatchItem_Leads": {
    "connection": "shared_sharepointonline"
  },
  "PatchItem_Notifications": {
    "connection": "shared_sharepointonline"  // ← Unificado
  }
}

Para Executivos e Leigos:
Imagine que sua empresa tem duas entradas: uma pela frente e outra pelos fundos. Antes, alguns funcionários entravam pela frente e outros pelos fundos, sem razão específica. Isso causava confusão no controle de acesso. Agora, todos entram pela mesma porta principal. Ficou mais simples, mais seguro e mais fácil de gerenciar. No sistema, isso significa que todas as operações usam o mesmo "cartão de acesso" para falar com o SharePoint, eliminando duplicação e pontos de falha.

Ação 3: Publicação Confiável via API

Criamos um script Python (publish_flow_patch.py) que:

1. Autentica via Azure CLI ou MSAL
2. Faz backup automático do fluxo original
3. Aplica patches cirúrgicos apenas nas ações necessárias
4. Usa método PATCH em vez de PUT (compatibilidade)
5. Preserva connectionReferences (evita quebra de conexões)
6. Valida antes de aplicar (modo dry-run disponível)

# Dry-run para validar mudanças
python publish_flow_patch.py \
  --env-id "Default-00000000-0000-0000-0000-000000000000" \
  --flow-name "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" \
  --recipient-upn "responsavel@suaempresa.com" \
  --dry-run \
  --backup flow-backup.json

# Aplicar mudanças reais
python publish_flow_patch.py \
  --env-id "Default-00000000-0000-0000-0000-000000000000" \
  --flow-name "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" \
  --recipient-upn "responsavel@suaempresa.com"

Para Executivos e Leigos:
Pense neste script como um "assistente de segurança" para fazer mudanças no sistema. Antes de realmente aplicar qualquer alteração, ele faz um "ensaio" (dry-run) - como quando você testa uma nova rota antes de usá-la no dia do compromisso importante. Além disso, ele sempre tira uma "foto" (backup) do sistema antes de mexer em qualquer coisa. É como ter um botão "desfazer" profissional: se algo der errado, podemos voltar ao estado anterior em segundos. Isso transforma mudanças arriscadas em operações seguras e controláveis.

Ação 4: Tratamento de Status com Fallback

Problema: No branch de 14 dias, precisávamos atualizar o status para "Aguardando Cliente" (código 11), mas o schema nem sempre expunha item/status/Value corretamente.

// Fallback seguro
if (exists(item.status.Value)) {
  status = item.status.Value
} else {
  status = "11"  // Código direto para "Aguardando Cliente"
}

Para Executivos e Leigos:
Imagine que você pede uma informação ao assistente, mas às vezes ele não consegue responder porque o dado não está no formato esperado. Antes, o sistema simplesmente parava e dava erro. Agora, criamos um "plano B": se o assistente não encontrar a informação no lugar esperado, ele usa um valor padrão seguro. É como quando você pergunta "que horas são?" e a pessoa não tem relógio, mas sabe que é "mais ou menos meio-dia" pelo sol. Melhor uma resposta aproximada e segura do que nenhuma resposta.

PARTE IV: Resultados e Aprendizados

Resultados Quantitativos

Resultados Qualitativos

1. Confiança operacional: O time agora confia no fluxo
2. Manutenibilidade: Alterações futuras são seguras e rastreáveis
3. Observabilidade: Logs e diagnósticos claros
4. Escalabilidade: Pronto para crescer com a empresa

Aprendizados-Chave

PARTE V: Próximos Passos - Evoluindo a Solução

Resiliência Nativa

Implementar Scopes com Try/Catch:

Try:
  ├─> Enviar notificação Teams
  ├─> Obter resposta usuário
  └─> Atualizar SharePoint
Catch:
  ├─> Log erro em lista auxiliar
  ├─> Enviar alerta para TI
  └─> Tentar ação compensatória

Benefícios:

• Erros não quebram o fluxo inteiro
• Possibilidade de retry automático
• Melhor observabilidade

Observabilidade Avançada

Adicionar logging estruturado:

• Criar lista "FlowAuditLog" no SharePoint
• Registrar cada etapa crítica
• Incluir timestamps e IDs de correlação
• Dashboard Power BI com métricas

Métricas sugeridas:

• Tempo médio de resposta do usuário
• Taxa de propostas que avançam após notificação
• Horários de pico de execuções
• Taxa de timeouts

Validações Defensivas

Guardrails antes de ações críticas:

IF (usuário.email existe) E (usuário.email contém "@")
  ENTÃO enviar Teams
SENÃO
  Log erro + notificar admin

IF (item.status é válido) E (item.responsavel não está vazio)
  ENTÃO processar
SENÃO
  Log erro + skip item

Automação de Testes

Criar "Test Harness":

1. Script que cria item de teste no SharePoint
2. Aguarda execução do fluxo (polling)
3. Valida resultado esperado
4. Limpa dados de teste
5. Gera relatório de conformidade

PARTE VI: Lições para Outros Projetos

1. Automação Não é "Set and Forget"

Mito: "Criei o fluxo, agora ele roda sozinho para sempre"

Realidade: Automação exige:

• Monitoramento contínuo
• Ajustes conforme mudanças de requisitos
• Manutenção preventiva
• Evolução incremental

2. Ferramentas Certas Fazem Diferença

Investimentos que valeram a pena:

• Script Python para publicação controlada
• Backup automatizado antes de mudanças
• Diagramas Mermaid para visualização
• Documentação em Markdown versionada

3. Integração Entre Ferramentas Microsoft

Ecossistema Microsoft 365:

• Power Automate (orquestração)
• SharePoint (persistência)
• Microsoft Teams (notificações)
• Office 365 Users (perfis)
• Power BI (analytics - futuro)

Lição: Maximize o que o ecossistema oferece, mas tenha plano B para cada dependência crítica.

4. Governança de Fluxos

Conclusão

Automatizar processos com Power Automate é como construir pontes: parece simples à distância, mas os detalhes de engenharia fazem toda a diferença entre uma estrutura que resiste ao tempo e uma que cai no primeiro vento forte.

Nossa jornada de correção do fluxo de notificações nos ensinou que:

1. Diagnóstico preciso é mais importante que agir rápido
2. Mudanças incrementais são mais seguras que reescritas completas
3. Backup e rollback são seus melhores amigos
4. Documentação é investimento, não custo
5. Testes estruturados evitam surpresas em produção

Para Reflexão

Glossário - Entendendo os Termos Técnicos

Se você não é da área de tecnologia, este glossário vai ajudar a entender os termos usados ao longo do artigo:

Para Executivos e Leigos:
Este glossário é como um "dicionário de viagem" para o mundo da tecnologia. Cada termo técnico foi traduzido para linguagem do dia a dia usando analogias familiares. Se você entender esses conceitos básicos, conseguirá acompanhar conversas técnicas com sua equipe de TI e tomar decisões mais informadas sobre investimentos em automação. Lembre-se: tecnologia complexa pode ser explicada de forma simples - basta usar as metáforas certas!

Recursos Adicionais

Sobre a Cara Core Informática

Cara Core Informática é especializada em desenvolvimento de soluções empresariais robustas, integração de sistemas e automação de processos. Nossa abordagem combina engenharia de software sólida com profundo conhecimento do ecossistema Microsoft 365.

Serviços relacionados:

• Consultoria em Power Platform (Power Automate, Power Apps, Power BI)
• Desenvolvimento de soluções SharePoint
• Integração de sistemas empresariais
• Automação de processos (RPA e low-code)
• Governança e boas práticas em automação

Hashtags

Contato

• E-mail: suporte@caracore.com.br
• Site: www.caracore.com.br
• LinkedIn: Cara Core Informática

Artigo técnico | 10 de dezembro de 2025 | Power Automate v1.0
© 2025 Cara Core Informática. Todos os direitos reservados.