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
Use this checklist 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.
Operation |
Done |
General configuration |
|
Perform the configuration of the instant messaging service as described in the Instant messaging services handbook. |
|
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. |
Configure the instant messaging service
Perform the steps described in the Instant messaging services handbook.
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.
- On the navigation menu on the left, select Service catalog and click Service policies.
- On
the Create service policy panel, fill in the service policy details:
- Name – specify the name of the service policy (for example, SMS).
- Service type – select Messaging service from the list.
- 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.
- Click Save.
- On the Service policy panel that opens, specify 3 in the Match priority field. If several service policies are selected for the message processing, the one with higher match priority will be applied.
- Go
to the Attributes panel, select Processing messages over SIP/SMPP
and enable the following attributes:
- External routing – select a checkbox and use a slider to enable this attribute. This will allow you to send SMS messages to off net vendors.
- Outgoing AAA – select a checkbox and use a slider to enable outgoing message authorization and billing.
- Transport protocol – select a checkbox and choose SMPP from the list.
- Userpart E164 translation – select a checkbox and use a slider to enable this attribute.
- Click
Save.
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.
- On the navigation menu on the left, select Service catalog and click Service policies.
- On
the Create service policy panel, fill in the service policy details:
- Name – specify the name of the service policy (for example, Messaging service).
- Service type – select Messaging service from the list.
- Recipient domain pattern – leave this field empty.
- Click Save.
- On
the Service policy panel that opens, go to the Attributes
panel, select Processing messages over SIP/SMPP and enable the
following attributes:
- Bind as – select a checkbox and choose the transceiver option from the list for the option to send and receive messages.
- Heartbeat interval – select a checkbox and 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.
- Click
Save.
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.
- On the navigation menu on the left, select Service catalog and click Tariffs.
- On
the Create tariff panel, fill in the tariff details:
- 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).
- Currency
– choose the currency in which the vendor charges you.
The currency for the tariff may be chosen only once, and cannot be changed later.
- Service – choose Messaging Service here.
- Format – leave the default E.164 format. If your SMS provider supports the E.212 format, select E.212 from the list.
- Applied to – choose Vendor in the Applied to list.
- Routing – move the slider to enable the Routing.
- 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:
- Rate codes – a mobile network prefix
- Unit price – price per message (e.g., $0.01)
Please consult the Rate import section for more details.
Perform the Create Tariff and Enter Rates steps described above until you have created a tariff with termination costs for each transmission partner you have.
Create vendors
- On the navigation menu, select Infrastructure, then select Vendors.
- On
the Create vendor panel, fill in the vendor details:
- Name – type a short name for the vendor object; this will be used on the web interface (i.e Z-Mobile).
- Currency – choose the currency in which this vendor charges you.
- Opening balance – this indicates a starting balance for the vendor; the default is zero.
- Billing period – split period for vendor statistics.
- Click
Save.
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.
- In this case, it is necessary to create an account for digest authorization of outgoing messages:
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.
- On your vendor’s panel (Z-Mobile), click Connections.
- 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.
- 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.
- 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.
- Click Save.
- On the Connection panel, select General configuration.
- On the General configuration panel, select the vendor authorization that you have created (SMS) from the Vendor authorization list.
- Click Save.
Create a customer tariff
This tariff will contain your customer’s rates for sending SMS.
- On the navigation menu on the left, select Service catalog and click Tariffs.
- On
the Create tariff panel, fill in the tariff details:
- Name – type a short name for the tariff object; this is the name you will see in the select menus (i.e., SMS costs).
- Currency
– indicates the currency in which you charge your customers.
The currency for the tariff is chosen only once and cannot be changed later.
- Service – choose Messaging service here.
- Format – leave the default E.164 format.
- Applied to – select Customer in the Applied to list.
- Managed by – select Administrator only.
- Click Save.
Enter rates to the customer tariff
- On
the Tariff panel, fill in the Add rate details:
- Rate
codes – a destination prefix may be entered directly (e.g., 42060
for the Czech Republic Mobile) or you can select it from the drop down
list.
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).
- Rate
codes – a destination prefix may be entered directly (e.g., 42060
for the Czech Republic Mobile) or you can select it from the drop down
list.
- Click Save.
- 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.
- On the navigation menu on the left, select Service catalog and click Products.
- Select the product that you wish to modify.
- On the Product panel, click Charges, Usage charges and then click Add:
- Click Save.
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.