Configurar Ou Modificar um Trigger Wevo iPaaS
Um trigger é a configuração que define como o processo de integração será iniciado. De vários tipos de triggers, escolha aquele que melhor se adapta às suas regras de integração.
Para entender melhor o conceito, considere, por exemplo, uma integração com um banco de dados que precisa ser executada a cada 30 minutos. Nesse caso, você pode definir um trigger do agendador que iniciará automaticamente o processo a cada meia hora. Existem outros tipos de trigger que você pode escolher.
Esta página mostra como configurar ou modificar um trigger após a criação de um flow.
Configuração Ou Modificação do Trigger
Encontre o flow que você quer editar e clique no ícone que representa o trigger. Uma caixa de diálogo será mostrada.
No campo Escolher conector, escolha o tipo de trigger, um agendador ou uma API.
Agendador
O trigger Scheduler permite que você agende os horários em que um flow deve ser executado periodicamente. Ao escolher esta opção, você deve decidir com que frequência o flow será executado.
-
Frequência de execução: Use as opções neste menu para decidir quanto tempo deve passar entre as execuções. Se você quiser uma frequência personalizada, pode fazer isso inserindo um código cron.
-
Timeout: Use este campo (destacado abaixo) para determinar a quantidade máxima de tempo que seu flow tem para cada execução.
Gancho de Rede
O trigger Webhook significa que um processo será iniciado toda vez que a rotear do flow for chamada. Esse tipo de trigger significa que você estará expondo uma API para a internet com uma URL criada pela plataforma que será capaz de aceitar requisições de API. Veja abaixo como configurar um trigger Webhook:
-
Caminho: Use este campo para personalizar sua URL de API. Quando você cria um caminho aqui, ele é mostrado no final do link que é mostrado no campo Visualizar logo abaixo, como mostra o exemplo.
-
Parâmetros de rota: Você também pode definir parâmetros de rotear. No campo Caminho, use a seguinte sintaxe:
${parameter}
. Depois de inserir seus parâmetros dessa forma, eles são automaticamente exibidos no campo Parâmetros de rota: -
Métodos: Use este campo para escolher o método que será usado durante a chamada da API. Você pode selecionar mais de um método. Saiba mais em API verbs.
-
Timeout: Você pode definir o timeout em segundos. Para triggers de webhook, o limite superior é 30 segundos.
-
Solicitação múltipla: Ao configurar este campo, sua API poderá receber mais de uma solicitação em paralelo, o que significa que enquanto um flow estiver sendo executado, ela poderá receber outras solicitações.
Autenticação
Ao ativar esta opção, os usuários precisarão ser autenticados para poderem chamar a API. Caso contrário, não será possível testá-la diretamente pelo navegador.
Como você viu, esta opção requer que os usuários se autentiquem. Isso pode ser feito com tokens. Para criar tokens:
-
Clique em Gerenciar Tokens. Você será levado para a página Contas.
-
Quando estiver lá, vá para Segurança > Token de acesso. Na tabela que será exibida, clique em Adicionar novo token.
-
Use o campo Detalhes do Token para adicionar uma breve descrição, então use o menu Data de Expiração para escolher quanto tempo ele deve durar. Em seguida, no menu Perfil, escolha quem está criando o token. Clique em Salvar para finalizar o processo.
Resposta
Com este campo, você pode definir qual resposta será mostrada na aplicação que enviará uma requisição para o flow da API. Você pode selecionar a saída de um conector como resposta, conforme mostrado na captura de tela abaixo:
-
Corpo: Use este menu para selecionar uma ferramenta ou conector cuja saída será mostrada como resposta.
-
Código de status personalizado: Insira o código de status da API que deve ser exibido na chamada.
-
Cabeçalho: Use esta opção para definir como a resposta deve ser lida. Clique em Adicionar Cabeçalho e preencha as informações. Por exemplo, inserindo
Content-type
no campo Chave etext/html
no campo Value, a resposta pode ser lida em formato HTML.
Referência de Flow
Referência de flow é um trigger que inicia um flow automaticamente após outro ser concluído, de forma síncrona ou assíncrona. Para que isso ocorra, o flow de origem deve conter a Referência de flow ferramenta em sua integração.
Evento de Trigger
Para otimizar seus processos e permitir um desenvolvimento de flow mais dinâmico, o evento de trigger permite que você inicie seus flows em tempo real, sem a necessidade de um agendador ou trigger de API. O flow monitorará o sistema e será executado quando um determinado evento ocorrer naquele sistema, como a inserção de um registro. Assim que o flow o receber, ele avançará com a integração. Veja Evento de trigger para saber mais.