We are hiring! See our vacancies
2 min. read
Joris Bloemen
Last update: 14-05-2021

Expand your services using Webhooks

Trigger webhooks from the IXON Cloud

Instead of pulling machine data from the IXON Cloud (using the API) you can push messages instantly & securely to any external application using webhooks.

What are webhooks?

A webhook (also called a web callback or HTTPS push API) is a way for an application to provide external applications with real-time information. Unlike typical APIs, where you would need to poll for data very frequently in order to get it real-time, a webhook delivers data to these applications as it happens, meaning you get data immediately.

This makes webhooks much more efficient for both provider and consumer. Webhooks are sometimes referred to as “Reverse APIs,” as they give you what amounts to an API spec, and you must design an API for the webhook to use. The webhook will make an HTTP request to your app (typically a POST), and you will then be charged with interpreting it.

Commonly used webhook platforms are Zapier, IFTTT, PagerDuty and hook.io. These platforms are connected to all major cloud platforms to set up easy integrations.

Why webhooks?

As you might know, the IXON Cloud is an open SaaS platform. This means you can connect any third party application to the IXON Cloud using the API (like Tableau) or webhooks. Use it when you want more flexibility, no lock-in or to take advantage of tools with more specialized features.

With the webhook feature, you expand your service options with triggers to external applications when something in your industrial device or machines occurs.


How to use webhooks in IXON Cloud

The IXON Cloud collects all IXrouter/IXagent device messages in the message centre, like transfers. Any machine alarms (triggered by the Cloud Notify feature) are also added to this message centre. Any message can be sent out using the webhooks feature.
The use of webhooks is totally free. To send out machine alarms you need a Cloud Notify licence.

Add a new webhook in your IXON Cloud account (messages section) using the name and webhook URL. This URL is provided by the external application you want to connect.

Apply any filters, like the priority of the message (high, medium, low), the company or message content, and choose if you want to trigger the webhook or not.

After configuration, the webhook is automatically triggered, real-time, in case of a new message.

Webhook machine alarm example code in JSON format

See below an example of a JSON message which is sent when an alarm is triggered by the IXON Cloud. This message contains all the info of the alarm and can be used in your external application.

{ "userName": "John Doe", "alarmRateLimitTill": null, "extraInfo": { "Device ID": "abdCiM0wfg9V", "GPIO": "True", "Device name": "Test Router" }, "shortContent": "Test Alarm of Demo Router was triggered at 5/21/19, 4:21 PM", "companyId": "1111-2222-3333-4444-5555", "systemLabel": "alarm-high", "createdOn": "2019-05-21T14:21:21", "companyName": "Test Company", "userId": "zkufaLacdLRr", "longContent": "Instructions: Please notify a developer to fix this issue" }


Trigger intelligent responses to critical machine malfunctions using PagerDuty

PagerDuty is an example of how to efficiently apply webhooks to inform your service team about machine issues.

With the webhook integration, you create intelligent response automation via PagerDuty, triggered by IXON Cloud alarms, to mobilize responders, engage stakeholders and send status updates.

When an incident is added to PagerDuty you can trigger a chain of responders. Send SMS messages or automated calls to inform someone immediately. When the message is unopened or the call unanswered, you can automatically try the next one in the chain.

The benefits: Act faster, provide better service and solve a problem before it is too late. Apply new business models or make more money by upgrading your SLA response times. Or offer it to your customers as an additional service.

Example usage of webhooks in an emergency scenario

Imagine that you are working in the food industry and your food is heated in an industrial oven. You don’t want to spoil any food because it is highly valuable. So the temperature of the oven should be constant to preserve the best results.

To monitor the temperature, and prevent peaks and valleys, you use the IXrouter to transmit the oven data real-time to the IXON Cloud. Configure an alarm, like when the temperature is above 200° or below 180°, and trigger a webhook for PagerDuty when this alarm is triggered. You can also log the values periodically in IXON Cloud or PagerDuty for analyses.

Create a response automation chain in PagerDuty to inform the service operator on duty to stop the food processing and fix the issue immediately. In case of no response, any other service employee will be informed to prevent any waste.

Other webhooks usage examples for IXON Cloud

Zapier is a service which contains a lot of cloud applications you can integrate with. Create a webhook in Zapier and connect any application to it. Some examples:

  • Reports and logging: create a Google Chat or Slack message for your service team or log any alarm in Google Sheets for reporting.
  • SMS: send an SMS immediately when an alarm appears.
  • Service desk & To-do lists: create a new ticket for your support team or use this to predict maintenance.


Get more out of your machines using webhooks

Benefit from ready to use machine features to upgrade your services and act faster when machine problems occur. Try IXON for free!

((Create your free IXON Cloud account)) or request the IXrouter evaluation kit.