This is the Java SDK for the Sinch REST SMS API for sending and receiving single or batch SMS messages. It also supports scheduled sends, organizing your frequent recipients into groups, and customizing your message for each recipient using parameterization. It offers an asynchronous Java API that provides convenient access to all the features of the SMS REST API.
The library is compatible with Java 8 and later.
To use this SDK, you can install them as follow
With Maven
<dependency>
<groupId>com.sinch</groupId>
<artifactId>sdk-sms</artifactId>
<version>1.0.5</version>
</dependency>
With Gradle
implementation 'com.sinch:sdk-sms:1.0.5'
This project uses the Maven build tool, and the typical Maven goals are supported. To install the package to your local Maven repository it therefore is sufficient to execute.
git clone https://github.com/sinch/sinch-java-sms.git
cd sinch-java-sms
mvn clean install
Build .jar file
$ mvn package
It will give you sdk-sms-1.0.5-jar-with-dependencies.jar
To skip local test
$ mvn package -Dmaven.test.skip=true
in your terminal. The project will then be compiled and tested before finally being installed in your local repository.
To import the project into Eclipse it is necessary to install the m2e plugin and the m2e-apt connector. Both are available at the Eclipse Marketplace. Before importing the project ensure that automatic configuration of JDT APT is enabled. The Immutables website has good instructions with screenshots.
After this initial setup development in Eclipse should be reasonably straight forward.
String SERVICE_PLAN_ID = "SERVICE_PLAN_ID";
String TOKEN = "SERVICE_TOKEN";
ApiConnection conn =
ApiConnection.builder()
.servicePlanId(SERVICE_PLAN_ID)
.token(TOKEN)
.start()
String SENDER = "SENDER"; // Optional
String [] RECIPIENTS = {"1232323131", "3213123"} ;
MtBatchTextSmsResult batch =
conn.createBatch(
SinchSMSApi.batchTextSms()
.sender(SENDER)
.addRecipient(RECIPIENTS)
.body("Something good")
.build()
// Creating simple Group
GroupResult group = conn.createGroup(SinchSMSApi.groupCreate().name("Subscriber").build());
// Adding members (numbers) into the group
conn.updateGroup(
group.id(), SinchSMSApi.groupUpdate().addMemberInsertion("15418888", "323232").build());
// Sending a message to the group
MtBatchTextSmsResult batch = conn.createBatch(
SinchSMSApi.batchTextSms()
.addRecipient(group.id().toString())
.body("Something good")
.build());
System.out.println("Successfully sent batch " + batch.id());
This project is licensed under the Apache License Version 2.0. See the LICENSE.txt file for the license text.