SMS Services

 

Checklist

Create a Service Policy for Transport Protocol Definition

Create a Service Policy for Vendor Connection

Create a Vendor Tariff

Upload Sending Rates to the Vendor Tariff

Create Vendors

Define a Connection

Create a Customer Tariff

Enter Rates to the Customer Tariff

Modify Usage Charges for a Product

Testing

 

Mobile operators make it possible for their users to exchange short text messages known as SMSs (Short Message Service). SMS messages are transported within mobile networks via the SMPP protocol.

 

With PortaSwitch®, you can enable your VoIP customers to send SMS messages to mobile networks. For example, let’s say your customer John Doe has his account registered on a soft phone (e.g. Linphone).

 

John’s friend Mark is now abroad, so his SIP account is offnet and he is therefore not accessible via the Internet. To congratulate Mark on his birthday, John sends him an SMS from his soft phone.

 

With PortaSwitch® you can also develop a custom application to bundle voice calls and messaging services (including both IM and SMS). This allows users of other networks (e.g. mobile) to register on your VoIP network, and thus expands your customer list.

 

This chapter demonstrates how to configure the basic SMS service so that in addition to voice calling and instant messaging services, your VoIP customers can send SMS messages.

 

Checklist

Print the following page and use it to check off the operations you have completed while performing the system setup according to the instructions in this chapter. Please be sure to perform all of the operations in the order designated (all of the boxes should be checked), otherwise the service will not work.

 

_Hint_ExclamationMark The checklist below assumes that you have already configured the instant messaging service as described in the Instant Messaging Services handbook.

 

 

Operation

 

Done

Network configuration

 

Create a service policy A. It determines the use of the SMPP protocol for the SMS service and is used for internal communications between PortaSIP® and the billing engine.

[     ]

Create a service policy B. It defines the specific parameters for the vendor connection. It is used to provision parameters required to connect to the off-net vendor

[     ]

Rating configuration (Vendor)

 

Create a tariff A, that describes your SMS aggregator’s transmission rates

[     ]

Enter rates in tariff A for the destinations your SMS aggregator transmits messages to

[     ]

Create a vendor for SMS transmission

[     ]

Create a connection for this vendor using tariff A and associate service policy B with it

[     ]

Rating configuration (Customer)

 

Create a tariff B, that describes your end users’ rates

[     ]

In tariff B, enter the rates for the destinations to which your customers will send messages

[     ]

Modify the product for the end users

[     ]

Create a rating entry for this product, using the PortaSIP® node, SMPP access code and tariff B

 

Create a rating entry for this product

[     ]

Testing

 

Registered your account on a soft phone (e.g. Linphone) and send an SMS.

 

[     ]

Create a Service Policy for Transport Protocol Definition

A service policy is a set of parameters that defines how the subsystems of PortaSwitch® must operate to provide the Messaging service.

 

At this point, it is necessary to create a service policy that defines the use of the SMPP protocol. This policy is used for the internal communication between PortaSIP® and the billing engine.

 

1.      In the Networking section of the admin interface, choose Service Policies.

2.      On the Service Policies page click Screen2 Add a new policy in the Messaging Service section.

 

Create a domain service policy

 

3.      Add the following attributes to the service policy:

·       Policy Name – Specify the name of the service policy.

·       Description – Provide a short text description of the service policy.

·       Match Priority – Specify 3 in this field.

·       Recipient domain pattern – Specify a pattern according to which the service policy is selected (% in our example). This means that the service policy is applied to all outgoing messages sent by your end users.

If you only allow end users to send SMSs to a specific mobile operator, specify the pattern as follows %XXX% (e.g. %380% for all mobile operators in Ukraine or %38050% for Vodafone Ukraine). Then when a user sends the message to 3805551122, PortaSIP® matches the pattern (e.g. 380) to select the corresponding service policy and sends the message to the SMS aggregator via the SMPP protocol.

·       External_routing – Choose Yes. This will allow you to send SMS messages to off net vendors.

·       Local_lookup – Choose No.

·       Outgoing_aaa – Choose the Yes option from the list to enable outgoing message authorization and billing.

·       Transport_protocol – Choose the SMPP option from the list.

·       Userpart_e164_translation – Choose Yes.

 

Add service policy for transport protocol definition

 

4.      Click save Save.

 

_Hint_ExclamationMark Note that any service policy changes will not be applied immediately. It will take several minutes until they are propagated to PortaSIP®.

Create a Service Policy for Vendor Connection

The service policy for a vendor connection defines the specific parameters for this connection. For these parameters to apply, the service policy must be associated with the corresponding vendor connection.

 

1.      In the Networking section of the admin interface, choose Service Policies.

2.      On the Service Policies page, click Screen2 Add a new policy in the Messaging Service section to add a new service policy.

 

Create a service policy for vendor connection

 

3.      Add the following attributes to the service policy:

·       Policy Name – Specify the name of the service policy.

·       Matching Priority – Leave this field empty.

·       Recipient domain pattern– Leave this field empty.

·       Description – Provide the short text description of the service policy.

·       Bind_as – Choose the transceiver option from the list for the option to send and receive messages.

·       Heartbeat_interval – Specify the interval (in seconds) in which ENQUIRE_LINK requests are sent to verify the connection. The default zero means no requests will be sent.

 

Configure a service policy for vendor connection

 

4.      Click save Save.

 

_Hint_ExclamationMark Note that any service policy changes will not be applied immediately. It will take several minutes until they are propagated to PortaSIP®.

Create a Vendor Tariff

