Adam's Continuity at BlackAcid » twilio http://blogs.blackacid.org Experiments in Real Time Tue, 27 Jan 2009 23:24:00 +0000 en hourly 1 http://wordpress.org/?v=3.1-alpha Twilio Emulator http://blogs.blackacid.org/2009/01/24/twilio-emulator/ http://blogs.blackacid.org/2009/01/24/twilio-emulator/#comments Sat, 24 Jan 2009 19:50:59 +0000 aballai http://blogs.blackacid.org/2009/01/24/twilio-emulator/ Continue reading →]]> So I’ve been putting this off for the last month. I’ve written loggers, done the manual way, etc. Instead of starting my second private project with twilio, I decided while in the shower I needed to do this before I start. After about an hour, I’ve uploaded the start of it to my github profile, first repo to try it out too! Anyways, feel free to try it out and not burn any trial minutes or pay minutes (like myself) while developing your phone app. There are a number of bugs that I have not taken care of, but I’m not done working on it this weekend. And yes, not all nodes are implemented, but hopefully by the end of the day we have a nice pretty command line with proper tag validation and exception handling.
Below are the links to the repo.
GitHub Master
Public Clone URL

]]> http://blogs.blackacid.org/2009/01/24/twilio-emulator/feed/ 0 Building an IVR with Twilio http://blogs.blackacid.org/2008/12/10/building-an-ivr-with-twilio/ http://blogs.blackacid.org/2008/12/10/building-an-ivr-with-twilio/#comments Thu, 11 Dec 2008 05:52:25 +0000 aballai http://blogs.blackacid.org/?p=28 Continue reading →]]> Developing an IVR can immediately be a daunting task if you have not had any experience doing so before. To simplify it, Twilio.com came up with a solution that takes the complicated choices in technology away from the project. You will immediately start to think about your call system instead of which text-to-speech solution should we go with, which software pbx technology to implement, how much will our phone costs be, can we afford it? Wait, what about multi-lingual call handling? Don’t get me wrong, I like to build systems, asterisk is quite fun to get dirty with, but you can’t do both and have immediate results.
A glimpse at a call diagram

A glimpse at a call diagram

So after whiteboarding your idea, you want to start out with a menu system. I’d recommend splitting up the greeting from your initial menu. For example in TwiML, do a call redirect from the greeting to your menu.

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <Response>
  3. <Say>
  4. Welcome to Hello IVR.
  5. </Say>
  6. <Redirect>
  7. http://example.com/voice/hello/
  8. </Redirect>
  9. </Response>
  10. Download this code: welcome.xml

Menu’s should be simple, they should also conform to the same usage standard through every call screen.

Some common dial keys that have been recommended by others are:

  • * – Repeat
  • # – Go back
  • 7 – Previous
  • 9 – Next
  • 0 – Operator

Also, when asking for user selection, keep the number of choices to 5. Have them enter 9 for more options. With menu’s always make sure to gather input at anytime to allow quick navigation for experienced phone users. Here’s an example of a call menu with TwiML.

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <Response>
  3. <Gather
  4. numDigits="1"
  5. method="GET">
  6. <Say>
  7. Sales, press 1.
  8. </Say>
  9. <Say>
  10. Support, press 2.
  11. </Say>
  12. <Say>
  13. Frontdesk, press 3.
  14. </Say>
  15. <Say>
  16. For more options, press 9.
  17. </Say>
  18. <Say>
  19. For the operator, press 0.
  20. </Say>
  21. <Say>
  22. To hear the options again, please stay on the line.
  23. </Say>
  24. </Gather>
  25. <Pause />
  26. <Redirect>
  27. http://example.com/voice/menu/
  28. </Redirect>
  29. </Response>
  30. Download this code: menu.xml

When you want to build a search interface into your IVR, you need to make it simple, but also make sure you accept all input and handle all operations normally. People really want to press 0 when it doesn't work. Additionally, you need to keep track of the number of search failures and offer a solution. In most cases, a dial out to a human will suffice. In the case of no man power, I recommend a voicemail using TwiML's record tags. Here's an example search interface:

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <Response>
  3. <Gather
  4. method="GET"
  5. numDigits="3"
  6. finishOnKey=""
  7. timeout="5"
  8. action="http://example.com/voice/search/?failures=0">
  9. <Say>
  10. Please enter the first three letters of what you are looking for.
  11. </Say>
  12. </Gather>
  13. <Redirect>
  14. http://search.earth911.com/voice/what/?failures=0
  15. </Redirect>
  16. </Response>
  17.  
  18. Download this code: search.xml

When you have too much data, too little structure, and need to tell the phone user a book, don't. Give them options, a details menu is a good thing. If you provide information such as phone numbers, add an option to redirect the call. If you have related information or you are nested one level deep in a list, offer the option to go directly to the next item. It's important to provide this level of navigation as it will save them time and you money on your minutes.

Voicemail systems are not complicated, but are difficult to maintain. Fortunately, for us we don't have to worry about that, we just want to send the recorded message to the right dept. Handle your voicemail successes & failures accordingly. Have the user try again if the voicemail fails and always provide a fail-safe redirect so that they can try something else if they can't leave a voicemail at that time.

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <Response>
  3. <Say>
  4. Leave your name, company, and your phone number to best reach you.
  5. </Say>
  6. <Say>
  7. Press the star key when finished.
  8. </Say>
  9. <Record
  10. action="http://example.com/voice/voicemail/"
  11. method="GET"
  12. maxLength="20"
  13. finishOnKey="*"
  14. />
  15. <Say>
  16. Try again.  Press the star key when finished.
  17. </Say>
  18. <Record
  19. action="http://example.com/voice/voicemail/"
  20. method="GET"
  21. maxLength="20"
  22. finishOnKey="*"
  23. />
  24. <Redirect>
  25. http://example.com/voice/
  26. </Redirect>
  27. </Response>
  28.  
  29. Download this code: voicemail.xml

Next up, I'll talk about Robo-Calling!

]]> http://blogs.blackacid.org/2008/12/10/building-an-ivr-with-twilio/feed/ 1