Soracom Event Handler

Overview

The Event Handler feature is a service that allows you to build automations based on SIM events, such as when a SIM status changes or when its data usage exceeds a particular threshold, in order to send email notifications, throttle or disable a SIM, execute a webhook, and so on. Event handlers can be applied to a single subscriber, a SIM that contains one or more subscriptions, a group of SIMs, or to all SIMs in your account.

Parameters

Each event handler consists of the following configuration parameters:

• Name and Description - Any name or description to identify the event handler.
• Target - Defines which SIMs or subscribers the event handler should apply to.
• Rule - Defines a condition that should be evaluated. When this condition is met, the actions will be performed.
• One or more Actions - Defines what actions should be performed when the event handler rule condition is met.
• Status - Enables or disables the event handler.

You can also use Variables with certain actions in order to dynamically change the value of the action parameter, such as using ${simId} to include the SIM ID of the matched SIM in an email notification or webhook.

Limitations

• If you configure multiple event handlers and their respective rule conditions are met at the same time, the actions of both event handlers will be executed.
• When the target of an event handler is set as a group, the rule condition will be evaluated for each individual SIM or subscriber belonging to the group, rather than to all SIMs or subscribers collectively.
• Each event handler is limited to a maximum of 5 actions.
• Each Soracom account is limited to the following number of event handler configurations: