...

Anchor

	top
	top

Excerpt

hidden	true

Learn to work with Conax Contego SMS Services

...

Conax Contego is a TV platform that streams content to Digital Video Broadcasting to digital video broadcasting (DVB), Internet Protocol Television internet protocol television (IPTV) and Overand over-Thethe-Top top (OTT) based subscriptions.

CRM.COM provides a ready-made implementation of Conax Contego SMS Services Protocol, using the Conax Contego Subscriptions Management System (SMS) Services protocol and uses the Conax Contego SMS Services Provisioning provisioning module, which is primarily responsible for handling handles the activation and deactivation of signals transmitted to devices. The module can also be used to send messages to the subscriber subscribers through their devices.

Major features

Integration to Conax Integration with Conax Contego 2.0 SMS SMS.
Activation Simultaneous activation and deactivation of multiple subscriptions simultaneously.
Errors are logged and can be reviewed within Logging and review of errors from the CRM.COM Softwaresoftware.
Sending of messages Ability to message multiple subscribers simultaneously
Requests not submitted to Conax, can be reviewed through an error file while taking the necessary actions to update CRM.COM accordingly
Usage of utilities to handle one subscription at a time at once.
Utilities can be used to manage individual subscriptions (e.g., to pair devices or send messagesOption to archive old provisioning requests. For more information ).
Archiving of former provisioning requests (refer to Utilities for more information).

Using Conax Contego SMS Services

The Conax Contego SMS Services implementation submits requests on the Conax Contego system asynchronously using FTP.
- Subscription actions update the subscription provisioning state.
- Provisioning Requests run identifies all request runs identify the subscriptions whose provisioning state must be updated in CONAX Contego system and creates create 'Pending' requests.
- 'Pending' requests coming from CRM CRM.COM requests are grouped together into in a file which that is then subsequently transferred through to CONAX Contego system through FTP in order to be processed.
Conax provides uses 'Error Handling' runs to provide CRM.COM with 'Accepted' and or 'Rejected' requests to CRM.COM through 'Error Handling' runs and . CRM.COM subscriptions are subsequently updated accordingly.

Image RemovedImage Added

Setting Up Conax Contego SMS Services

Info

icon	false

Billing > Provisioning > Conax Contego SMS Services > Set Up Provisioning Provider

Provisioning

...

provider

Include Page

	Provisioning Provider
	Provisioning Provider

Operations Parameters

Maximum Number Of of Records in Each File: The maximum number of client IDs that can be included in each file , which cannot exceed 20000 (the default value set automatically if no other value is specified).Renewal Frequency in Months: A subscription sent to CONAX SMS always has an end date (calculated using the (20000 by default)

Add Subscription End Period in Months).
To ensure that a subscription will not be deactivated once the end date is reached a 'Renewal request' must be sent.
Define how often the renewal of each subscription should be handled. It defaults to '1' and cannot exceed '35'.Add Subscription End Period in Months: The period to calculate the end date of a subscription service : A value between 1 (default) and 36, used when a request is sent to activate a subscription, to calculate the end date of the services.

Renewal Frequency in Months: A values between 1 (default) and 35, which determines how often each subscription should be renewed.

Renew Subscription End Period in Months: A value between 1 (default) and 36, used when a request is sent to activate it. If not specified, it defaults to '1' and it cannot exceed '36'renew a subscription, to calculate the end date of the services.

Cancel Subscription End Period in Months: The period A value between 1 (default) and 36, used to calculate the end date of the deactivation . months used to and set the Cancel Subscription End Date. If not specified, it defaults to '1' and it cannot exceed '36'.

Note
A subscription request sent to CONAX SMS must always contain a predefined end date, calculated using the Add Subscription End Period in Months. A 'renewal request' must be sent (from CRM to Conax) so that the subscription is not deactivated once the end date is reached (Renewal Frequency in Months). The Renew Subscription End Period in

months: The period

Months will be used to calculate the

subscription's

new end date of the subscription once the

'

Renewal request

'

is sent.

If not specified, it defaults to '1' and it cannot exceed '36'.

Back to top

