使用 AWS SES 发送电子邮件：综合指南-js教程-PHP中文网

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

霞舞

发布： 2024-10-18 20:42:11

转载

1228人浏览过

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

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

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

什么是 aws ses？

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

主要特点：

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

设置 aws ses

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

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

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

验证电子邮件地址：

转到 aws ses 控制台。
导航到身份管理下的电子邮件地址。
点击验证新电子邮件地址。
输入您的电子邮件地址，然后单击验证此电子邮件地址。
检查您的收件箱并单击来自 aws 的电子邮件中的验证链接。

验证域名：

导航到身份管理下的域。
点击验证新域名。
输入您的域名。
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: `
          <html>
            <body>
              <h1>welcome!</h1>
              <p>we're glad to have you on board.</p>
            </body>
          </html>
        `,
      },
    },
  },
};

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);
  }
});

登录后复制

说明：