Configurar e testar webhooks

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 3 min. de leitura

    • Configurar webhooks manualmente em Azure DevOps e testá-los.

    Configure webhooks no Azure DevOps manualmente

    Configure webhooks no Azure DevOps para enviar notificações de sincronização para Velocidade de mudança para DevOps aplicação.

    Antes de Iniciar

    Função necessária: sn_devops.admin ou sn_devops.tool_owner em Velocidade de mudança para DevOps, Azure DevOps administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Você também pode acessar a configuração manual do Azure DevOps registro da ferramenta em Velocidade de mudança para DevOps.

    Procedimento

    1. Em Azure DevOps abra o projeto para o qual você está configurando webhooks.
    2. Navegar até Configurações > Ganchos de serviço E criar uma NOVA ASSINATURA DE GANCHOS DE SERVIÇO, em Azure DevOps.
    3. Em Velocidade de mudança para DevOps, escolha Configurar manualmente ao configurar a instância da ferramenta para enviar dados.
      Ferramenta de configuração do Azure DevOps
    4. Em Velocidade de mudança para DevOps, copie o. URL do webhook Detalhes da conexão da instância da ServiceNow para Azure DevOps.
      Nota:
      Selecione Cópia no campo apropriado para copiar o valor para a área de transferência. O rótulo do campo muda para Copiado , mas você pode copiar várias vezes.
      Azure DevOps configurar webhooks manualmente
    5. Modifique o URL do webhook copiado para refletir os detalhes da ferramenta e cole o URL Azure DevOps.

      Por exemplo:

      https://myinstance.service-now.com/api/sn_devops/v2/devops/tool/{code | plano | artefato | orquestração | teste | softwarequality <project_sys_id>

      1. Selecione um dos recursos da ferramenta código | plano | artefato | orquestração | teste | softwarequality para corresponder à sua ferramenta.
        Por exemplo:

        https://myinstance.service-now.com/api/sn_devops/v2/devops/tool/orchestration?toolId=23410545938c71d0db5bfe686cba1036&projectId=<project_sys_id>

      2. Substituir <project_sys_id> com seu Azure DevOps ID do projeto em ServiceNow(coluna native_id na tabela sn_devops_project).
      3. Copie o URL modificado para URL Campo da NOVA ASSINATURA DE GANCHOS DE SERVIÇO em Azure DevOps.
    6. Em Velocidade de mudança para DevOps, copie o. Token secreto Detalhes de conexão da instância da ServiceNow para Azure DevOps.
    7. Em Azure DevOps, em Cabeçalho Campo da NOVA ASSINATURA DE GANCHOS DE SERVIÇO, cole o copiado Token secreto no formato correto.
      1. Use este formato para Azure DevOps Cabeçalhos HTTP campo:
        " Token: <tokenValue> "
      2. Substituir <tokenValue> , com o copiado Token secreto Nos detalhes de conexão da instância da ServiceNow para Azure DevOps.
      Tabela 1. Copiar valores de campo
      De Velocidade de mudança para DevOps campo . Azure DevOps campo
      URL do webhook (modificado) URL
      Token secreto

      Cabeçalhos HTTP

      No formato:

      Token: <tokenValue>
      Azure DevOps configurar webhooks manualmente

    Teste webhooks no Azure DevOps

    Você pode testar manualmente se os webhooks estão configurados corretamente diretamente do Azure DevOps para cada projeto.

    Antes de Iniciar

    Função necessária: Azure DevOps privilégios de administrador

    Procedimento

    1. Navegue até Azure DevOps e selecione o projeto para o qual você deseja testar webhooks.
    2. Navegar até Configurações do projeto > Ganchos de serviço.
      Para cada projeto, Velocidade de mudança para DevOps cria webhooks para estes eventos:
      • Compilação concluída
      • Código enviado por push
      • Versão criada
      • Implantação da versão concluída
      • Estado da fase de execução alterado
      • Item de trabalho criado
      • Item de trabalho excluído
      • Item de trabalho restaurado
      • Item de trabalho atualizado
    3. Selecione um webhook e selecione Editar .
    4. Selecione Próximo Para ver o URL e os detalhes da autenticação.

      Detalhes do webhook configurado.

    5. Para testar o webhook, selecione Teste .

      • Se o webhook estiver configurado corretamente, você receberá um Bem-sucedido mensagem.

        Mensagem de sucesso quando o webhook está configurado corretamente.

      • Se o webhook estiver configurado incorretamente, você receberá um Falha mensagem.

        Mensagem de falha quando o webhook está configurado corretamente.

        Para corrigir um webhook, você pode tentar as seguintes opções:
        • Reconfigure os webhooks selecionando Configurar na página de registro do projeto em Velocidade de mudança para DevOps. Isso reconfigurará todos os webhooks existentes para o projeto.

        • Verifique se toolIde. projectIdestão corretos em URL campo. Você pode encontrar os valores corretos na página de registro da ferramenta em Velocidade de mudança do DevOps.

          ToolId e ProjectID no URL.

        • Se você estiver usando as credenciais de usuário de integração para autenticação, verifique se as credenciais estão corretas em Autenticação básica campos de nome de usuário e senha.

          Campos de autenticação básica no webhook.

        • Se você estiver usando o token secreto para autenticação, o valor do token será mascarado em Senha de autenticação básica campo. Você pode substituir o token neste campo.

          Token no webhook.