Funções do Power Automate: guia de referência completo

Todo fluxo de Power Automate que cresce sem controle tem o mesmo sintoma: uma sequência de ações de “Inicializar variável”, “Definir variável” e “Condição” que poderia ter sido resolvida em uma única expressão. O motivo quase sempre é o mesmo: quem monta o fluxo não sabe que a função existe, ou não lembra da sintaxe exata na hora de escrever.

O Power Automate usa a Workflow Definition Language, a mesma linguagem de expressões dos Azure Logic Apps, para tudo que não é uma ação de conector. Ela tem mais de 140 funções distribuídas em nove categorias, todas documentadas pela Microsoft, mas espalhadas em uma única página longa, sem categorização fácil de escanear. Este guia organiza essas funções por finalidade, com sintaxe e link direto para a referência oficial, para consulta rápida enquanto você edita uma expressão no fluxo.

Por que escrever expressões em vez de empilhar ações

Cada ação adicionada a um fluxo tem custo. Custo de execução (mais chamadas, mais tempo, mais chance de throttling em conectores premium), custo de manutenção (mais passos para outra pessoa entender) e custo de licenciamento em cenários onde a ação dispara uma chamada a um conector premium desnecessário. Uma expressão bem escrita substitui, com frequência, três ou quatro ações por uma única linha dentro de um campo já existente.

Um exemplo comum: extrair o domínio de um e-mail. A abordagem por ações usa split em uma ação de composição, depois um índice, depois outra composição para montar o resultado. A abordagem por expressão resolve em uma linha:

split(triggerBody()?['Email'], '@')[1]

Isso não significa que expressão é sempre superior a ação. Fluxos muito densos em expressões aninhadas ficam ilegíveis para quem não domina a sintaxe, e depurar uma expressão longa dentro do editor do Power Automate é mais difícil do que inspecionar a saída de várias ações pequenas no histórico de execução. A recomendação prática é usar expressão para transformações pontuais de dado (formatar, extrair, comparar, converter) e manter ações separadas para passos que representam uma decisão de negócio relevante, algo que alguém vai querer localizar rápido ao revisar o fluxo.

Onde escrever a expressão

O editor de expressões fica disponível em qualquer campo dinâmico do fluxo, acessível pelo ícone de raio ou digitando diretamente entre chaves. No modo texto do fluxo (Editar em modo avançado, disponível ao exportar o fluxo como código ou usar o editor do Power Automate for desktop e do Copilot Studio), a sintaxe segue o padrão @{funcao(parametros)}. Dentro do editor visual padrão, basta digitar o nome da função e o Intellisense sugere os parâmetros esperados.

A documentação oficial completa da Workflow Definition Language, com todas as funções, parâmetros e exemplos atualizados pela Microsoft, está na referência de funções para expressões no Azure Logic Apps e Power Automate. As tabelas abaixo linkam direto para a seção correspondente dessa página.

Funções de texto

Manipulam strings: recorte, concatenação, busca de substring, mudança de caixa. São as mais usadas em fluxos que tratam entrada de formulário, e-mail ou arquivo, onde o dado raramente chega já formatado do jeito que o próximo passo espera.

Uma pegadinha frequente com substring e slice: os índices são baseados em zero e um valor de início maior que o comprimento da string gera erro em tempo de execução, não retorna vazio. Se o dado de origem pode variar de tamanho (nome de arquivo, e-mail sem domínio), combine com length dentro de uma verificação antes de fatiar, ou use if para tratar o caso em que a string é mais curta que o esperado.

Funções de coleção

Atuam sobre arrays: filtrar, ordenar, combinar, dividir. Ganham relevância em fluxos que processam listas do SharePoint, resultados de uma consulta ao Dataverse ou arrays retornados por uma chamada HTTP a uma API externa.

Uma decisão de arquitetura relevante aqui: filter como ação nativa do Power Automate já resolve boa parte do que se tentaria fazer combinando contains e intersection em expressão. Quando o filtro depende de uma condição simples sobre um array vindo de uma ação anterior, use a ação Filtrar array, que gera um log de execução legível. Reserve as funções de coleção em expressão para transformações que a ação nativa não cobre, como cruzar dois arrays de origens diferentes.

Funções de comparação lógica

Constroem a lógica condicional que, de outra forma, exigiria várias ações de Condição aninhadas. São a base de qualquer expressão dentro de um campo de “Condição” configurado em modo avançado.

