Configuring a team space webhook

You can configure a team space webhook to send notifications to a messaging application whenever an event occurs on HCL DevOps Test Hub (Test Hub).

Before you begin

You must have completed the following tasks:

About this task

When you configure a webhook on Test Hub, you must copy the URL of the communication application in the Webhook URL field and paste the outgoing URL, and then select the events. You can select either all events or a subset of events.

You can be notified of the following types of events:
  • All Events
  • Team space Events
  • Project Events
  • Execution Events
  • License Events

You can configure the webhook resume policy by selecting either the Queue old messages or Discard old messages option. When a team space webhook is disabled due to communication failures or network issues, the team space event notifications are not delivered to the configured webhook, and you receive a notification that the webhook is disabled. By configuring the queue old messages, you can ensure that the event notifications are not lost and are delivered to the configured webhook after the team space webhook is enabled again.

If you configure the Discard old messages for a team space webhook, the event notifications are discarded from the moment the webhook is disabled. Only team space events that occur after the webhook is re-enabled are sent to the configured webhook.

Procedure

  1. Log in to Test Hub.

    The team space that contains your project is displayed.

  2. Click the Settings icon settings icon on the left navigation pane, and then click Manage Team space.
  3. Click Webhooks.
    The TEMPLATES tab of Webhooks is displayed.
  4. Click the WEBHOOKS tab, and then click New Webhook.

    The New Webhook page is displayed.

  5. Enter a name for the webhook and paste the URL that you copied in the Webhook URL field.
    You must copy the URL while you configure your communication application.
  6. Click the Webhook resume policy, and then select a resume policy option from the drop-down list. You can select any of the following options:
    1. Queue old messages
    2. Discard old messages
  7. Click the Channel Type, and then select a channel type from the list.
  8. Enter a description for the webhook, and then select a template from the drop-down list.
    A corresponding event that you configured for the template is displayed in the Events field.
  9. Click the Templates icon template icon, to add the templates that are configured for the channel type.
    Note: If you want to change the events, then click the events option and select the required events.
  10. You can perform any of the following steps:
    1. Click move the template to a higher priority icon high priority to move the template to a higher priority.
    2. Click move the template to a lower priority icon low priority to move the template to a lower priority.
  11. Click Apply.
    The webhook is created and added to the WEBHOOKS tab.

Results

You have configured and created a team space webhook on Test Hub.

What to do next