IP Messaging Quickstart for Java

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

Config Value	Description
Service Instance SID	Like a database for your IP Messaging data - generate one in the console here
Account SID	Your primary Twilio account identifier - find this in the console here.
API Key	Used to authenticate - generate one here.
API Secret	Used to authenticate - just like the above, you'll get one here.

A Note on API Keys

When you generate an API key pair at the URLs above, your API Secret will only be shown once - make sure to save this in a secure location, or possibly your ~/.bash_profile.

Setting Up The Java Application

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

Begin by creating a configuration file for your application:

cp .env.example .env

Edit .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 .env

Next, we need to install our depenedencies from Maven:

mvn install

And compile our application code:

mvn package

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

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

Your application should now be running at http://localhost:4567. Open this page in a couple browsers or tabs, and start chatting!

License

MIT