Acionadores instantâneos (webhooks)
Muitos serviços fornecem webhooks para fornecer notificações instantâneas sempre que determinada alteração (evento) ocorrer no serviço. Para processar esses eventos, recomendamos que você use acionadores instantâneos. Os disparadores instantâneos exibem a marca Instant
na lista de módulos de um determinado conector.
Se um conector não incluir um webhook, você poderá executar um dos seguintes procedimentos:
- Crie um webhook personalizado usando o módulo Webhook.
Para obter mais informações, consulte Webhooks. - Use acionadores de pesquisa para pesquisar o serviço periodicamente.
Para obter mais informações, consulte Agendar um cenário
Para obter uma introdução em vídeo a webhooks no Workfront Fusion, consulte:
Agendar acionadores instantâneos
Ao configurar um acionador instantâneo, você será solicitado a selecionar quando ele for executado.
Selecione Immediately
para executar o cenário imediatamente quando o Workfront Fusion receber novos eventos do serviço. Esses eventos são enviados imediatamente para uma fila e processados no cenário, um de cada vez, na mesma ordem em que os dados são recebidos.
Quando o cenário é executado, a quantidade total de eventos pendentes em espera na fila é contada e o cenário executa quantos ciclos houver de eventos pendentes, processando um evento por ciclo.
Para obter mais informações sobre ciclos, consulte Execução do cenário, ciclos e fases.
-
Um ciclo não é o mesmo que uma execução de cenário. Pode haver vários ciclos em uma execução de cenário.
-
Quando você executa um cenário com um gatilho instantâneo agendado para execução
Immediately
, as seguintes exceções se aplicam:-
O intervalo entre duas execuções não está sujeito ao intervalo mínimo de acordo com o plano de precificação.
Por exemplo, uma vez concluída a execução do cenário, a fila do webhook será verificada novamente. Se houver webhooks pendentes, o cenário será executado imediatamente novamente e todos os webhooks pendentes serão processados novamente.
-
A configuração de cenário Número máximo de ciclos é ignorada e definida como 100, o que significa que não mais de 100 webhooks pendentes serão processados durante uma única execução de cenário (na taxa de 1 evento por ciclo).
-
Se você usar qualquer outra configuração de agendamento que não Imediatamente, o cenário será executado nos intervalos especificados. Como vários webhooks podem ser coletados na fila durante o intervalo, recomendamos definir a opção Número máximo de ciclos com um valor maior que o padrão 1 para processar mais webhooks em uma execução de cenário:
- Clique no ícone Configurações de cenário ícone
- No painel Configurações de cenário exibido, insira um número no campo Número máximo de ciclos para indicar o número de eventos da fila que você deseja executar sempre que executar o cenário.
Os eventos restantes na fila serão processados na próxima vez que o cenário for executado, até o número definido no campo Número máximo de ciclos.
Medidas de proteção de Webhook
Para garantir um bom desempenho, o Workfront Fusion tem as seguintes medidas de proteção em vigor para webhooks.
Limites de taxa
O limite de taxa atual é de 5 webhooks por segundo. Se o limite for excedido, um código de status 429
será retornado.
Expiração de webhooks inativos
Um webhook que não foi atribuído a nenhum cenário por mais de 120 horas é removido.
Cargas do Webhook
O Workfront Fusion armazena cargas de webhook por 30 dias. Acessar uma carga de webhook mais de 30 dias após sua criação resulta no erro Failed to read file from storage.
Tratamento de erros
Quando há um erro no seu cenário com um acionador instantâneo, o cenário:
- Para imediatamente quando o cenário está definido para execução Imediatamente.
- Interrompe após 3 tentativas malsucedidas (3 erros) quando o cenário está definido para ser executado como programado.
Se ocorrer um erro durante a execução do cenário, o evento será colocado de volta na fila durante a fase de reversão do acionador instantâneo. Nessa situação, você pode corrigir o cenário e executá-lo novamente.
Para obter mais informações, consulte Reversão no artigo Execução de cenário, ciclos e fases.
Se houver um módulo de resposta do Webhook em seu cenário, o erro será enviado para a resposta do Webhook. O módulo de resposta do Webhook é sempre executado por último (quando a opção Confirmação automática nas configurações de Cenário não está habilitada).
Para obter mais informações, consulte Responding to webhooks no artigo Webhooks.
Desativação do Webhook
Os webhooks são desativados automaticamente se qualquer uma das seguintes situações se aplicar:
- O webhook não foi conectado a nenhum cenário por mais de 5 dias.
- O webhook é usado somente em cenários inativos, que ficaram inativos por mais de 30 dias.
Os webhooks desativados são excluídos e não registrados automaticamente se não estiverem conectados a nenhum cenário e estiverem com o status desativado por mais de 30 dias.
Webhooks personalizados
Você pode criar seus próprios webhooks. Para obter mais informações, consulte Webhooks.
Recursos
Para obter mais informações sobre ciclos, consulte Execução do cenário, ciclos e fases.