Jasmin - Open source SMS gateway

Introduction

Jasmin is a very complete open source SMS Gateway with many enterprise-class features such as:

• SMPP Client / Server
• HTTP Client / Server
• Console-based configuration, no service restart required
• Based on AMQP broker for store&forward mechanisms and other queuing systems
• Using Redis for in-memory DLR tracking and billing
• Advanced message routing/filtering (Simple, Roundrobin, Failover, Leastcost ...)
• Web and console ui for management
• Supports Unicode (UTF-8) for sending out multilingual SMS
• Supports easy creation and sending of specialized/binary SMS like mono Ringtones, WAP Push, Vcards
• Supports concatenated SMS strings (long SMS)

Jasmin relies heavily on message queuing through message brokers (Using AMQP), it is designed for performance, high traffic loads and full in-memory execution.

Architecture

Jasmin core and its external connectors (used for AMQP, Redis, SMPP, HTTP, Telnet ...) are written in Python and are mainly based on Twisted matrix, an event-driven networking engine.

Getting started

Refer to Installation steps to get Jasmin gateway up and running quickly with a simple SMS sending scenario.

Documentation

The documentation is at: http://docs.jasminsms.com

If you still need to build it locally:

$ cd misc/doc
$ make html
...
...
Build finished. The HTML pages are in build/html.

Links

• Project home page
• Documentation
• Support
• Source code
• Travis CI

License

Jasmin is released under the terms of the [Apache License Version 2]. See `LICENSE` file for details.

Credits

• SMPP PDU parsing based on smpp.pdu: https://github.com/mozes/smpp.pdu
• SMPP 3.4 Client based on smpp.twisted: https://github.com/mozes/smpp.twisted
• GSMP 3.38 based on Python messaging: https://github.com/pmarti/python-messaging

Change Log

0.7 (under development)

• http://bit.ly/jasmin-0-7

0.6

• Setting "bind_ton 1" on connector is broken #97
• Check Tarik's bug (dlr-level and the value of registered_delivery) #87
• SMPP Client is disconnecting when receiving a submit_sm_resp with 0x00000106 (Destination Address Sub unit is Invalid.
• SMPP Server #49
• Publishing submit_sm_resp must be optional #66
• Implement NetworkErrorCodeEncoder() #65
• bind_ton and src_ton settings on connector not working #104
• A numeric password set through jCli will cause an exception when trying to bind #105
• Add validity period parameter in http api #109
• Incorrect http dlr-level parameter mapping to smpp registered_delivery parameter #107
• Incorrect comparison of bound_connections_count #114
• Tuning: change redis set to setex
• Add throughput in User MTCredentials and apply it on SMPP and HTTP #51
• PDUParseError #120
• Command Length is invalid #124
• PDUCorruptError: Command Length is invalid #128
• Error on receiving message on smpp connector #117
• need configuration to send deliver_sm instead of data_sm for SMPP delivery receipt #139
• Error when throwing deliver_sm through smpp: deliverSmThrowerConfig instance has no attribute 'max_retries' #147
• Services don´t start unless jasmin.cfg is missing or commented #144
• Fix problem with numeric logins and passwords #138
• Receipts are not transmitted to smpp client #153
• Expose real time statistics in jCli #123
• SMPP Server: Omit sending deliver_sm receipt when receiving a submit_sm_resp receipt #159
• Implement submit_sm retry on failure depending on the error type (for example ESME_RTHROTTLED ...) #60
• Don't charge messages when sending SMS through SMPP returns an error in submit_sm_resp #164
• CentOS / Red Hat Jasmin init script seems to be not working properly #165
• Provide deb and rpm packages for Jasmin #169
• Dockerize Jasmin #170
• SMPP Server API #49
• Basic statistics in user-level #77
• Delivery retrial on specific/configurable errors #60
• Easier installation procedure through Linux packages #78
• and more: http://bit.ly/jasmin-0-6

0.5

• User credentials: validation, default/fallback values and balance/quota management
• Changed system service startup script from twisted tap plugin to bin/jasmind
• Rated routes (for billing purpose)
• Prepaid billing including asynchronous mode
• jCli supports user credentials management
• Updated documentation
• Various fixes

0.4.0

• Setuptools command support
• Documentation hosted on http://docs.jasminsms.com
• Updated documentation
• Various fixes

0.3.0

• Routing for MO and MT flows between HTTP and SMPP connectors
• Management through jCli console
• Updated documentation
• Various fixes

0.2.0

• HTTP Server (for SMS MT sending)
• HTTP Client (for SMS MO and delivery receipts)

0.1.0

• SMPP Client API