使用 AWS SES 发送电子邮件:综合指南

使用 aws ses 发送电子邮件:综合指南

aws simple email service (ses) 是一种功能强大、经济高效的解决方案,可以帮助您安全地发送电子邮件,无论是用于交易消息、营销活动还是自动通知。

在这篇博文中,我们将探讨如何使用 aws ses 发送电子邮件,涵盖各种用例,例如发送 html 模板、附件,甚至日历事件。我们将通过实际示例帮助您快速入门。


目录

  1. 什么是 aws ses?
  2. 设置 aws ses
  3. 发送简单的电子邮件
  4. 发送 html 电子邮件
  5. 发送带附件的电子邮件
  6. 发送日历邀请
  7. 最佳实践
  8. 结论

什么是 aws ses?

aws simple email service (ses) 是一项基于云的电子邮件发送服务,旨在帮助数字营销人员和应用程序开发人员发送营销、通知和交易电子邮件。对于各种规模的企业来说,这是一项可靠、可扩展且经济高效的服务。

主要特点:

  • 可扩展性:轻松处理大量电子邮件。
  • 交付率: 由于 aws 的声誉,交付率很高。
  • 成本效益:即用即付定价模式。
  • 安全性:支持dkim和spf等身份验证机制。

设置 aws ses

在我们深入发送电子邮件之前,让我们为您的账户设置 aws ses。

第 1 步:验证您的电子邮件地址或域名

aws ses 要求您验证您计划使用的电子邮件地址或域。

  1. 验证电子邮件地址:
  • 转到 aws ses 控制台。
  • 导航到身份管理下的电子邮件地址
  • 点击验证新电子邮件地址
  • 输入您的电子邮件地址,然后单击验证此电子邮件地址
  • 检查您的收件箱并单击来自 aws 的电子邮件中的验证链接。
  1. 验证域名:
  • 导航到身份管理下的
  • 点击验证新域名
  • 输入您的域名。
  • aws 将提供 dns 记录。将这些添加到您域的 dns 设置中。

第 2 步:请求生产访问权限

默认情况下,新的 aws 账户位于沙盒环境中,这限制了电子邮件发送功能。

  • 前往ses发送限制页面。
  • 点击请求提高发送限额
  • 填写退出沙箱的申请表。

步骤 3:设置 aws 凭证

您需要 aws 访问密钥才能以编程方式与 ses 交互。

  • 转到 aws iam 控制台。
  • 使用编程访问创建新用户。
  • 附加 amazonsesfullaccess 策略。
  • 保存您的访问密钥id秘密访问密钥

发送简单的电子邮件

我们首先使用适用于 node.js 的 aws 开发工具包发送一封简单的纯文本电子邮件。

先决条件

  • node.js 安装在您的计算机上。
  • 已安装适用于 node.js 的 aws 开发工具包 (aws-sdk)。

代码示例

const aws = require('aws-sdk');

// configure aws sdk
aws.config.update({
  accesskeyid: 'your_access_key_id',
  secretaccesskey: 'your_secret_access_key',
  region: 'us-east-1', // replace with your ses region
});

const ses = new aws.ses();

const params = {
  source: 'sender@example.com',
  destination: {
    toaddresses: ['recipient@example.com'],
  },
  message: {
    subject: {
      data: 'test email from aws ses',
    },
    body: {
      text: {
        data: 'hello, this is a test email sent using aws ses!',
      },
    },
  },
};

ses.sendemail(params, (err, data) => {
  if (err) {
    console.error('error sending email', err);
  } else {
    console.log('email sent successfully', data);
  }
});

说明:

  • 来源:您发送邮件时所使用的经过验证的电子邮件地址。
  • 目的地:收件人的电子邮件地址。
  • 消息:包含电子邮件的主题和正文。

发送 html 电子邮件

现在,让我们发送一封包含 html 内容的电子邮件,使其更具视觉吸引力。

代码示例

const params = {
  source: 'sender@example.com',
  destination: {
    toaddresses: ['recipient@example.com'],
  },
  message: {
    subject: {
      data: 'welcome to our service!',
    },
    body: {
      html: {
        data: `
          
            
              <h1>welcome!</h1>
              <p>we're glad to have you on board.</p>
            
          
        `,
      },
    },
  },
};

ses.sendemail(params, (err, data) => {
  if (err) {
    console.error('error sending html email', err);
  } else {
    console.log('html email sent successfully', data);
  }
});

温馨提示:

  • 您可以内联包含 css 样式或使用基本样式来确保跨电子邮件客户端的兼容性。
  • 始终包含纯文本版本作为后备。

发送带附件的电子邮件

要发送带有附件的电子邮件,我们将使用 sendrawemail 方法而不是 sendemail。

代码示例

