Java SMS Quickstart

This quickstart serves as a guide to get your first SMS application up and running with FreeClimb.

Specifically, the project will:

• Receive an incoming message via a FreeClimb application
• Respond "Hello World!" to the incoming message

We offer a Java SMS Quickstart Tutorial for more detailed set-up instructions and explanation of how FreeClimb works.

A FreeClimb account

A registered application with a named alias

A configured FreeClimb number assigned to your application

Trial accounts: a verified number

Tools:

• Java 8 or higher
• ngrok (recommended for hosting)
• Gradle

1. Configure environment variables:

   ENV VARIABLE	DESCRIPTION
   ACCOUNT_ID	Account ID which can be found under API credentials in dashboard.
   API_KEY	API key which can be found under API credentials in dashboard.

2. Replace placeholder values for to and from numbers:

   VARIABLE	DESCRIPTION
   TO	The number which will receive messages from your application. For trial accounts, this is your verified number.
   FROM	The number that sends messages from your application. Your FreeClimb number.

3. Configure your applications's endpoints by adding a publicly accessible URL (we recommend an ngrok URL) and the route reference /incomingSms to your App Config's SMS URL field:

   https://YOUR-URL.ngrok.io/incomingSms

1. Start your voice quickstart application

   gradle build && java -Dserver.port=0080 -jar build/libs/Java-SMS-Quickstart-3.0.6-plain.jar

2. Call the FreeClimb number assigned to the application you've configured for this tutorial

If you would like to give the team feedback or you encounter a problem, please contact support or submit a ticket in the dashboard.