Release

Search

SMS services

Link copied to clipboard

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

Link copied to clipboard

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

Link copied to clipboard

Perform the steps described in the Instant messaging services handbook.

Create a service policy for transport protocol definition

Link copied to clipboard

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. On the navigation menu on the left, select Service catalog and click Service policies.
  2. 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.
  3. Click Save.

    Create a service policy

  4. 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.
  5. 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.

      Enable the attributes

  6. 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

Link copied to clipboard

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. On the navigation menu on the left, select Service catalog and click Service policies.
  2. 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.
  3. Click Save.

    Create a service policy for vendor connection

  4. 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.

      Configure a service policy for vendor connection

  5. 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

Link copied to clipboard

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

  1. On the navigation menu on the left, select Service catalog and click Tariffs.
  2. On the Create tariff panel, fill in the tariff details:

    Add a vendor tariff

    • 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.
  3. Click Save.

Upload sending rates to the vendor tariff

Link copied to clipboard

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.

timesaver 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

Link copied to clipboard
  1. On the navigation menu, select Infrastructure, then select Vendors.
  2. 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.
  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

Link copied to clipboard

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.
    • 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.

      Connection 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

Link copied to clipboard

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

  1. On the navigation menu on the left, select Service catalog and click Tariffs.
  2. On the Create tariff panel, fill in the tariff details:

    Create a customer tariff

    • 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.
  3. Click Save.

Enter rates to the customer tariff

Link copied to clipboard
  1. 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). Add rates to the customer tariff
  2. Click Save.
  3. Repeat these steps if you need to enter more rates.

Modify usage charges for a product

Link copied to clipboard

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 on 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

Link copied to clipboard

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

On this page

Release
What's new
Admin manuals
Handbooks
API
UI help
Search