Integrations
There are many ways to notify you about the fact that an alert has occurred in TeamViewer Remote Management (TV RM).
The default notification types are phone call, SMS, and email messages. TeamViewer Remote Management has also developed integrations with third party systems, such as Webhook, and others will be added in the near future.
Webhook
What is a webhook?
A webhook is a HTTP POST JSON format request that TeamViewer Remote Management sends to the URL of your choosing when a certain alert occurs. This request is accompanied by a payload of data in the body of the POST directly related to the alert. A webhook with a state change is triggered when a monitor or a check changes its state from OK to Failed and the opposite as well.
With webhooks it is easy to connect your TV RM alerts data with multiple applications. Webhooks work on an alert based output mechanism. It allows you to streamline and manage your critical TV RM alerts in almost any third-party application.
How to setup?
To setup a webhook integration it requires you to first get a Webhook URL of the desired third-party service. Once you have the Webhook URL, follow the steps below to integrate TV RM alerts data with other third-party applications using Webhooks:
1. Log in to the TeamViewer (Classic) Management Console - https://login.teamviewer.com/LogOn
2. Navigate to Remote Management > Overview > Contact Book > Add Integration
3. Select Webhook in the integration types drop-down list
4. Add the Alias and provide the Hook URL
5. Click Add
6. Confirm the Webhook by entering the 6-digit confirmation code
Now you have a new Webhook contact that will allow a connection to another third-party application.
How to use webhooks?
If you are connecting to a third-party system, the third-party system is expecting the incoming Webhook (e.g., the data sent from your app to that system) to use a message format to process it.
If you already have a Webhook contact, you can now configure your Webhook alerts to integrate your Remote Management solution with other third parties by using a service like Zapier.
Zapier is a universal application that allows a connection to thousands of web apps by creating Zaps. Zap is a workflow that connects apps, so that they can work together. Zaps join multiple third-party apps by enabling a trigger and an action; finally it helps to automate tedious tasks throughout the workflow.
How to set up a Zap
1. Log in to your Zapier
2. Click on the Make a Zap button
3. Select Webhooks by Zapier from the list of supported apps
4. Select Catch Hook or Catch Raw Hook and click Continue
5. Copy the custom Webhook URL and use it to set up a Webhook contact in the Remote Management Contact Book – (see How to setup? section above)
6. Click the Test your trigger button to get the 6-digit confirmation code to use to activate the Webhook contact
7. Now that you have an active Webhook contact which is already connected with a Zap, you can select the third-party app you want to push your alert messages to, for example Slack or others.
Examples of Webhook JSON output
{
"AlarmStart": "2021-Apr-04 17:48:50 UTC",
"Details": "Given remote host could not be resolved",
"FailuresFrom": "DE (Munich), AT (Vienna)",
"MonitorCollections": "Test Monitor Collection",
"MonitorName": "Daniel' Sensor",
"MonitorType": "Uptime",
"Protocol": "HTTP",
"RequestMethod": "GET",
"URL": "http://sdifvndafgfaudnsnfd.com"
}