if aninhado substitui bem uma cadeia de Condições quando o resultado é um valor simples (texto, número, booleano) a ser usado em outro campo. Quando o resultado de cada ramificação é uma sequência de ações diferentes, mantenha a ação Condição nativa: aninhar mais de dois ou três níveis de if numa única expressão produz uma string difícil de revisar e praticamente impossível de depurar a olho nu.

Funções de conversão

Convertem entre tipos e formatos: texto, número, binário, base64, URI, JSON, XML. Essenciais em qualquer fluxo que troca dado com uma API REST, processa anexos ou lê arquivo.

A função json merece atenção especial: é o caminho mais direto para parsear a resposta de uma chamada HTTP sem precisar de uma ação separada de Analisar JSON. A troca é que, sem o schema declarado que a ação Analisar JSON exige, o Intellisense não sugere as propriedades internas, e você precisa conhecer a estrutura do payload de antemão ou consultar a documentação da API de origem.

Funções matemáticas

Operações aritméticas básicas e geração de intervalos numéricos. Curtas, mas frequentes em cálculo de paginação, distribuição de carga entre lotes e geração de índices para loops.

Funções de data e hora

São, na prática, a categoria com mais chance de erro silencioso em produção, porque o Power Automate trabalha internamente em UTC. Um fluxo que soma dias ou horas sem converter para o fuso do usuário final envia notificação no horário errado, e o erro só aparece quando alguém reclama, não durante o teste no editor.

A dupla convertFromUtc e convertTimeZone resolve o problema de fuso, mas exige o nome exato do fuso horário no formato aceito pelo Windows (por exemplo, E. South America Standard Time para o horário de Brasília), não o nome IANA usado em outras plataformas. Errar essa string não gera erro de sintaxe, gera conversão silenciosamente incorreta, porque a função ignora fuso não reconhecido e mantém UTC.

Funções de workflow

Acessam o contexto de execução do próprio fluxo: saída de uma ação anterior, corpo do gatilho, valor de uma variável, índice de iteração dentro de um loop. São a categoria mais usada, ainda que de forma invisível, porque o editor do Power Automate gera boa parte dessas expressões automaticamente quando você seleciona um conteúdo dinâmico na interface.

A diferença entre body('actionName') e outputs('actionName') confunde bastante gente: body retorna só a propriedade body da saída da ação, outputs retorna a saída inteira, incluindo cabeçalhos e status code de uma chamada HTTP, por exemplo. Se você precisa validar o status de uma resposta HTTP antes de seguir, é outputs, não body, que traz essa informação.

Funções de parsing de URI

Quebram uma URI em seus componentes. Usadas com frequência em fluxos que recebem um link (de um item do SharePoint, de um e-mail, de um webhook) e precisam extrair só uma parte dele, como o host para validação de domínio ou a query string para ler parâmetros.

Funções de manipulação de JSON e XML

Editam objetos JSON e navegam em XML sem precisar reconstruir o objeto inteiro em uma ação separada. Particularmente úteis quando o fluxo precisa enriquecer um payload antes de enviá-lo a uma API, adicionando ou removendo uma propriedade pontual.

coalesce resolve um padrão que, sem ela, vira uma torre de if aninhado: pegar o primeiro valor preenchido entre vários campos opcionais de um formulário. Em vez de if(empty(campoA), if(empty(campoB), campoC, campoB), campoA), a expressão fica coalesce(campoA, campoB, campoC), mais curta e muito mais fácil de auditar depois.

Como usar esta referência no dia a dia

Nenhuma equipe de automação memoriza 140 funções. O ganho real de ter essa lista organizada por categoria é outro: quando você sente que uma transformação está exigindo ações demais, a primeira pergunta vira “existe uma função para isso” em vez de “que ação eu adiciono agora”. Isso muda o hábito de construção do fluxo, e fluxos construídos com esse hábito tendem a ter menos ações, menos pontos de falha e menos consumo desnecessário de conectores premium.

Vale também documentar, dentro do próprio fluxo, expressões que combinam três ou mais funções aninhadas. Um comentário na ação, ou um nome descritivo na variável que recebe o resultado, economiza tempo de quem vai dar manutenção seis meses depois e não tem a lógica da expressão fresca na cabeça.

Se o seu fluxo já cresceu a ponto de virar um emaranhado de condições e variáveis, ou se a dúvida é sobre onde a lógica de negócio deveria morar (no fluxo, num conector customizado, num Power Automate Desktop, numa Function do Azure), essa é uma conversa de arquitetura que vale a pena ter antes de continuar empilhando ações.