Você criou um fluxo do Power Automate para ser executado quando um arquivo é carregado em uma biblioteca de documentos do SharePoint, mas o fluxo não inicia. A condição de gatilho parece correta e o fluxo aparece habilitado, mas nenhuma ação ocorre após o upload dos arquivos. Esse problema geralmente acontece devido a uma configuração incorreta nas definições do gatilho, nas configurações de versão da biblioteca ou nas permissões do site para a conta de serviço do fluxo. Este artigo explica as causas técnicas exatas para essa falha e fornece aos proprietários do site um conjunto claro de verificações para fazer o fluxo funcionar de forma confiável.
Principais conclusões: corrigir um fluxo do Power Automate no SharePoint que não dispara ao fazer upload de arquivo
- Condição de gatilho ‘Quando um arquivo é criado’ vs ‘Quando um arquivo é criado ou modificado’: Use o gatilho correto para eventos apenas de upload para evitar perder novos arquivos.
- Versão da biblioteca e verificação de versão principal: Os fluxos podem disparar apenas na publicação da versão principal, não em rascunhos secundários, dependendo da configuração do gatilho.
- Permissões da conta de serviço para o proprietário do fluxo: O proprietário do fluxo deve ter pelo menos permissão de Contribuição na biblioteca para que o gatilho seja acionado.
Por que um fluxo do Power Automate no SharePoint não dispara ao fazer upload de arquivo
A causa raiz mais comum é uma incompatibilidade entre o tipo de gatilho e o comportamento real do upload. O gatilho ‘Quando um arquivo é criado’ no Power Automate é acionado apenas quando um novo arquivo aparece na biblioteca. No entanto, se o usuário fizer upload de um arquivo e imediatamente o sobrescrever com o mesmo nome, o gatilho interpreta o evento como uma modificação, não uma criação. O gatilho ‘Quando um arquivo é criado ou modificado’ lida com ambos os casos, mas pode produzir execuções duplicadas.
Outra causa frequente envolve as configurações de versão. Quando uma biblioteca tem controle de versão habilitado e exige aprovação de conteúdo, o upload de um arquivo cria uma versão secundária (rascunho). Muitos gatilhos do Power Automate são configurados para disparar apenas na publicação da versão principal. O fluxo nunca vê o evento de versão secundária e, portanto, não é executado.
Uma terceira causa está relacionada às permissões. O proprietário do fluxo, que é a conta que criou ou editou o fluxo pela última vez, deve ter pelo menos permissão de Contribuição na biblioteca de documentos. Se o proprietário do fluxo perder o acesso ou se as permissões do site forem alteradas, o gatilho para de funcionar silenciosamente. O Power Automate não gera um erro nesses casos; o fluxo simplesmente não inicia.
Etapas para verificar e corrigir a configuração do gatilho
- Verifique o tipo de gatilho no Power Automate
Abra o fluxo no portal do Power Automate. Na etapa do gatilho, verifique se você selecionou ‘Quando um arquivo é criado’ ou ‘Quando um arquivo é criado ou modificado’. Para cenários apenas de upload, use ‘Quando um arquivo é criado’. Se precisar capturar sobrescritas também, use ‘Quando um arquivo é criado ou modificado’ e adicione uma condição posteriormente para filtrar duplicatas. - Verifique as configurações de versão da biblioteca
Vá para a biblioteca de documentos do SharePoint. Selecione Configurações > Configurações da biblioteca > Configurações de versão. Em ‘Exigir aprovação de conteúdo para itens enviados?’, escolha ‘Não’ a menos que a aprovação seja obrigatória. Em ‘Histórico de versões do documento’, defina ‘Criar versões principais’ se quiser que o gatilho dispare em cada upload. Se precisar de versões secundárias, altere o gatilho para incluir ‘criado ou modificado’ e teste com um upload de versão secundária. - Confirme se o proprietário do fluxo tem permissões na biblioteca
No SharePoint, vá para a biblioteca de documentos. Selecione Configurações > Permissões da biblioteca. Verifique se a conta do proprietário do fluxo aparece na lista com pelo menos permissão de Contribuição. Se o proprietário não estiver listado, adicione-o. Se o proprietário for uma conta de serviço ou um grupo do Microsoft 365, garanta que essa conta tenha acesso direto à biblioteca. - Teste o gatilho com um upload simples
Faça upload de um novo arquivo com um nome único para a biblioteca. Aguarde 60 segundos e verifique o histórico de execução do fluxo no Power Automate. Vá para a página de detalhes do fluxo e selecione ‘Histórico de execuções’. Se nenhuma execução aparecer, o gatilho não foi acionado. Se uma execução aparecer, mas falhar, examine a mensagem de erro nos detalhes da execução. - Revise os filtros da condição do gatilho
Na etapa do gatilho, expanda ‘Mostrar opções avançadas’. Procure por ‘Condições do gatilho’. Se alguma condição estiver definida, remova-a temporariamente e teste novamente. Filtros comuns como ‘Pasta’ ou ‘Extensão do arquivo’ podem bloquear o gatilho se não corresponderem ao arquivo carregado. - Verifique conflitos de receptores de eventos na biblioteca
Se a biblioteca tiver receptores de eventos personalizados ou outros complementos de terceiros, eles podem interferir no gatilho. Remova ou desabilite temporariamente quaisquer receptores de eventos personalizados e teste o fluxo novamente. Você pode verificar receptores de eventos usando o SharePoint Designer ou PowerShell.
Se o fluxo ainda não disparar após as verificações de configuração
O histórico de execução do fluxo mostra status ‘Ignorado’
Um status ‘Ignorado’ significa que o gatilho foi acionado, mas a condição foi avaliada como falsa. Revise as configurações da condição do gatilho novamente. Remova todas as condições e teste. Se a execução agora for bem-sucedida, adicione as condições de volta uma de cada vez para encontrar o filtro bloqueador. Verifique também se o arquivo atende aos critérios da condição, como estar em uma pasta específica ou ter uma determinada extensão de arquivo.
O histórico de execução do fluxo mostra status ‘Falhou’ com erro ‘403 Proibido’
Um erro 403 indica um problema de permissão. A conta do proprietário do fluxo não tem acesso ao site ou à biblioteca do SharePoint. Vá para as permissões do site do SharePoint e garanta que o proprietário do fluxo tenha pelo menos permissão de Contribuição. Se o fluxo usar uma conexão que referencia uma conta diferente, atualize a conexão para usar a conta correta.
O fluxo não dispara ao fazer upload pelo Microsoft Teams ou aplicativo móvel
Os uploads do Teams ou do aplicativo móvel do SharePoint passam pelo mesmo gatilho que os uploads da web. No entanto, esses uploads podem usar um caminho de pasta diferente ou criar o arquivo em um local temporário antes de movê-lo. Verifique se a condição do gatilho inclui o caminho da pasta correto. Se a condição for muito restritiva, o fluxo ignora o upload. Remova os filtros de pasta e teste novamente.
O fluxo dispara apenas para alguns usuários, mas não para outros
Esse sintoma geralmente aponta para uma diferença de permissão. Os usuários cujos uploads não disparam o fluxo podem ter apenas permissão de Leitura na biblioteca. Os gatilhos do Power Automate exigem pelo menos permissão de Contribuição para o usuário que faz o upload se o fluxo usar ‘Quando um arquivo é criado’ com o conector ‘SharePoint’. Verifique os níveis de permissão para todos os usuários que precisam acionar o fluxo.
Tipos de gatilho do Power Automate para upload de arquivo no SharePoint: comparação
| Item | Quando um arquivo é criado | Quando um arquivo é criado ou modificado |
|---|---|---|
| Evento de gatilho | Novo arquivo adicionado à biblioteca | Novo arquivo ou modificação de arquivo existente |
| Lida com upload de sobrescrita | Não | Sim |
| Lida com versão secundária (rascunho) | Apenas se a configuração do gatilho incluir secundária | Apenas se a configuração do gatilho incluir secundária |
| Risco de execuções duplicadas | Baixo | Possível se o arquivo for criado e imediatamente modificado |
| Caso de uso recomendado | Fluxos de trabalho apenas de upload com nomes de arquivo únicos | Fluxos de trabalho que precisam capturar sobrescritas ou edições |
Agora você pode verificar sistematicamente o tipo de gatilho, as configurações de versão e as permissões para restaurar seu fluxo do Power Automate. Comece testando com um upload simples de um nome de arquivo único após remover todas as condições do gatilho. Se o fluxo for executado, adicione as condições gradualmente. Como dica avançada, use o gatilho ‘Quando um arquivo é criado ou modificado’ e adicione uma condição que verifica se o carimbo de data/hora ‘Criado’ do arquivo é igual ao carimbo ‘Modificado’ para filtrar modificações que não são novos uploads.