This is a stoopid simple cherrypy app that uses the caldav python library to decide who to forward voice and sms messages to based on calendar data.

You need a caldav calendar. I've tested with Zimbra. The code uses the ical 'summary' field (the event name in Zimbra or Google calendar) for a contact name and the ical 'location' field for an E.164-formatted phone number.

Set up a calendar with events. They can be one-time events, all-day events, or recurring events. The name of the event must be set (to anything), and the location field of the event must contain an E.164-formatted phone number.

There is currently no support for concurrent events. If there are two events during the same date and time, results may vary.

There is, however, support for overlapping all-day and part-day events. So Bob could have an all-day event forwarding to his number, with an 1100-1300 event forwarding to Susie, both on the same day. From 1100-1300, the call will go to Susie, and the rest of the day, the call will go to Bob.

But avoid creating events that overlap in time, (e.g. 1100-1300 and 1200-1400) and overlapping all-day events.

The code first polls your calendar for today's events. It looks first for any events matching the current time, then for any all-day events matching the current day, using the first match it finds. From the matching event, it extracts the name of the event and the phone number (from the location field). It then forwards calls and text messages to the number from the location field, after replying with sms_reply or voice_reply as appropriate.

If there are no calendar events for the day, the messages are forwarded to default_phone.

1. create and activate a fresh virtualenv
2. checkout the code: git clone https://github.com/wryfi/twilio-caldav.git
3. cd twilio-caldav
4. install requirements: pip install -r requirements.txt
5. create settings.py file in root of checkout (see below)
6. run natively with cherrypy: python twilio-caldav.py, or
7. run with wsgi using twilio-caldav.wsgi and your favorite webserver (e.g. apache or nginx)
8. set your twilio number to use <twilio-caldav_url>/voice (GET) for voice the voice URL, and <twilio-caldav_url>/sms (POST) for the sms URL.

Create a file called settings.py in the root of your clone. It must contain the following variables:

# the path to the python virtualenv for this app
virtualenv_path = '/path/to/virtualenv/lib/python2.6/site-packages'
# the timezone of your machine
timezone = 'America/Los_Angeles'
# the url to your calendar. For zimbra, it looks something like:
caldav_url = 'https://<username>:<password>@<zimbrahost>/dav/<zimbraemail>/<calendarname>'
# the phone number to return when there are no events on the calendar for today
default_phone = '+14155554321'
# the name to return when there are no events on the calendar
default_name = 'Popeye'
# the twilio phone number to forward sms messages from; must be a valid phone number from your twilio account
twilio_phone_number = '+14155551234'
# your twilio account sid from twilio.com
twilio_account_ssid = 'xxxxxxxxxxxxxxxxxxxxxxxxxx'
# your twilio auth token from twilio.com
twilio_auth_token = 'zzzzzzzzzzzzzzzzzzzzzzzzzz'
# text to auto-respond to sender
sms_reply = 'Thanks for your text. I will forward your message along.'
# voice response to caller
voice_reply = 'Thank you for calling. I will transfer you to the appropriate party'