javasmppjsmpp

Using SMPP to send sms texts in JAVA


I am trying to send sms using JAVA. After googling, I found out that SMPP protocol is to be used for it and stumbled upon the below source code.

public class SendSMS
{
public static void main(String[] args) throws Exception
{
    SendSMS obj = new SendSMS();
    SendSMS.sendTextMessage("<mobile number>");
}

private TimeFormatter tF = new AbsoluteTimeFormatter();

/*
 * This method is used to send SMS to for the given MSISDN
 */
public void sendTextMessage(String MSISDN)
{

    // bind param instance is created with parameters for binding with SMSC
    BindParameter bP = new BindParameter(
            BindType.BIND_TX, 
            "<user_name>",
            "<pass_word>", 
            "<SYSTEM_TYPE>", 
            TypeOfNumber.UNKNOWN,
            NumberingPlanIndicator.UNKNOWN,
            null);

    SMPPSession smppSession = null;

    try
    {
        // smpp session is created using the bindparam and the smsc ip address/port
        smppSession = new SMPPSession("<SMSC_IP_ADDRESS>", 7777, bP);
    }
    catch (IOException e1)
    {
        e1.printStackTrace();
    }

    // Sample TextMessage
    String message = "This is a Test Message";

    GeneralDataCoding dataCoding = new GeneralDataCoding(false, true,
            MessageClass.CLASS1, Alphabet.ALPHA_DEFAULT);

    ESMClass esmClass = new ESMClass();

    try
    {
        // submitShortMessage(..) method is parametrized with necessary
        // elements of SMPP submit_sm PDU to send a short message
        // the message length for short message is 140
        smppSession.submitShortMessage(
                "CMT",
                TypeOfNumber.NATIONAL,
                NumberingPlanIndicator.ISDN,
                "<MSISDN>",
                TypeOfNumber.NATIONAL, 
                NumberingPlanIndicator.ISDN, 
                MSISDN,
                esmClass, 
                (byte) 0, 
                (byte) 0, 
                tF.format(new Date()),
                null,
                new RegisteredDelivery(SMSCDeliveryReceipt.DEFAULT),
                (byte) 0,
                dataCoding, 
                (byte) 0, 
                message.getBytes());
    }
    catch (Exception e)
    {
        e.printStackTrace();
    }
}

}

But the problem I encounter with the source code is that it requires specific set of parameters like user_name, pass_word, system_type, SMSC IP address etc which I have no clue of. I have only recently known about the SMPP protocol and so am unaware of how to get this code working to fulfil my usecase of sending sms to my mobile. So can someone please help me get this code to work or guide me to a place where i can learn about doing this?


Solution

  • I've been working on SMPP project recently.

    The library I used for SMPP protocol is OpenSMPP.

    Here is the example of my class for building and sending SMPP data

    public class SmppTransport implements Transport {
    
    @Override
    public void send(String url, Map<String, String> map) throws IOException {
        int smscPort = Integer.parseInt(map.get("port"));
        String smscHost = map.get("send_url");
        String smscUsername = map.get("username");
        String smscPassword = map.get("password");
        String recipientPhoneNumber = map.get("phone_num");
        String messageText = map.get("text");
    
        try {
            SubmitSM request = new SubmitSM();
         // request.setSourceAddr(createAddress(senderPhoneNumber)); // you can skip this
            request.setDestAddr(createAddress(recipientPhoneNumber));
            request.setShortMessage(messageText);
         // request.setScheduleDeliveryTime(deliveryTime);           // you can skip this
            request.setReplaceIfPresentFlag((byte) 0);
            request.setEsmClass((byte) 0);
            request.setProtocolId((byte) 0);
            request.setPriorityFlag((byte) 0);
            request.setRegisteredDelivery((byte) 1); // we want delivery reports
            request.setDataCoding((byte) 0);
            request.setSmDefaultMsgId((byte) 0);
    
            Session session = getSession(smscHost, smscPort, smscUsername, smscPassword);
            SubmitSMResp response = session.submit(request);
        } catch (Throwable e) {
            // error
        }
    }
    
    private Session getSession(String smscHost, int smscPort, String smscUsername, String smscPassword) throws Exception{
        if(sessionMap.containsKey(smscUsername)) {
            return sessionMap.get(smscUsername);
        }
    
        BindRequest request = new BindTransmitter();
        request.setSystemId(smscUsername);
        request.setPassword(smscPassword);
     // request.setSystemType(systemType);
     // request.setAddressRange(addressRange);
        request.setInterfaceVersion((byte) 0x34); // SMPP protocol version
    
        TCPIPConnection connection = new TCPIPConnection(smscHost, smscPort);
     // connection.setReceiveTimeout(BIND_TIMEOUT);
        Session session = new Session(connection);
        sessionMap.put(smscUsername, session);
    
        BindResponse response = session.bind(request);
        return session;
    }
    
    private Address createAddress(String address) throws WrongLengthOfStringException {
        Address addressInst = new Address();
        addressInst.setTon((byte) 5); // national ton
        addressInst.setNpi((byte) 0); // numeric plan indicator
        addressInst.setAddress(address, Data.SM_ADDR_LEN);
        return addressInst;
    }
    
    }
    

    And my operator gave me this parameters for SMPP. There are many configuration options but these are essential

    #host = 192.168.10.10 // operator smpp server ip
    #port = 12345         // operator smpp server port
    #smsc-username = "my_user" 
    #smsc-password = "my_pass" 
    #system-type = "" 
    #source-addr-ton = 5
    #source-addr-npi = 0
    

    So if you want to test your code without registering with GSM service provider, you can simulate SMPP server on your computer. SMPPSim is a great project for testing. Download it and run on your computer. It can be configured in multiple ways e.g. request delivery reports from SMPP server, set sms fail ratio and e.t.c. I've tested SMPPSim on linux.