Acionadores instantâneos (webhooks) em Adobe Workfront Fusion
Muitos serviços fornecem webhooks para fornecer notificações instantâneas sempre que uma determinada alteração ocorrer no serviço. Para processar essas notificações, recomendamos que você use acionadores instantâneos. Você pode reconhecê-los facilmente no Adobe Workfront Fusion por causa da tag:
Se o serviço não fornecer webhooks, você precisará usar acionadores de polling para pesquisar o serviço periodicamente.
Para obter uma introdução em vídeo a webhooks no Workfront Fusion, consulte:
Requisitos de acesso
Você deve ter o seguinte acesso para usar a funcionalidade neste artigo:
Para saber que plano, tipo de licença ou acesso você tem, contate o administrador do Workfront.
Para obter informações sobre Adobe Workfront Fusion licenças, consulte Adobe Workfront Fusion licenças.
Exibir a fila de um webhook
Todas as mensagens de webhooks recebidos são armazenadas na fila do webhook.
-
Clique em Webhooks no menu à esquerda.
-
Localize o Webhook para o qual deseja exibir a fila.
-
Clique no botão com um ícone de caminhão e o número de webhooks recebidos.
note note NOTE Os dados de entrada do webhook são sempre armazenados na fila, independentemente de como você definiu a opção Dados como confidencial (descrita em O painel de configurações do cenário Adobe Workfront Fusion). Assim que os dados forem processados em um cenário, eles serão excluídos permanentemente do sistema.
Agendar acionadores instantâneos
Se o cenário contiver um acionador instantâneo, você poderá agendar sua execução imediatamente:
Nesse caso, o cenário será executado imediatamente quando Workfront Fusion receber novos dados do serviço. Depois que o cenário é executado, a quantidade total de webhooks pendentes em espera na fila é contada e o cenário executa quantos ciclos houver webhooks pendentes, processando um webhook por ciclo. Para obter mais informações, consulte Execução do cenário, ciclos e fases em Adobe Workfront Fusion.
-
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 acionador instantâneo agendado para ser imediato, 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, é recomendável definir 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
- Na caixa Configurações de cenário exibida, digite um número na caixa Número máximo de ciclos para indicar o número de webhooks da fila que você deseja executar sempre que executar o cenário.
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 "Falha ao ler arquivo do armazenamento."
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 ser executado Imediatamente.
- Interrupções 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 webhook será colocado de volta na fila durante a fase de reversão do acionador instantâneo. Em tal situação, você tem a possibilidade de 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 em Adobe Workfront Fusion.
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 (caso em que a opção Confirmação automática nas configurações de Cenário não está habilitada). Para obter mais informações, consulte Respondendo a webhooks no artigo Webhooks.
Webhooks personalizados
Você pode criar seus próprios webhooks. Para obter mais informações, consulte 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.