Configurar ou modificar um gatilho Wevo iPaaS

Um gatilho é a configuração que define como o processo de integração será iniciado. Dentre os vários tipos de gatilhos, 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 gatilho agendador que iniciará o processo automaticamente a cada meia hora. Existem outros tipos de gatilho que você pode escolher.

Esta página mostra como configurar ou modificar um gatilho após a criação de um fluxo.

Configuração ou modificação do gatilho

Encontre o fluxo que deseja editar e clique no ícone que representa o gatilho. Uma caixa de diálogo será exibida.

No campo Escolher conector, escolha o tipo de gatilho: um agendador ou uma API.

Agendador

O gatilho Agendador permite agendar os horários em que um fluxo deve ser executado periodicamente. Ao escolher esta opção, você deve decidir com que frequência o fluxo será executado.

• Frequência de Execução: Use as opções neste menu para decidir quanto tempo deve passar entre as execuções. Se desejar uma frequência personalizada, você pode fazer isso inserindo um código cron.

  

• Tempo limite: Use este campo (destacado abaixo) para determinar o tempo máximo que seu fluxo terá para cada execução.

  

Webhook

O gatilho Webhook significa que um processo será iniciado sempre que a rotear de fluxo for chamada. Esse tipo de gatilho significa que você estará expondo uma API à internet com uma URL criada pela plataforma que poderá aceitar solicitações de API. Veja abaixo como configurar um gatilho Webhook:

• Caminho: Use este campo para personalizar a URL da sua API. Ao criar um caminho aqui, ele será exibido no final do link exibido 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}. Após inserir seus parâmetros dessa forma, eles serão exibidos automaticamente 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 Verbos da API.

• Tempo limite: Você pode definir o tempo limite em segundos. Para gatilhos de webhook, o limite máximo é 30 segundos.

• Requisição múltipla: Ao configurar este campo, sua API poderá receber mais de uma requisição em paralelo, o que significa que enquanto um fluxo estiver em execução, ela poderá receber outras requisições.

Autenticação

Ao ativar esta opção, os usuários precisarão ser autenticados para poder 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:

1. Clique em Gerenciar Tokens. Você será direcionado para a página Contas.

   

2. Uma vez lá, acesse Segurança > Token de Acesso. Na tabela que será exibida, clique em Adicionar Novo Token.

   

3. Use o campo Detalhes do Token para adicionar uma breve descrição e, em seguida, use o menu Data de Validade para escolher a duração do token. 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á exibida no aplicativo que enviará uma solicitação ao fluxo 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 uma 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 e text/html No campo Valor, a resposta pode ser lida em formato HTML.

  

Referência de fluxo

Referência de fluxo é um gatilho que inicia um fluxo automaticamente após a conclusão de outro, de forma síncrona ou assíncrona. Para que isso ocorra, o fluxo de origem deve conter a Referência de fluxo ferramenta em sua integração.

Evento de gatilho

Para otimizar seus processos e permitir um desenvolvimento de fluxos mais dinâmico, o evento de gatilho permite que você inicie seus fluxos em tempo real, sem a necessidade de um agendador ou gatilho de API. O fluxo monitorará o sistema e será executado automaticamente quando um determinado evento ocorrer nesse sistema, como a inserção de um registro. Assim que o fluxo o receber, ele prosseguirá com a integração. Consulte Evento de gatilho para saber mais.