How do I set up a webhook on my account?

Webhooks are a great way to receive real time events to a url endpoint based on the use cases you require.

We require that you use a https web server for your endpoint. Zapier (webhooks) and other similar services offer endpoints for webhooks that you can use or you can develop your own. Make sure it has at least SSL encryption.

Adding a default Webhook

Once you have set up the endpoint for the webhooks, copy the url and go to the Webhooks section of the platform. Click create a new webhook. The simplest is just a global webhook that sends all events. 

Adding webhook

URL end points need to be unique. Two webhooks cannot have the same url - but it can be different sub directories of a url.

There are six kinds of events of webhooks:

  1. Network Logs - when a SIM registers, authenticates or de-registers to a network.
  2. Data usage - per SIM is updated every 15 minutes of activity or when a SIM de-registers from a network.
  3. Device SMS - when a device sends a SMS to any number.
  4. SMS usage - separately for both outgoing and ingoing 
  5. Location (approximate) - of a SIM at the beginning and end of a session and when the location changes during a session.
  6. Usage alerts - when a device reaches a usage alert threshold (optional) or is blocked by usage limit

Editing a webhook

It is easy to also edit a webhook. When the webhook changes have been saved, the webhook will change and the new update will come into effect.

Customizing Webhooks for use cases

IoT deployments can quickly become large. Receiving all events for all SIMs and altering it on the backend requires developer time and resources. Taking advantage of Tags, webhooks can be customized for specific uses.

Adding webhook

Some of the many examples of use:

  • tracking network-logs in a test country
  • catching SMS error codes from a legacy device
  • monitoring events of a development kit to help monitor how it is functioning
  • mapping location events of a specific product

What is the data being sent?

You can find more information on the data structure for the different events in the webhooks section of the documentation.

If you have any further questions, you are welcome to send to support@onomondo.com.