USM Content
Webhooks do Jira
Em 15 de novembro de 2023, atualizamos o esquema de webhook do conector Jira do Smartsheet para aumentar a eficiência. Todos os fluxos de trabalho bidirecionais criados após essa data se beneficiarão de um sistema de webhook compartilhado. Esse aprimoramento estratégico foi projetado para se alinhar à alteração do limite do Atlassian Jira Cloud de julho de 2024 para 100 webhooks do Jira por ambiente do Jira, que introduziu um limite de 100 webhooks do Jira por ambiente do Jira Cloud. A vantagem? Agora você tem o que é preciso para estabelecer quantos fluxos de trabalho forem necessários, contornando as restrições de webhook do Jira.
Converter fluxos de trabalho existentes para o novo modelo
Com a recente atualização do limite de webhooks do Jira da Atlassian em julho de 2024, agora é recomendável migrar todos os seus fluxos de trabalho para o novo modelo de webhooks compartilhados. Para iniciar esse processo, um administrador de sistema ou administrador do conector Jira da sua conta deve fazer o seguinte:
- Navegar até o painel do administrador do conector Jira.
Selecionar o botão Migrate Workflows (Migrar fluxos de trabalho).
Se você receber um alerta indicando que alguns fluxos de trabalho não conseguiram migrar após selecionar o botão, tente novamente. Depois que todos os fluxos de trabalho forem migrados com sucesso, o botão Migrate Workflows (Migrar fluxos de trabalho) não ficará mais visível. Observação: essa alteração não afetará os fluxos de trabalho existentes, e não há necessidade de reativá-los.
Consolidar fluxos de trabalho automatizados quando possível
As melhores práticas da Atlassian para webhooks sugerem ter o menor número possível de webhooks. Uma maneira de consolidar fluxos de trabalho é usar um filtro mais geral no fluxo de trabalho e usar a planilha conectada como um local de preparação para seus dados. Em seguida, você pode usar o DataMesh para filtrar e enviar dados entre planilhas.
Se você tem muitos fluxos de trabalho e está enfrentando lentidão no Jira, consulte o guia de solução de problemas de webhook da Atlassian para saber como o administrador do Jira pode diagnosticar os webhooks que estão causando a lentidão.
Habilitar o processamento assíncrono de webhook
Por padrão, o Jira Server e o DataCenter processam esses webhooks individualmente após cada alteração em um problema.
O Jira tem um recurso oculto não oficial que o faz processar webhooks de modo assíncrono, tornando a interface do usuário mais responsiva após as alterações. Para habilitar essa alteração, é necessária permissão de um usuário administrador do Jira.
Conforme este tíquete do Jira, você pode habilitar o recurso ao:
- Habilitar manualmente o sinalizador de recurso com.atlassian.jira.webhookEventsAsyncProcessing com as seguintes instruções.
- Reiniciar sua instância do Jira (ou cada nó no caso de DC)
As seguintes versões do Jira Server e DataCenter podem habilitar esse recurso:
- 8.13.25, 8.20.12 ou posterior
- 9.2.0 ou posterior
Perguntas frequentes
Limite de webhook excedido
Se você recebeu essa mensagem, isso significa que está usando mais de 100 webhooks em seu ambiente Jira. Como a Atlassian impõe um limite de 100 webhooks por instância do Jira Cloud, você deve realizar as seguintes ações para reduzir sua contagem de webhooks abaixo de 100.
- Identifique quantos fluxos de trabalho bidirecionais estão em uso.
- Desabilite fluxos de trabalho bidirecionais suficientes para ficar abaixo da contagem de 100 webhooks (ou seja, será necessário ter no mínimo menos de 100 fluxos de trabalho bidirecionais).
- Depois que os fluxos de trabalho bidirecionais forem desabilitados por um administrador ou pelo proprietário do fluxo de trabalho, você poderá converter aqueles existentes para o novo sistema.
- Peça ao proprietário do fluxo de trabalho que atualize a página; em seguida, selecione o botão Reset (Redefinir) para reabilitar o fluxo de trabalho. Depois de confirmar que o fluxo de trabalho foi redefinido com sucesso, continue o processo para os fluxos de trabalho do Jira bidirecionais desabilitados restantes.
Essa ação deve ser executada pelo proprietário do fluxo de trabalho, pois qualquer usuário do Jira pode desabilitar um fluxo de trabalho, mas apenas o proprietário pode reabilitar.