1. RUBY ON THE PHONE
Mat Schaffer, Ruby Nation 2011

2. MAT
SCHAFFER
github.com/matschaffer
@matschaffer

3. RAILS – JAVASCRIPT
(for hire)

4. CALLME

5. • Provider comparison
• Making phone calls
• Handling Call flow
• SMS
• Testing

6. XML REST API JSON REST API
you generate TwiML they host a JVM script
just phone and SMS IM and Twitter integration
1¢/2¢ per minute 3¢ per minute
$1 per month per line $3 per month per line

7. PLACING CALLS

8. https://github.com/webficient/twilio
require 'rubygems'
require 'twilio'
Twilio.connect(ENV['TWILIO_SID'], ENV['TWILIO_TOKEN'])
Twilio::Call.make('+12155551213',
'+12155551234',
'http://myapp.com')
From*
To
What do to

9. > curl -d From=+12155551212
-d To=+12155551234
-d Url=http://myapp.com
-u $TWILIO_SID:$TWILIO_TOKEN
https://api.twilio.com/2010-04-01/Accounts/
$TWILIO_SID/Calls

10. POST https://twilio/call
Url=http://me/calls
POST https://me/calls
CallSid=CAc7ca63fb9...

11. <?xml version="1.0" encoding="UTF-8" ?>
<Response>
<Say>Hello Ruby Nation</Say>
</Response>

12. INCOMING CALLS

14. require 'rubygems'
require 'twilio'
Twilio.connect(ENV['TWILIO_SID'], ENV['TWILIO_TOKEN'])
resp = Twilio::AvailablePhoneNumbers.search_local(:postal_code => '20191')
numbers = resp['TwilioResponse']['AvailablePhoneNumbers']['AvailablePhoneNumber']
my_number = numbers.first
Twilio::IncomingPhoneNumber.create(:PhoneNumber => my_number['PhoneNumber'],
:VoiceUrl => 'http://myapp.com')

16. For a good time call (540) 318-2266
post '/' do
return Twilio::Verb.new do |v|
v.say "Welcome to the party!"
v.dial do
v.conference 'rubynation_partyline'
end
end.response
end
<?xml version="1.0" encoding="UTF-8"?>
<Response>
<Say>Welcome to the party!</Say>
<Dial>
<Conference>rubynation_partyline</Conference>
</Dial>
</Response>

18. TWIML

19. VERBS
OUTPUT <Play> <Say>
INPUT <Gather> <Record>
<Dial>
CALLS <Number> <Conference>
<Hangup> <Reject>
OTHERS <Pause> <Redirect> <Sms>

20. WHOOPS! RAILS ISSUES
• skip_before_filter :verify_authenticity_token
• be careful about response types (use *.xml or filter)
• tough to fit in RESTful model

21. CALL FLOW

22. TWILIO LOOP
1.Post initial call information with new CallSid
2.Perform action
3.Post action’s result with original CallSid
4.Repeat

23. <?xml version="1.0" encoding="UTF-8"?>
<Response>
<Gather action="/calls/response.xml">
" <Say>Hi there, press a number</Say>
</Gather>
</Response>
<?xml version="1.0" encoding="UTF-8"?>
<Response>
<Say>Thanks for your input</Say>
</Response>

24. <?xml version="1.0" encoding="UTF-8"?>
<Response>
<Dial action="/calls/complete.xml">
" <Number url="/calls/prompt.xml?connection_id=1">2155551212</Number>
</Dial>
</Response>
<?xml version="1.0" encoding="UTF-8"?>
<Response>
<Say>
Here’s what the called person hears
</Say>
</Response>
<?xml version="1.0" encoding="UTF-8"?>
<Response>
<Say>The caller hears this after the call</Say>
</Response>

25. SMS

26. SENDING
require 'rubygems'
require 'twilio'
Twilio.connect(ENV['TWILIO_SID'], ENV['TWILIO_TOKEN'])
Twilio::Sms.message('+12155551213',
'+12155551234',
"Hello sms")

27. RECEIVING
require 'rubygems'
require 'sinatra'
require 'twilio'
post '/sms' do
return Twilio::Verb.new do |v|
v.sms "Ohai #{params[:From]}"
end.response
end
<?xml version="1.0" encoding="UTF-8"?>
<Response>
<Sms>Ohai +12155551212</Sms>
</Response>

28. TESTING

29. REST CALL TESTING
• Mocking: Mocha, Rspec, etc
• HTTP Mocking: VCR, Artiface, FakeWeb, WebMock

30. require 'rubygems'
require 'sinatra'
class FakeTwilio < Sinatra::Base
def fixture(resource)
resource.gsub!('/', '-')
Rails.root.join('test', 'support', 'twilio_responses',
"#{resource}-GET.xml").read
end
get '/2010-04-01/Accounts/:sid/*' do |sid, resource|
fixture(resource)
end
post '/2010-04-01/Accounts/:sid/*' do |sid, resource|
fixture(resource)
end
end
Artifice.activate_with(FakeTwilio)

31. ARTIFICE + CUCUMBER
Kinda sucked. got better?
module Selenium
Net = ::Net.dup
module Net
HTTP = Artifice::NET_HTTP
end
end
class Capybara::Server
Net = ::Net.dup
module Net
HTTP = Artifice::NET_HTTP
end
end

32. TWIML TESTING
test "new should omit connected connections" do
@connection.connect!
post :new, :CallSid => @sid
assert_match "Number", response.body
assert_not_match @connection.number, response.body
end
Basic match testing

33. NEED MORE INPUT?

34. THANK YOU
questions?