const fs = require('fs');
const path = require('path');
const aws = require('aws-sdk');
const ses = new aws.ses();

// read the attachment file
const filepath = path.join(__dirname, 'attachment.pdf');
const filecontent = fs.readfilesync(filepath);

// define the email parameters
const params = {
  rawmessage: {
    data: createrawemail(),
  },
};

function createrawemail() {
  const boundary = '----=_part_0_123456789.123456789';

  let rawemail = [
    `from: sender@example.com`,
    `to: recipient@example.com`,
    `subject: email with attachment`,
    `mime-version: 1.0`,
    `content-type: multipart/mixed; boundary="${boundary}"`,
    ``,
    `--${boundary}`,
    `content-type: text/plain; charset=utf-8`,
    `content-transfer-encoding: 7bit`,
    ``,
    `hello, please find the attached document.`,
    `--${boundary}`,
    `content-type: application/pdf; name="attachment.pdf"`,
    `content-description: attachment.pdf`,
    `content-disposition: attachment; filename="attachment.pdf";`,
    `content-transfer-encoding: base64`,
    ``,
    filecontent.tostring('base64'),
    `--${boundary}--`,
  ].join('\n');

  return rawemail;
}

ses.sendrawemail(params, (err, data) => {
  if (err) {
    console.error('error sending email with attachment', err);
  } else {
    console.log('email with attachment sent successfully', data);
  }
});

说明:

  • 多部分 mime 消息: 我们构建带有 mime 边界的原始电子邮件以包含附件。
  • base64 编码: 附件必须采用 base64 编码。
  • 内容标头:电子邮件客户端需要正确的标头才能正确解释附件。

发送日历邀请

要发送日历事件,我们将包含一个 .ics 文件作为附件。

代码示例

function createCalendarEvent() {
  const event = [
    'BEGIN:VCALENDAR',
    'VERSION:2.0',
    'BEGIN:VEVENT',
    'DTSTAMP:20231016T090000Z',
    'DTSTART:20231020T100000Z',
    'DTEND:20231020T110000Z',
    'SUMMARY:Meeting Invitation',
    'DESCRIPTION:Discuss project updates',
    'LOCATION:Conference Room',
    'END:VEVENT',
    'END:VCALENDAR',
  ].join('\n');

  return Buffer.from(event).toString('base64');
}

function createRawEmail() {
  const boundary = '----=_Part_0_123456789.123456789';

  let rawEmail = [
    `From: sender@example.com`,
    `To: recipient@example.com`,
    `Subject: Meeting Invitation`,
    `MIME-Version: 1.0`,
    `Content-Type: multipart/mixed; boundary="${boundary}"`,
    ``,
    `--${boundary}`,
    `Content-Type: text/plain; charset=UTF-8`,
    `Content-Transfer-Encoding: 7bit`,
    ``,
    `Hello, you're invited to a meeting.`,
    `--${boundary}`,
    `Content-Type: text/calendar; method=REQUEST; name="invite.ics"`,
    `Content-Transfer-Encoding: base64`,
    `Content-Disposition: attachment; filename="invite.ics"`,
    ``,
    createCalendarEvent(),
    `--${boundary}--`,
  ].join('\n');

  return rawEmail;
}

ses.sendRawEmail(params, (err, data) => {
  if (err) {
    console.error('Error sending calendar invite', err);
  } else {
    console.log('Calendar invite sent successfully', data);
  }
});

说明:

  • 日历事件格式:我们使用 icalendar 格式创建一个 .ics 文件内容。
  • method=request: 表示这是会议邀请。
  • 正确的标题:确保日历文件的内容类型和内容处置正确。

最佳实践

  • 错误处理:始终在您的应用程序中包含强大的错误处理。
  • 电子邮件验证:发送前确保电子邮件地址有效。
  • 限制: 请注意您的 ses 发送限制以避免限制。
  • 取消订阅链接:在营销电子邮件中包含取消订阅选项以遵守法规。
  • 监控:使用 aws cloudwatch 监控您的电子邮件发送活动。
  • 安全性:保护您的 aws 凭证并尽可能使用 iam 角色。

结论

aws ses 是一项多功能服务,可以处理各种电子邮件发送需求。无论您是发送简单的通知、包含丰富 html 内容的营销电子邮件,还是包含附件和日历事件的复杂消息,aws ses 都能满足您的需求。

通过遵循本指南,您现在应该充分了解如何:

  • 为您的账户设置 aws ses。
  • 发送纯文本和 html 电子邮件。
  • 在电子邮件中包含附件和日历邀请。

感谢您的阅读!如果您有任何问题或建议要分享,请随时在下面发表评论。快乐编码!

以上就是使用 AWS SES 发送电子邮件:综合指南的详细内容,更多请关注其它相关文章!