Fluxo do Power Automate Não Dispara no Upload de Arquivo: Causa e Solução
🔍 WiseChecker

Fluxo do Power Automate Não Dispara no Upload de Arquivo: Causa e Solução

Você criou um fluxo do Power Automate que deveria iniciar automaticamente quando um arquivo é enviado para uma biblioteca de documentos do SharePoint. Mas o fluxo não é executado após você adicionar um arquivo. Esse problema interrompe fluxos de processamento de documentos, cadeias de aprovação e sistemas de notificação. A causa raiz geralmente é uma incompatibilidade entre a configuração do gatilho e o evento real que o SharePoint envia. Este artigo explica por que o gatilho falha e fornece correções passo a passo para fazer seu fluxo funcionar novamente.

Principais Conclusões: Corrigir um Fluxo do Power Automate Que Ignora Uploads de Arquivos

  • Condição do gatilho “Quando um arquivo é criado ou modificado (somente propriedades)”: Esse gatilho pode não disparar se os metadados do arquivo não forem alterados após o upload.
  • Condição do gatilho “Quando um arquivo é criado (somente propriedades)”: Use este gatilho apenas para arquivos novos; ele dispara uma vez por upload.
  • Configurações de versões da lista ou biblioteca do SharePoint: Se o controle de versão estiver desativado, o gatilho pode ignorar eventos para alguns tipos de arquivo.

ADVERTISEMENT

Por que o Gatilho do Power Automate Não Dispara no Upload de Arquivo

O Power Automate usa webhooks do SharePoint para detectar alterações em arquivos. Quando você faz upload de um arquivo, o SharePoint envia um evento para o webhook. Mas o gatilho do fluxo só responde a tipos específicos de evento. O gatilho mais comum é “Quando um arquivo é criado ou modificado (somente propriedades)”. Esse gatilho é acionado quando o SharePoint detecta uma alteração nos metadados do arquivo — não no conteúdo do arquivo em si. Se os metadados não forem alterados, o gatilho pode não disparar.

Outra causa comum é a configuração da condição do gatilho. O gatilho “Quando um arquivo é criado ou modificado (somente propriedades)” inclui eventos de criação e modificação. Mas se você usar o gatilho “Quando um arquivo é criado (somente propriedades)”, ele só dispara para arquivos novos. Misturar esses gatilhos pode causar confusão. Além disso, o fluxo deve estar salvo e ativado. Um fluxo desabilitado não pode disparar.

As configurações da biblioteca do SharePoint também afetam o disparo. Se a biblioteca tiver o controle de versão desativado, alguns tipos de arquivo — como imagens ou PDFs — podem não gerar o evento esperado. O webhook pode até disparar, mas o Power Automate pode ignorar o evento se ele não corresponder ao esquema do gatilho. Por fim, o fluxo pode estar em estado “suspenso” ou “com falha” devido a um erro anterior. Você deve verificar o histórico de execução do fluxo para ver se o gatilho disparou, mas a ação falhou.

Passos para Diagnosticar e Corrigir o Problema do Gatilho

  1. Verifique o status do fluxo no Power Automate
    Abra o Power Automate em make.powerautomate.com. Vá para Meus fluxos. Encontre seu fluxo. Observe o selo de status. Se estiver “Desligado” ou “Suspenso”, ative-o selecionando o fluxo e clicando em Ativar. Se o fluxo estiver “Com falha”, revise a mensagem de erro e corrija a ação que causou a falha.
  2. Revise o tipo de gatilho
    Abra seu fluxo no modo de edição. Clique no cartão do gatilho. Observe o nome do gatilho na parte superior do cartão. Se disser “Quando um arquivo é criado ou modificado (somente propriedades)”, ele será acionado para arquivos novos e alterados. Se disser “Quando um arquivo é criado (somente propriedades)”, ele será acionado apenas para arquivos novos. Se você quiser que o fluxo seja executado em cada upload (incluindo substituições de arquivos existentes), use o primeiro gatilho. Para alterá-lo, exclua o gatilho e adicione o correto.
  3. Verifique a condição do gatilho
    No cartão do gatilho, clique nos três pontos (…) e selecione Configurações. Procure pela seção Condições do gatilho. Se houver uma condição, ela deve ser avaliada como verdadeira para o fluxo ser executado. Por exemplo, uma condição como “@equals(triggerBody()?[‘{Identifier}’],’SpecificValue’)” pode bloquear o gatilho. Remova ou edite qualquer condição que não corresponda ao seu cenário de upload.
  4. Teste com um upload de arquivo simples
    Faça upload de um novo arquivo de texto (.txt) para a biblioteca de documentos. Aguarde 30 segundos. Vá para o histórico de execução do fluxo (clique no nome do fluxo e depois na guia Histórico de execução). Se você vir uma execução, o gatilho funcionou. Se não vir nenhuma execução, o gatilho não disparou. Se vir uma execução que falhou, o gatilho disparou, mas as ações falharam. Corrija as ações.
  5. Verifique as configurações de versão da biblioteca do SharePoint
    Vá para a biblioteca de documentos do SharePoint. Clique em Configurações (ícone de engrenagem) > Configurações da biblioteca. Em Configurações gerais, clique em Configurações de versão. Certifique-se de que “Criar versões principais” ou “Criar versões principais e secundárias” esteja selecionado. Se o controle de versão estiver desativado, ative-o. Isso garante que o SharePoint envie eventos adequados para todos os tipos de arquivo.
  6. Recrie a conexão do gatilho
    No cartão do gatilho, clique nos três pontos (…) e selecione Configurações. Em Conexão, clique no nome da conexão. Clique em Remover. Em seguida, adicione uma nova conexão ao mesmo site do SharePoint. Salve o fluxo. Teste novamente.
  7. Redefina o webhook
    Em alguns casos, o webhook entre o Power Automate e o SharePoint fica travado. Para redefini-lo, desligue o fluxo, aguarde 10 segundos e ligue-o novamente. Isso força o Power Automate a registrar novamente o webhook no SharePoint.

