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 smpp.smsgateway.ca on port 7779.
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.
|