OZEKI

Quick start
Download
Manual
How to buy
Contact
Sign in
Create Account

Ozeki 10 SMS Gateway

Overview | SMPP server

SMPP client
This guide is about SMPP client connection setup. It
defines what an SMPP client connection is, what
does SMPP stand for and how you can use an SMPP
client connection to connect your Ozeki SMS
gateway system directly to the Short Message
Service Center (SMSC) of a mobile network operator
over the Internet.

What does SMPP stand for?

SMPP stands for Short Message Peer-to-Peer Protocol.
This is an industry standard protocol designed to deliver
SMS messages over TCP/IP connections through the
Internet. This protocol is implemented by Ozeki SMS
Gateway.

What is an SMPP client?

An SMPP client is a software that allows you to connect
to an SMS service provider on the Internet. An SMPP
client, such as Ozeki SMS Gateway, uses the SMPP
protocol to send and receive SMS text messages.

How to connect an SMPP

Client (Quick steps)
To connect an smpp client:

1. Open https://localhost:9515 in your browser

2. Login using your username and password
3. Click on "Add new connection"
4. Select "SMPP client"
5. Enter the smpp host name and port
6. Enter the telephone number
7. Click ok to connect the smpp client
8. Chech the smpp logs
9. Send a test sms

How to send SMS through

an SMPP client
This system works in a way that the user gives their
computer instructions on sending a message (Figure 1).
The computer forwards this information to an SMS
Centre. This is done through an SMPP (Short Message
Peer-to-Peer Protocol) client connection. The SMSC then
sends the text message to the recipients' mobile devices.

Figure 1 - How to send SMS through an SMPP client

How to setup an SMPP

client connection using
Ozeki SMS Gateway (video
tutorial)
The following short video shows the steps you need to
take to setup an SMPP client connection in Ozeki SMS
Gateway what works in any country. The video starts with
the login form, and takes you all the way to sending your
first text message as a test over the newly created SMPP
client connection.

Detailed smpp setup

instructions
Setting up an smpp SMS connection in Ozeki SMS
Gateway is a relatively simple procedure. You need to
login to the SMS gateway using a web browser as
administrator, and you need to perform a few simple
steps. For configuration we recommend to login using the
administrator account. The administrator account
username is "admin", and the password is the one you
provided during install.

OZEKI10

Login
admin

http://192.168.112.166.9505
Version:10.1.13
©2000-2018OzekiLtd.(www.ozeki.hu)

Figure 2 - Logging in to Ozeki 10 for SMPP client connection setup

How to create a new SMPP

client connection
To create a new SMPP client connection after login, you
need to click on the 'Add new connection' link in the
management console of the Ozeki 10 SMS Gateway app.
This link is located in the Connections panel below the
text "No connections are installed..." (Figure 2). This link
will bring up a list of available protocols. Note that SMPP
is an SMS protocol that can be used to send SMS
messages.

IOZEKI10(192.168.112.166) X +

••C©localhost:9505/SMS+Gateway/?a=Home

SMSGateway-192.168.112.166

"Edit ServiceproviderconnectionsUsersandapplications-View•Help

介 ※
Home New CARISAGE onnect ROUSS Annana