This tariff will contain your SMS aggregator’s transmission rates.

 

1.      On the navigation menu to the left, select Service catalog and click Tariffs.

2.      On the Create tariff panel, fill in the tariff details:

 

Add a vendor tariff

 

o   Name – Type a short name for the tariff object; this is the name you will see in the select menus (i.e. SMS transmission costs).

o   Currency – Choose the currency in which the vendor charges you.

NOTE: The currency for the tariff may be chosen only once, and cannot be changed later.

o   Service – Choose Voice Calls here.

o   Format – Leave the default E.164 format. If your SMS provider supports the E.212 format, select E.212 from the list.

o   Applied to – Choose Vendor in the Applied to list.

o   Routing – Move the slider to enable the Routing.

 

3.      Click Save.

Upload Sending Rates to the Vendor Tariff

Upload per-destination sending rates provided by your SMS aggregator from a .CSV or .XLS file. As messaging services are charged per message, the rating parameters will be as follows:

 

o   Rate Codes – a mobile network prefix

o   Unit Price – price per message (e.g. $0.01)

 

Please consult the Rate Import section for more details.

 

timesaver Perform the Create Tariffand Enter Rates steps described above until you have created a tariff with termination costs for each transmission partner you have.

Create Vendors

1.      On the navigation menu, select Infrastructure, then select Vendors.

2.      On the Create vendor panel, fill in the vendor details:

o   Name – Type a short name for the vendor object; this will be used on the web interface (i.e Z-Mobile).

o   Currency – Choose the currency in which this vendor charges you.

o   Opening balance – This indicates a starting balance for the vendor; the default is zero.

o   Billing period – Split period for vendor statistics.

 

3.      Click Save.

 

Create a vendor

 

When a message is sent from your network to the vendor’s gateway, the vendor performs an authorization for the message. The vendor will provide you with a username and password to use for message authorization. These credentials should be stored with the “vendor authorization” info and then associated with a specific connection so that they can be used during actual message transmission.

 

4.      In this case, it is necessary to create an account for digest authorization of outgoing messages:

·       On your vendor’s panel (Z-Mobile), click General configuration, then click Authorization.

·       On the Authorization panel, click Add and enter the credentials provided by the vendor.

·       Click Save.

 

Configure vendor authorization

 

Define a Connection

This connection represents the point from which messages leave your network and are directed to the SMS provider where charges are incurred.

1.      On your vendor’s panel (Z-Mobile), click Connections.

2.      On the Create connection panel, fill in the connection details: 

·       Description –Type a descriptive name for this connection. It will be displayed in the list of connections.

·       Service type – Select Messaging service.

·       Type of connections – Select SMPP.

·       Tariff – Select the tariff that defines your termination costs for this connection/vendor (SMS transmission costs).

·       Active – Use the slider to set this connection as active.

 

Connextion for SMS service

 

·       Enter the Gateway ID (the IP address of the vendor’s SMS gateway).

·       Port – Specify the port of the SMS provider’s gateway through which SMS will be delivered to this provider. The default SMPP port is 2775.

·       Select the corresponding service policy for this connection from the Service Policy list.

3.      Click Save.

 

4.      On the Connection panel, select General configuration.

5.      On the General configuration panel, select the vendor authorization that you have created (SMS) from the Vendor authorization list.

 

Add vendor authorization

 

6.      Click Save.

Create a Customer Tariff

 

This tariff will contain your customer’s rates for sending SMS.

 

1.      On the navigation menu to the left, select Service catalog and click Tariffs.

2.      On the Create tariff panel, fill in the tariff details:

 

Create a customer tariff

 

o   Name – Type a short name for the tariff object; this is the name you will see in the select menus (i.e. SMS costs).

o   Currency – Indicates the currency in which you charge your customers.

NOTE: The currency for the tariff is chosen only once and cannot be changed later.

o   Service – Choose Messaging service here.

o   Format – Leave the default E.164 format.

o   Applied to – Select Customer in the Applied to list.

o   Managed by – Select Administrator only.

 

3.      Click Save.

Enter Rates to the Customer Tariff

Add rates to the customer tariff

 

1.      On the Tariff panel, fill in the Add rate details:

·       Rate Codes – A destination prefix may be entered directly (e.g. 4206 for the Czech Republic Mobile) or you can access the destinations directory by clicking the Rate Codes link (in the column header). Here you will find the desired prefix by country name.

NOTE:  You should create an entry for certain rate codes in the Destination register before creating a rate for them in the tariff.

·       Unit Price – Price per message (e.g. $0.025).

 

2.      Click Save.

3.      Repeat these steps if you need to enter more rates.

Modify Usage Charges for a Product

To allow your customers to use the service, it is necessary to include it in the services configuration for the appropriate products. Since our example assumes that voice calls and instant messaging services have already been configured for the product, it is only necessary to add a ration entry for the SMS.

 

 

1.        On the navigation menu to the left, select Service catalog and click Products.

2.        Select the product that you wish to modify.

3.        On the Product panel, click Charges, Usage Charges and then click Add:

·       Select Messaging service from the Service list.

·       Select the PortaSIP® node in the Node field.

·       Type SMPP in the Access code field.

·       In the Tariff field, select the tariff that applies to your customers for sending SMS (e.g. SMS costs).

 

Add a rating entry for SMS

 

4.        Click Save.

 

Save the product

 

Now your SIP subscribers who have this product can send SMS in addition to VoIP and Instant messaging services.

Testing

Configure the messaging client as described in the Instant Messaging Services handbook and send an SMS.