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
- A Twilio Account. Don't have one? Sign up for free!
- Follow the iOS full quickstart tutorial here or Android full quickstart tutorial here.
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