Connections (Add IncomingeA

Noconnectionsareinstalled.Tocommunicate,youneedtoinstallatleastoneconnection.Clickonthelinkbellow! N°Routename From
1.defin_admin Any_S
Addnewconnection
Addnewroute...

Figure 3 - Create a new SMPP client connection

To install the SMPP client connection, you will have to

select SMPP client from the available connections list.
The SMPP client can be found in the IP SMS
Connections section (Figure 3). You need to click install
to install the SMPP client. You will use a client
connection because you wish to connect the SMS
gateway to an SMS service provider over the Internet. (If
you wish to provide an SMS service, and you want your
customers to connect to your SMS gateway over SMPP,
you need to setup an SMPP user account and you need
to configure an SMPP service.)

Select the 'SMPP client' from the list and click on install.

Figure 4 - Installing the SMPP client connection

Configure your SMPP client

connection
In order to configure your SMPP client connection, you
need to provide the host name and port number of the
SMPP service, your SMPP credentials and your must
specify telephone number associated with this
connection. There could be more than one phone
numbers associated with this connection. In this case
provide the first one and check the overridable checkbox.
If this checkbox is checked, you will be able to use all
phone numbers as sender IDs.

To configure an smpp client:

Select the General tab

Scroll to the smpp client config form
Give a name to this smpp client connection
Enter the smpp hostname
Set the smpp port number
Provide your smpp username
Type your password
Assign a sender id to this smpp client
Click OK

Figure 5 - Providing SMPP Client credentials

It is important to mention that the SMPP hostname and

port plus the username and password are provided by
your SMS service provider. For example if you contact
Vodafone, and ask for an SMPP SMS service, you will
sign a contract with them, and often an attachment of this
contract will contain the connection following information.
If you subscribe to an SMS service on-line, you will likely
find this information in the on-line control panel of your
SMS service provider. Of course you can always ask your
SMS service provider in e-mail and ask what are the
SMPP server connection details.

Smpp host:

The smpp host is the host name of the IP address the

SMPP client uses to connect to the SMPP server. This is
the IP address (or host name) of the SMPP server.

Smpp port number:

The smpp port number is the TCP IP port number of the

SMPP client uses to connect to the SMPP server. This
port number is where the server is listening for incoming
SMPP connections.

Smpp username:

The smpp username is the smpp system id. This

identifier is provided by the SMPP server operator when
you sign up to their service.

Smpp password:

The smpp password is the password that is used to

authenticate your smpp account on the SMPP server.
This password is provided to you by the SMPP server
operator (or SMPP service provider) when you sign up to
their service.

Smpp telephone number:

The smpp telephone number is the smpp sender ID. This

is the phone number that is displayed on the mobile
phone as the sender address, when your SMS messages
is received.

Check the SMPP log

Once the SMPP client connection is configured, you
should check the SMPP client connection log to see if the
system connected properly to your SMS service provider.
If the system connected properly you will see the
"Connection online" log entry. The SMS connection logs
can be found in the following directory in Windows:
C:\Program Files\Ozeki\Data\Logs\Connections\. In this
Event tab of the SMPP client connection's details page,
you can see a preview of the log. This page contains the
last 100 log entries. Note that the SMPP log files are
rotated to save disk space.
How to view the SMPP client connection log:

Open the SMPP client connection's details page

Click on the Events tab
Click on the eye icon next to the Events title
Copy the file name next to the Events title
Open notepad
Paste the filename into the File/Open dialog in notepad
Click OK to open the SMPP log file
Use F3 to find the date you are interested in
Search for "ERRO" to find errors in the log

X
_OZEKI10(192.168.85.125) X +

C ©localhost.9515/SMS+Gateway/?a=connection_details&ConnectionID=SMPP_client_1%40localhost&refreshrequest=HAFECFO)

SMSGateway-192.168.85.125-Trialversion.Clickheretopurchasealicense. admin

OZEKIFI
.ServiceoroviderconnectionsUsersandapolications •veyahelc

介
Management Messages
SMPP_client_1 SMPP_client_1details
Test Test Configure Help Events Powers PDUDecoder

contigure Events®
2020-07-1009:27:97.007ANEOSMeECAlent:Contagurationupdated.Reguestingconnect/dasconnect.
더Help 2020-07-1809927997.507718303019
ellent
2020-07-1809:27:47.607INFOSMEP_client_i:Connectingso121.0.0.1:9550.
2020-07-18 03:27:47.001ENNESTE cliene:contagurationupdated.Requestingconnect/assconnect..
ClEvents

2026--1⅜8:37189:386번주장아나트륨양하도
2020-07-1809927:50.23480SU: econneccioncomnco127.0.0.199550,05Covonorescao13nTa?co

_client_-:Disconnected.Connectiondownto'121.0.0.1:9550' yoCOuLdMOyGo
2020-07-16 09:27:30.234ANEOSOFFellent, -:vasconnected-27.0.0.2:9990
Connection
2020-67-1889127159.231HaRoSvElchient-
2020-07-1809:27:50.234INFOSMEP. iconnectinaco127.060.1195506

