As promised from my post, Exploring Telco Clouds with VoIP Drupal, Tropo & Twilio, this is the first part of a how-to and hello-world for VoIP Drupal with Tropo as the backend service.
The first step is to install Drupal version 6.x as the VoIP Drupal module won’t work with earlier versions or Drupal 7.x. There are many how-tos for installing Drupal and the process is quite painless so I won’t be reviewing it.
The next steps are to:
- Get an account with Tropo over here.
- Install the VoIP Drupal module in the standard way you install modules, it can be downloaded from here.
Next, configure Tropo:
- Logon to Tropo with the account you created.
- Create a new Tropo application for your site:
- In “Your Applications” section which you will find on the account page, click on the link “Create new application” and choose “Tropo WebAPI”.
- Fill in with a name of your choice in the application name field.
- Fill in the URL field with either of the following patterns, depending on whether you have enabled clean URLs in Drupal:
- http://mysite.com/voip/tropo/callhandler/ (With clean URLs)
- http://mysite.com/voip/?q=tropo/callhandler/ (Without clean URLs)
- Now press the “Create Application” button on the screen.
- Activate your application tokens:
- Click on “Outbound Tokens” > “Voice”, a pop-up window will appear with a “Launch Token” button. Press the button.
- Repeat the same procedure for the Messaging token.
(Note: These two tokens are required for the Tropo configuration in your Drupal site, so make sure you copy them for future use)
- Now you can go ahead with associating a phone numbers with your site. Tropo provides both a default Skype and SIP address for your application. If you want to associate additional phone numbers with your Tropo account, follow these steps:
- Click on “Add new phone number”, a pop up window will appear.
- Choose a phone number from the list and press the plus (+) sign shown on the right. The phone number you enter will be a new inbound number for your site. (Add any additional numbers you want and close the pop up window).
- You can view all the numbers/addresses in the Tropo applications’ settings where they are all listed.
- Navigate to your sites admin > voip > call section
- Enter the new number in the “caller id number” field. The field takes in numeric digits only.
- Now you can associate instant messaging networks with your site including GTalk, MSN, Twitter:
- Click on the icon for the IM network you want to add under the “Instant Messaging Networks” section in the Tropo application.
- Fill in the username and password.
- Click on the “activate” button located to the right.
Note: If you want to use a specific number as the caller ID for all calls made from your site, follow these steps:
Now you must configure VoIP Drupal:
- Install the voiptropo.module and enable it.
- Set Tropo as the VoIP server:
- Go to admin > voip > servers
- Click on the “configure” link under Tropo
- Using your Tropo credentials, fill in the “Username” and “Password” field.
- Fill in the “Messaging Outbound Token” and “Voice Outbound Token” with the tokens you saved when you configured the Tropo service:
- Press “Save”. This takes you back to the admin > voip > servers page
- Now select the ‘Tropo’ option
- Press the button ‘Set default voip server’
- Now enable outgoing calls (outbound) to be made from your site:
- Go to admin > users > permissions
- Look for the “VoIP Module” permissions
- Enable the “make outbound calls” permission for the roles desired in this location
- Press the “save permissions” button
That’s it; you now have finished configuring VoIP Drupal and are ready to start building your application, which I will cover tomorrow when I get some time…
