如何利用GraphServiceClient获取邮件投递状态及失败反馈？

核心结论 #

完全可行，通过保存邮件到已发送文件夹+追踪邮件ID+监听投递反馈，就能实现投递失败时的状态更新。

具体实现步骤 #

1. 先创建草稿再发送，获取唯一邮件ID #

原SendMail方法不会返回邮件ID，无法后续追踪。改成先创建草稿、拿到ID后再发送，就能关联后续投递状态：

var graphServiceClient = new GraphServiceClient(GetCredentials());

// 1. 创建邮件草稿，获取唯一标识ID
var draftMessage = await graphServiceClient
    .Users[NOREPLY_SENDER_ID]
    .Messages
    .Request()
    .AddAsync(message);
string messageId = draftMessage.Id;

// 2. 发送草稿，默认会保存到已发送文件夹
await graphServiceClient
    .Users[NOREPLY_SENDER_ID]
    .Messages[messageId]
    .Send()
    .Request()
    .PostAsync();

注：邮件的Id本身就是全局唯一标识，可直接关联你的业务记录，无需额外生成GUID。

2. 处理即时投递错误 #

发送时遇到即时可检测的错误（如收件人邮箱格式无效、发送权限不足），Graph会直接抛出ServiceException，可捕获异常并更新状态：

try
{
    // 发送邮件代码...
}
catch (ServiceException ex)
{
    // 根据错误码判断类型，例如收件人不存在对应错误码"ErrorInvalidRecipient"
    if (ex.Error.Code == "ErrorInvalidRecipient")
    {
        // 更新业务状态为「投递失败：收件人邮箱不存在」
    }
    // 其他错误类型的处理逻辑
}

3. 追踪异步投递失败（如延迟的收件人不存在） #

部分错误是异步发生的（比如收件人邮箱真实不存在，邮件发出后被对方服务器退回），此时Exchange会生成未送达报告（NDR），可通过两种方式追踪：

方式一：定期查询已发送邮件的投递状态

通过邮件ID查询已发送邮件的internetMessageHeaders，解析其中的投递状态头信息：

var sentMessage = await graphServiceClient
    .Users[NOREPLY_SENDER_ID]
    .Messages[messageId]
    .Request()
    .Select("internetMessageHeaders")
    .GetAsync();

// 提取投递状态头
var deliveryStatusHeader = sentMessage.InternetMessageHeaders
    .FirstOrDefault(h => h.Name.Equals("X-Delivery-Status", StringComparison.OrdinalIgnoreCase));
if (deliveryStatusHeader?.Value == "Failed")
{
    // 更新业务状态为投递失败
}

方式二：监听NDR邮件的webhook

订阅发件人邮箱的收件箱，当收到NDR时，通过NDR中的In-Reply-To头关联原邮件ID，进而更新对应业务记录的状态。

关键说明 #

• 必须保存邮件到已发送文件夹：只有保存后，才能通过Graph API查询到邮件的后续投递状态，以及关联NDR。
• 邮件ID足够唯一：Graph返回的邮件Id本身就是全局唯一标识，无需额外生成GUID。

内容的提问来源于stack exchange，提问作者Mark Chequer