voice transcription mvp based on Twilio Client Quickstart App
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 6 commits ahead of TwilioDevEd:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Twilio Client Quickstart for Ruby

This application should give you a ready-made starting point for writing your own voice apps with Twilio Client. Before we begin, we need to collect all the config values we need to run the application:

Config Value Description
Account SID Your primary Twilio account identifier - find this in the console here.
Auth Token Used to authenticate - just like the above, you'll find this here.
TwiML App SID The TwiML application with a voice URL configured to access your server running this app - create one in the console here. Also, you will need to configure the Voice "REQUEST URL" on the TwiML app once you've got your server up and running.
Twilio Phone # A Twilio phone number in E.164 format - you can get one here

Setting Up The Ruby (Sinatra) Application

  1. Create a configuration file for your application:

    cp .env.example .env
  2. Edit .env with the four configuration parameters we gathered from above.

  3. Next, we need to install our depenedencies:

    bundle install
  4. Run the application using the ruby command.

    bundle exec ruby app.rb
  5. Your application should now be running at http://localhost:4567.

  6. Download and install ngrok

  7. Run ngrok:

    ngrok http 4567
  8. When ngrok starts up, it will assign a unique URL to your tunnel. It might be something like https://asdf456.ngrok.io. Take note of this.

  9. Configure your TwiML app's Voice "REQUEST URL" to be your ngrok URL plus /voice. For example:

    screenshot of twiml app

You should now be ready to rock! Make some phone calls. Open it on another device and call yourself. Note that Twilio Client requires WebRTC enabled browsers, so Edge and Internet Explorer will not work for testing. We'd recommend Google Chrome or Mozilla Firefox instead.

screenshot of phone app