Related configuration areas

Include Page

	Provisioning - Related Configuration Areas
	Provisioning - Related Configuration Areas

Back to top

...

Using Batch Processes to Handle Subscriptions

Info
Billing > Provisioning > Conax Contego SMS Services

...

Handling rejected requests

...

Once Provisioning requests resulting from the provisioning processing run is executed, the respective provisioning requests are sent to Conax through FTP, remain in a 'Pending' life cycle state.

Once Conax is updated it creates the responses for updated, Conax responds to CRM.COM (i.e. such as reports on whether requests have been rejected or have failed).
, reporting whether each request was rejected or failed. CRM.COM is then subsequently synchronized to Conax Contego based on these responses which are handled by Error Handling Files Runs reverting changes done to subscriptions .

The responses are handled by 'error handling file runs', which in case of an error in Conax, revert changes on subscriptions.

Error Handling handling file runs are created through the ' error handling files run definition' , once it is submitted.

Sending mail & bark messages

...

The table describes the sections of 'the mail and bark messages run definition ' Data Entry page, and and explains how the fields in the page are used.

Mandatory Configurable

Main Information

Name & , Alternative Code

Input Settings

Message Type:The type of the message that will be sent, which can be 'Mail Message' or 'Bark Message'.

Communication Queue External System: The Communication Queue External System that will be system used to identify which the 'Pending' communications must to be processed by the run.

Sequence: The sequence that should be used to send the message. This is the order by which the messages will be handled by Conax.
If not specified, then the System defaults to '255'.Duration in Seconds: Defines the duration in seconds for which bark messages appear on the subscriber's screen. If not specified, then the system defaults to '20' A value between '1' and '255' (default) that determines the order in which Conax will handle the messages.

Duration in Seconds of bark messages on the screen of the subscriber ('20' by default).

Process Immediately: Determines if whether the request will be is sent directly to Conax, or created and processed subsequently by during the provisioning request processing run.

Back to top

...

Using Utilities to Handle a Subscription

Info
Billing > Provisioning > Conax Contego SMS Services

Utilities are used to handle one subscription at a time.

...

Pairing smartcards and set-top boxes (STB)

...

Include Page

	Provisioning - Pair Smartcards & STBs
	Provisioning - Pair Smartcards & STBs

Specify the smartcard and the STB which that should be paired. If the selected smartcard or the smartcard and STB are already paired, then the existing paired device pair is automatically loaded. Select Set the Priority to 'Express' Priority if you need , so that Conax handles the pairing to be handled by Conax as soon as possible.

Note
If the request is successful then each the 'Installed item subscription provisioning distribution' Initialized field is updated by setting the 'Item is initialized' to 1to 'Yes'.

Back to top

...

Sending mail & bark messages

...

Include Page

	Provisioning - Send Mail Messages
	Provisioning - Send Mail Messages

.
Start by selecting the Type of message to be sent and provide the rest of Provide the required information. Unlike Message Runs, no Communication is related to messages that are sent through the utility as the text to be included in the message , starting with the type of message to be sent.
There is no related Communication as the message text is provided through the utility (unlike message runs).
Main Information
Message Type: The type of the message that will be sent, which can be 'Mail Message' or 'Bark Message'.
Smartcard: The smartcard that should receive the message.
Text: The text which will be sent through the messageSequence: Defines the sequence that should be used to send the message. If not specified then the system Defaults to '255'. (message)
Sequence: A value between '1' and '255' (default) that determines the order in which Conax will handle the messages.
Display Duration in Seconds: Defines the duration in seconds for which of bark messages will appear in the STB. If not specified, then the system defaults to on the screen of the subscriber ('20' by default).
Back to top
Anchor
commands
commands
Conax Contego SMS
...
Requests
...
The table below displays the CRM.COM processes that trigger each Conax Contego SMS Services command (a request) requests, as well as the parameters sent sent for each each request.
Activation and deactivation commands are not directly triggered by the execution of Subscription Actions. Once the Provisioning Request Processing Run Definition is executed, the system is checked against the logic available under subscription actions.
...
Once the 'provisioning request processing run definition' is executed, system conditions available under the Trigger Logic column , and must be met, in order for the respective Conax Contego command is created, provided the necessary conditions are met.
...
Conax Contego SMS Services Command
to be created.

