Corrigir falhas de ligação em fluxos na nuvem

O teu fluxo estava a correr bem, e agora já não está. Este guia guia-o pelas causas mais comuns por ordem de probabilidade, para que possa encontrar o problema rapidamente.

Passo 1: O seu fluxo está ativado?

Abra a página de detalhes do fluxo. Verifique o estado no canto superior direito.

  • Ligado: O fluxo está ativo. Avançar para o Passo 2.
  • Desligado: Alguém desligou manualmente. Ligue-o novamente. Se desligar novamente imediatamente, verifique se há violações da política DLP (Passo 3b mais adiante neste artigo).
  • Suspenso: Power Automate suspendia automaticamente o fluxo devido a falhas repetidas. Abra o histórico de execução para encontrar a ação falhada, corrija a causa raiz e depois volte a ligar o fluxo.

Tip

Se o fluxo estiver completamente ausente, verifica se estás no ambiente correto. Use o seletor de ambientes no canto superior direito do portal Power Automate.

Passo 2: O gatilho foi acionado?

Abra o histórico de execuções do fluxo. Vê a lista de corridas.

Se não houver corridas recentes

  • Acionador agendado: Verifique as definições de recorrência. Verifica o fuso horário. Um fluxo definido para "9:00 AM" usa o fuso horário configurado no trigger, que pode diferir da sua hora local.
  • Disparador automático (quando um item é criado, quando chega um email, e semelhantes): Confirme que o evento desencadeador ocorreu realmente. Crie um item de teste ou envie um email de teste e espere entre 5 a 10 minutos.
  • Condição de gatilho: Se o seu gatilho tiver uma expressão de condição, verifique se esta é avaliada como true para o seu evento de teste. Um erro comum é uma condição que filtra todos os eventos.
  • Disparador instantâneo (manual): Estes só funcionam quando você ou outro utilizador inicia explicitamente o fluxo. Verifica se o botão ou a aplicação que o ativa ainda está configurado.

Se aparecerem corridas, mas todas estão marcadas como "Canceladas"

O gatilho disparou, mas a corrida foi cancelada antes da execução das ações. Isto normalmente significa que uma configuração de concorrência está a rejeitar novas execuções enquanto outra está ativa. Verifique as definições de controlo de concorrência do gatilho.

Passo 3: Alguma ação específica falhou?

Abre uma execução falhada. Percorre as ações até encontrares a que está destacada a vermelho. Expande-o para ver o erro.

Passo 3a: Leia o código de erro

Código de erro Significado A solução mais provável
401 Não autorizado O seu token de ligação expirou, ou a sua palavra-passe foi alterada. Vai à página de Ligações, encontra a ligação e volta a autenticar. Veja o Passo 4: Verificações de saúde da ligação.
403 Proibido Não tens permissão para aceder ao recurso, ou uma política DLP está a bloquear o conector. Verifique as suas permissões no recurso alvo (site SharePoint, caixa de correio, base de dados). Se as permissões estiverem corretas, pergunte ao seu administrador se alguma política DLP foi alterada recentemente.
404 Não encontrado O recurso foi apagado, renomeado ou movido. Uma lista do SharePoint list foi renomeada, um ficheiro foi movido, uma caixa de correio foi desprovisionada ou um canal do Teams foi eliminado. Atualize a ação para apontar para a nova localização.
429 Pedidos a Mais Atingiste o limite de taxa de API para este conector. Adicione uma ação de atraso antes da ação que falha, ou ative a política de retentativa com recuo exponencial nas definições da ação. Para fluxos que processam muitos itens, adicione um atraso dentro de Aplicar a cada um.
500 Erro interno do servidor O serviço alvo está a ter problemas. Espera 15-30 minutos e tenta novamente. Se persistir, verifique o painel de Saúde do Serviço Microsoft 365 ou a página de estado do serviço não Microsoft.
502 Bad Gateway A ligação entre o Power Automate e o serviço alvo falhou. Normalmente são transitórios. Ativar nova tentativa na ação. Se acontecer de forma consistente, verifica as definições de rede/firewall (especialmente para gateways locais).

Passo 3b: Violações da política DLP

