Azure.Communication.Messages 1.0.0

Azure 通信消息的 .NET 客户端库

此包包含 Azure 通信消息服务的 C# SDK。

源代码 | 包（NuGet） | 产品文档

入门

安装包

使用 NuGet 安装 Azure 通信消息的 .NET 客户端库

dotnet add package Azure.Communication.Messages

先决条件

您需要一个 Azure 订阅 和一个 通信服务资源 才能使用此包。

要创建新的通信服务，您可以使用Azure 门户、Azure PowerShell或.NET 管理客户端库。

关键概念

NotificationMessagesClient提供了发送通知消息的功能。

使用声明

using Azure.Communication.Messages;

验证客户端

连接字符串

消息客户端可以使用从Azure 门户获取的Azure通信资源中的连接字符串进行身份验证。

var connectionString = "<connection_string>"; // Find your Communication Services resource in the Azure portal
NotificationMessagesClient notificationMessagesClient = new NotificationMessagesClient(connectionString);
MessageTemplateClient messageTemplateClient = new MessageTemplateClient(connectionString);

示例

发送通知消息

要发送通知消息，请从NotificationMessagesClient调用Send或SendAsync函数。

发送文本消息

// Create the recipient list, currently only one recipient is supported 
var recipient = new List<string> { "<to-phone-number>" };
var textContent = new = new TextNotificationContent(new Guid("<channel-registration-id>"), recipient, "Come on everyone, let's go for lunch together.");
SendMessageResult result = await notificationMessagesClient.SendAsync(textContent);
Console.WriteLine($"Message id: {result.Receipts[0].MessageId}");

发送模板消息

// Create the recipient list, currently only one recipient is supported 
var recipient = new List<string> { "<to-phone-number>" };
string templateName = "sample_template";
string templateLanguage = "en_us";
var messageTemplate = new MessageTemplate(templateName, templateLanguage);
var templateContent = new TemplateNotificationContent(channelRegistrationId, recipientList, messageTemplate);
SendMessageResult result = await notificationMessagesClient.SendAsync(templateContent);
Console.WriteLine($"Message id: {result.Receipts[0].MessageId}");

发送媒体消息

// Create the recipient list, currently only one recipient is supported 
var recipient = new List<string> { "<to-phone-number>" };
var uri = new Uri("https://aka.ms/acsicon1");
var mediaContent = new MediaNotificationContent(channelRegistrationId, recipientList, uri);
SendMessageResult result = await notificationMessagesClient.SendAsync(mediaContent);
Console.WriteLine($"Message id: {result.Receipts[0].MessageId}");

检索模板

要检索模板，请从MessageTemplateClient调用GetMessages或GetMessagesAsync函数。

AsyncPageable<MessageTemplateItem> templates = messageTemplateClient.GetTemplatesAsync(channelId);
await foreach (MessageTemplateItem template in templates)
{
    Console.WriteLine($"{template.Name}");
}

故障排除

对于任何不成功的请求，都会抛出RequestFailedException作为服务响应。该异常包含有关从服务返回的响应代码的信息。

下一步

• 了解更多关于Azure通信服务中的消息的信息（链接待添加）。
• 了解更多如何设置新消息和消息投递状态的Event Grid订阅（链接待添加）。

贡献

此项目欢迎贡献和建议。大多数贡献都需要您同意贡献者许可协议（CLA），声明您拥有授予我们使用您贡献的权利，并且实际上确实授予了我们这样的权利。有关详细信息，请访问CLA。

本项目已采用Microsoft开源行为准则。有关更多信息，请参阅行为准则常见问题回答或通过[email protected]联系，以提出任何额外的问题或意见。