ADVERTISEMENT

Se o Fluxo Ainda Não Disparar Após a Correção Principal

Fluxo do Power Automate Mostra “Ignorado” no Histórico de Execução

Se o histórico de execução mostrar um status “Ignorado”, o gatilho disparou, mas a condição do gatilho foi avaliada como falsa. Volte ao passo 3 e remova ou ajuste a condição. Verifique também se o gatilho usa uma consulta de filtro. No cartão do gatilho, expanda “Mostrar opções avançadas”. Procure por “Consulta de filtro”. Se contiver uma condição como “Title eq ‘Test’”, remova-a ou altere-a para corresponder aos seus arquivos.

Fluxo do Power Automate Não Dispara para Certos Tipos de Arquivo

Alguns tipos de arquivo, como .tmp ou .lnk, não disparam eventos do SharePoint. Além disso, arquivos enviados via sincronização (cliente de sincronização do OneDrive) podem não disparar o evento se o cliente de sincronização usar uma API diferente. Para corrigir isso, use o gatilho “Quando um arquivo é criado ou modificado (somente propriedades)” e certifique-se de que o controle de versão esteja ativado. Se o arquivo for enviado via sincronização, peça aos usuários que façam upload diretamente pela interface do navegador do SharePoint.

Fluxo do Power Automate Dispara, mas é Executado no Arquivo Errado

O gatilho pode disparar em um arquivo que foi modificado, não criado. Se você quiser apenas arquivos novos, use o gatilho “Quando um arquivo é criado (somente propriedades)”. Se ainda vir execuções em arquivos modificados, verifique a condição do gatilho para filtrar por “@equals(triggerBody()?[‘{IsFolder}’],false)” e “@equals(triggerBody()?[‘{IsCheckedOut}’],false)”. Isso garante que o fluxo seja executado apenas em arquivos, não em pastas ou itens com check-out.

Tipos de Gatilho do Power Automate para Upload de Arquivo no SharePoint

Item Quando um arquivo é criado (somente propriedades) Quando um arquivo é criado ou modificado (somente propriedades)
Dispara no upload de novo arquivo Sim Sim
Dispara na modificação do arquivo (alteração de metadados) Não Sim
Dispara apenas na alteração de conteúdo do arquivo Não Não
Melhor caso de uso Processamento único para novos arquivos Processamento contínuo que inclui atualizações
Suporte a condição do gatilho Sim Sim

Use o gatilho “Quando um arquivo é criado (somente propriedades)” se você precisar que o fluxo seja executado exatamente uma vez por upload de arquivo. Use o gatilho “Quando um arquivo é criado ou modificado (somente propriedades)” se você precisar que o fluxo seja executado toda vez que os metadados do arquivo forem alterados — por exemplo, quando um usuário atualizar o título ou a descrição do arquivo após o upload.

Agora você pode diagnosticar por que seu fluxo do Power Automate não dispara no upload de arquivo. Comece verificando o status do fluxo e o tipo de gatilho. Em seguida, verifique a condição do gatilho e as configurações da biblioteca do SharePoint. Se o problema persistir, redefina o webhook ou recrie a conexão. Para controle avançado, use condições do gatilho para filtrar eventos indesejados. Isso garante que seu fluxo seja executado de forma confiável para cada upload de arquivo.

ADVERTISEMENT