Affiliate Login
Learn More Try it How to use Pricing Login

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 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.


footer
© 2015 Swift SMS Gateway Inc.