jsgoecke / fonolo

Click here to lend your support to: fonolo and make a donation at www.pledgie.com !

Ruby Library for consuming the Fonolo web services for deep dialing

This URL has Read+Write access

Added the new test to the gemspec and incremented the version number
jsgoecke (author)
Sun Jan 25 09:28:07 -0800 2009
commit  391bb7999c3419a249d33470c5a3a43a2e1de7d3
tree    01eadcaec8142c8ec4e70917fb58060488871588
parent  764ea297b920cb2be02c2072218606aa730c92ee
fonolo /
name age
history
message
file .gitignore Loading commit data...
file LICENSE
file README.textile
file fonolo.gemspec
directory lib/
directory test/
README.textile

Fonolo Ruby Library

Description

Ruby library for consuming the Fonolo web services. Fonolo allows deep dialing of corporate IVR menus to bypass the machine and get directly to humans.

Features

The library exposes all of the methods available in the Fonolo API v1.1 and returns a Ruby hash of the results. These methods include:

  • check_member
  • check_member_number
  • company_search
  • company_list
  • company_details
  • call_start
  • call_status
  • call_canel

For more information please refer to the Fonolo developer website. In order to use this library you will need to sign-up for a username/password and a developer key from the Fonolo website.

Example


	
	require 'fonolo'

#Initialize the Fonolo object
fonolo = Fonolo.new(“uname”, “passwd”, “key”)

#Check that your username and password are registered as a valid member
fonolo.check_member

#Check that the phone number you plan to use is registered with your user
fonolo.check_member_number(“4155551212”)

#Search the company directory
fonolo.company_search(“hotels”)

#List all of the companies in the Fonolo database from a certain date
fonolo.company_list(5, 0, “2008-01-01”)

#Obtain the company details retrieved from a search or list with company_id
fonolo.company_details(“company_id”)

#Initiate a ‘deep dial’ to a particular company using the company_id
response = fonolo.call_start(“company_id”, “415-555-1212”)

#Obtain the call status based on the session id from a call_start request
fonolo.call_status(response[“result”][“data”][“session_id”])

#Disconnect a call with the session id from a call_start request
fonolo.call_cancel(response[“result”][“data”][“session_id”])


h2. Dependencies

  • json_pure v1.1.3+ (for JRuby compatibility)

Installation

sudo gem install jsgoecke-fonolo —source=http://gems.github.com/