Configurar um webhook bidirecional

Configure um webhook para assinar Jira com um URL de retorno de chamada ServiceNow.

Antes de Iniciar

• Solicitar uma assinatura de IntegrationHub
• Ativar o spoke Jira
• Função necessária: administrador

Criar um token

Crie um token para incorporar na URL do webhook Jira.

Antes de Iniciar

Função necessária: administrador

Procedimento

1. No filtro [ navigation, insira token_verification.list.
   O sistema exibe registros na tabela Verificações de token.
2. Clique em Nova.
3. No formulário, preencha os campos.

   Tabela 1. Formulário de Verificação de token

   Campo	Descrição
   Nome	Nome exclusivo para identificar o token. Por exemplo, token do Jira.
   Descrição	Descrição do token.
   Token	Token de autenticação. Este token é criptografado e incorporado ao URL.

Resultado

O token é criado para ser incorporado ao URL do webhook Jira.

Registrar um webhook [ Jira em ServiceNow

Registre um webhook [ Jira em ServiceNow para notificar o app ServiceNow quando determinados eventos ocorrerem em Jira.

Antes de Iniciar

Função necessária: administrador

Procedimento

1. Navegar até Todos > Webhooks do Jira > Registros de webhook do Jira.
2. Clique em Nova.
3. No formulário, preencha os campos.

   Tabela 2. Formulário Registro do webhook do Jira

   Campo	Descrição
   Nome	Nome exclusivo para identificar o registro. Por exemplo, webhook do Jira.
   Descrição	Descrição do registro.
   Token	Token de autenticação. Este token é criptografado e incorporado ao URL. Por exemplo, token do Jira.
   Caminho	Jira caminho do webhook. Por padrão, este caminho é definido como api/sn_jira_spoke/jira_webhook_callbacks/wh_entry.

4. Clique com o botão direito no cabeçalho do formulário e clique em Salvar.
5. Clique em URL de retornode chamada.
   O sistema exibe o URL de allback webhook c.
6. Copie e registre a URL de allback webhook c.

Resultado

O webhook Jira está registrado na sua instância ServiceNow.

Como adicionar uma URL de retorno de chamada no Jira

Forneça um URL de retorno de chamada do webhook na sua conta do AtlassianJira para criar um webhook.

Antes de Iniciar

Função necessária: administrador

Procedimento

1. Faça login na sua Jira conta Atlassian.
2. Crie um webhook na sua conta da Atlassian.
3. Insira a URL de retorno de chamada do webhook no campo URL .
   Consulte a documentação do portal Atlassian Developer para obter instruções sobre como criar um webhook.

Resultado

O URL de retorno da chamada é adicionado à sua Jira conta Atlassian. Você pode criar políticas de roteamento e subfluxos de acordo com seus requisitos. Consulte Personalizar a webhook bidirecional para obter informações sobre a criação de novas políticas de roteamento e subfluxos.

Personalizar a webhook bidirecional

Crie uma política de roteamento de webhook e subfluxo de acordo com seus requisitos.

Antes de Iniciar

Função necessária: administrador

Por Que e Quando Desempenhar Esta Tarefa

A política de roteamento padrão no módulo Políticas de roteamento do WebHook do Jira aciona o subfluxo Processar Webhooks do Jira e notifica o app ServiceNow quando determinados eventos ocorrem em Jira. Consulte Jira Spoke para obter informações sobre os campos compatíveis com a política de roteamento padrão e os subfluxos. Para usar outros campos em seu subfluxo personalizado e personalizar as condições na política de roteamento, execute estas etapas.

Procedimento

1. Navegar até Todos > Flow Designer > Designer.
2. Selecione Subfluxos.
3. Crie uma cópia do subfluxo padrão, Processar Webhooks do Jira.
4. Personalize o subfluxo de acordo com seus requisitos e publique-o.
   Consulte Criação de subfluxos para obter mais informações sobre como criar e usar subfluxos e Jira Spoke para obter informações sobre os campos compatíveis com a política de roteamento padrão e os subfluxos.
5. Navegar até Webhooks do Jira > Políticas de roteamento do WebHook do Jira.
6. Selecione Novo.
7. No formulário, preencha os campos.

   Tabela 3. Formulário de decisão

   Campo	Descrição
   Rótulo	Rótulo exclusivo para identificar a política de roteamento.
   Resposta padrão	Opção para especificar se esta é a resposta padrão. A resposta padrão dé aplicável quando as condições não são atendidas. Selecione o ícone de pesquisa ( ícone de ). Selecione o subfluxo necessário na lista Documento . Nota: Certifique-se de que o nome da tabela seja Fluxo [sys_hub_flow].
   Condição	Condições a serem atendidas quando os eventos necessários ocorrerem em Jira. Confira Jira webhooks para obter informações sobre os campos compatíveis.
   Resposta	Subfluxo em que deve ser acionado quando as condições especificadas forem atendidas.

8. Selecione Enviar.
   Nota:

   Essas políticas de roteamento são salvas nas tabelas de decisão. Os usuários são alertados para não atualizar ou modificar diretamente os dados nessas tabelas.

Resultado

A política de saída re o subfluxo são criados.