SMPP is an industry standard, reliable method of sending a high number of messages. Our documentation leads you through the process of integrating with our SMPP service.
Developing and implementing your SMPP based application can be difficult to do without an industry standard test platform. We offer a fully compliant SMPP test profile as part of our wholesale service. The test profile allows your developers to simulate a real production environment (including delivery receipting) without incurring the costs of sending messages.
Introduction to the aql SMPP service
aql supports SMPP v3.4. The following contains a list of the PDUs supported by aql:
Client to aql
aql to client
Binding to aql
There are two options available when binding to aql.
You can either bind using the transmitter and receiver pair from SMPP v3.3 or bind using the transceiver mode new to SMPP v3.4.
When the SMPP account is set up for you, you will be given a username (system_id), password and a system_type value to connect with.
Maximum number of binds
You are initially restricted to the number of binds you can make to aql.
Depending on the version of SMPP you are using it will be either 1 transceiver connection or 1 transmitter and 1 receiver connection. In most cases this is sufficient. If, however, you require this configuration changing on your account, please raise a support ticket via our support system (see bottom of page 1). We will then be able to discuss your needs and make the appropriate changes.
IMPORTANT: You can only connect to aql via certain IP addresses that you have registered. If you wish to connect from multiple IP addresses, please raise a support ticket via our support system.
Submitting messages to aql
The following table gives a breakdown of the SUBMIT_SM PDU. It contains details regarding each of the parameters of the PDU and how they should be used when passing messages to the aql servers.
NOTE: Optional parameters are not required by aql and are not supported.
source_addr_ton and source_addr_npi parameters
When mimicking a mobile number, international format must be used. In this case both source_addr_ton and source_addr_npi must be set to 1. In other cases, it is generally acceptable to leave these parameters set to 0 (zero).
Querying a previously submitted message
aql support the QUERY_SM PDU.
This can be used to determine the state of a message at a time that is suitable to you. The table below gives a breakdown of the QUERY_SM PDU and how it should be used with aql.
The QUERY_SM_RESP PDU is as defined in the SMPP specification.
Error response codes
The error responses that can be sent back are as defined in the SMPP specification. The additional error codes specific to aql are outlined in the table below.
If the register_delivery parameter is set to 1 in the original SUBMIT_SM PDU then a DELIVER_SM response will be sent back to you when the message has reached a final state. This could take anywhere between seconds and hours. Some cases could take even longer.
The following table shows a breakdown of the parameters that are sent in a DELIVER_SM and how to interpret them when received from aql.
The short message for a delivery receipt is a string and will look like the following:
“id:IIIIIIIIII sub:SSS dlvrd:DDD submit date:YYMMDDhhmm done date:YYMMDDhhmm stat:DDDDDDD err:E Text: . . . . . . . . .”
The fields in the delivery receipt are explained in the following table:
The stat parameter contains the status of the message.
The values it can take along with associated error codes are described below:
In the near future we will be adding additional status codes.
This will allow us to pass along more detailed information.
As with all SMPP communications, the aql servers expect a DELIVER_SM_RESP PDU in response to a delivery report.
Terminating the connection
In order to stop the connection to aql you must first issue the UNBIND PDU.
aql will send back an UNBIND_RESP PDU at which point it is safe to terminate the connection.
You will require an SMPP client to send messages via the aql SMPP server. The following section may prove useful in this regard.
There is an excellent open source SMPP client for Linux available at: http://www.kannel.org. This provides functionality above and beyond what is required to send messages via aql. It is fairly complex to configure but it is extremely reliable and worth considering.
There is a small SMPP client written in PHP located at:
If you would like to develop your own SMPP client, then there is a Java API available to download. This can be found at:
An equivalent Perl API is available at: