{"id":19035741,"url":"https://github.com/freeclimbapi/java-voice-quickstart","last_synced_at":"2026-02-12T14:01:54.236Z","repository":{"id":51699970,"uuid":"218580567","full_name":"FreeClimbAPI/Java-Voice-Quickstart","owner":"FreeClimbAPI","description":"Java - Getting Started Tutorial","archived":false,"fork":false,"pushed_at":"2025-01-09T22:18:48.000Z","size":18381,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-09T23:24:51.113Z","etag":null,"topics":["quickstart"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/FreeClimbAPI.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-10-30T17:07:09.000Z","updated_at":"2025-01-09T22:18:53.000Z","dependencies_parsed_at":"2024-11-08T22:03:31.170Z","dependency_job_id":null,"html_url":"https://github.com/FreeClimbAPI/Java-Voice-Quickstart","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FreeClimbAPI%2FJava-Voice-Quickstart","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FreeClimbAPI%2FJava-Voice-Quickstart/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FreeClimbAPI%2FJava-Voice-Quickstart/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FreeClimbAPI%2FJava-Voice-Quickstart/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FreeClimbAPI","download_url":"https://codeload.github.com/FreeClimbAPI/Java-Voice-Quickstart/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240090090,"owners_count":19746351,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["quickstart"],"created_at":"2024-11-08T21:51:57.602Z","updated_at":"2026-02-12T14:01:49.216Z","avatar_url":"https://github.com/FreeClimbAPI.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Java Voice Quickstart\n\nThis quickstart serves as a guide to get your first Voice application up and running with [FreeClimb](https://docs.freeclimb.com/docs/how-freeclimb-works).\n\nSpecifically, the project will:\n\n- Receive an incoming call via a FreeClimb application\n- Respond with a [PerCL](https://docs.freeclimb.com/reference/percl-overview) command to say 'Hello World!' to caller\n\n## Tutorial\n\nWe offer a [Java Voice Quickstart Tutorial](https://docs.freeclimb.com/docs/java-voice-calling-quickstart) for more detailed set-up instructions and explanation of how FreeClimb works.\n\n## Requirements\nA [FreeClimb account](https://www.freeclimb.com/dashboard/signup/)\n\nA [registered application](https://docs.freeclimb.com/docs/registering-and-configuring-an-application#register-an-app) with a named alias\n\nA [configured FreeClimb number](https://docs.freeclimb.com/docs/getting-and-configuring-a-freeclimb-number) assigned to your application\n\nTrial accounts: a [verified number](https://docs.freeclimb.com/docs/using-your-trial-account#verifying-outbound-numbers)\n\nTools:\n- [Java](http://www.oracle.com/technetwork/java/javase/downloads/index.html/) 8 or higher\n- [Gradle](https://gradle.org/install/) 5.5 or higher\n- [ngrok](https://ngrok.com/download) (recommended for hosting)\n- [Git](https://git-scm.com/)\n\n## Setting up the Quickstart\n1. Make your local server publicly accessible\n    ```bash\n    ngrok http 3000\n    ```\n    Once you run ngrok you should receive a response with a public URL, that looks something like 'https://ba1c-63-209-137-19.ngrok-free.app'. \n\n2. [Configure your applications's endpoints](https://docs.freeclimb.com/docs/registering-and-configuring-an-application#configure-your-application) by adding a publicly accessible URL (we recommend an [ngrok](https://ngrok.com/download) URL) and the route reference `/incomingCall` to your App Config's VoiceURL:\n\n    ```bash\n    https://YOUR-URL.ngrok-free.app/incomingCall\n    ```\n    \n## Running the Quickstart\n1. Start your voice quickstart application\n\n    ```bash\n    gradle build \u0026\u0026 java -Dserver.port=3000 -jar build/libs/java-voice-quickstart.jar\n    ```\n\n2. Call the FreeClimb number assigned to the application you've configured for this tutorial \n\n## Using Docker to Run the Quickstart\n\n1. Pull docker image from dockerhub\n\n   ```bash\n   docker pull freeclimbapi/java-voice-quickstart\n   ```\n\n2. Run docker image\n\n   ```bash\n   docker run -p 3000:3000 freeclimbapi/java-voice-quickstart\n   ```\n\n## Feedback \u0026 Issues\nIf you would like to give the team feedback or you encounter a problem, please [contact support](https://www.freeclimb.com/support/) or [submit a ticket](https://freeclimb.com/dashboard/portal/support) in the dashboard.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffreeclimbapi%2Fjava-voice-quickstart","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffreeclimbapi%2Fjava-voice-quickstart","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffreeclimbapi%2Fjava-voice-quickstart/lists"}