Introdução
Este módulo descreve como você pode expandir a funcionalidade de conectores personalizados com definições de gatilhos.
Neste módulo, você vai:
Aprender sobre gatilhos em conectores personalizados.
Descobrir cenários comuns em que os gatilhos podem ser usados.
Identificar diferentes tipos de gatilhos.
Saiba como estender uma definição de conector personalizado a gatilhos definidos por uma API de serviço.
Com os gatilhos, você consegue expandir a funcionalidade dos conectores nos Aplicativos Lógicos do Microsoft Power Automate e do Microsoft Azure, nos quais um sistema precisa responder à alterações feitas nos dados ou serviços subjacentes. O cenário mais comum de uso de um gatilho é a criação de um fluxo da nuvem que começa quando dados subjacentes são alterados, como "Quando um registro é criado", ou quando determinado evento ocorre no serviço definido pelo conector personalizado, como "Quando o alarme é ativado".
Gatilhos no Power Automate e Aplicativos Lógicos
O Power Automate e os Aplicativos Lógicos definem um gatilho como um evento que dá início a um fluxo da nuvem ou a um fluxo de trabalho dos Aplicativos Lógicos. Esses eventos podem ser iniciados por um usuário, agendados ou gerados por um conector, incluindo um personalizado. As definições de gatilho expandem os conectores personalizados e permitem que eles sejam usados para iniciar fluxos da nuvem e fluxos de trabalho dos Aplicativos Lógicos.
A maioria dos conectores resume os gatilhos como "Quando <object> é <verb>", e uma implementação de conector comum inclui um gatilho para uma ou mais ações.
Tipos de gatilho
Imagine um sistema de gerenciamento de caixa postal. Um gatilho neste sistema poderia ser um evento "nova mensagem de correio de voz recebida". Existem duas maneiras de definir um método para identificar se um novo correio de voz foi recebido:
Ligar periodicamente para a caixa de correio de voz para verificar se há novas mensagens. Esse comportamento descreve um gatilho de polling, ou seja, a implementação na qual os dados são obtidos do serviço subjacente. Um gatilho de polling é uma atividade temporal que inicia uma chamada à API de serviço em um intervalo regular e configurável para verificar se novos dados estão disponíveis. Para ajudar os gatilhos de polling, a API pode filtrar os resultados com base em um estado. O estado geralmente tem base no tempo, por exemplo, "Trazer todos os correios de voz recebidos desde ontem".
Deixar que seu sistema de correio de voz envie um email quando uma nova mensagem de voz for recebida. Essa abordagem define uma implementação ou gatilho de webhook para onde o serviço envia os dados. O serviço que oferece suporte a gatilhos de webhook deve ser capaz de manter uma lista de partes para retornar a ligação e saber como fazer isso. No exemplo do correio de voz, isso seria uma lista de endereços de email e a capacidade de enviar um email de notificação.
Na essência, a diferença entre esses dois tipos de gatilho tem a ver com qual lado é responsável pelo gerenciamento da operação.
| Polling | Webhook |
|---|---|
| Começa definindo um estado | Registrado com o serviço |
| Verifica periodicamente se há atualizações | Sinaliza quando o evento ocorre |
| Solicita todos os dados novos desde a última atualização do estado | É subdividido automaticamente |
| O serviço mantém o estado | O Power Automate ou os Aplicativos Lógicos gerenciam o processo de inclusão e exclusão do registro de webhooks |
Importante
O fato de uma API REST estar disponível para um serviço não significa que é possível definir gatilhos de conectores personalizados. O serviço subjacente precisa ser capaz de trazer os dados de forma incremental ou fornecer uma implementação do webhook. Se os gatilhos forem necessários, mas a API de serviço não tiver o recurso, um desenvolvedor precisaria expandir o serviço para que os usuários conseguissem definir um gatilho.
Definir um gatilho
De maneira muito parecida com a definição de um conector, os dois tipos de gatilho são definidos por um documento OpenAPI (Swagger) que especifica os pontos de extremidade, os parâmetros, as condições e as respostas. No entanto, a versão de especificação OpenAPI usada pelo Microsoft Power Platform não diferencia ações e gatilhos. O Microsoft Power Platform adiciona extensões OpenAPI personalizadas para expandir as especificações e definir gatilhos e o respectivo conteúdo.
Como isso pode ser um tópico confuso às vezes, você pode usar o Copilot para ajudar. Basta enviar ao Copilot algumas solicitações como:
"Como começo a criar um conector personalizado no Power Automate?"
"Qual é a melhor maneira de definir a autenticação para meu conector personalizado?"
O Copilot pode ajudar sugerindo as etapas para a criação do conector ou até mesmo revisando se as configurações do conector estão completas.
Se isso não ajudar, você poderá simplesmente usar o assistente passo a passo para gatilhos. Ele segue o mesmo layout geral do assistente de ação.
Assim como as ações de conectores personalizados, selecionar um bom resumo de gatilhos é importante. Este resumo é usado quando um fabricante pesquisa os conectores. Quando um gatilho é selecionado, seu resumo se torna o título da etapa padrão no Power Automate e nos Aplicativos Lógicos.
Diferentemente das ações, que, na sua maioria, podem ser construída inteiramente no designer de conectores personalizados, os gatilhos podem ser mais complexos e, geralmente, exigem modificações manuais. Este módulo descreve como criar definições de gatilhos em cenários de polling e de webhook.