SMS Output Event Adapter

SMS output event adapter is used to send message notifications via Short Message Peer-to-Peer Protocol (SMPP). It uses Axis2 SMS events when sending SMSs from WSO2 products. SMPP allows Axis2 to connect to a Short Messaging Service Center (SMSC) and send/receive SMSs. SMS event adapter can be configured with XML, text, and JSON output mappings.

Prerequisites

Before the configuration starts, follow the steps below to configure the SMS sender.

1. Enable SMS Transport by adding following configuration under “Transport Senders” section in <PRODUCT_HOME>/repository/conf/axis2/axis2_client.xml file .

   <axisconfigname="AxisJava2.0">
      ... 
      <transportSenderclass="org.apache.axis2.transport.sms.SMSSender"name="sms">
           <parametername="systemType"></parameter>
           <parametername="systemId">cep1</parameter>
           <parametername="password">cep123</parameter>
           <parametername="host">localhost</parameter>
           <parametername="port">2775</parameter>
           <parametername="phoneNumber">CEP1</parameter>
       </transportSender>
       ...
   </axisconfig>

2. Copy following libraries to <PRODUCT_HOME>/repository/components/lib/ directory.

   • axis2-transport-sms-1.0.0.jar
   • jsmpp-2.1.0.jar

Configuring output SMS event adapter

SMS output adapter requires following adapter configurations; 

Other post configurations that use SMS event adapter

Follow the instructions below to set up and configure a SMSC Simulator  to receive messages. This guide uses Logica SMSC simulator.

1. Navigate to SMSC Simulator directory. The folder must contain following 3 files
   smpp.jar
   smscsim.jar
   users.txt

2. Add the following name-value pairs to users.txt file. 

   Enter the value of the systemId parameter defined in the above SMS transport sender configuration as the value of the name parameter in the below list.

   name=cep1 
   password=cep123
   timeout=unlimited

3. Start SMSC Simulator by executing the following command:
   java -cp smpp.jar:smscsim.jar com.logica.smscsim.Simulator
4. In the console where the command runs:
   
   • Enter 1 for the prompt to start simulation.

   • Enter 2775 as the port number (this port is equal to the port defined in the SMS transport sender configuration.)

   When the Starting listener... started log is displayed on the console, the SMSC simulator is ready to accept messages as shown below.