We are currently in the process of updating this sample template. If you are encountering any issues with the sample, please open an issue at github.com/twilio-labs/code-exchange/issues and we'll try to help you.
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 |
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 .envEdit .env with the four configuration parameters we gathered from above. Export
the configuration in this file as system environment variables like so on Unix
based systems:
source .envBegin by creating a configuration file for your application:
cp .env.example.ps1 .env.ps1Edit .env.ps1 with the four configuration parameters we gathered from above.
"Dot-source" the file in PowerShell like so:
. .\.env.ps1This assumes you will run the application in the same PowerShell session. If not,
edit the .env.ps1 and uncomment the [Environment]::SetEnvironmentVariable calls.
After re-running the script, the environment variables will be peramently set for
your user account.
Next, we need to install our depenedencies from Maven and compile our application code:
mvn packageRun the application using the java -jar command.
java -jar target/client-quickstart-1.0-SNAPSHOT.jarYour application should now be running at http://localhost:4567.
There's just a few more steps to get Twilio's voice infrastructure talking to your server.
-
Run ngrok:
ngrok http 4567
-
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. -
Configure your TwiML app's Voice "REQUEST URL" to be your ngrok URL plus
/voice. For example:
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.
MIT