Azure 通信服务 for Rust 📱 📧

这个 Rust 库为 Azure 通信 API 提供了一个便捷的包装器，使得将 Azure 通信服务集成到你的 Rust 项目中变得容易。

功能

• Azure 通信服务易于使用的接口
• 支持发送短信
• 支持发送电子邮件

安装

将以下内容添加到你的 Cargo.toml

[dependencies]
azure_communications = "0.1.0"

🚀 示例

请确保在 Azure 通信服务中注册一个账户并创建一个连接字符串。有关如何操作的信息，请参阅 此处。

使用示例文件

1. 克隆此仓库
2. 设置必要的环境变量
   • 在类 Unix 系统上

     export AZURE_COMMUNICATIONS_CONNECTION_STRING="your_connection_string"
     export SENDER_ADDRESS="[email protected]"
     export RECIPIENT_ADDRESS="[email protected]"
     

   • 在 Windows 上

     set AZURE_COMMUNICATIONS_CONNECTION_STRING=your_connection_string
     set [email protected]
     set [email protected]
     

3. 运行示例： cargo run --example email

程序将尝试使用 Azure 通信服务发送电子邮件。

用法

发送电子邮件 📧

send_mail 方法需要一个发送者地址、主题、可选的正文、可选的 HTML 正文和一个收件人列表。发送者地址必须是有效的电子邮件地址，并且必须在 Azure 通信服务门户中注册。更多信息可以在 官方文档 中找到。

收件人列表必须至少包含一个收件人，并且每个收件人必须有一个有效的电子邮件地址，以及可选的显示名称。

use azure_communication::{AzureCommunicationsClient, types::Recipient};

let az_communications = AzureCommunicationService::new(&connection_string, None);

let recipients = vec![Recipient {
    address: "[email protected]".to_string(),
    display_name: Some("Test".to_string()),
}];

let sender_adress = "[email protected]";

az_communications
    .send_mail(
        &sender_adress,
        "Hello from Azure Communications",
        Some("Hello!"),
        None,
        recipients,
    )
    .await
    .expect("Error sending email");

发送短信 📱

传递给 send_sms 方法的 sender_name 参数可以是 E.164 格式的电话号码的字符串或最多 11 个字母数字字符的字符串。发送者电话号码需要在 Azure 通信服务门户中注册。有关更多信息，请参阅 官方文档。

use azure_communication::AzureCommunicationsClient;

let az_communications = AzureCommunicationService::new(&connection_string, None);

az_communications
    .send_sms("SampleCoLtd", "Hello from Azure Communications", vec!["+1234567890"])
    .await
    .expect("Error sending SMS");

📌 待办事项

• 添加对电话通话的支持