Subscribe to request for entry updates

Send the result of each Employee Health Screening entry request to a third-party system by configuring a webhook.

Before you begin

Sending outbound webhook calls requires the following plugins.

• ServiceNow Integration Hub Runtime (com.glide.hub.integration.runtime)
• Workflow Studio Action Step - Payload Builder (com.glide.hub.action_step.payload)
• ServiceNow Integration Hub Action Step - REST (com.glide.hub.action_step.rest)

These plugins must be requested through the Now Support Service Catalog. For instructions, see Request a plugin.

When you set up the webhook, the system automatically sends a REST request to a third-party endpoint every time an employee or visitor requests entry. Work with an administrator for the third-party system to determine the correct endpoint to provide.

Note: The webhook does not include authentication headers in the request. Ensure that you provide an endpoint that includes query parameters to authenticate the request.

To learn more about the Employee Health Screening Request Entry module, see Conduct a health screen for entry.

Role required: sn_imt_core.admin or admin

Procedure

1. Navigate to All > Employee Health and Safety Status > Outbound Webhooks.

2. In the Webhook [sn_imt_core_webhook] table, click New.

3. On the form, fill in the fields.

var secureRandom = GlideSecureRandomUtil;
var secret = secureRandom.getSecureRandomString(30);
gs.log(secret);

1. Click Submit.

Result

The Employee Health Screening application sends request entry data to the third-party endpoint every time an employee requests entry. The JSON payload contains the following data.

{
  "event": "entry.requested",
  "email": "aileen.mottern@example.com",
  "username": "aileen.mottern",
  "user_id": "a8f98bb0eb32010045e1a5115206fe3a",
  "location": "San Antonio",
  "location_id": "108486c7c611227500b093211aa88dcc",
  "access_granted": false,
  "updated": "2020-07-01 22:19:03"
}