Cartões de início rápido no Power Automate: tutorial

Cartões de início rápido no Power Automate: o que muda na prática

A página inicial do Power Automate ganhou uma seção nova de cartões de início rápido, e o efeito prático é direto: quem precisa criar um fluxo de aprovação ou de notificação sai da tela inicial com o gatilho e a ação já conectados, sem passar pela galeria de templates. Este tutorial mostra o caminho exato para montar, a partir de um desses cartões, um fluxo de aprovação de compra de insumos agrícolas, com aprovador definido, atualização de status e notificação de retorno. No final, você também vê como a busca server side em My Flows, lançada na mesma atualização, resolve o problema de encontrar um fluxo específico quando a fazenda ou a cooperativa já acumulou dezenas deles.

O recurso é disponibilidade geral (GA). Não existe etapa de ativação de preview, não existe toggle de tenant para ligar. Se seu ambiente já está no ramo de lançamento padrão do Power Automate, os cartões aparecem sozinhos na próxima vez que você abrir a página Início.

Pré-requisitos

• Licença: qualquer licença que já dê acesso a criar fluxos na cloud (Power Automate incluído no Microsoft 365, licença por usuário do Power Automate, ou plano de desenvolvedor). Os cartões usam os mesmos conectores padrão de sempre, sem exigir plano específico para aparecerem.
• Permissão no tenant: papel de Environment Maker no ambiente onde o fluxo será criado (ou um papel superior, como Environment Admin). Sem esse papel, o botão de criar fluxo a partir do cartão fica desabilitado.
• Ambiente: um ambiente do Power Platform com uma lista do SharePoint acessível (no exemplo deste tutorial, a lista fica num site de suprimentos da fazenda ou da cooperativa). Não é necessário Dataverse para este cenário específico.
• Conector: acesso ao conector padrão do SharePoint e ao conector de Aprovações do Power Automate, ambos incluídos em qualquer plano que já permita criar fluxos.
• Papel de negócio: alguém que conheça a alçada de aprovação real do processo de compra, porque o cartão entrega a estrutura do fluxo, não a regra de negócio.

Passo a passo: aprovação de compra de insumos a partir de um cartão

O cenário usado aqui é comum em operações agrícolas com múltiplas fazendas ou filiais regionais: um solicitante registra um pedido de compra de defensivo, fertilizante ou semente numa lista do SharePoint, e esse pedido precisa da aprovação do gerente da fazenda ou do comprador regional antes de seguir para o fornecedor.

O cartão já entrega gatilho e ação conectados; o clique que sobra é configurar a conexão e o aprovador reais, não buscar no catálogo de templates.

Passo 1: acesse o Power Automate no ambiente correto

Abra make.powerautomate.com e confira o seletor de ambiente no canto superior direito da tela. Os cartões de início rápido são carregados a partir do ambiente selecionado, e se a lista de suprimentos estiver em outro ambiente, o cartão ainda funciona, mas a autorização de conexão vai pedir para você apontar para o site certo no passo 4.

Passo 2: localize a seção de cartões na página Início

Na página Início, os cartões aparecem logo abaixo da barra de busca, antes da lista de fluxos recentes. Cada cartão representa um cenário fechado: aprovação sobre um item de lista, notificação por e-mail quando um arquivo é criado, cópia de arquivo entre bibliotecas, entre outros. Antes desta atualização, chegar a qualquer um desses pontos de partida exigia clicar em Criar, abrir a galeria de templates, digitar uma palavra-chave e escolher entre uma lista de resultados nem sempre exata. O cartão elimina essa etapa de busca.

Passo 3: clique no cartão de aprovação

Escolha o cartão equivalente a "iniciar uma aprovação quando um item for criado ou modificado numa lista" e clique nele. Esse clique único já abre o designer de fluxo com o gatilho do SharePoint e a ação de Aprovações inseridos e conectados entre si. É o clique a menos que a atualização promete: sem o cartão, chegar a esse mesmo par gatilho-ação exigiria montar a ligação manualmente ou aceitar um template genérico e depois editar cada campo do zero.

Passo 4: aponte o gatilho para a lista real e autorize a conexão

No designer, configure a ação Quando um item é criado ou modificado apontando para o site e a lista de suprimentos usados na sua operação, por exemplo o site "Suprimentos-FazendaRegional" e a lista "Pedidos de Insumos". Quando solicitado, autorize a conexão do SharePoint com sua conta. Este é o único ponto do fluxo que continua sendo manual mesmo com o cartão, porque o template genérico não conhece o nome do seu site nem da sua lista.

Passo 5: configure a ação de aprovação com os campos do pedido

Defina o tipo de aprovação (primeiro a responder ou todos precisam aprovar), o aprovador responsável (o gerente da fazenda ou o comprador regional) e monte o título e os detalhes usando conteúdo dinâmico dos campos da lista. Um exemplo de expressão para o título, combinando fazenda e valor do pedido, fica assim:

concat('Aprovação de compra de insumos - ', triggerOutputs()?['body/Fazenda'], ' - R$ ', triggerOutputs()?['body/ValorTotal'])

