1. Function
Webex Teams is an application from Cisco for continuous team collaboration with video meetings, group messaging and file sharing. Topics or teams are organized in so-called spaces. You can also use such a space to receive notifications from Checkmk. For the actual connection a webhook must be created in Webex Teams.
2. Configuring Cisco Webex Teams
The prerequisite for receiving notifications from Checkmk in Webex Teams is therefore that at least one area (space) is set up. This can be done in a few seconds and is described in the Webex help: Webex App - Create a space.
For a first test, at any rate it is certainly a good idea to set up a dedicated area with an appropriate name just for Checkmk.
In Webex Teams the Incoming Webhooks app must now be activated or connected. You can find this app in the Webex App Hub.
Click on Connect on this page. (If you are not logged into Webex Teams with the browser you are using, the Cisco Webex login dialog will appear first.)
After a short waiting period, at first it looks as if not much has changed — but now, at the end of the input and selection fields, you can specify both a name for the webhook and the area to be used in Webex Teams. Finally click on Add.
Next, copy the webhook URL created in this way by clicking on the corresponding icon:
3. Configuration in Checkmk
You have already learned how to set up Checkmk notifications in general in the article about notifications.
As a reminder:
You can not only specify individual users and contact groups as recipients of the notifications. Instead, you can also define a ticket system or an event engine as the target of the notifications, for example. However, you must then take two factors into account when creating the notification rules:
Only a single user may be entered as a contact, i.e. neither a contact group nor an object contact, otherwise several notifications will be sent to the target system for each event.
If the first point is fulfilled, but this user is used in several notification rules that are of the same type (e.g. ServiceNow), then only the last rule applies in each case. It is therefore advisable to create a separate functional user for each of these notification rules.
The activation in Checkmk is now limited to the specification of the webhook URL copied above:
For the Notification Method select Cisco Webex Teams.
Enter the copied webhook URL.
Optionally, you may specify URL prefixes to control links on your Checkmk GUI within the notification. Instead of specifying the webhook URL directly here, you can also use Checkmk’s password store and read the URL from one of its entries.
For testing you can use the Fake check results and Custom notification commands.