caktus / rapidsms-twilio

RapidSMS Twilio Backend

rapidsms-twilio

Twilio backend for the RapidSMS project. Uses python-twilio to communicate with Twilio.

Features

• Incoming (MO) and Outgoing (MT) SMS support.
• Support for Twilio's status callback

Requirements

• Python 2.7 or Python 3.3+
• Django 1.7+
• RapidSMS v0.18.0+

Future versions: We currently support Django 1.8 with no pending deprecation warnings in our 1.0 release. We expect each future point release to similarly support the next version of Django, so our 1.1 release would support Django 1.9 with no pending deprecation warnings. Support for older Django versions may be dropped when the period of 'mainstream support' expires. See Django's supported versions documentation for those timelines.

Installation

rapidsms-twilio requires Django >= 1.7 and Python >= 2.7.

To install from PyPi:

pip install rapidsms-twilio

Documentation

Documentation on using rapidsms-twilio is available on Read The Docs.

License

rapidsms-twilio is released under the BSD License. See the LICENSE file for more details.

Contributing

If you think you've found a bug or are interested in contributing to this project check out rapidsms-twilio on Github.

Development by Caktus Consulting Group.

rapidsms-twilio's Issues

status_callback needs to be able to accept a backend_name

Now that we validate requests to the callback URL, we need to be able to pass in a custom backend_name to the status_callback view (which will only be used by the validate_twilio_signature decorator).

Currently, when you try to do this, you get an error like this:

Internal Server Error: /backend/twilio/status-callback/custom-backend-name/
Traceback (most recent call last):
  File "/var/www/rescuesms/env/local/lib/python2.7/site-packages/django/core/handlers/base.py", line 111, in get_response
    response = wrapped_callback(request, *callback_args, **callback_kwargs)
  File "/var/www/rescuesms/env/local/lib/python2.7/site-packages/newrelic-2.54.0.41/newrelic/hooks/framework_django.py", line 499, in wrapper
    return wrapped(*args, **kwargs)
  File "/var/www/rescuesms/env/local/lib/python2.7/site-packages/django/views/decorators/http.py", line 41, in inner
    return func(request, *args, **kwargs)
  File "/var/www/rescuesms/env/local/lib/python2.7/site-packages/django/views/decorators/csrf.py", line 57, in wrapped_view
    return view_func(*args, **kwargs)
  File "/var/www/rescuesms/env/local/lib/python2.7/site-packages/rtwilio/views.py", line 36, in _wrapped_view
    return view_func(request, *args, **kwargs)
TypeError: status_callback() got an unexpected keyword argument 'backend_name'

1.0 Roadmap

This project has been stable for a long time. In usually only needs minor updates for Django or RapidSMS changes. We should get this up to date with the latest and call it 1.0. Need to determine what versions we are going to support.

• Determine supported Python versions
• Determine supported Django versions
• Determine supported RapidSMS versions
• Determine resolution for #8.
• Document future release cycles for new Django/RapidSMS versions

Did I miss anything?

status_callback Needs to Be CSRF Exempt

This view is the postback from Twilio so it needs to be marked as CSRF exempt. Impacts all branches.

Ensure Python3 and Django >=1.7 compatibility

Wheel Support

Not hard to add and people seem to like them

Installing rapidsms-twilio

Hi all, i installed rapidsms in my local and tested the ping & pong demo. Its works fine. For mobile messages, where the rapidsms twilio is installed? I read the documents but didn't got an idea about installation.
I want to send message to application and respond to that message.

Thanks.