VoIP Drupal building sites that answer calls, send SMS, and more

VoIP Drupal Hands On

Experience

Presented by: Michele (Micky) Metts of DrupalConnection.com

While you are waiting for the conference to start, go to my test site at http://MickyMetts.com and post an AUDIO BLOG. We want to hear your ideas for future VoIP Drupal Hands On Experiences!

VoIP Drupal is an initiative of the MIT Center for Civic Media - civic.mit.edu

Date of Event: TBD

Series of Episodes

Introduction

A Series of Episodes

VoIP Drupal Hands On Experience

Introduction

Setup and Configuration of VoIP Drupal Modules

#1

#1

Acknowledgments

Many thanks to all the Drupal users and developers who have taken the time to contribute to this incredible project that will change the world for the better.

VoIP Drupal is a project created by Dr. Leo Burd and the MIT Center for Civic Media civic.mit.edu

Drupal 6x installed and running and accessible on the Internet. Drupal Administrative permissions to enable modules

Server access to upload and install modules (for those that do not have the VoIP Drupal or Click2Call modules installed already) Tropo.com account - the account is FREE until you are finished developing!

cURL must be installed on your server (most web hosts have Curl installed as part of their PHP package, if unsure please check with your web host)

13245This Webinar will walk you through enabling VoIP Drupal modules and basic configuration of Tropo (VoIP provider). We will go step-by-step through the Administration screens and show each configuration.

Requirements:

Potential VoIP Drupal Applications

Call centers

2-1-1 and 3-1-1 community hotlines

Phone - and SMS - based surveys

Group communications

Story recording / playback

Audio speed dating services

Language training

Audio tours

Adventure games

Interactive community radio programs

Emergency announcements

Get Out the Vote campaigns

VoIP Drupal is a PLATFORM that many applications can be built upon

Goals for Today

Making a VoIP Drupal Script Interact with a Phone.

Setup a Tropo account and create a WebAPI

Setup VoIP Drupal Server ConfigurationsSetup the VoIP Drupal Default Call ConfigurationSelect Scripts, Voices and LanguagesEditing a Sample Script (No Programming)Take a Peek at Visual VoIP Drupal to Inspire You!Call the VoIP Drupal Phone # and Join a Conference.

Get started editing scripts and making them your own!

Basic Server Requirements

Your host should have these basic services in place.

You will need an FTP account and administrative access to your Drupal site to upload and install modules.

Drupal 6xInstalled and hosted on a Web server that is accessible on the Internet.

PHP-cURLBoth Tropo and Twilio require PHP-cURL to be installed, check your Status Report page /admin/reports/status to see if cURL is installed. If not, please check with your host, or if you have access, install the cURL PHP extension.

Clean URLsYou should use the Apache 'mod_rewrite' extension to allow for clean URLs./admin/settings/clean-urls

Our Test Server is: Linux - CENT OS 5, Apache, MySQL-5.0.95, PHP-5.2.17

Clean URLs

The test site for this Webinar is setup to display clean URLs.

If your site is not configured for clean URLs, then any dynamic URLs will be displayed with /?= after your domain name.

Clean URLs:http://your_site.com/Drupal_Dynamic_Page

No Clean URLs:http://your_site.com/?=Drupal_Dynamic_Page

VoIP Drupal
Modules

In this hands on Webinar, we will walk you through installation and configuration of the basic VoIP Drupal modules.

These are the modules that work together as the VoIP Drupal Platform

Required VoIP Drupal Modules

These are the required modules to be enabled for today's experience:MODULES (listed under the VoIP Drupal category on the Modules page at /admin/build/modules):

VoIP Drupal (modules listed below are all included in the voipdrupal package) VoIP Drupal Core http://drupal.org/project/voipdrupal VoIP TropoVoIP CallVoIP Script Samples

In addition to VoIP Drupal's required modules, some examples in this Webinar use 2 more. Please install them in order to follow along with me.http://drupal.org/project/cck http://drupal.org/project/views

OPTIONAL Drupal Modules

(listed by the section they appear in on the Modules page located at /admin/build/modules):

http://drupal.org/project/views

Views Views -

http://drupal.org/project/cck

CCK CCK -Text Click2Call Field

VoIP Drupal VoIP Script UI (included in VoIP Drupal Core you will need Views to enable this)

http://drupal.org/project/click2call

Click2CallClick2Call -Click2Call Block

VoIP Drupal Modules in List

VoIP Drupal Modules in List

Enable these 4 modules

Click2Call Modules in List

What about those README.TXT files?

README.TXT voiptropo.module

== Introduction ==

