Send a message

Note:

Before you can get started, you need to do the following:

Set all Conversation API configuration settings.
The latest version of .Net Core with Long Term Support and a familiarity with how to create a new console application.

Using the Conversation API, you can send messages to any channel you have configured. This tutorial shows you how to set up and send a message in a .Net Core application.

Steps:

Set up your .Net Core application
Send your first message

Set up your .Net Core application

Create a new folder where you want to keep your app project. Then, open a terminal or command prompt to that location.
Create a new .Net Core console app with the following command:
Copy

Copied
```
dotnet new console
```
Add the Newtonsoft.Json NuGet package.
Copy

Copied
```
dotnet add package Newtonsoft.Json
```

Modify your application

Note:

This tutorial uses basic authentication for testing purposes. We recommend OAuth 2.0 authentication in a production environment. Read more about authentication methods here.

Open the Program.cs file in your project folder. Replace all of the code in the Main method with the following code:

Copy

Copied

SendMessage sendMessage = new SendMessage("App_Id", "Channel", "Identity");
sendMessage.send(sendMessage, "Access_Key", "Access_Secret", "Project_Id");
Console.ReadLine();

Assign your values to the following parameters:

Parameter	Your value
`App_Id`	Find your app ID on your Sinch dashboard.
`Access_Key`	Find your access key on your Sinch dashboard.
`Access_Secret`	Find your access secret on your Sinch dashboard. Note: Access secrets are only available during initial key creation.
`Project_Id`	Find your project ID on your Sinch dashboard.
`Channel`	The channel you want to use to send the message. Available channels are configured for the app on your Sinch dashboard. This guide assumes you've started with an `SMS` channel, but you can use any channel configured for your app: `SMS` `MESSENGER` `MMS` `RCS` `WHATSAPP` `VIBER` `VIBERBM` `INSTAGRAM` `TELEGRAM` `KAKAOTALK` `APPLEBC` `LINE`
`Identity`	The ID of the contact to which you want to send the message.

Save the file.
Next, create a new file in the project folder named Message.cs. Populate that file with the "Message.cs" code found on this page and save the file. This code sends a text message.

Note:

This sample code is configured for the US region. If your Conversation API app wasn't created in the US region, replace all instances of https://us.conversation.api.sinch.com with https://eu.conversation.api.sinch.com in the sample code.

Before executing your code, you must first compile your application. Execute the following command:
Copy

Copied
```
dotnet build
```

Send your first message

Now you can execute the code and send your test message. Run the following command:

Copy

Copied

dotnet run

You should receive a message in your configured messaging platform.

Next steps

Now that you know how to send a message, learn how to handle an incoming message.

Additional resources

Read the links below to learn more: