rapidsms-smpp-gateway

A RapidSMS SMPP gateway.

Management commands

smpp_client

Start an SMPP client instance:

python manage.py smpp_client smppsim

Example configuration using environment variables:

export PGDATABASE=libya_elections
export DATABASE_URL=postgresql://localhost/$PGDATABASE
export SMPPLIB_HOST=localhost
export SMPPLIB_PORT=2775
export SMPPLIB_SYSTEM_ID=smppclient1
export SMPPLIB_PASSWORD=password
export SMPPLIB_SUBMIT_SM_PARAMS='{"foo": "bar"}'

healthchecks.io support

An integration with healthchecks.io can be enabled by passing the --hc-uuid option or setting the HEALTHCHECKS_IO_UUID environment variables, for example:

export HEALTHCHECKS_IO_UUID=c0c6...

If enabled, the smpp_client management command will send a success ping to healthchecks.io for the configured check at most every minute from the main listen loop.

This functionality requires the healthchecks-io Python package.

listen_mo_messages

Listen for mobile-originated (MO) messages:

python manage.py listen_mo_messages --channel new_mo_msg

Publish

1. Update setup.py with the version number
2. Update CHANGES.md with release notes
3. Create a new release and tag on GitHub. A publish Github Actions workflow is configured to run on tag creation.