Enable webhooks for alerts in Control Hub in webex
The alerts can be set up to appear in third-party applications by setting up a webhook callback URL.
Overview
There is an Alerts Center feature on the Control Hub that gives you access to a variety of alerts associated with Webex events across your deployment, and allows you to create, manage, and receive alerts through a variety of delivery channels. At the moment, the alert center supports the following delivery channels for delivering messages: email, Webex App spaces, and the Control Hub.
A new delivery channel is now being added to the mix with the introduction of webhooks. In IT service management (ITSM) tools, webhooks are an easy way for admins to consume alerts generated by different collaboration apps, ticketing systems, and custom dashboards, as well as any other application that is capable of receiving webhooks.
A webhook callback URL can be specified by the administrator in the Control Hub. In the rules for new or existing alerts, you have the option to choose the webhook option as an additional delivery channel after providing a callback URL. The following steps will guide you through the process of configuring webhooks.
For a webhook alert, here is an example of what the JSON elements look like in the webhook’s JSON:
{
"orgId": "1ab23cde-4567-890f-1234-gh56ijk07l891",
"title": "title",
"summary" : "notification for a test alert",
"actionUrl" : "www.actionURL.com",
"severity" : "HIGH",
"eventType" : "created",
"resourceType": "ControlHubAlerts",
"type": "Meeting",
"subtype": "Live Meeting Monitoring",
}
Set up a webhook callback URL
In order to enable rules that use webhooks, you need to add a webhook callback URL first.
- It is possible to access the Organization settings in https://admin.webex.com from the customer view.
- In the Alerts section, scroll to the bottom of the page.
- Add the Webhook URL you want to use as the callback URL under Webhook callback URL.
A secure token can also be added as a parameter to the webhook if you so desire. For more information about secure tokens, please view this blog post.
Save the file by clicking the Save button.
Enable webhook in a rule
In order to use webhooks as a delivery channel, you will first need to set up a webhook URL, which you can then use to set up rules.
- Click on the Manage button in the Alerts center when you are logged in to the customer view at https://admin.webex.com.
- Select a rule from the list of rules under the All rules tab.
- You can check the Webhook checkbox in the Delivery Method section of the page.
- Click Save.