.NET SDK Guide¶

The Azure Communication Services (ACS) .NET SDK allows developers to integrate SMS, email, chat, and voice calling into their C# applications. It follows the standard Azure SDK for .NET patterns, including support for dependency injection and asynchronous operations.

NuGet Packages¶

The .NET SDK is modular. You only need to include the specific packages for the features you use.

Prerequisites¶

• .NET 6.0 or later.
• dotnet CLI or Visual Studio.
• An active Azure subscription and an ACS resource.

Quick Start: Send SMS¶

using Azure.Communication.Sms;

string connectionString = Environment.GetEnvironmentVariable("COMMUNICATION_SERVICES_CONNECTION_STRING");
SmsClient smsClient = new SmsClient(connectionString);

SmsSendResult result = await smsClient.SendAsync(
    from: "<your-acs-number>",
    to: "<recipient-number>",
    message: "Hello from .NET!"
);

Console.WriteLine($"Message sent with ID: {result.MessageId}");

SDK Workflow¶

The .NET SDK is designed for modern C# development, featuring Async methods and Response<T> wrappers.

graph TD
    Config[User Secrets / AppSettings] --> ClientInit[Initialize Client]
    ClientInit --> Operation[Await Client.OperationAsync]
    Operation --> Response[Handle Response / Exception]

Next Steps¶

• Tutorial: A complete guide to building a communication-enabled application.
• Recipes: Snippets for specific common tasks and configurations.

Sources¶

• Azure Communication Services .NET SDK Reference
• NuGet Gallery