Connectivity management events

Learn about events generated by Transatel connectivity management system

Introduction

The connectivity management system generates events related to your subscribers lifecycle. If your offer includes IoT specificities, additional events may be emitted. They can then be pushed to your platform by creating webhooks using the Webhooks API. Integrating those events can allow you to trigger any necessary logic, for example send end-user notifications or facilitate your workflows.

To discover how to integrate connectivity management events, please refer to our integration guide.

Source information in events

All connectivity management events provide information about the source system which triggered the event as well as the user login accountable for the event.

The source and createdBy information can be one of the following:

SourceCreated byDescription
api<your api login>The event has been triggered by a request submitted via API
webtool<your user login>The event has been triggered by a request submitted in SIM management portal
ftpftp_userThe event has been triggered by a request submitted via file on FTP server
systemsystemThe event has been triggered by TSL platform

⚠️ Please be aware that in the below diagrams, we removed the event prefix CONNECTIVITY-MANAGEMENT/ in order to improve readability.

Events on subscribers

SUBSCRIBER/PREACTIVATED
SUBSCRIBER/ACTIVATED
SUBSCRIBER/ACTIVATED
SUBSCRIBER/SUSPENDED
SUBSCRIBER/REACTIVATED
SUBSCRIBER/TERMINATED
SUBSCRIBER/TERMINATED
Pre-Activated
Available
Active
Suspended
Terminated

Events emitted during the life of a subscriber

Events on IoT subscribers

SUBSCRIBER/ACTIVATED
SUBSCRIBER/ACTIVATED
SUBSCRIBER/REACTIVATED
SUBSCRIBER/HOLIDAY/EXITED
SUBSCRIBER/TERMINATED
SUBSCRIBER/TERMINATED
SUBSCRIBER/TERMINATED
SUBSCRIBER/TERMINATED
SUBSCRIBER/SUSPENDED
SUBSCRIBER/TEST_MODE/EXITED
SUBSCRIBER/HOLIDAY/ENTERED
SUBSCRIBER/HOLIDAY/ENTERED
SUBSCRIBER/SUSPENDED
SUBSCRIBER/REACTIVATED
Tariff_Holiday
Available
TestMode
Active
Suspended
Terminated

Events emitted during the life of an IoT subscriber

Other events may occur for activated subscribers until their termination:

Non lifecycle eventsDESCRIPTION
CONNECTIVITY-MANAGEMENT/SUBSCRIBER/MODIFIEDChanges in subscriber's options or contact information
CONNECTIVITY-MANAGEMENT/SUBSCRIBER/MSISDN/SWAPPEDMSISDN swap
CONNECTIVITY-MANAGEMENT/SUBSCRIBER/SIMCARD/SWAPPEDSIM card swap

Subscriber events

Below is the list of all available subscriber events.

Subscriber pre-activation event

This event informs that a SIM card has been pre-activated and a subscriber created.

Event information:
Event type definitionCONNECTIVITY-MANAGEMENT/SUBSCRIBER/PREACTIVATED
Applicable forAvailable SIM card when pre-activation is enabled

Subscriber activation event

This event informs that either an available SIM card or a pre-activated subscriber has been activated.

Event information:
Event type definitionCONNECTIVITY-MANAGEMENT/SUBSCRIBER/ACTIVATED
Applicable forAvailable SIM card or Pre-Activated subscriber

Subscriber modification event

This event informs that the subscriber's rate plan, options or contact information have been modified.

Event information:
Event type definitionCONNECTIVITY-MANAGEMENT/SUBSCRIBER/MODIFIED
Applicable forActive, TestMode or Suspended subscriber

Subscriber suspension event

This event informs that a subscriber has been suspended, hence, its SIM card is not able to attach to the network anymore.

Event information:
Event type definitionCONNECTIVITY-MANAGEMENT/SUBSCRIBER/SUSPENDED
Applicable forActive or TestMode subscriber

Subscriber reactivation event

This event informs that a previously suspended subscriber has been reactivated.

Event information:
Event type definitionCONNECTIVITY-MANAGEMENT/SUBSCRIBER/REACTIVATED
Applicable forSuspended subscriber

Subscriber SIM card swap event

This event informs that a subscriber's SIM card was swapped to a new one. The SIM card serial number in the event is one of the newly swapped card.

Event information:
Event type definitionCONNECTIVITY-MANAGEMENT/SUBSCRIBER/SIMCARD/SWAPPED
Applicable forActive or Suspended subscriber

Subscriber MSISDN swap event

This event informs that a subscriber's MSISDN was swapped to a new one. The MSISDN in the event is one of the newly swapped number.

Event information:
Event type definitionCONNECTIVITY-MANAGEMENT/SUBSCRIBER/MSISDN/SWAPPED
Applicable forActive or Suspended subscriber

Subscriber terminated event

This event informs that a subscriber has been permanently terminated. The SIM card has been terminated as well and the related MSISDN cannot be used on the network anymore.

Event information:
Event type definitionCONNECTIVITY-MANAGEMENT/SUBSCRIBER/MSISDN/TERMINATED
Applicable forActive, TestMode, Tariff_Holiday orSuspended subscriber

IoT subscribers events

Below is the list of subscriber events, dedicated to those which have an IoT lifecycle.

Subscriber enter tariff holiday event

This event informs that a subscriber has entered a tariff holiday period. Tariff holiday periods always begin at the beginning of bill cycles, which are defined to the 1st day of the month. Thus, this event is to be expected the 1st of each month if the subscriber has been requested to enter holiday period during the previous month.

Event information:
Event type definitionCONNECTIVITY-MANAGEMENT/SUBSCRIBER/HOLIDAY/ENTERED
Applicable forActive or TestMode subscriber

Subscriber exit tariff holiday event

This event informs that a subscriber has exited a tariff holiday period. The exit can be caused by an explicit request, or because there's no more remaining days allowed for the tariff holiday period.

Event information:
Event type definitionCONNECTIVITY-MANAGEMENT/SUBSCRIBER/HOLIDAY/EXITED
Applicable forSubscriber in Tariff_Holiday

Subscriber exit test mode event

This event informs that a subscriber has exited the test mode. The exit can be caused by an explicit request, or because either its network usage has crossed the allowed threshold or the test mode period is over.

Event information:
Event type definitionCONNECTIVITY-MANAGEMENT/SUBSCRIBER/HOLIDAY/EXITED
Applicable forSubscriber in TestMode