The VoIP Tropo module makes it possible for the VoIP Drupal platform to make and receive text and voice calls via the Tropo Cloud API service (http://www.tropo.com/).

In particular, the VoIP Tropo module enables the creation of Drupal sites that:* Are accessible via SIP connections and phone numbers in over 40 countries* Provide SMS capabilities to and from U.S. numbers* Can use a combination of 16 voices (8 male, 8 female) in 6 different languages for text to speech generation

In addition to that, the VoIP Tropo module extends the standard VoIP Drupal API with support to voice recognition via the new addGetVoiceInputCommand(). Check the 'voiptropo_speech_recognition_demo' script for an example of that functionality in action.

== Requirements ==

In order to install the voiptropo.module, you will need:

1. A Tropo account

2. The VoIP Drupal module (http://drupal.org/project/voipdrupal)

3. The PHP Curl extension in your system. For Debian systems, just run $ sudo apt-get install php5-curl $ sudo /etc/init.d/apache2 restart

== Installation ==

Installing voiptropo.module is very simple. It requires a few configuration steps on your Drupal site to let it know how to reach your Tropo account. It also requires a few settings in your Tropo account to make sure it knows which Drupal site to use.

Tropo configuration:

1. Login into your Tropo account

How Things Work

Setup an Account at Tropo.com it's free

Next

Create a New Application

Create a New Application using Tropo WebAPI

http://your_site.com/voip/tropo/callhandler

any_name

Create a New Application

Give your new application a name and fill in the URL to your VoIP Tropo module

Add a phone number

Add a New Tropo VoIP Phone Number

*Tropo's SMS configuration field only shows up after you choose a US phone number for your WebAPI app.

*Tropo's SMS configuration field only shows up after you choose a US phone number for your WebAPI app.

These are your Tokens, issued by Tropo. You must now launch your Tokens. Click on each one and select: LaunchIn the pop up window.

Launch Your Outbound Tokens

pop up window

Choose Tropo as your Default Server here.

Default Server Configuration

Default Server Configuration

Add your outbound token numbers from your Tropo.com account here.

Do not share your token numbers. They are issued by Tropo and are connected to your personal account information.

Choose the voice and language settings here. You can set a Default Voice that will be used in all scripts, and set options for individual voices to be chosen for each script.

Default Call Configuration

Tips, Hints and Help

What to do when things go wrong...

Here are some things you can do to troubleshoot your configuration:

When you setup a phone number with Tropo it can take time for it to be propagated throughout the system. Please be patient.

Make sure that Tropo is selected as the default server in your Default Server Configuration within the VoIP Drupal Administrative settings

Check your server's call log, everything is recorded there and it will give you some good information. Call logs are found in the VoIP Drupal Administration menu:http://your_site.com/admin/voip/call/log

Tropo.com offers a real time debugger so you can see what is happening on their server when a call is initiated. You will find this on your Tropo account page. Go to that page and then try calling your VoIP Drupal number.

Check for typos in your Inbound and Outbound Tokens issued by Tropo.

Some issues you may run into include: busy signal, call hangups, no answer.

Location of VoIP Drupal Scripts

There are several script examples that are included in the voipdrupal downloaded module. You can *view the scripts in a list by going to this URL within your Drupal site:

http://your_site.com/voip/voipscripts

or, for those not using Clean URLs:http://your_site.com/?q=voip/voipscripts

Today we will enable the Conference Call script:http://your_site.com/voip/voipscripts/view/voipscript_join_conference

or, for those not using Clean URLs:http://your_site.com/?q=voip/voipscripts/view/voipscript_join_conference

* To view the sample scripts, you will need to have the Views module installed and enabled - http://drupal.org/project/views

http://your_site.com/voip/voipscripts

$script = new VoipScript('hello_world');$script->addSay('hello world');$script->addHangup();

Hello World

$script = new VoipScript('voipscript_small_office_ivr');$script->addSay(t('Welcome to our office hotline.));$script->addLabel(office_menu);$options_menu = t(For sales, dial 1. For customer support, dial 2. For hours of operation, dial 3. To hang up, dial the star key.);$input_options = array( 1 => sales, 2 => customer support, 3 => hours, * => hang up, I => hang up, t => hang up);$invalid_msg = t(Invalid option selected.);$script->addRunIvrMenu($options_menu, $input_options, $invalid_msg);$script->addGoto(%ivr_option_selected);$script->addLabel(sales);$script->addSay(Sales department);$script->addGoto(hang up);$script->addLabel(customer support);$script->addSay(t(Customer support department));$script->addGoto(hang up);$script->addLabel(hours);$script->addSay(t(Our office is open Monday to Friday from 9am to 5pm.));$script->addGoto(office_menu);$script->addLabel(hang up);$script->addSay(t(Thanks so much for calling our office. Bye bye.'));$script->addHangup();

Office Hotline

In the Default Call Configuration settings - /admin/voip/call/settings,Set the Default Inbound Call Script to: voipscript_join_conference and save.

Call our VoIP Drupal Phone Number

US 617-981-4636CAN 604-800-9161

Enter the 3-digit conference extension number to join(The extension number will be given during the Webinar)

Test your own setup by calling the Tropo VoIP phone number listed in the settings for your WebAPI application within your Tropo.com account. You can have multiple numbers within one account or one WebAPI.

Testing the System

Key Benefits of the Platform

Facilitates the construction of unified communications systems integrating SMS, email, web, and voice

Makes Drupal accessible from any phone no data plan required!

Enables the expansion of community plumbing beyond the web

Works with Drupal modules Actions, Triggers, Rules etc.

Is open source and free you are in control

Benefits for Administrators

Easy installation and configuration no programming required

Fully customizable enable only the features you need

Run as part of the Drupal system itself

Enable access to VoIP Drupal features using roles and permissions

Assign Rules, Actions and Triggers

Enhance user interaction with ready-to-use audio blogs, click-to-call fields, phone recorders, audio announcements, etc.

Benefits for Administrators

Easy installation and configuration no programming required

Fully customizable enable only the features you need

Run as part of the Drupal system itself

Enable access to VoIP Drupal features using roles and permissions

Assign Rules, Actions and Triggers

Enhance user interaction with ready-to-use audio blogs, click-to-call fields, phone recorders, audio announcements, etc.

Benefits for Developers

Well defined API that can be extended to other VoIP services

20+ sample scripts that can be customized

20+ modules that already implement common functionality no need to reinvent the wheel

Simple, yet powerful PHP-like scripting language with a short learning curve

Visual programming language for novice developers and fast prototyping

Next

Learn what you can do with VoIP Drupal without any programming skills. Easily install and configure several features using only your browser

The VoIP Drupal core module includes scripts that can be used as they are, or modified to suit your needs.

Learn about the visual programming language for novice developers to create fast prototypes

Episode

#2

#2

Setup and Configuration of VoIP Drupal Modules without Programming

Walk through the setup and configuration of VoIP Drupal modules that are very user friendly. No programming skills are needed to setup advanced interaction of the phone system with your Drupal Website.

***This topic will be comprised of several short Webinars that cover a few modules at a time.

Who is this for?Site Administrators

More than twenty sample scripts are included with the core VoIP Drupal module. Many of these scripts can be used without editing. This will allow you to have immediate functionality of some very advanced features.

These are just a few of the modules we will cover

"VoIP Drupal with little or no programming" -- explore what VoIP Drupal can do out of the box.

#2

#2

Who is this for?Site Administrators

Click2Call - Enable your Website to make outgoing phone callsAudioField - Using CCK to add an Audio field to content typesAudioRecorder - Enable users to post audio messages on your WebsitePhoneRecorder - Enable users to call your Website and interact in several ways.Small Office Script - Dial 2 for support, 3 for billing etc.AudioBlog - Enable posting of Audio and Text content from phonesExtensions - Enable phone extensions for users, or for pieces of content

Some of the Modules we will setup and configure:

#2

#2

Let's take a quick peek at Click2Call...

Click2Call will appear as Blocks On the administrative screen, choose how many blocks you would like for Click2Call and enable them on the Blocks Administration page.

Click2Call

Click2Call has 2 Admin screens, one for general settings and one for blocks. There is also a CCK field for Click2Call.

#2

#2

This is one style of a Block enabled with Click2Call

Episode

#3

#3

Setup and Configuration of Visual VoIP Drupal Workspace

This Webinar will show you how to create scripts using the visual editor components. Drag and drop scripts elements into the workspace to arrange events for user interaction or routing calls.

Who is this for?Developers + Site Admins

#3

#3

Let's go create and edit a script in the sandbox!

Open a browser and go to http://voipdrupal.org

Log in on the left:User name: voiptestPassword: voiptest

On the right, click on Create VoIP Scriptshttp://voipdrupal.org/node/add/voipscriptui Edit the text that says your message here and save the script.

On the right, click on Listen to your own VoIP Scriptshttp://voipdrupal.org/node/add/scripts-demo

Fill in a Title, then select the script you just created from the Click2Call list.

Save, then click on the Title link that appears and type in your phone number.

132456

Things We Accomplished Today:

We created and enabled an application in Tropo

We enabled the VoIP Drupal modules

We setup the VoIP Drupal Server Configurations

We setup the VoIP Drupal Default Call Configuration

We selected Scripts, Voices and Languages for Messages

We edited a sample script

We did not do any programming

We took a peek at Visual VoIP Drupal to inspire you!

We visited the VoIP Drupal Sandbox to play with scripts

Ways to Get Involved

Join http://groups.drupal.org/voip-drupal

Play with script samples in the sandbox at http://voipdrupal.org

Create new modules; new sites using VoIP Drupal

Contribute code and documentation

Organize meetups in your area (meetup.com)

Help us spread the word, using social media!

Support goes both ways in the Drupal Community Give some- Get some!

Always look at the resource options before seeking help in the forums!

Stay tuned to groups.drupal.org/voip-drupal for dates of future WebinarsUpcoming VoIP Drupal Events

List of Future Webinars, Meetups and Events

Office Hours: Every Wednesday at noon EST. We will be answering questions and discussing VoIP Drupal-related topics. To participate, meet us at the newly created VoIP Drupal chat room: http://voipdrupal.org/node/1296

drupal.org/voipdrupalgroups.drupal.org/voip-drupalvoipdrupal.org

Presented by: Michele (Micky) Metts

Special Thanks to:

For additional information on the VoIP Drupal Project:

Dr. Leo Burd and the MIT Center for Civic Media - civic.mit.edu

Drupal is a registered trademark of Dries Buytaert - http://buytaert.net