Configure and test webhooks

Manually configure webhooks in Azure DevOps and test them.

Parent Topic:Azure DevOps integration with DevOps Change Velocity

Configure webhooks in Azure DevOps manually

Configure webhooks in Azure DevOps to send sync notifications to the DevOps Change Velocity application.

Before you begin

Role required: sn_devops.admin or sn_devops.tool_owner in DevOps Change Velocity, Azure DevOps admin

About this task

You can also access manual configuration from the Azure DevOps tool record in DevOps Change Velocity.

Procedure

1. In Azure DevOps, open the project for which you are configuring webhooks.

2. Navigate to Settings > Service Hooks and create a NEW SERVICE HOOKS SUBSCRIPTION, in Azure DevOps.

3. In DevOps Change Velocity, choose Configure manually when configuring the tool instance to send data.

1. In DevOps Change Velocity, copy the Webhook URL field from the ServiceNow instance connection details for Azure DevOps.

   Note: Select Copy in the appropriate field to copy the value to your clipboard. The field label changes to Copied, but you can copy multiple times.

1. Modify the copied Webhook URL to reflect your tool details, and paste the URL in Azure DevOps.

   For example:

   https://myinstance.service-now.com/api/sn_devops/v2/devops/tool/{code | plan | artifact | orchestration | test | softwarequality }?toolId=23410545938c71d0db5bfe686cba1036&projectId=<project_sys_id>

   1. Select one of the tool capabilities {code | plan | artifact | orchestration | test | softwarequality } to match your tool.

      For example:

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

   2. Replace <project_sys_id> with your Azure DevOps project ID in ServiceNow (native_id column in the sn_devops_project table).

   3. Copy the modified URL to the URL field of the NEW SERVICE HOOKS SUBSCRIPTION in Azure DevOps.

2. In DevOps Change Velocity, copy the Secret token field from the ServiceNow instance connection details for Azure DevOps.

3. In Azure DevOps, in Header field of the NEW SERVICE HOOKS SUBSCRIPTION, paste the copied Secret token in the correct format.

   1. Use this format for the Azure DevOps HTTP headers field:

      "token : <tokenValue>"

   2. Replace <tokenValue>, with the copied Secret token from the ServiceNow instance connection details for Azure DevOps.

-   If the webhook is configured incorrectly, you’ll receive a **Failed** message.

    To fix a webhook, you can try the following options:

    -   Reconfigure the webhooks by selecting **Configure** from the project record page in DevOps Change Velocity. This will reconfigure all the existing webhooks for the project.
    -   Verify if the **toolId** and **projectId** are correct in the **URL** field. You can find the correct values in the tool record page in DevOps Change Velocity.

    -   If you're using the integration user credentials for authentication, check if the credentials are correct in the **Basic authentication** username and password fields.

    -   If you're using the secret token for authentication, the token value is masked in the **Basic authentication password** field. You can replace the token in this field.