Skip to content

wix-incubator/libsms

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

43 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

libsms

A simple Java/Scala outgoing SMS SPI.

Actively used by Wix.com to deliver mission-critical text messages to your favorite restaurants.

Supported SMS providers

SMS Provider Project
BulkSMS libsms-bulksms
Cellact libsms-cellact
Clickatell libsms-clickatell
CM libsms-cm
Nexmo libsms-nexmo
Plivo libsms-plivo
Twilio libsms-twilio

Usage

In a nutshell, usage is as simple as instantiating one of the SMS provider implementations, and calling sendPlain with some text to send, sender information and destination phone number. You get back a provider-specific message ID.

Of course, you'll need to have an account with the SMS provider. Sending text messages isn't free, you know.

For actual code, see the IT suite that accompanies each SMS provider implementation.

Reporting Issues

Please use the issue tracker to report general issues related to this library.

Issues related to a specific SMS provider implementation should be reported to its separate issue tracker.

License

This library uses the Apache License, version 2.0.

Contributions

Want to see your SMS provider supported by this library? Awesome, we do too!

  • Implement the SmsGateway trait in any JVM supported language (Scala, Java, Clojure, ...)
  • Include a test-kit module for integration testing (for reference, see the -testkit module included in any existing SMS gateway implementation).
  • Create a pull request, or add an issue with a link to your implementation