connection.org.status.change event

This event tracks the number of status changes across an entire organization.  It will fire when the number of status changes specified in the threshold exceeds the number of status changes (activations, deactivations, and so on) that have occurred during the time period.  This event is evaluated hourly to determine if the thresholds have been reached, thus there is no real-time configuration of this event.

Example use cases:

  • To track if more than 100 activations occur during the last 24 hours.
  • To track if more than 100 deactivations occur during the current billing month.

 The connection organization status change event is triggered when the number of status changes for connections exceeds a specified threshold.

Form

Parameters

Name Type Required Description
Time period String Yes

Month to date - Evaluate the usage of the connection in the current billing month.

Last time period - Evaluate the usage since the last X amount of time in seconds (s), minutes (m), hours (h) or days (d).

Status String Yes

The status of the connection to use in the evaluation, can be one of the following (depending on carrier):

  • Activated
  • Deactivated
  • Ready
  • Testing
  • Retired
Number of status changes to trigger Number The number of status changes that need to occur during the defined time period for the specified status to cause this event to fire.
Notification frequency String Yes The frequency that this event will re-execute once the condition is met. Setting this value to 7d means that after the condition is met, the trigger will not fire again until 7 days pass and the condition is true again. The format is a number followed by m (minutes), h (hours), d (days). The maximum period is 30 days. Examples: 24h, 7d, 30d, 120m.
Filter MCC/MNC Integer   It allows filtering the usage change results by MCC/MNC

Event variables

Name
Type
Description
$(event.threshold) Number The threshold that was configured by the user.
$(event.transitions) Number The number of status transitions that triggered the event to fire.
$(event.since) String The beginning of the time range evaluated to determine the usage. If the "Last period" was configured as "7d", then "since" will be 7 days prior to the current date.
$(event.ts) String The timestamp of the connection status change that initiated this trigger.