Se o seu fluxo foi recentemente bloqueado ou suspenso e não alterou nada:

  1. O seu administrador pode ter atualizado uma política de Prevenção de Perda de Dados (DLP).
  2. Vá a detalhes do fluxo>Propriedades. Se visualizar uma mensagem de violação de DLP, o fluxo utiliza conectores que agora se encontram em diferentes grupos de políticas.
  3. Contacta o administrador da tua Power Platform. Eles podem dizer-lhe que apólices mudaram e quais os conectores afetados.

Important

As alterações às políticas DLP entram em vigor imediatamente e podem bloquear fluxos sem aviso prévio. Se vários fluxos se quebraram ao mesmo tempo, uma alteração do DLP é a causa mais provável.

Passo 4: Verificações de saúde da ligação

As ligações são a razão mais comum pela qual um fluxo que já funcionava se quebra.

Verificar o estado da ligação

  1. Abra o seu fluxo em modo de edição.
  2. Olha para o painel de ligações (ou verifica a referência de ligação de cada ação).
  3. Cada ligação deve mostrar um visto verde ou o estado "Conectado".
  4. Se alguma ligação mostrar um aviso ou ícone de erro, selecione-o e selecione Corrigir ligação ou Re-autenticar.

Porque é que as ligações se rompem

  • Mudança de palavra-passe: Mudou a sua palavra-passe, ou a sua organização impõe rotação periódica de palavra-passe. O token OAuth armazenado está agora inválido.
  • Alteração da política de MFA: O seu administrador ativou ou alterou os requisitos de Autenticação Multifator. O token existente já não satisfaz a nova política.
  • Consentimento do administrador revogado: Um administrador revogou o consentimento da aplicação que Power Automate usa para aceder a um serviço em seu nome.
  • Expiração do token: Os tokens de atualização do OAuth expiram após aproximadamente 90 dias de inatividade. Se um fluxo não for executado há 90 dias, a ligação pode precisar de nova autenticação.
  • Expiração do segredo do principal de serviço: Se a ligação usar um principal de serviço, o segredo de cliente pode ter expirado. Gera um novo segredo no Microsoft Entra ID e atualize a ligação.

Re-autenticar uma ligação

  1. Vai a Power Automate>Connections (navegação à esquerda).
  2. Encontre a ligação com o erro.
  3. Selecione os três pontos (...) >Corrigir a ligação ou editar.
  4. Inicia sessão novamente com as tuas credenciais.
  5. Retorne ao seu fluxo e verifique se a ação agora mostra uma marca de verificação verde.

Observação

Se o fluxo usar uma ligação partilhada (pertencente a outra pessoa), precisas que essa pessoa se volte a autenticar, ou podes criar a tua própria ligação e atualizar o fluxo para a usar.

Passo 5: Prevenir falhas silenciosas

Os fluxos podem falhar sem que ninguém repare. Estabeleça estas salvaguardas para qualquer fluxo que importe.

Adicionar uma notificação de falha

  1. No designer, adiciona um ramo paralelo após a ação que é mais provável que falhe.
  2. Selecione os três pontos na primeira ação do novo ramo, >Configurar execução após> apenas se falhou.
  3. Adicione uma ação Enviar um email (ou publicar no Teams) com o assunto "Fluxo falhado: [nome do fluxo]" e inclua os detalhes do erro da ação falhada usando conteúdo dinâmico.

Tip

Isto garante que recebe um alerta minutos após uma falha, e não dias. Para fluxos críticos de produção, envie notificações de falha para uma caixa de correio partilhada ou canal do Teams para que o alerta não seja ignorado.

Verificação semanal do histórico de corridas

Para fluxos de produção, consulte a página do histórico de execuções uma vez por semana. Procure:

  • Execuções com o estado Falhado que a sua notificação de falha pode ter falhado em captar.
  • Executa com o estado Cancelado , que pode indicar concorrência ou desencadear problemas.
  • Uma queda súbita no número de corridas, o que pode significar que o gatilho parou de disparar.

Utilizar ligações do principal de serviço

As ligações principais do serviço não dependem do token OAuth do utilizador. Não expiram quando alguém altera a palavra-passe ou sai da organização. Para fluxos de produção, pergunte ao seu administrador sobre a configuração de ligações de principal de serviço para os seus conectores de chave.