Send
Request
Use
Triggered by
Trigger Logic
Command Parameters
ADD_SUBSCRIPTIONAdd Subscription
Activates subscription services
Conax Contego SMS APIs
Provisioning request processing run

Has There is at least one 'Effective' or 'Short Term Effective' subscription service, which is not authorized¹.
The subscription provisioning distributor linked with to the subscription service
The subscription service CA ID
The smartcard CA smartcard CA ID.
CANCEL_SUBSCRIPTIONCancel Subscription
Deactivates subscription services
Conax Contego SMS APIs
Provisioning request processing run

Has at There is at least one 'Not Effective', 'Regretted', 'Swapped', 'Removed', 'Cancelled', 'In Resting' or 'Short Term Not Effective' subscription service, which is authorized¹.
The subscription provisioning distributor linked with to the subscription service
The subscription service CA ID
The smartcard CA ID.
RENEW_SUBSCRIPTIONRenew Subscription
Renews subscription services
Conax Contego SMS APIs
Provisioning request processing run

Has There is at least one 'Effective' or 'Short Term Effective' subscription service, which is authorized¹.
The subscription provisioning distributor's authorization date AND the 'Renewal Frequency' defined in the Provider's configuration is less than or equal to the current date.
The subscription provisioning distributor linked with to the smartcard (if applicable)
The smartcard and STB CA ID
The subscription provisioning distributor linked with to the STB (if applicable).

CREATE_PAIRINGCreate Pairing Pairs Smartcards and STBs
Conax Contego SMS APIs
Pair smartcards & STB utilityHas at
There is at least one 'Effective' or 'Short Term Effective' subscription service distributed to at least one smartcard or STB, which is not initialized².
The subscription provisioning distributor linked with to the smartcard (if applicable)
The smartcard and STB CA ID
The subscription provisioning distributor linked with to the STB (if applicable).
SEND_MESSAGE
Send Message
Sends messages to subscribers
Mail & Bark message utility
Mail & Bark message run
Provisioning request processing run
For requests through the mail & bark definition:
Entries exist There are entries in the communication queue in a 'Pending' life cycle state.
External The external system of the provider is equal to the External System one specified on in the Mail & Bark Message Run Definitionrun definition.
The related communication is classified as 'Outgoing'.
The related communication refers to a subscription or notification having the subscription in the notification Informationinformation.
The subscription provisioning distributor linked with to the smartcard
Smartcard CA ID
Text that will be sent to the subscriber
Type of Message which can be message ('Mail' or 'Bark')
Communication queue number processed by the provisioning request (if applicable)
Sequence The sequence that should be used to send the message. This is the order by which the messages will be handled by Conax.
The duration in seconds that the Bark bark message will be shown displayed on the screen of the subscriber's screen.
Info
1. 'Authorized' is a field kept in CRM.COM for every subscription service which that represents its state at the provider.
authorized Authorized = active Active (1)
not Not authorized = inactive Inactive (0)
2. 'Initialized' is a field kept in CRM.COM for every installed item which that represents its state at the provider.
initializedInitialized = registered Registered (1)
not Not initialized = not Not registered (0)