Essa expressão gera um título de aprovação como "Aprovação de compra de insumos - Fazenda Santa Rita - R$ 18500", o que evita que o aprovador precise abrir o item para saber de qual pedido se trata.

Passo 6: trate o resultado da aprovação com uma condição

Depois da ação de aprovação, adicione uma Condição que verifica o resultado retornado. Se aprovado, atualize o status do item para "Aprovado" e notifique o solicitante pelo Teams; se rejeitado, atualize para "Rejeitado" e registre o motivo enviado pelo aprovador. A expressão de condição típica compara o outcome da aprovação:

@equals(outputs('Iniciar_uma_aprovação')?['body/outcome'], 'Approve')

Vale um alerta aqui: o valor retornado por outcome vem em inglês (Approve ou Reject) mesmo quando toda a interface de aprovação está em português. Comparar com "Aprovado" nessa expressão faz a condição nunca ser verdadeira.

Passo 7: salve e teste com um pedido real

Clique em Salvar no canto superior direito do designer. Depois, crie um item de teste na lista "Pedidos de Insumos" com um valor e uma fazenda reais, e acompanhe a execução na aba de histórico do fluxo.

Antes e depois: quantos cliques o cartão elimina

Como validar que o fluxo funciona

Depois de salvar, o fluxo aparece em Meus Fluxos com status Ativado. Ao criar o item de teste na lista, o histórico de execução deve mostrar uma execução com status Bem-sucedida em poucos segundos. O aprovador definido no passo 5 recebe a solicitação no centro de aprovações do Power Automate (web ou mobile) e, se a integração com Teams estiver configurada, também no próprio Teams, com botões de Aprovar e Rejeitar. Depois da decisão, o item na lista "Pedidos de Insumos" deve refletir o novo status automaticamente, sem intervenção manual.

Erros comuns e a causa de cada um

• "Falha ao salvar o fluxo: a ação não tem uma conexão válida": a autorização de conexão do SharePoint foi cancelada ou expirou durante a montagem a partir do cartão. Reabra a ação e autorize novamente.
• "400 Bad Request - InvalidTemplate. Não foi possível processar a expressão de linguagem de modelo na ação 'Condição'": geralmente aparece quando a expressão compara o outcome com um texto em português em vez de Approve/Reject, como descrito no passo 6.
• "The template language expression associated with the 'if' action's condition is invalid": costuma indicar incompatibilidade de tipo, por exemplo comparar um campo de moeda com um texto sem converter com float() ou int() antes.
• Gatilho não dispara para itens antigos: o gatilho "quando um item é criado ou modificado" só reage a partir do momento em que o fluxo é ativado. Itens já existentes na lista antes disso não geram execução.

A segunda novidade: busca server side em My Flows

Na mesma atualização, a busca na página Meus Fluxos passou a ser server side. Antes, a caixa de busca filtrava apenas os fluxos já carregados na tela, o que na prática significava rolar a página inteira ou carregar mais páginas antes de encontrar um fluxo criado há alguns meses. Agora a busca é enviada para o serviço, que retorna resultados de toda a lista de fluxos disponíveis no ambiente, não só do que já foi renderizado no navegador.

Isso importa especialmente para operações agrícolas com múltiplas frentes de automação rodando ao mesmo tempo: aprovação de compra de insumos, monitoramento de alerta climático por talhão, notificação de conclusão de colheita, conciliação de nota fiscal com o ERP, roteirização de frete. Cada fazenda regional ou cada área de negócio tende a acumular seu próprio conjunto de fluxos, e o ambiente inteiro facilmente passa das centenas de itens. Digitar parte do nome na caixa de busca de Meus Fluxos agora traz o resultado certo direto do backend, independente de quantos fluxos existem no ambiente ou de quantos já foram carregados na tela.

A armadilha: cartão genérico não substitui o levantamento do processo real

O cartão de aprovação que você usou neste tutorial resolve um cenário genérico: um item, um aprovador, dois resultados possíveis. O processo real de compra numa operação agrícola raramente é tão simples. Existe alçada por valor, onde pedidos acima de um teto passam por um segundo aprovador financeiro. Existe aprovação em cascata entre comprador regional e diretoria. Existe janela de urgência, porque uma aprovação parada por três dias pode atrasar uma aplicação de defensivo numa janela de clima que não se repete. Existe fallback para quando o aprovador está em campo sem sinal de internet.

Nenhum cartão de início rápido resolve essas particularidades, e não é essa a promessa dele. O ganho real está em economizar o trabalho mecânico de montar o esqueleto do fluxo, não em substituir o mapeamento do processo de decisão do cliente. Quem implementa automação de aprovação numa operação de agro sem antes levantar a alçada real, os prazos de safra e as exceções de conectividade em campo entrega um fluxo bonito que trava na primeira situação fora do padrão.

Esse levantamento prévio, entender quem aprova o quê, com qual limite de valor e qual tolerância a atraso, é justamente o trabalho que separa um fluxo de demonstração de um fluxo que sobrevive à safra inteira em produção.