Principais cinco (5) problemas de ligação por conector

SharePoint

Emissão Sintoma Correção
Consentimento do administrador necessário 403 no primeiro uso ou após alteração da apólice O administrador deve conceder consentimento em Microsoft Entra ID > Aplicações Empresariais > Power Automate
Permissões do site alteradas 403 sobre ações direcionadas a um local específico Verifique se a sua conta tem pelo menos acesso de Contribuidor ao site
Limiar de vista de lista A tentativa de operação é proibida porque ultrapassa o limite de visualização de lista Adicione uma consulta de filtro ou um filtro OData à ação Obter Itens para devolver menos de 5.000 itens. Use $top e filtros de coluna indexados.
Lista ou biblioteca renomeada 404 em todas as ações que visam essa lista Atualize a ação para referenciar o novo nome ou ID da lista
Incompatibilidade dos nomes das colunas As ações têm sucesso mas devolvem dados vazios ou errados Os nomes internos do SharePoint diferem dos nomes de visualização. Use o nome interno (visível na URL quando ordenar por essa coluna).

Outlook/Office 365

Emissão Sintoma Correção
Permissões de caixa de correio partilhada 403 ao enviar ou ler uma caixa de correio partilhada O proprietário da ligação precisa de permissão de Enviar As ou Acesso Total na caixa de correio partilhada no Centro de Administração do Exchange
Acesso de delegados removido 401 sobre ações envolvendo a caixa de correio de outro utilizador Reconceda permissões de delegação ou mude para uma caixa de correio partilhada
Aplicação da MFA 401 após o administrador ativar o MFA Re-autentica a ligação. O novo token inclui a reivindicação MFA.
Limite de tamanho do anexo 413 ou falha de ação em acessórios grandes O conector do Outlook tem um limite de anexos de 25 MB. Para ficheiros maiores, faça upload para SharePoint/OneDrive e partilhe um link.

SQL Server

Emissão Sintoma Correção
Gateway em local offline Tempo limite de ligação ou "gateway inacessível" Verificar a máquina de gateway. Reinicie o serviço On-premises Data Gateway. Verifica se a máquina tem acesso à internet.
Regras de firewall Tempo de espera da conexão para o SQL do Azure Adicione intervalos de IP do Power Automate às suas regras de firewall SQL do Azure, ou ative "Permitir serviços Azure" nas definições de rede do servidor SQL.
Cadeia de ligação alterada 404 ou falha de ligação Servidor renomeado, base de dados movida ou porta alterada. Atualize a ligação com os novos detalhes do servidor/base de dados.
Login SQL desativado 401 em todas as consultas O login SQL pode estar desativado ou a palavra-passe expirar. Reativar no SQL Server Management Studio.

Dataverse

Emissão Sintoma Correção
Permissões do ambiente 403 nas operações do Dataverse O seu utilizador precisa de um papel de segurança no ambiente Dataverse alvo. Pede ao teu administrador para atribuir uma (por exemplo, permissões de Utilizador Básico + tabelas personalizadas).
Função de segurança sem acesso a tabela 403 em tabelas específicas O seu papel de segurança não inclui acesso de leitura/escrita à tabela. O administrador deve atualizar a função de segurança.
Ambiente trocado As ações referem-se ao ambiente errado Se o fluxo foi importado ou o ambiente alterado, atualize a ligação Dataverse para apontar para o ambiente correto.

Conectores HTTP/personalizados

Emissão Sintoma Correção
Chave API alternada 401 em todos os pedidos HTTP Atualize a chave API nos cabeçalhos de ligação ou ação.
Certificado expirado Erro SSL/TLS O certificado SSL do servidor alvo expirou. Contacte o fornecedor da API ou atualize o certificado.
URL alterada 404 em todas as requisições O URL do endpoint da API foi atualizado. Consulte a documentação do fornecedor da API para a nova URL.
Lista de autorização de propriedade intelectual 403 ou tempo limite de conexão A API de destino só permite endereços IP específicos. Adicione os intervalos de IP do Power Automate para a sua região. Para mais informações, consulte configuração de endereços IP.

Nota: O autor criou este artigo com a ajuda da IA. Mais informações

  • Last updated on