c# - 如何使用 Mailgun Rest API (C#) 发送 iCal 邀请

Question

我正在尝试将 iCal 格式的日历邀请添加到通过 MailGun API 发送的电子邮件中。这是我到目前为止所拥有的:

var request = new RestRequest();

request.AddParameter("domain", this.domain, ParameterType.UrlSegment);
request.Resource = "{domain}/messages";
request.AddParameter("from", contactDetails.SenderAddress);
request.AddParameter("to", contactDetails.RecipientAddress);
request.AddParameter("subject", message.Subject);
request.AddParameter("text", message.TextBody);
request.AddParameter("html", message.HtmlBody);

if (!string.IsNullOrWhiteSpace(message.IcalAttachment))
{
    request.AddFileBytes("attachment", 
                         Encoding.UTF8.GetBytes(message.IcalAttachment), 
                         "invite.ics", 
                         "text/calendar");
}

request.Method = Method.POST;
return request;

这导致日历作为附件包含在电子邮件中，不是电子邮件的替代 View 。附件在 gmail 中工作正常，但在 Outlook 中它显示为附件文件，您必须首先单击它，然后同意将日历添加到 Outlook 日历。是否有另一种使用 REST API 的方法，以便正确发送日历邀请，作为替代电子邮件 View ？

需要说明的是，这就是我使用 .Net SmtpClient 发送日历邀请的方式:

var contentType = new ContentType("text/calendar");
if (contentType.Parameters != null)
{
    contentType.Parameters.Add("method", "REQUEST");
    contentType.CharSet = "UTF-8";
}

// this is the same way you add a html view to the message
request.AlternateViews.Add(
    AlternateView.CreateAlternateViewFromString(
        message.IcalAttachment, 
        contentType));

Answer 1

特别感谢 Mailgun 的支持，为我指明了正确的方向。相关部分或他们的回应是:

You can use the /message.mime endpoint to construct the MIME for the calendar invite: https://documentation.mailgun.com/api-sending.html#sending

创建 MIME 消息并不像简单地使用/message 端点那么简单，但是有几个 .net 库可用于执行此操作。我用了MimeKit在这个例子中。

var request = new RestRequest();

request.AddParameter("domain", this.domain, ParameterType.UrlSegment);
request.Resource = "{domain}/messages.mime";
request.AddParameter("to", contactDetails.RecipientAddress);
request.AddFile(
    "message", 
    Encoding.UTF8.GetBytes(BuildMimeContent(message)), 
    "message.mime");

request.Method = Method.POST;
return request;

我要创建的 MIME 内容将包含一个多部分/混合正文，它又将包含一个多部分/替代项以及每个附件。日历邀请实际上会附加两次，作为替代 View 和附件。这是为了帮助不同电子邮件客户端之间的兼容性。

BuildMimeContent(message) 的实现如下所示:

// create the alternative views
var textBody = new TextPart("plain") { Text = message.TextBody };
var htmlBody = new TextPart("html") { Text = message.HtmlBody };

// add views to the multipart/alternative
var alternative = new Multipart("alternative");
alternative.Add(textBody);
alternative.Add(htmlBody);

if (!string.IsNullOrWhiteSpace(message.CalendarInvite))
{
    // also add the calendar as an alternative view
    // encoded as base64, but 7bit will also work
    var calendarBody = new TextPart("calendar")
    {
        Text = message.CalendarInvite,
        ContentTransferEncoding = ContentEncoding.Base64
    };

    // most clients wont recognise the alternative view without the 
    // method=REQUEST header
    calendarBody.ContentType.Parameters.Add("method", "REQUEST");
    alternative.Add(calendarBody);
}

// create the multipart/mixed that will contain the multipart/alternative
// and all attachments
var multiPart = new Multipart("mixed") { alternative };
if (!string.IsNullOrWhiteSpace(message.CalendarInvite))
{
    // add the calendar as an attachment
    var calAttachment = new MimePart("application", "ics")
    {
        ContentDisposition = new ContentDisposition(ContentDisposition.Attachment),
        ContentTransferEncoding = ContentEncoding.Base64,
        FileName = "invite.ics",
        ContentObject = new ContentObject(GenerateStreamFromString(message.CalendarInvite))
    };

    multiPart.Add(calAttachment);
}

// TODO: Add any other attachements to 'multipart' here.

// build final mime message
var mimeMessage = new MimeMessage();
mimeMessage.From.Add(GetMimeAddress(message.MessageInfo.SenderName, message.MessageInfo.SenderAddress));
mimeMessage.To.Add(GetMimeAddress(message.MessageInfo.RecipientName, message.MessageInfo.RecipientAddress));
mimeMessage.Subject = message.Subject;
mimeMessage.Body = multiPart;

// parse and return mime message
return mimeMessage.ToString();

针对使用 Office 365 进行测试的人员的警告

Office365 在验证日历邀请时非常挑剔。为避免收到如下所示的消息，您需要确保 vCal 的 organizer 电子邮件地址与电子邮件的 from 地址相匹配。如果您使用的是 mailgun 的沙箱测试环境，这是不可能的。