Back to top
Conax Contego SMS Services Business Examples
...
Subscriptions with multiple viewing points
Panel
name blue
title Provisioning Distributors
Scenario 1
Company ZX offers to its customers the option to have multiple viewing points per for each subscription. This enables its customers to Customers can have a separate 'box and card' pair in each of the roomsroom, and choose between having the same channels or different channels available through boxes. The maximum number of viewing points that to have a different selection of channels available from each pair. Up to four viewing points can be added to a subscription is 4.
Solution
For each set of box and card that will be made available to subscribers, CRM.COM must have a different provisioning distributor available , in order to set the for each pair (box and card) offered to subscribers, as channel availability and restrictions per can be set separately for each box.
To support this, the following distributors must be set up in the Provisioning Providerprovisioning provider.
Main
TWIN1
TWIN2
TWIN3
Back to top
...
Sending mail messages to subscriber
...
boxes
Panel
name blue
title Conax Web Services 'Mail & Bark Messages' Utility
Scenario 2
Company ZX would like wants to send personalized messages to its subscribers , that will be directly accessible via their Set-Top Boxes (STBs). Specifically, it wants to be able to send:
Messages that can be accessed via the subscriber's STB inbox.
Messages that are shown on the subscriber's
that are:
Directly accessible through their set-top boxes (STBs)
Displayed on their TV.
Solution
Agents should use the "'Mail & Bark Messages Utility" and ', select the appropriate type type of message for each of the above method of communication. The agents should type and provide the message that they would like to send to the subscriber.
Messages that can be accessed via their through subscriber's STB inbox
Mail Message
Messages that are shown on their subscriber's TV
Bark Message
Note
title Notes
If you are using a previous release, view CRM.COM Release Changes.
Use the WEB API to create and manage Conax Contego SMS Services provisioning requests from an external system. Refer to the Conax Contego SMS Services WEB API for a comprehensive list of available actions.
Back to top

Glossary
Stands for system), which DVB and is a IPTVStands for Over The Top and is media FTP.
CRM.COM Term DefinitionCA
Conditional Access ( CA) A system (in this case is Conax Contego) that provides content to subscribers through their devices.
Mail Message A message sent by the provider to the customer, that which appears in the Setset-Top Box top box (STB) mailbox , either when it is received or at a specific predetermined time.
Bark Message A message sent by the provider to the customer, that which appears directly on the screen , either when it is received or at a specific predetermined time. Stands for
Digital Video Broadcasting (DVB) A suite of internationally accepted open standards for digital television.
Internet Protocol Television (IPTV) A system that delivers television content using the internet Protocolprotocol, instead of the traditional terrestrial or satellite signal.
Over-the-top (OTT ) Media content, such as audio or video, which that is delivered over the internet with no intervention from the service Providerprovider. Stands for
File Transfer Protocol
Provisioning State
The provisioning state of a Subscription service (i.e. a channel) that can be either 'Active' or 'Inactive'.
'Active' State: Provisioning signals are sent to the subscriber's device.
'Inactive' State: No Provisioning signals are sent to the subscriber's device.
(FTP) The standard network protocol used for the transfer of computer files between a client and server on a computer network. (Wikipedia)
Service CA ID or Provisioning ID The An ID that is used in Conax Contego to identify The a subscription service for which signals should be sent to the subscriber's device(channel) that should be handled (added, activated, deactivated, removed).
Panel
name grey
Related Links
Filter by label (Content by label)
showLabels false
spaces V4Manual
showSpace false
labels global

Versions Compared

Old Version 7

New Version Current

Key

Major features

Using Conax Contego SMS Services

Setting Up Conax Contego SMS Services

Provisioning

provider

Related configuration areas

Using Batch Processes to Handle Subscriptions

Handling rejected requests

Sending mail & bark messages

Using Utilities to Handle a Subscription

Pairing smartcards and set-top boxes (STB)

Sending mail & bark messages

Anchor
commands
commands
Conax Contego SMS

Requests

Conax Contego SMS Services Business Examples

Subscriptions with multiple viewing points

Sending mail messages to subscriber

boxes

Glossary

Related Links

