Configuring a server webhook

You can configure a server 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 server webhook is disabled due to communication failures or network issues, the server 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 server webhook is enabled again.

If you configure the Discard old messages for a server webhook, the event notifications are discarded from the moment the webhook is disabled. Only server 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 the Settings icon settings icon on the menu bar, and then click Webhooks.
    The TEMPLATES tab of Webhooks is displayed.
  3. Click the WEBHOOKS tab, and then click New Webhook.

    The New Webhook page is displayed.

  4. 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.
  5. 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
  6. Click the Channel Type, and then select a channel type from the list.
  7. 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.
  8. 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.
  9. 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.
  10. Click Apply.
    The webhook is created and added to the WEBHOOKS tab.

Results

You have configured and created a server webhook on HCL OneTest™ Server.

What to do next

You can perform any of the following tasks: