Connectivity management events

Learn about events generated by Transatel connectivity management system

Introduction

The connectivity management system generates events related to your subscribers lifecycle and their eventual portability from/to another network operator. 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.

The source information can be one of the following:

SourceDescription
apiThe event has been triggered by a request submitted via API
webtoolThe event has been triggered by a request submitted in SIM management portal
ftpThe event has been triggered by a request submitted via file on FTP server
systemThe 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 for subscribers

Subscriber lifecycle

Events emitted during the life of a 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

Events for IoT subscribers

IoT Subscriber lifecycle

Events emitted during the life of an IoT subscriber

Events about portability

FR portability

Port in

Port in lifecycle

Events emitted during the port in of a subscriber

Port out

Port out lifecycle

Events emitted during the port out of a subscriber

UK portability / switch

Port in

Port in lifecycle

Events emitted during the port in of a subscriber

Switch in

Switch in lifecycle

Events emitted during the switch inf a subscriber

Port out

Port out lifecycle

Events emitted during the port out of a subscriber

Switch out

Switch out lifecycle

Events emitted during the switch out of a subscriber

Subscriber events

Below is the list of all available subscriber events.

Subscriber pre-activation event

This event occurs when 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 occurs when 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 occurs when 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 occurs when a subscriber has been suspended, hence, their 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 occurs when 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 occurs when 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 occurs when 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 occurs when 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/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 occurs when 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 occurs when 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 occurs when a subscriber has exited the test mode. The exit can be caused by an explicit request, or because either their network usage has crossed the allowed threshold or the test mode period is over.

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

FR portability events

Below is the list of FR portability events.

Port in eligibility event

This event occurs when an ingoing portability request has been declared eligible.

Event information:
Event type definitionCONNECTIVITY-MANAGEMENT/PORTABILITY/FR/PORT_IN/ELIGIBILITY_OK
Applicable forActive or Suspended subscriber

Port in GOP event

This event occurs when an ingoing portability request has received a GOP.

Event information:
Event type definitionCONNECTIVITY-MANAGEMENT/PORTABILITY/FR/PORT_IN/GOP
Applicable forActive or Suspended subscriber

Port in completion event

This event occurs when an ingoing portability has been completed successfully.

Event information:
Event type definitionCONNECTIVITY-MANAGEMENT/PORTABILITY/FR/PORT_IN/DONE
Applicable forActive or Suspended subscriber

Port in cancellation event

This event occurs when an ingoing portability request has been canceled.

Event information:
Event type definitionCONNECTIVITY-MANAGEMENT/PORTABILITY/FR/PORT_IN/CANCELED
Applicable forActive or Suspended subscriber

Port in rejection event

This event occurs when an ingoing portability request has been declared not eligible.

Event information:
Event type definitionCONNECTIVITY-MANAGEMENT/PORTABILITY/FR/PORT_IN/ELIGIBILITY_KO
Applicable forActive or Suspended subscriber

Port out eligibility event

This event occurs when an outgoing portability request has been declared eligible.

Event information:
Event type definitionCONNECTIVITY-MANAGEMENT/PORTABILITY/FR/PORT_OUT/ELIGIBILITY_OK
Applicable forActive or Suspended subscriber

Port out GOP event

This event occurs when an outgoing portability request has received a GOP.

Event information:
Event type definitionCONNECTIVITY-MANAGEMENT/PORTABILITY/FR/PORT_OUT/GOP
Applicable forActive or Suspended subscriber

Port out completion event

This event occurs when an outgoing portability has been completed successfully.

Event information:
Event type definitionCONNECTIVITY-MANAGEMENT/PORTABILITY/FR/PORT_OUT/DONE
Applicable forActive or Suspended subscriber

Port out cancellation event

This event occurs when an outgoing portability request has been canceled.

Event information:
Event type definitionCONNECTIVITY-MANAGEMENT/PORTABILITY/FR/PORT_OUT/CANCELED
Applicable forActive or Suspended subscriber

Port out rejection event

This event occurs when an outgoing portability request has been declared not eligible.

Event information:
Event type definitionCONNECTIVITY-MANAGEMENT/PORTABILITY/FR/PORT_OUT/ELIGIBILITY_KO
Applicable forActive or Suspended subscriber

UK portability / switch events

Below is the list of UK portability or switch events.

Port in network attach request event

This event occurs when an ingoing portability request is waiting for a subscriber attachment on the receiver operator network.

Event information:
Event type definitionCONNECTIVITY-MANAGEMENT/PORTABILITY/UK/PORT_IN/ATTACH/REQUESTED
Applicable forActive or Suspended subscriber

Port in network attach receive event

This event occurs when an ingoing portability request has seen an attachment from the subscriber on the receiver operator network.

Event information:
Event type definitionCONNECTIVITY-MANAGEMENT/PORTABILITY/UK/PORT_IN/ATTACH/RECEIVED
Applicable forActive or Suspended subscriber

Port in request validation event

This event occurs when an ingoing portability request has been validated.

Event information:
Event type definitionCONNECTIVITY-MANAGEMENT/PORTABILITY/UK/PORT_IN/VALIDATED
Applicable forActive or Suspended subscriber

Port in completion event

This event occurs when an ingoing portability has been completed successfully.

Event information:
Event type definitionCONNECTIVITY-MANAGEMENT/PORTABILITY/UK/PORT_IN/DONE
Applicable forActive or Suspended subscriber

Port in cancellation event

This event occurs when an ingoing portability request has been canceled.

Event information:
Event type definitionCONNECTIVITY-MANAGEMENT/PORTABILITY/UK/PORT_IN/CANCELED
Applicable forActive or Suspended subscriber

Port in network attach failure event

This event occurs when an ingoing portability request has not seen attachment from the subscriber to the receiver operator network in time.

Event information:
Event type definitionCONNECTIVITY-MANAGEMENT/PORTABILITY/UK/PORT_IN/ATTACH/FAILED
Applicable forActive or Suspended subscriber

Port in request invalidation event

This event occurs when an ingoing portability request has been invalidated.

Event information:
Event type definitionCONNECTIVITY-MANAGEMENT/PORTABILITY/UK/PORT_IN/INVALIDATED
Applicable forActive or Suspended subscriber

Switch in network attach request event

This event occurs when an ingoing switch request is waiting for a subscriber attachment on the receiver operator network.

Event information:
Event type definitionCONNECTIVITY-MANAGEMENT/PORTABILITY/UK/SWITCH_IN/ATTACH/REQUESTED
Applicable forActive or Suspended subscriber

Switch in network attach receive event

This event occurs when an ingoing switch request has seen an attachment from the subscriber on the receiver operator network.

Event information:
Event type definitionCONNECTIVITY-MANAGEMENT/PORTABILITY/UK/SWITCH_IN/ATTACH/RECEIVED
Applicable forActive or Suspended subscriber

Switch in request validation event

This event occurs when an ingoing switch request has been validated.

Event information:
Event type definitionCONNECTIVITY-MANAGEMENT/PORTABILITY/UK/SWITCH_IN/VALIDATED
Applicable forActive or Suspended subscriber

Switch in completion event

This event occurs when an ingoing switch request has been completed successfully.

Event information:
Event type definitionCONNECTIVITY-MANAGEMENT/PORTABILITY/UK/SWITCH_IN/DONE
Applicable forActive or Suspended subscriber

Switch in cancellation event

This event occurs when an ingoing switch request has been canceled.

Event information:
Event type definitionCONNECTIVITY-MANAGEMENT/PORTABILITY/UK/SWITCH_IN/CANCELED
Applicable forActive or Suspended subscriber

Switch in network attach failure event

This event occurs when an ingoing switch request has not seen attachment from the subscriber to the receiver operator network in time.

Event information:
Event type definitionCONNECTIVITY-MANAGEMENT/PORTABILITY/UK/SWITCH_IN/ATTACH/FAILED
Applicable forActive or Suspended subscriber

Switch in request invalidation event

This event occurs when an ingoing switch request has been invalidated.

Event information:
Event type definitionCONNECTIVITY-MANAGEMENT/PORTABILITY/UK/SWITCH_IN/INVALIDATED
Applicable forActive or Suspended subscriber

Port out request validation event

This event occurs when an outgoing portability request has been validated.

Event information:
Event type definitionCONNECTIVITY-MANAGEMENT/PORTABILITY/UK/PORT_OUT/VALIDATED
Applicable forActive or Suspended subscriber

Port out completion event

This event occurs when an outgoing portability request has been completed successfully.

Event information:
Event type definitionCONNECTIVITY-MANAGEMENT/PORTABILITY/UK/PORT_OUT/DONE
Applicable forActive or Suspended subscriber

Switch out request validation event

This event occurs when an outgoing switch request has been validated.

Event information:
Event type definitionCONNECTIVITY-MANAGEMENT/PORTABILITY/UK/SWITCH_OUT/VALIDATED
Applicable forActive or Suspended subscriber

Switch out completion event

This event occurs when an outgoing switch request has been completed successfully.

Event information:
Event type definitionCONNECTIVITY-MANAGEMENT/PORTABILITY/UK/SWITCH_OUT/DONE
Applicable forActive or Suspended subscriber