{"id":22085670,"url":"https://github.com/nexmo/dotnet-skeleton-app","last_synced_at":"2026-05-02T09:34:36.003Z","repository":{"id":51080360,"uuid":"249763389","full_name":"Nexmo/dotnet-skeleton-app","owner":"Nexmo","description":"Sample .NET app to test environment setup","archived":false,"fork":false,"pushed_at":"2021-05-24T20:17:34.000Z","size":718,"stargazers_count":0,"open_issues_count":9,"forks_count":0,"subscribers_count":15,"default_branch":"main","last_synced_at":"2025-01-29T05:25:13.963Z","etag":null,"topics":["dotnet","nexmo","sms"],"latest_commit_sha":null,"homepage":null,"language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Nexmo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-03-24T16:45:41.000Z","updated_at":"2023-07-04T07:31:51.000Z","dependencies_parsed_at":"2022-09-03T10:12:26.175Z","dependency_job_id":null,"html_url":"https://github.com/Nexmo/dotnet-skeleton-app","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/Nexmo%2Fdotnet-skeleton-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nexmo%2Fdotnet-skeleton-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nexmo%2Fdotnet-skeleton-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nexmo%2Fdotnet-skeleton-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Nexmo","download_url":"https://codeload.github.com/Nexmo/dotnet-skeleton-app/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245175481,"owners_count":20572787,"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":["dotnet","nexmo","sms"],"created_at":"2024-12-01T01:15:52.256Z","updated_at":"2026-05-02T09:34:35.954Z","avatar_url":"https://github.com/Nexmo.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Vonage .NET Skeleton Application\n\nThis is a basic .NET core 3.1 application built to allow you to easily test your credentials and enviornment. Utilize this app to ensure that your API credentials are in working order and to make sure you can receive webhook data on your endpoint.\n\n[![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy)\n\n* [Requirements](#requirements)\n* [Installation and Usage](#installation-and-usage)\n  * [API Credentials](#api-credentials)\n  * [Using ngrok](#using-ngrok)\n  * [Running the Application](#running-the-application)\n\t* [Sending an Sms](#sending-an-sms)\n\t* [Receiving an Sms](#receiving-an-sms)\n* [Contributing](#contributing)\n* [License](#license)\n\n\n## Requirements\n\nThis application requires you to have:\n\n* [.NET core 3.1 runtime](https://dotnet.microsoft.com/download/dotnet-core/3.1)\n* [Visual Studio 2019 - community should work](https://visualstudio.microsoft.com/downloads/)\n\n## Installation and Usage\n\n1. Grab this repo\n\n```text\ngit clone https://github.com/nexmo/dotnet-skeleton-app.git\n```\n\n2. Open `dotnet-skeleton-app.sln` in Visual Studio\n\n### Api Credentials\n\nYour Api Key and Api Secret can be found in the [Vonage API Dashboard](https://dashboard.nexmo.com/)\n\nYou can set your Api Key or Api Secret for the app one of two ways:\n\n1. In Visual Studio - right click on the dotnet-skeleton-app projects and click properties. Inside the properties menu click debug, in debug add new enviornment variables for `VONAGE_API_KEY` and `VONAGE_API_SECRET`\n\n2. Open dotnet-skeleton-app/Controllers/SmsController.cs and replace the VONAGE_API_KEY and VONAGE_API_SECRET with your key/secret\n\n### Using Ngrok\n\nIn order to test the incoming webhook data from Vonage, the Vonage API needs an externally accessible URL to send that data to. A commonly used service for development and testing is ngrok. The service will provide you with an externally available web address that creates a secure tunnel to your local environment. The [Nexmo Developer Platform](https://developer.nexmo.com/concepts/guides/testing-with-ngrok) has a guide to getting started with testing with ngrok.\n\nOnce you have your ngrok URL, you can enter your [Vonage Dashboard](https://dashboard.nexmo.com) and supply it as the `EVENT URL` for any Vonage service that sends event data via a webhook. A good test case is creating a Voice application and providing the ngrok URL in the following format as the event url:\n\n`#{ngrok URL}/webhooks/inbound-sms`\n\nYou can then text your Vonage number, and with your skeleton application running you can observe the webhook data be received in real time for diagnosis of any issues and testing of your Vonage account.\n\n## Running the Application\n\nOnce your API credentials have been added, and ngrok setup, you're ready, To start the application server simply hit f5 or click debug in IIS express\n\n### Sending an SMS\nThis will bring you to the SMS controller page - here input\n\n1. The number you are sending to\n2. The Vonage Number you are sending from\n3. The message you would like to send\n\nAfter that click 'send' and your message will be sent\n\n### Receiving an SMS\n\nYou can now send a sms message back to your Vonage number - since you've configured ngrok you will see something like this output to your debug console\n\n```text\n------------------------------------\nINCOMING TEXT\nFrom: 12018675309\nTo: 13218675309\nMessage: Test\nId: 170000026DFEE1C4\nTime Stamp: 1585070409\n------------------------------------\n```\n\nYou can exit the application by hitting stop in visual studio.\n\n## Contributing\n\nWe ❤️ contributions from everyone! [Bug reports](https://github.com/nexmo/dotnet-skeleton-app/issues), [bug fixes](https://github.com/nexmo/dotnet-skeleton-app/pulls) and feedback on the application is always appreciated. Look at the [Contributor Guidelines](https://github.com/Nexmo/dotnet-skeleton-app/blob/master/CONTRIBUTING.md) for more information and please follow the [GitHub Flow](https://guides.github.com/introduction/flow/index.html).\n\n## License\n\nThis projet is under the [MIT License](LICENSE.md)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnexmo%2Fdotnet-skeleton-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnexmo%2Fdotnet-skeleton-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnexmo%2Fdotnet-skeleton-app/lists"}