Before you can get started, you need the following already set up:
Set all SMS API configuration settings.
- The latest version of .Net Core with Long Term Support and a familiarity with how to create a new app.
Learn how to quickly send SMS messages in a .Net Core application with the Sinch API.
Create a new folder where you want your app project. Then, open a terminal or command prompt to that location.
Create a new .Net Core console app with the following command:
dotnet new console
Add the
Newtonsoft.Json
nuget package.dotnet add package Newtonsoft.Json
Open the
Program.cs
file in your project folder. Replace everything in the file with the following code:SMS sms = new SMS("YOUR_Sinch_virtual_number", new string[] {"recipient_number"}, "Hello from Sinch!" ); sms.sendSMS(sms, "YOUR_servicePlanId", "YOUR_API_token"); Console.ReadLine();
Next, create a new file in the project folder named
SMS.cs
. Populate that file with the "Send an SMS message" code found on this page.Send an SMS message// Find your Service Plan ID and API Token at dashboard.sinch.com/sms/api/rest // Find your Sinch numbers at dashboard.sinch.com/numbers/your-numbers/numbers using System.Text; using Newtonsoft.Json; public class SMS { public string from { get; set; } public string[] to { get; set; } public string body { get; set; } public SMS(string from, string[] to, string body) { this.from = from; this.to = to; this.body = body; } public async void sendSMS(SMS sms, string servicePlanId, string apiToken) { using (var client = new HttpClient()) { client.DefaultRequestHeaders.Add("Authorization", "Bearer " + apiToken); string json = JsonConvert.SerializeObject(sms); var postData = new StringContent(json, Encoding.UTF8, "application/json"); var request = await client.PostAsync("https://us.sms.api.sinch.com/xms/v1/" + servicePlanId + "/batches", postData); var response = await request.Content.ReadAsStringAsync(); Console.WriteLine(response); } } }
Save the file.
Back in the
Program.cs
file, replace the following values for these parameters with your values:Parameter Your value YOUR_Sinch_virtual_number
Any number you've assigned to your Sinch account. Find the number on your Sinch dashboard by clicking the service plan ID link and scrolling to the bottom of the page. recipient_number
The phone number to which you want to send the test SMS message. YOUR_servicePlanId
The API token found on your Sinch dashboard. Click Show
to reveal your API token.YOUR_API_token
The service plan ID found on your Sinch dashboard. Double check that the region is correct on your base URL. Learn more about regional options here.
Save the file.
Before executing your code, you must first compile your application. Execute the following command:
dotnet build
Now you can execute the code and send your test SMS message. Run the following command:
dotnet run
You should receive a text to the phone number you entered and you'll see a response in your terminal or command prompt. Press Enter
to exit the application. You did it!
The code you used in the SMS.cs
file sends a POST request to the Sinch API /batches
endpoint to send the SMS message.
- Explore the API specification to test more endpoints.