https://github.com/freeclimbapi/csharp-sms-quickstart
https://github.com/freeclimbapi/csharp-sms-quickstart
messaging tutorial
Last synced: 7 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/freeclimbapi/csharp-sms-quickstart
- Owner: FreeClimbAPI
- Created: 2020-02-20T19:45:43.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2025-01-10T19:59:02.000Z (about 1 year ago)
- Last Synced: 2025-06-20T01:04:40.264Z (7 months ago)
- Topics: messaging, tutorial
- Language: C#
- Size: 40 KB
- Stars: 0
- Watchers: 3
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# C# SMS Quickstart
This quickstart serves as a guide to get your first SMS application up and running with [FreeClimb](https://docs.freeclimb.com/docs/how-freeclimb-works).
Specifically, the project will:
- Receive an incoming message via a FreeClimb application
- Respond "Hello World!" to the incoming message
## Tutorial
We offer a [C# SMS Quickstart Tutorial](https://docs.freeclimb.com/docs/c-messaging-quickstart) for more detailed set-up instructions and explanation of how FreeClimb works.
## Requirements
A [FreeClimb account](https://www.freeclimb.com/dashboard/signup/)
A [registered application](https://docs.freeclimb.com/docs/registering-and-configuring-an-application#register-an-app) with a named alias
A [configured FreeClimb number](https://docs.freeclimb.com/docs/getting-and-configuring-a-freeclimb-number) assigned to your application
Trial accounts: a [verified number](https://docs.freeclimb.com/docs/using-your-trial-account#verifying-outbound-numbers)
## Tools:
- [.NET](https://dotnet.microsoft.com/en-us/download)
- [ngrok](https://ngrok.com/download) (recommended for hosting)
## Setting up the Quickstart
1. Install the required packages
```bash
dotnet add package freeclimb
```
2. Configure environment variables (in `.env.sample` and rename the file to `.env`):
| ENV VARIABLE | DESCRIPTION |
| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| ACCOUNT_ID | Account ID which can be found under [API credentials](https://www.freeclimb.com/dashboard/portal/account/authentication) in dashboard. |
| API_KEY | API key which can be found under [API credentials](https://www.freeclimb.com/dashboard/portal/account/authentication) in dashboard. |
| FREECLIMB_NUMBER | The number that sends messages from your application. Your FreeClimb number. |
3. Make your local server publicly accessible
```bash
ngrok http 3000
```
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'.
4. [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 `/IncomingSms` to your App Config's SMS URL field:
```bash
https://YOUR-URL.ngrok.io/incomingSms
```
## Running the Quickstart
1. Start your voice quickstart application
```bash
dotnet run --urls=http://127.0.0.1:3000
```
2. Text the FreeClimb number assigned to the application you've configured for this tutorial
## Using Docker to Run the Quickstart
1. Pull docker image from dockerhub
```bash
docker pull freeclimbapi/csharp-sms-quickstart
```
2. Run docker image after replacing placeholder values
```bash
docker run -e ACCOUNT_ID= -e API_KEY= -e FREECLIMB_NUMBER= -p 3000:3000 freeclimbapi/csharp-sms-quickstart
```
## Feedback & Issues
If 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.