Configuring a project webhook

You can configure a project webhook to send notifications to a messaging application whenever an event occurs on HCL OneTest™ Server.

Before you begin

You must have completed the following tasks:

About this task

When you configure a webhook on HCL OneTest™ Server, 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 project webhook is disabled due to communication failures or network issues, the project 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 project webhook is enabled again.

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

Procedure

  1. Log in to HCL OneTest™ Server.

    The team space that contains your project is displayed.

  2. Click Active projects > My projects > project_name to open the project that contains the test assets.

    The Overview page of the project is displayed.

  3. Click Manage > Webhooks in the navigation pane.
    The Webhooks page 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

      The Queue old messages is selected as the default option.

  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 template icon 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 project webhook on HCL OneTest™ Server.

What to do next

You can perform any of the following tasks: