Accessing SMS Gateway using SMPP
Introduction
SMS Gateway now offers limited SMPP support to allow clients to send their text
messages using the SMPP protocol. The SMS Gateway SMPP interface complies with
version 3.4 issue 1.2 of the SMPP protocol. Currently, the SMS Gateway SMPP
interface supports the following operations:
- BIND
- UNBIND
- SUBMIT_SM
- QUERY_SM
- CANCEL_SM
Before You Begin
Before you can send SMS messages through SMS Gateway via SMPP, you will need to
create an account.
Once you have an account, you will have chosen your password and been assigned an Account Key.
Both of these are required to perform the SMPP BIND operation.
BIND
This is the first operation that must be performed to establish a connection
between your client program and the SMS Gateway SMPP Server.
Currently our SMPP interface allows the BIND_TRANSCEIVER mode of operation so use that
binding mode when connecting. Our SMPP server is running at smsgateway.ca on port 7777.
In addition to choosing the mode of operation, the BIND command requires you to
authenticate with the SMS Gateway SMPP Server. Your SMS Gateway AccountKey and Password
have to be passed with the BIND_TRANSCEIVER command in the SMPP parameters system_id and password
respectively.
SUBMIT_SM
Once you have successfully performed the BIND operation, you can start sending your
short messages to the SMS Gateway SMPP Server using the SUBMIT_SM command.
There are two mandatory parameters utilized by the SMS Gateway SMPP interface for this command.
They are:
| destination_addr |
The phone number to which to send the message, numbers only.
For example, (416) 123-1234 should be entered as destination_addr=4161231234.
|
| short_message |
The body of the message to send, in ASCII encoding.
Even though the SMPP protocol allows up to 254 characters in this field,
the value should not exceed 160 characters due to network contstraints of
the mobile carriers.
|
QUERY_SM
You can use this command to query the status of a previously submitted short message.
Messages are identified based on the message_id assigned by our SMPP Server that you
received in the SUBMIT_SM_RESP PDU response when you sent your message using the
SUBMIT_SM command.
At this time, message status information is only available for 24 hours after the
send event.
CANCEL_SM
You can use this command to cancel a previously submitted short message that is
still pending delivery. Messages are identified based on the message_id assigned by our SMPP Server that you
received in the SUBMIT_SM_RESP PDU response when you sent your message using the
SUBMIT_SM command. Once a message has been placed onto the wireless networks
for delivery, it cannot be cancelled.
Getting Started
There are many different SMPP client libraries available to help you jumpstart your
integration. One such library, written in Java is available
here.
|