This document discusses using VoIP technologies to enhance Drupal sites. It describes existing Drupal modules that integrate VoIP features, such as making phone calls and playing audio. It proposes the "Voip Drupal" platform to facilitate building Drupal sites with more advanced VoIP capabilities. The platform would provide core modules and a flexible architecture to integrate VoIP servers and services. It outlines design considerations and provides examples of potential modules and a dialplan scripting system to control audio workflows. Current progress is described along with needs for further development.

1. From Phone 2 Web
(and back)
using VoIP technologies to enhance Drupal sites
Leo Burd & Bryan Hirsch & Chad Phillips
1 2 3
1civic.media.mit.edu
2starswithstripes.org
3apartmentlines.com
2010.04.20 – Drupal Con SF 2010

2. Contents
• Who is doing what?
• Cases
• The asterisk.module
• The What’s Up system
• Others?
• The Voip Drupal platform
• Next steps

3. The asterisk.module

4. The What’s Up system

5. Can technology
help change
this situation?
5

7. organization of
personally
meaningful
community events

9. demo

10. Other examples?

11. The Voip Drupal
platform

12. Voip Drupal is…
A platform that facilitates the construction of Drupal sites
that literally pick-up the phone, make calls, record
messages, broadcast audio, run voice polls, and more.

13. design considerations
• Flexibility
• Integration with Asterisk, FreeSwitch and other VoIP servers
• Integration with SMS, email and other communication services
• Speed
• Minimize file transference, use URLs instead
• Minimize file conversion; use MP3 as much as possible
• Ease of use
• CCK (Fields) integration
• End-user creation of “dialplan scripts” (IVRs)
• Web-based audio recording
• Voice/language support
• Ease of adoption
• Basic building blocks for common applications
• Minimize dependencies on the VoIP service provider
• D6 (D7?) compatibility

14. Voip Drupal modules
specific voip_geo_call.module voip_weather.module
voip_polls.module voip_group.module
voip_voice.module voip_events.module
useful
voip_call_blast.module voip_conference.module
voip_voicemail.module voip_announcements.module
voip_directory.module voip_fields.module
voip_logger.module voip_extensions.module
core
voip.module
voip_asterisk.module voip_freeswitch.module

15. Basic architecture
a.module z.module
voip_send_request
($request_id, $options) hook_voip_process_request
($request_id, $options)
voip.module
voip_server.api voip_process_request
($request_id, $options )
voip_<server>.module
voip_<server>.module services.module
<server>.api
<voip server>

16. 1 wav/mp3
files
dial-in
asterisk workflow
asterisk server
phpagi_fastagi
2 drupal server
asterisk_ mp3 files
script_handler.
sh
3
script and
command voip
requests) modules
drupal

17. wav/mp3
files
dial-out
asterisk workflow
asterisk server
phpagi_fastagi
phpagi_asmanager
drupal server
3
asterisk_ mp3 files
script_handler. 2
sh
script and
command voip
requests) modules
4
drupal
1

18. The dialplan script system
• Dialplan scripts are like “audio pages”
• Each module defines its own scripts
• Basic commands might include
• Dial <number, script>
• Say <text>
• Play <audio>
• Menu <options>
• Goto <script name>
• Back
• Record
• GetInput
• Hangup

19. Sample dialplan scripts
<?xml version="1.0"?>
<voip_script name='hello_world'>
<say><text>Hello, world!</text></say>
<goto>bye_bye</goto>
</voip_script>
<?xml version="1.0"?>
<voip_script name='bye_bye'>
<say><text>Nice meeting you. Goodbye!</text></say>
<hangup></hangup>
</voip_script>

20. Current status
• Already have “proof of concept” (What’s Up, asterisk.module)
• Defined basic architecture
• Implemented basic skeleton of the system
• Implementing core modules
– voip.module
– voip_extensions.module
– voip_directory.module
– voip_call_blast.module
• Defining core dialplan commands

21. Love needed
• audio_recorder.module
• dialplan command definition
• voip_freeswitch.module
• all the other modules
• … and more!

22. For additional information
• Leo Burd (leoburd@media.mit.edu)
• Bryan Hirsch (bhirsch@starswithstripes.org)
• Chad Phillips (chad@apartmentlines.com)
• http://www.voipdrupal.org/ (soon!!)
• http://groups.drupal.org/voip-drupal