Request	Use	Triggered by	Trigger Logic	Command Parameters
ADD_SUBSCRIPTIONAdd Subscription	Activates subscription services	Conax Contego SMS APIs Provisioning request processing run	Has There is at least one 'Effective' or 'Short Term Effective' subscription service, which is not authorized¹.	The subscription provisioning distributor linked with to the subscription service The subscription service CA ID The smartcard CA smartcard CA ID.
CANCEL_SUBSCRIPTIONCancel Subscription	Deactivates subscription services	Conax Contego SMS APIs Provisioning request processing run	Has at There is at least one 'Not Effective', 'Regretted', 'Swapped', 'Removed', 'Cancelled', 'In Resting' or 'Short Term Not Effective' subscription service, which is authorized¹.	The subscription provisioning distributor linked with to the subscription service The subscription service CA ID The smartcard CA ID.
RENEW_SUBSCRIPTIONRenew Subscription	Renews subscription services	Conax Contego SMS APIs Provisioning request processing run	Has There is at least one 'Effective' or 'Short Term Effective' subscription service, which is authorized¹. The subscription provisioning distributor's authorization date AND the 'Renewal Frequency' defined in the Provider's configuration is less than or equal to the current date.	The subscription provisioning distributor linked with to the smartcard (if applicable) The smartcard and STB CA ID The subscription provisioning distributor linked with to the STB (if applicable).
CREATE_PAIRINGCreate Pairing	Pairs Smartcards and STBs	Conax Contego SMS APIs Pair smartcards & STB utilityHas at	There is at least one 'Effective' or 'Short Term Effective' subscription service distributed to at least one smartcard or STB, which is not initialized².	The subscription provisioning distributor linked with to the smartcard (if applicable) The smartcard and STB CA ID The subscription provisioning distributor linked with to the STB (if applicable).
SEND_MESSAGE	Send Message	Sends messages to subscribers	Mail & Bark message utility Mail & Bark message run Provisioning request processing run	For requests through the mail & bark definition: Entries exist There are entries in the communication queue in a 'Pending' life cycle state. External The external system of the provider is equal to the External System one specified on in the Mail & Bark Message Run Definitionrun definition. The related communication is classified as 'Outgoing'. The related communication refers to a subscription or notification having the subscription in the notification Informationinformation.	The subscription provisioning distributor linked with to the smartcard Smartcard CA ID Text that will be sent to the subscriber Type of Message which can be message ('Mail' or 'Bark') Communication queue number processed by the provisioning request (if applicable) Sequence The sequence that should be used to send the message. This is the order by which the messages will be handled by Conax. The duration in seconds that the Bark bark message will be shown displayed on the screen of the subscriber's screen.

CRM.COM Term	DefinitionCA
Conditional Access (	CA)	A system (in this case is Conax Contego) that provides content to subscribers through their devices.
Mail Message	A message sent by the provider to the customer, that which appears in the Setset-Top Box top box (STB) mailbox , either when it is received or at a specific predetermined time.
Bark Message	A message sent by the provider to the customer, that which appears directly on the screen , either when it is received or at a specific predetermined time.	Stands for
Digital Video Broadcasting	(DVB)	A suite of internationally accepted open standards for digital television.
Internet Protocol Television (IPTV)	A system that delivers television content using the internet Protocolprotocol, instead of the traditional terrestrial or satellite signal.
Over-the-top (OTT	)	Media content, such as audio or video, which that is delivered over the internet with no intervention from the service Providerprovider.	Stands for
File Transfer Protocol
Provisioning State	The provisioning state of a Subscription service (i.e. a channel) that can be either 'Active' or 'Inactive'. 'Active' State: Provisioning signals are sent to the subscriber's device. 'Inactive' State: No Provisioning signals are sent to the subscriber's device.
(FTP)	The standard network protocol used for the transfer of computer files between a client and server on a computer network. (Wikipedia)
Service CA ID or Provisioning ID	The An ID that is used in Conax Contego to identify The a subscription service for which signals should be sent to the subscriber's device(channel) that should be handled (added, activated, deactivated, removed).

Page Comparison

Versions Compared

Old Version 7

New Version Current

Key

Major features

Using Conax Contego SMS Services

Setting Up Conax Contego SMS Services

Provisioning

provider

Related configuration areas

Using Batch Processes to Handle Subscriptions

Handling rejected requests

Sending mail & bark messages

Using Utilities to Handle a Subscription

Pairing smartcards and set-top boxes (STB)

Sending mail & bark messages

AnchorcommandscommandsConax Contego SMS

Requests

Conax Contego SMS Services Business Examples

Subscriptions with multiple viewing points

Sending mail messages to subscriber

boxes

Glossary

Related Links

Anchor
commands
commands
Conax Contego SMS