Tutorial section - SMS
Send SMS with SMPP using Java
Sending SMS with the SMPP API using the Java programming languageTyr SMS Gateway
to
and worldwideThe jsmpp
library can be used to build an SMPP client that can make SMPP requests using Java. This library's higher-level functions can be used to synchronously submit SMS to an SMS gateway or SMSC.
SMPP requirements and resources
SMPP is the Short Message Peer-to-Peer protocol and is used by applications for sending and receiving SMS. An SMPP client can be used to connect to an SMSC or SMS gateway using the SMPP protocol. An SMPP account, including special Developer accounts, can quickly and easily be obtained for using the Melrose Labs Tyr SMS Gateway or SMSC Simulator. The following are required to send SMS with SMPP:
- SMPP Protocol [reference]
Short Message Peer-to-Peer Protocol v3.3, v3.4 and v5 specifications and guides - SMPP Client [tool]
Browser-based SMPP client supporting SMPP v3.x and v5 via Web Sockets
Java requirements and resources
Java is a programming language and can be used to quickly and easily add SMS support for programmatically sending and receiving SMS messages. Use it for transactional messaging and notifications between your application and mobiles. The following are required to send SMS using Java:
- Java
Java programming language
Requirements and resources
The following are required to send SMS with SMPP using Java:
- jSMPP
jSMPP Java Library
Code
Create the file SimpleSubmitExample.java
containing the code below. Replace the hostname smscsim.melroselabs.com
, port 2775
, SYSTEMID
and PASSWORD
values with those from your SMPP API account. Alternatively, replace SYSTEMID
and PASSWORD
with those allocated to you for use with the Melrose Labs SMSC Simulator.
The following example Java code opens an SMPP transmitter bind to smscsim.melroselabs.com
on port 2775
(SMPP port), and then sends the message Hello World #$£
to mobile number 447712345678
from MelroseLabs
. The message ID returned in messageId
is that returned from the SMS gateway or SMSC after a successful submission. The SMPP system ID and password for the SMPP account are contained in SYSTEMID
and PASSWORD
respectively.
import logging
import org.jsmpp.InvalidResponseException;
import org.jsmpp.PDUException;
import org.jsmpp.bean.Alphabet;
import org.jsmpp.bean.BindType;
import org.jsmpp.bean.ESMClass;
import org.jsmpp.bean.GeneralDataCoding;
import org.jsmpp.bean.MessageClass;
import org.jsmpp.bean.NumberingPlanIndicator;
import org.jsmpp.bean.RegisteredDelivery;
import org.jsmpp.bean.SMSCDeliveryReceipt;
import org.jsmpp.bean.TypeOfNumber;
import org.jsmpp.extra.NegativeResponseException;
import org.jsmpp.extra.ResponseTimeoutException;
import org.jsmpp.session.BindParameter;
import org.jsmpp.session.SMPPSession;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
public class SimpleSubmitExample {
private static final Logger LOGGER = LoggerFactory.getLogger(SimpleSubmitExample.class);
public static void main(String[] args) {
SMPPSession session = new SMPPSession();
try {
LOGGER.info("Connecting");
String systemId = session.connectAndBind("smscsim.melroselabs.com", 2775, new BindParameter(BindType.BIND_TX, "SYSTEMID", "PASSWORD", "", TypeOfNumber.UNKNOWN, NumberingPlanIndicator.UNKNOWN, null));
try {
String messageId = session.submitShortMessage("",
TypeOfNumber.UNKNOWN, NumberingPlanIndicator.UNKNOWN, "MelroseLabs",
TypeOfNumber.INTERNATIONAL, NumberingPlanIndicator.UNKNOWN, "447712345678",
new ESMClass(), (byte)0, (byte)1, TIME_FORMATTER.format(new Date()), null,
new RegisteredDelivery(SMSCDeliveryReceipt.DEFAULT), (byte)0, new GeneralDataCoding(Alphabet.ALPHA_DEFAULT, MessageClass.CLASS1, false), (byte)0,
"Hello World €$£".getBytes());
LOGGER.info("Message successfully submitted (message_id={})", messageId);
} catch (PDUException e) {
// Invalid PDU parameter
LOGGER.error("Invalid PDU parameter", e);
} catch (ResponseTimeoutException e) {
// Response timeout
LOGGER.error("Response timeout", e);
} catch (InvalidResponseException e) {
// Invalid response
LOGGER.error("Receive invalid response", e);
} catch (NegativeResponseException e) {
// Receiving negative response (non-zero command_status)
LOGGER.error("Receive negative response, e");
} catch (IOException e) {
LOGGER.error("IO error occured", e);
}
session.unbindAndClose();
} catch (IOException e) {
LOGGER.error("Failed connect and bind to SMSC", e);
}
}
}
Using in production
Whatever the language or API, you can send SMS and receive SMS between applications and mobiles for a wide range of uses with any of the trusted and reliable CPaaS services from Melrose Labs. Take a look at our Messaging, SMS gateway and Bulk SMS solutions, and sign-up for a Developer account on our Tyr SMS Gateway service to try us out.
We provide a wide range of CPaaS services and infrastructure to organisations, including cloud platforms that enable you to run your own SMS gateway.
Get in contact with us to find out more about CPaaS voice, messaging, video and identity from Melrose Labs.
Testing
For testing your application's SMS support when using the SMPP protocol, we recommend starting with the Melrose Labs SMSC Simulator service to simulate SMS message delivery to mobiles (MT SMS) and simulate SMS messages from mobiles (MO SMS). The SMSC Simulator supports SMPP v3.3, v3.4 and v5.
SMSC SimulatorFor live testing and delivery to mobiles, use the reliable and dependable Melrose Labs Tyr SMS Gateway for A2P, P2A, bulk, wholesale and business SMS, text marketing and other uses. The Melrose Labs Tyr SMS Gateway supports REST and SMPP APIs.
Tyr SMS GatewayAlternative APIs and languages
Other APIs covered in our tutorials that can be used for sending and receiving SMS using Java include: REST
Other languages covered in our tutorials that can be used for sending and receiving SMS with SMPP include: Python, PHP, C++, C#, Perl, Go, Node.js, Ruby