Ozeki NG SMS Gateway logo OZEKI NG SMS Gateway
"The World's most reliable SMS gateway software!"
info@ozekisms.com
Tel.: +36 1 371 0150
SMS Gateway to send SMS via GSM modem or IP SMS connection Overview SMS Gateway to send SMS via GSM modem or IP SMS connection SMS Gateway to send SMS via GSM modem or IP SMS connection Quick start SMS Gateway to send SMS via GSM modem or IP SMS connection SMS Gateway to send SMS via GSM modem or IP SMS connection Download SMS Gateway to send SMS via GSM modem or IP SMS connection SMS Gateway to send SMS via GSM modem or IP SMS connection Manual SMS Gateway to send SMS via GSM modem or IP SMS connection SMS Gateway to send SMS via GSM modem or IP SMS connection How to buy SMS Gateway to send SMS via GSM modem or IP SMS connection SMS Gateway to send SMS via GSM modem or IP SMS connection FAQ SMS Gateway to send SMS via GSM modem or IP SMS connection SMS Gateway to send SMS via GSM modem or IP SMS connection Contact Us SMS Gateway to send SMS via GSM modem or IP SMS connection
OZEKI NG SMS Gateway - Product Guide

Cancel_sm Contents | SearchDynamic SMPP parameters

Home > Product Manual > Installation Guide > Service Provider Connections > SMPP connection > Optional SMPP parameters

SMS Gateway SMS Gateway Home

  Product Manual
  Introduction
  SMS technology
  Installation Guide
  Prerequisites
  Download Information
  Installation Steps
  Service Provider Connections
  GSM Modem connectivity
  SMPP connection
  FLASH
  System type
  Low level
  Short code
  Cancel_sm
  Optional SMPP parameters
  Dynamic SMPP parameters
  UCP Connection
  CIMD2 Connection
  HTTP Client connection
  HTTP Server connection
  Service providers
  Send MMS via MM7
  Receive MMS via MM7
  Send/receive MMS via EAIF
  SAG ParlayX SOAP/XML
  TDC
  SNPP Connection
  SMTP Connection
  HTTP Service Provider
  Users and applications
  Linux
  User Guide
  Developers Guide
  Examples and Solutions
  Appendix
  FAQ
  Feature list
  Commercial Information
  Search
  Cookie policy
 


Automated phone calls?
Ozeki Phone System XE VoIP PBX software is an advanced PBX built for automated voice calls and 2 way SMS messaging. It has outstanding APIs for software developers. It can be used for:

Phone calls from SQL
Phone calls from HTTP
Voice and SMS applications

Callcenter developers
If you are working on telephone solutions, please check out the Ozeki VoIP SIP SDK.
It can be used to create VoIP client and server software.

Contact Us!
If you wish to get further information, do not hesitate to contact us!

E-mail: info@ozekisms.com

If you have a technical question, please submit a support request on-line.

Optional SMPP parameters

On this page, you can read about what optional parameters are where they can be given and how they can be customized within the SMPP connection. This guide also gives a definition to what TLV field means and helps to carry out the customization of optional parameters.

In certain cases it is advisable to add extra parameters to SMPP connection. These parameters are inserted into TLV fields. The fill-out of these fields is only optional and depends on the service provider's requirements. Ozeki NG SMS Gateway supports the functionality of this solution. The following sections are going to demonstrate the use and features of TLV field and explain how to fill them out with optional SMPP parameters.

What does TLV stand for?

TLV is a data type, a structure which enables the addition of new parameters to SMPP PDU. TLV is the acronym of Tag Length Value. TLVs are often called 'optional fields'. The TLV extra parameters were added to the SMPP protocol in version 3.4. TLV's can be added as byte stream at the end of the standard SMPP PDU's. The first two bytes give the length of the parameter, the third and fourth byte indicate the value of the actual data which go directly after the set bytes.

General

You need to install Ozeki NG SMS Gateway as well as SMPP service provider to send SMS. After configuration the system may require more parameters to gain total functionality. The extra parameteres are called TLVs and they are used to maintain the optimal performance of the system.

Note: This solution is only available in Ozeki NG SMS Gateway v3.15.33 or above!

Customization

1. Send SMS with general customization of TLV parameters

If you customize your parameters according to the followings, all the messages sent through this SMPP connection will be sent out containing this optional field. After the configuration of SMPP connection further parameters can be set. Click on the Configure menu and select the Message submission tab. Fill in the Optional parameter box with the data as in the example in Figure 1.



Figure 1 - Optional parameter box


I send a test message afterwards (Figure 2).



Figure 2 - Test message


The success of configuration can be checked at the Events of SMPP service provider. At the end of the PDU you can view the customized parameters the same way as in Figure 3.



Figure 3 - TLV parameters in log

2. Customizing the optional parameters with each SMS

It is possible to set the optional parameter with each SMS. This way, it can be determined which TLV value is added to the PDU at the SMPP connection. There are two ways to pre-determine the optional field: Database user or HTTP API.

Database user

To determine the optional parameters install a Database user. After installation, log in Ozeki NG SMS Gateway and enter the Configure menu in Database user. The name of the field is already containing data. The data is placed after the "tlv_" part. This is the Tag of the TLV field. The data returned in this field will be the Value of the TLV. The Length of the customized TLV field will be calculated from the returned data. To customize the Database user click on the SQL for sending tab and type the "tlv_" keyword and the TLV tag's value into the Polling box as the example shows in Figure 4.



Figure 4 - TLV tag

In this example the SQL field name is "tlv_5721". The TLV Tag is 5721. The data returned in this SQL field is '38353334322213'. This will be the TLV Value. The TLV Length will be calculated from the TLV Value.

Enter SQL prompt and give an SQL query. An example is shown in Figure 5.



Figure 5 - SQL query


In the example the number in tlv_5721 is the TLV Tag, which has a Value,'38353334322213'. The Length is determined by the Value which is '0007'.


The success of configuration can be checked at the Events of SMPP service provider. At the end of the PDU you can view the customized parameters the same way as in Figure 6.



Figure 6 - Log message


HTTP API

Optional parameters can be requested in HTTP API as well. The customization of TLV parameters occurs the same way as in case of Database user. The "tlv_" is the TLV field containing the TLV Tag. The data returned is again the Value of the TLV and the Length is calculated from it. To do the customization insert an HTTP request into your browser. Below is an example.

HTTP request
http://127.0.0.1:9501/api?action=sendmessage&username=admin&password=abc123&recipient
=06301234567&tlv_5721=38353334322213&messagetype=SMS:TEXT&messagedata=Hello+world

You can see in the response (Figure 7) that the Ozeki NG SMS Gateway has accepted the message for sending.



Figure 7 - HTTP response in xml


The success of configuration can be checked at the Events of SMPP provider. At the end of the PDU you can view the customized parameters the same way as in Figure 8.



Figure 8 - TLV parameters in HTTP log message


In the example the number in tlv_5721 is the TLV Tag, which has a Value,'38353334322213'. The Length is determined by the Value '0007'.


Dig deeper!
People who read this also read...





Next page: Dynamic SMPP parameters
Copyright © 2000 - 2017 Ozeki Informatics Ltd.
All rights reserved

Software PBX for Windows | VoIP SDK   |   Legal information   |   Privacy policy   |   Terms of use
Please, address your inquiries to info@ozekisms.com