Home

Awesome

Programmable Voice: Quickstart Application Server - Java

This repository contains the server-side web application required to run the Twilio Programmable Voice iOS SDK Quickstart and Android SDK Quickstart mobile sample apps.

Looking for the Quickstart mobile app?

Download the client-side Quickstart Applications in Swift and iOS here:

Download the client-side Quickstart Application for Android here:

Prerequisites

Setting up the Application

This application uses the lightweight Spark Framework, and requires Java 8 and Maven.

Begin by creating a configuration file for your application:

cp .env.example .env

Edit .env with the three configuration parameters we gathered from above. Export the configuration in this file as system environment variables like so on Unix based systems:

source .env

Next, we compile our application code:

mvn package

Now we should be all set! Run the application using the java -jar command.

java -jar target/voice-quickstart-1.0-SNAPSHOT.jar

Visit http://localhost:4567 to ensure the server is running.

Up and running

This web application needs to be accessbile on the public internet in order to receive webhook requests from Twilio. Ngrok is a great options for getting this done quickly.

Once you have the application running locally, in a separate terminal window, make your server available to the public internet with the following:

ngrok http 4567

You should see a dynamically generated public Ngrok URL in the command window. Ngrok will now tunnel all HTTP traffic directed at this URL to your local machine at port 3000.

Test the app

Test your app by opening the {YOUR_SERVER_URL}/accessToken endpoint in your browser. Use the publicly accessible domain on ngrok. You should see a long string. This is an Access Token. You can examine its contents by pasting it into a JWT tool like jwt.io.

License

MIT