_client_-:Connectiondownto'121.0.0.1:9550'.0SCouldnotestablishTCPco
Name:
SMPP_cient_1 09:27:31.091ERKOSMEE clsent D48COnNEOUE0.COANEOUCAGONNUO127.0,0,488500605COu-GHOUEB
SMPPclient
TuDe:

connection:
2020-37-1889127:54.891INFoSMer-chient-
202080797809177137789740109975 :013connect00727.0.0.89550

_ellent_-:Connectingto127.0.0.1:9550
2020-07-1809:27:54.339 WARNSMPP
-Ci4eRE-: connecuzonconvo 1127.0.0.1:95501 OSCouldnotescablishICPco

2020-37-1808127:54.339ENroSMer-chient-1:Basconnected27.2.8:1.5580мso'127.9.0.119550%,05Ceuildnotes*
2020-07-1809:27:54.339ERROSMPP.
Connectto:127.0.0.1:9550
username: smoT
2020-07-1809:27:54.339INFO
SSL: 2020-07-1809:27:56.091WARNSMPP.
Ready(?) cileno:Disconnecreo,Conneccioncommco127.001:9550,05covonores

Speed: 0,00MPM(?) 2020-07-1809:27:56.091INFOSMPP. _1:Disconnected127.0.0.1:9550

2020-07-1809:23:06.150INEOSMPR -tlReepconnectson,Reconnectreguestedbecauseconnecusenseemsve
CLient:connectino0127.060.199950
Receivedcertificate 2020-07-1809:29:06.507330SME
Connectedfrom127.0.0.1:51681€o127.0.0.1:9550
(2020-07-1009:28:06.150INEOSUPP <-000000300000000900000000000000017369703100717765313233004F5A654
2020-67-1889125106. 150INFOSMERchient-
Stteaes:si9999eg99099g0:90000090000000091332543333353335:385300
Folders 2020-07-1809:29:06.150830309 SuccesefulLogin.
2020-07-1009:20:06.150INEOSMPPOlLendascomecuzo.onaane
*Accepted(0/0) 2020-07-18 09:24806.50INFOSMPPclient_1:SuccessfullyinitializedSMPP_client_19localhost(SMPPelient)
**.Forwarded(0/0)
2020-07-1809:29:36.4331830309
ellent <-00000010000000150000000000600002
2020-09-1809:28:36.438 SMEP_cadent 00000010800000150000000000000002
Deleted(0)

fStart SMSGateway 9:28

Figure 6 - View the SMPP client connection log

Send a test SMS message

Once your connection is connected, you can check to
see if it is ready to deliver SMS messages by sending a
test SMS. To send a test SMS message, you need to
open the Test tab, and you need to enter the phone
number and message text. It is recommended to provide
the phone number in international format. This means the
phone number should start with a plus sign followed by a
country code. If your local phone number starts with a 0,
it is likely that you will need to drop the 0 prefix. For
example if your UK phone number 07958663698, you
would send the test SMS to +447958663698.
How to send a test SMPP message:

Navigate to the SMPP client connection's details page

Select the Test tab
Enter the recipient phone number
Make sure the phone number is in international format
Enter the message text
Make sure the message text is less than 160 characters
Click on the Send button
Check the SMPP logs

The sms is sent using the smpp submit_sm pdu over the
SMPP link established between the SMPP client and the
SMPP server. This PDU carries the sender id, the
recipient address, the message text and all the
neccessary flags and smpp parameters needed to
display the sms properly on the recipient mobile phone.

You might ask why should the message text be less than
160 characters. This is because GSM system was
designed to send 160 character long text messages. If a
message is longer, it will be split into multiple message
segments, and will be delivered in more than one SMS
message.

SMSGateway-192.168.112.166
ServiceproviderconnectionsUsersandapplicationsView=Heig

PARA TRAINER SYSTCAS

SMPPclient1 SMPP_client_1details

Test Test Configure Events Subscribers

Configure Textmessage
PleasecreateanSMSmessagebyproviding
9Events therecipientandthemessagetext

General
Connection
Name: SMPP_client_1
Type: SMPPclient Recipient
Connection: To:=+3620123467

Folders SMS
Accepted(0/0)
helloworld
+Forwarded(0/0)
€Deleted(0)

Description
TheSMPP(ShortMessagePeertoPeer)
protocolcanbeusedtoconnectyourPC
directlytotheShortMessageService
Center(SMSC)oftheserviceprovider.
ThiswayyoucansendandreceiveSMS
messagesoverthememeorovera
onvaleтепетоĸ 11character(s),1SMSmessage(s)
•Includenewlinecharactersinmessage

Sent Cancel

Figure 7 - Sending a test message

After the message is successfully sent, you should check

the SMPP logs. The SMPP logs will reveal the low level
SMPP messages, that are used to pass the message
content to the SMS service provider. These messages
are also called an SMPP PDU (SMPP protocol data unit).
If there is a problem with message submission, your SMS
service provider will ask for the SMPP logs. In this case,
you need to send the SMPP PDUs to them. For every
SMS submission, two SMPP PDUs will appear in the log.
One is the SMPP SUBMIT_SM pdu, which passes the
message to the SMS service provider's over, and the
SMPP SSUBMIT_SM_RESP, which returns a reference
ID, that can be used for tracking a message, and for
finding the delivery reports returned to you when the
message is delivered to the recipient handset.

Figure 8 - SMPP SMS submit result in the logs

SMPP protocol
specification
The SMPP protocol specification can be used to
understand each SMPP PDU you see in the logs. You will
see, that there are several operations in this protocol
specifications. For example there is an operation for
keeping the SMPP client connection alive using keep
alive messages, and there are multiple operations for
submitting and receiving SMS messages and SMS
delivery reports.
SMPP protocol specification:

Download: smpp-protocol-specification-v3.4.pdf

SMPP protocol versions

The SMPP standard is an evolving protocol. The first
widely adopted version was v3.3. Currently the most
common version you will find is v3.4, but there is also a
newer version v5.0 which is rarely used in SMS services.

SMPP 3.3 the oldest version supports GSM SMS

messages only. It generates an immediate response for
each message sent. In most cases this version is not
supported over SSL connections. The problem with
SMPP 3.3 is that it requires two SMPP links: an SMPP
transmitter and an SMPP receiver link to the SMS service
provider. When you setup an SMPP v3.3 link in Ozeki
SMS Gateway, you will have to create two SMPP client
connections, and configure on as SMPP transmitter and
the other as SMPP receiver.

The SMPP 3.4 protocol is similar to SMPP 3.3, but it has

a strong advantage: it allows you to send and receive
SMS messages over a single TCP/IP link. In Ozeki SMS
gateway you will only have to setup on SMPP client
connection if you wish to use this protocol. SMPP v3.4
also adds optional Tag-Length-Value (TLV) parameters,
to the SMS message, which allows the user to work with
non-GSM SMS technologies, such as SMS messaging in
CDMA networks.

SMPP 5.0 is the latest version of SMPP. It extends v3.4

by adding support for cell broadcasting, smart flow
control. Not many SMS service providers use this
protocol. We recommend you to setup SMPP v3.4
connections in Ozeki SMS gateway.

SMPP client testing

To test your SMPP client connection, it is a good idea to
setup another SMPP gateway as an SMPP Simulator.
This way you can do performance testing and test all the
aspects of SMS messaging. To see how we have used
this SMPP simulator method to test the performance of
our SMS gateway by sending 1 000 000 SMS through it,
check out the SMPP performance testing page.

Summary
This guide provided all the neccessary information on
how to setup SMPP client connection in Ozeki SMS
Gateway. SMPP is great because it allows yout to send
SMS messages to the SMSC over the Internet and Ozeki
SMS Gateway provides excellent speed for delivery. If
you wish to setup an efficient SMS notifiation service in
your business, SMPP is the way to go.

The information you have obtained is valuable, there are

further useful documents in this guide, so keep on
reading. It is a good idea to check out the UCP protocol
setup guide and the CIMD client connection tutorial,
because these protocols offer similar, high speed SMSC
connectivity.

Now download Ozeki SMS Gateway and let the work

begin!
 

Overview | SMPP server

Copyright © 2000-2023 | Ozeki Ltd | [email protected] |

Home > Service providers > SMPP client
Our site uses cookies, by continuing to
Privacy | Terms of use
browse, you accept our privacy policy.
x
5953 | 129.0.76.245 | 31.220.77.148 | Login