Power Automate com SharePoint: automações essenciais
Guia prático de Power Automate com SharePoint: gatilhos, criar e atualizar itens, notificar por e-mail e Teams, mover arquivos e evitar loops e limites.
O trabalho manual em listas do SharePoint drena horas da sua equipe
Toda semana alguém abre uma lista do SharePoint, confere se entrou uma solicitação nova, copia o dado para outra lista, avisa o responsável no chat e move um anexo para a pasta certa. Repetido dezenas de vezes por dia, esse ritual consome horas e ainda erra: um item passa batido, um e-mail nunca sai. É exatamente esse tipo de tarefa repetitiva que o Power Automate com SharePoint resolve bem, porque o SharePoint é um conector padrão da plataforma e não exige licença premium para os cenários mais comuns.
Neste artigo vou mostrar, na prática, as automações essenciais que sustentam a maioria dos fluxos com listas e bibliotecas: disparar quando um item é criado ou modificado, criar e atualizar itens, notificar por e-mail e pelo Teams, mover arquivos entre bibliotecas e os cuidados com looping e limites que separam um fluxo confiável de um que quebra em produção. Tudo com passo a passo, sem enrolação.
Escolher o gatilho certo define o comportamento do fluxo inteiro
O conector do SharePoint oferece gatilhos automáticos que iniciam o fluxo sozinhos quando algo acontece na lista ou biblioteca. Os dois que você mais vai usar são Quando um item é criado e Quando um item é criado ou modificado. Existe também Quando um arquivo é criado (somente propriedades) para bibliotecas de documentos. A diferença entre eles não é detalhe, ela muda o comportamento de tudo o que vem depois.
| Gatilho | Dispara quando | Cuidado principal |
|---|---|---|
| Quando um item é criado | Um item novo entra na lista | Não reage a edições posteriores |
| Quando um item é criado ou modificado | Item novo ou item existente editado | Pode disparar em loop se o próprio fluxo atualizar o item |
| Quando um item é modificado | Um item existente é editado | Também dispara em loop se o fluxo edita o mesmo item |
| Quando um arquivo é criado (somente propriedades) | Chega arquivo novo na biblioteca | Traz metadados, não o conteúdo binário |
O gatilho Quando um item é criado ou modificado é o mais versátil, mas guarda a maior armadilha da plataforma: se o seu fluxo atualiza o mesmo item que o disparou, essa atualização conta como uma modificação e aciona o gatilho de novo, gerando um ciclo. Vou tratar disso em detalhe mais adiante.
Como configurar um gatilho de item criado
- Crie um fluxo do tipo Automatizado no Power Automate.
- Busque o conector SharePoint e selecione Quando um item é criado.
- Informe o Endereço do site (a URL do site do SharePoint) e o Nome da lista nos campos do gatilho.
- Salve e crie um item de teste na lista para confirmar que o fluxo dispara.
A partir daí, todo campo do item fica disponível como conteúdo dinâmico nas ações seguintes: título, autor, data de criação, colunas personalizadas e o ID do item, que você vai usar bastante.
Criar e atualizar itens é o coração da automação
Depois do gatilho, as ações que mais aparecem são Criar item, Atualizar item e Obter item. Com elas você espelha dados entre listas, registra histórico e mantém status em dia sem ninguém digitar nada.
Criar um item em outra lista
Um caso clássico: quando chega uma solicitação numa lista de entrada, você registra uma cópia numa lista de acompanhamento do time responsável.
- Após o gatilho, adicione a ação SharePoint, Criar item.
- Selecione o site e a lista de destino.
- Preencha os campos da nova lista usando o conteúdo dinâmico do item que disparou o fluxo.
- Salve e teste com um item real.
Atualizar um item existente
Para atualizar, você precisa dizer ao Power Automate qual item alterar, e é aí que entra o ID.
- Adicione a ação SharePoint, Atualizar item.
- Informe site e lista.
- No campo Id, use o identificador do item (o conteúdo dinâmico ID do gatilho, quando é o mesmo item, ou o ID retornado por uma ação anterior).
- Preencha só os campos que devem mudar. Os que você deixar em branco podem ser sobrescritos, então preencha com o valor atual quando quiser preservá-lo.
Uma observação que evita dor de cabeça: campos obrigatórios da lista precisam de valor na ação de criar ou atualizar, senão o fluxo falha. Se a coluna é do tipo Pessoa, Pesquisa ou Escolha, o formato do dado importa, então teste com um valor real antes de publicar.
| Ação do conector | Para que serve | Campo que não pode faltar |
|---|---|---|
| Criar item | Inserir um registro novo na lista | Colunas obrigatórias da lista |
| Atualizar item | Alterar um item que já existe | Id do item |
| Obter item | Ler um item específico pelo Id | Id do item |
| Obter itens | Buscar vários itens com filtro | Consulta de filtro (recomendado) |
| Excluir item | Remover um item | Id do item |
A ação Obter itens merece atenção porque traz vários registros e é onde o desempenho pode escorregar. Sempre que possível, use a Consulta de filtro OData para trazer só o que interessa, em vez de puxar a lista inteira e filtrar dentro do fluxo. Buscar 20 itens filtrados no servidor é muito mais rápido e barato do que trazer milhares e descartar quase todos.
Notificar por e-mail e Teams fecha o ciclo de comunicação
Automatizar o dado é metade do trabalho. A outra metade é avisar a pessoa certa na hora certa, e o Power Automate faz isso sem sair da plataforma.
Enviar e-mail quando um item é criado
- Após o gatilho, adicione a ação Enviar um email (V2) do conector Office 365 Outlook.
- No campo Para, use o e-mail do responsável (um valor fixo ou o conteúdo dinâmico de uma coluna Pessoa).
- Escreva o Assunto e o Corpo misturando texto e conteúdo dinâmico do item, por exemplo o título e o link para o item.
- Salve e teste.
Postar mensagem no Microsoft Teams
O conector do Teams permite postar em um canal ou enviar mensagem direta. Para avisar o time num canal:
- Adicione a ação Postar mensagem em um chat ou canal do conector Microsoft Teams.
- Escolha Canal como destino e selecione a equipe e o canal.
- Monte a mensagem com o conteúdo dinâmico do item.
- Salve e valide a postagem.
Um conselho de consultor: não dispare notificação para tudo. Notificação demais vira ruído e as pessoas param de ler. Notifique mudanças de status relevantes, prazos e exceções, não cada campo que muda.
Mover arquivos entre bibliotecas organiza o acervo sozinho
Em bibliotecas de documentos, um padrão comum é mover o arquivo para uma pasta de aprovados assim que a propriedade de status muda. O conector do SharePoint tem a ação Mover arquivo justamente para isso.
- Use o gatilho Quando um arquivo é criado (somente propriedades) ou Quando um arquivo é criado ou modificado (somente propriedades) na biblioteca de origem.
- Se precisar decidir com base em um valor, adicione uma ação Condição avaliando a propriedade, por exemplo Status igual a Aprovado.
- No ramo verdadeiro, adicione SharePoint, Mover arquivo.
- Informe o site e o caminho de origem (o Identificador do arquivo do gatilho) e o site e a pasta de destino.
- Defina o comportamento para quando já existe um arquivo com o mesmo nome, escolhendo substituir ou gerar nome único.
- Salve e teste com um arquivo real.
Os gatilhos de biblioteca que terminam em somente propriedades entregam os metadados do arquivo, não o conteúdo binário. Para a maioria dos fluxos de organização e roteamento isso basta e é mais leve. Se você precisa do conteúdo em si, para enviar como anexo por exemplo, use a ação Obter conteúdo do arquivo.
O looping e os limites são o que separa fluxo amador de fluxo profissional
Aqui está a parte que a maioria dos tutoriais ignora e que mais causa incidente em produção. Preste atenção nestes três pontos.
Loop de gatilho. Como já adiantei, o gatilho Quando um item é criado ou modificado dispara sempre que o item muda, inclusive quando é o próprio fluxo que o altera com a ação Atualizar item. Sem cuidado, o fluxo entra num ciclo: modifica o item, o gatilho detecta a modificação, roda de novo, modifica outra vez, e assim por diante até estourar limite ou consumo. As formas de prevenir são:
- Use uma coluna de controle, por exemplo uma coluna Sim/Não chamada Processado. Logo no início do fluxo, use a Condição de disparo (Trigger Condition) para só executar quando essa coluna ainda estiver como Não, e ao final marque como Sim.
- Prefira o gatilho Quando um item é criado quando você só precisa reagir a itens novos, evitando de vez a reentrada por modificação.
- Estruture o desenho para não editar, no mesmo fluxo, o mesmo item que o disparou, quando isso for evitável.
Limites de execução. O Power Automate tem limites por licença, como número de execuções em um período e teto de itens em ações de loop. Ações como Aplicar a cada têm limite de iterações e há um teto padrão de linhas retornadas em Obter itens que você ajusta na configuração de paginação da ação. Trazer coleções gigantes sem filtro é o caminho mais curto para bater no limite e ver o fluxo lento ou falhando.
Throttling do SharePoint. O SharePoint impõe limitação de requisições quando um fluxo faz chamadas em volume alto e rápido. Fluxos que percorrem centenas de itens fazendo uma chamada por item são os primeiros a sofrer. Reduza chamadas com filtro OData, traga só as colunas necessárias e, quando o volume for realmente grande, questione se a lista é a ferramenta certa ou se o caso pede uma base de dados. Esse é um ponto onde conversamos bastante sobre arquitetura em engenharia de dados.
| Risco | O que acontece | Como prevenir |
|---|---|---|
| Loop de gatilho | Fluxo se aciona em ciclo ao editar o próprio item | Coluna de controle + condição de disparo |
| Limite de execuções | Fluxo falha ou é interrompido no período | Filtrar dados, evitar disparos desnecessários |
| Throttling do SharePoint | Requisições recusadas em alto volume | Filtro OData, menos chamadas por item |
| Campo obrigatório vazio | Ação de criar ou atualizar falha | Preencher todas as colunas obrigatórias |
Adotando esses cuidados desde o primeiro fluxo, você constrói automações que aguentam produção. Se quiser entender como o Power Automate se encaixa no restante da plataforma, vale ler o guia de Power Platform com Power Apps e Automate e conhecer nosso serviço de Power Platform.
Perguntas frequentes
O conector do SharePoint exige licença premium no Power Automate?
Não. O SharePoint é um conector padrão, o que significa que gatilhos e ações como criar, atualizar e obter itens funcionam nos planos incluídos no Microsoft 365, sem custo de conector premium. Cenários com conectores premium, como alguns bancos de dados externos, é que demandam licença adicional.
Como evito que o gatilho Quando um item é modificado entre em loop?
O loop acontece quando o próprio fluxo atualiza o item que o disparou, e essa atualização é vista como nova modificação. Use uma coluna de controle e uma condição de disparo para o fluxo só rodar quando essa coluna indicar que o item ainda não foi processado, marcando-a ao final. Assim a atualização feita pelo fluxo não reinicia o ciclo.
Qual a diferença entre Quando um item é criado e Quando um item é criado ou modificado?
O primeiro dispara apenas quando um item novo entra na lista e ignora edições posteriores. O segundo dispara tanto na criação quanto em qualquer edição de itens existentes, o que é mais abrangente, mas exige cuidado com loop caso o fluxo altere o mesmo item.
Preciso do ID do item para atualizar um registro?
Sim. A ação Atualizar item precisa do campo Id para saber exatamente qual registro alterar. Quando é o mesmo item que disparou o fluxo, use o conteúdo dinâmico ID do gatilho. Quando o item vem de uma busca, use o ID retornado pela ação Obter itens.
Consigo mover um arquivo de uma biblioteca para outra automaticamente?
Sim. Use um gatilho de biblioteca do SharePoint, avalie a propriedade com uma condição se necessário e chame a ação Mover arquivo, informando o arquivo de origem e a pasta de destino. Defina também o que fazer se já existir um arquivo com o mesmo nome no destino.
Por que meu fluxo fica lento ao processar muitos itens?
Normalmente por trazer itens demais e por fazer muitas chamadas ao SharePoint em sequência, o que aciona a limitação de requisições. Filtre com consulta OData na ação Obter itens, traga só as colunas necessárias e reduza chamadas dentro de loops. Em volumes muito altos, avalie se uma lista ainda é a base adequada.
Power Automate com SharePoint pede que você comece pequeno e evolua com segurança
As automações essenciais do Power Automate com SharePoint cabem em poucas ações: um gatilho bem escolhido, criar ou atualizar itens com o ID correto, notificar por e-mail e Teams sem exagero, mover arquivos por propriedade e, acima de tudo, tratar loop e limites desde o começo. Comece por um fluxo simples, teste com dados reais e só então adicione complexidade. É assim que se constrói automação que a equipe confia.
Se você quer acelerar essa jornada com quem já entregou milhares de soluções Microsoft, conheça nossas soluções e fale com a gente.
Quer aplicar isso na sua empresa?
A Fynx implementa BI, Power BI e Power Platform de ponta a ponta. Conte seu cenário e devolvemos um diagnóstico direto ao ponto.
Falar com um especialista