Node.js用Mailgun发送同步Gmail/Outlook日历邀请及RSVP实现

你的代码存在3个核心错误，导致Gmail、Outlook无法识别日历邀请，只能将其作为普通带附件邮件处理，自然不会自动同步日历、显示RSVP选项：

• 错误将.ics文件作为普通附件发送，没有按照iCalendar规范构造MIME邮件结构
• 生成的ICS文件存在字段缺失、属性值不符合RFC 5545标准的问题
• 参会人状态配置错误，客户端判定为已处理的邀请，不会弹出响应选项

1. 调整ical-generator生成逻辑 #

你之前的代码存在重复字段、属性挂载层级错误、字段值不符合规范的问题，直接替换为以下配置即可：

const ical = require('ical-generator');
// 初始化日历时指定发件域名，用于生成符合规范的事件ID
const cal = ical({ domain: '你的发件域名，例如dummy.in' });
// REQUEST方法必须设置在日历对象层级，不要挂载到单个事件上
cal.method('REQUEST');

cal.createEvent({
  // 时间字段传Date对象，避免时区解析错误
  start: new Date('2022-06-02T06:59:52.653Z'),
  end: new Date('2022-06-02T07:59:52.653Z'),
  summary: 'Test mail',
  description: 'Hi User',
  // UID必须带@域名后缀，保证全局唯一，不要只用纯数字
  uid: '125756xr378@dummy.in',
  sequence: 0,
  location: 'USA, main',
  organizer: {
    name: 'Narendra M',
    email: 'narendrahd@example.in'
  },
  attendees: [
    // 组织者如果要参会，单独配置，状态设为ACCEPTED
    {
      name: 'Narendra M',
      email: 'narendrahd@example.in',
      rsvp: true,
      partstat: 'ACCEPTED',
      role: 'CHAIR'
    },
    // 其余收件人状态必须设为NEEDS-ACTION，否则不会显示RSVP按钮
    {
      name: 'Veda',
      email: 'iamnotveda@example.com',
      rsvp: true,
      partstat: 'NEEDS-ACTION',
      role: 'REQ-PARTICIPANT'
    }
  ],
  // 标记事件为已确认状态
  status: 'CONFIRMED'
});

// 不需要保存到本地文件，直接生成ICS字符串即可
const icsContent = cal.toString();

注意：不要往createEvent方法里传Content-Type、subject这类不属于事件属性的字段，这些字段不会被写入最终ICS文件，反而可能导致生成的内容格式异常。

2. 调整Mailgun发送配置 #

绝对不要把ICS文件放在attachment字段里，必须作为内联内容嵌入邮件，构造符合规范的multipart/alternative邮件结构，替换发送代码如下：

const request = require('request');

const options = {
  method: 'POST',
  url: 'https://api.mailgun.net/v3/<你的Mailgun配置域名>/messages',
  headers: {
    'Authorization': 'Basic <你的API密钥Base64编码>'
  },
  formData: {
    from: 'noreply@dummy.in',
    to: ['narendrahd@example.in', 'iamnotveda@example.com'],
    subject: 'Hey There, Im testing API',
    // 同时提供text和html格式的正文，兼容不同邮件客户端
    text: '您好，您收到一封日历邀请，若客户端未自动识别，请下载附件中的ics文件导入日历。',
    html: '<p>您好，您收到一封日历邀请，若客户端未自动识别，请下载附件中的ics文件导入日历。</p>',
    // 日历内容作为inline内联资源传入，不要放在attachment中
    inline: {
      value: icsContent,
      options: {
        filename: 'invite.ics',
        contentType: 'text/calendar; method=REQUEST',
        encoding: 'utf8'
      }
    }
  }
};

request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

• 发件域名必须配置正确的SPF、DKIM、DMARC解析记录，否则Gmail、Outlook会将邀请判定为可疑垃圾内容，拦截自动同步和RSVP功能
• 不要在ICS配置中添加非标准的自定义X-字段，否则Outlook可能无法正常识别邀请
• 测试时不要给同一收件人重复发送相同UID的邀请，客户端会将其判定为重复内容，不会弹出提示
• 如果后续需要发送取消邀请的通知，将日历method改为CANCEL，事件status设为CANCELLED，sequence字段值加1即可，客户端会自动移除对应日历事件

内容的提问来源于stack exchange，提问作者Narendra M