Ativar ações personalizadas (fluxos do Power Automate)

Você pode ativar sistemas externos com uma regra Activator definindo ações personalizadas com o Power Automate. Ações personalizadas podem ser úteis para:

  • Envio de notificações usando outros sistemas além do Teams e do email.
  • Criação de itens de ação em sistemas de tíquetes.
  • Chamada de aplicativos de linha de negócios.

Para ativar ações personalizadas nas suas regras, primeiro defina uma ação personalizada criando um fluxo do Power Automate. Em seguida, chame sua ação personalizada da regra Ativador.

Criar uma ação personalizada

Uma ação personalizada é uma ação reutilizável que você pode usar em várias regras em itens do Activator. Criar uma ação personalizada exige familiaridade com o Power Automate. No entanto, depois de criar uma ação personalizada, outros usuários do Activator poderão usar a ação em qualquer regra, sem exigir qualquer conhecimento do Power Automate.

Uma ação personalizada define como chamar um sistema externo específico por meio de uma regra usando um fluxo. Ele define um conjunto de campos de entrada para passar de suas regras para o fluxo, de modo que o fluxo chame o sistema externo. Por exemplo, suponha que você queira definir uma ação personalizada que adicione uma tarefa a Microsoft To Do. O campo de entrada para essa ação pode ser Nome da tarefa. Essa ação personalizada seria vinculada a um fluxo que usa um conector Microsoft To Do para criar a tarefa em seu nome.

Nomear a ação e adicionar campos de entrada

Abra o Activator e selecione uma regra para exibir o painel Definição. Role para baixo até Ação>, Tipo, e selecione Nova ação personalizada.

Em seguida, dê um nome à sua ação, como Adicionar uma tarefa a Fazer. Defina os campos de entrada que você gostaria de usar posteriormente ao criar um fluxo no Power Automate. Essas cadeias de caracteres, como nome da tarefa, responsável, etc. podem ser passadas em código para o Power Automate. E, de volta ao Activator, você pode dar a essas sequências um nome que aparecerá na sua tarefa pendente — como "verificar temperatura do pacote" e "Sally".

Captura de tela da criação de uma nova ação personalizada do Activator.

A próxima etapa é definir o fluxo no Power Automate. Selecione Copiar para copiar a cadeia de conexão e, em seguida, escolha Abrir construtor de fluxo. O Activator levará você ao Power Automate para que você possa definir o fluxo.

Definir seu fluxo no Power Automate

O fluxo é preenchido previamente com uma ação para o Activator.

Você deve colar a cadeia de conexão da etapa anterior nessa ação. Selecione o tile do Power Automate que exibe o erro de parâmetros inválidos . Em seguida, cole a cadeia de conexão copiada na etapa anterior. Isso remove a mensagem de erro e permite que você continue criando seu fluxo.

Captura de tela colando a cadeia de conexão.

Adicionar uma nova etapa ao fluxo

  1. Selecione o sinal de adição (+) para adicionar uma nova etapa ao fluxo.

  2. Neste exemplo, estamos adicionando uma tarefa Pendente, portanto, procuramos Tarefa Pendente e escolhemos Adicionar uma tarefa pendente (V3).

    Captura de tela da definição de um fluxo para o ativador.

  3. Preencha os campos necessários na janela Adicionar uma tarefa pendente (V3). Comece selecionando uma lista existente no menu suspenso da Lista de tarefas pendentes ou escolhendo Insira um valor personalizado e dando um nome a uma nova lista de tarefas pendentes.

Opcionalmente, insira uma expressão nos campos de entrada. Se você selecionar um campo de entrada e ver um ícone fx, isso significa que o campo dá suporte a funções e conteúdo dinâmico. Vamos adicionar conteúdo dinâmico ao campo de entrada Título e passar uma função no campo de entrada Conteúdo do Corpo.

Usar conteúdo dinâmico em seu fluxo

Conteúdo dinâmico permite adicionar campos do próprio evento Activador. Selecione o campo na lista suspensa para passá-lo dinamicamente para o fluxo.

  1. Com o cursor no campo Título, selecione fx.
  2. Selecione a guia Conteúdo dinâmico.
    Quando você seleciona o conteúdo dinâmico, ele é adicionado à caixa de texto.
  3. Adicione a data e a hora usando Hora de ativação. Quando você seleciona Adicionar, a expressão aparece no campo Título. Passe o mouse sobre Tempo de ativação para ver quais informações estão sendo transmitidas. Ao adicionar uma data ao título, você pode evitar nomes duplicados.
  4. Opcionalmente, remova o texto de espaço reservado DefaultToDo e substitua-o por algo mais significativo, como Tarefa Temperatura.

Passe um campo de entrada para o fluxo

  1. Mova o cursor para o campo Conteúdo do corpo, selecione fx.

  2. Procure pela função triggerBody ou copie e cole essa função: triggerBody()?['customProperties/NAME_OF_INPUT_FIELD']. Substitua NAME_OF_INPUT_FIELD por um dos campos de entrada que você criou anteriormente. Neste exemplo, usamos nome da tarefa.

    Você pode usar qualquer campo de entrada predefinido criado em funções do Power Automate.

    Captura de tela da tela de edição da guia Função.

  3. Selecione Adicionar>Salvar. Pode levar alguns minutos para salvar.

  4. Opcionalmente, selecione Testar na barra de menu para forçar a execução do fluxo.

Para saber mais sobre o Power Automate, consulte Power Automate.

Conclua a ação personalizada

Depois de salvar o fluxo, volte ao Activator.

Captura de tela mostrando a mensagem de êxito no Activator.

Chamar a ação personalizada por meio de uma regra

Depois de criar uma ação personalizada, ela estará disponível para uso por todas as regras e usuários que têm acesso ao item de ativador que você definiu na ação personalizada. Para chamar sua ação personalizada, a partir de uma regra, selecione a regra no painel de Definição e escolha Ação>Tipo, em seguida, selecione sua ação personalizada na lista.

Captura de tela do menu suspenso Tipo mostrando a ação recém-criada.

Selecione Editar ação para ver os campos de entrada da sua regra. Preencha-os conforme apropriado para a definição de regra:

Quando a regra é ativada, ela chama o fluxo, enviando a ele os valores dos campos de entrada que você definiu. Como solicitamos que o nosso fluxo atualize uma lista de afazeres, abra o Microsoft To Do para ver a nova tarefa.

Captura de tela da tela Microsoft To Do mostrando as novas tarefas.

Você também pode saber mais sobre o Microsoft Fabric: