Блог

Отправка электронной почты — обычное требование во многих веб-приложениях. Если вам нужно отправить электронные письма с подтверждением, уведомления или информационные бюллетени, наличие надежного метода отправки электронных писем имеет решающее значение. В этой статье мы рассмотрим библиотеку sgMail, мощный инструмент для отправки электронных писем в Node.js, и обсудим различные методы выполнения этой задачи на примерах кода.

Знакомство с sgMail

sgMail — это модуль Node.js, предоставляющий простой и понятный API для отправки электронных писем с помощью службы SendGrid. SendGrid — это облачная платформа, которая специализируется на доставке транзакционных и маркетинговых электронных писем. sgMail действует как оболочка веб-API SendGrid, упрощая отправку электронных писем из приложений Node.js.

Для начала вам необходимо установить пакет sgMail с помощью npm:

npm install @sendgrid/mail

После установки вы можете потребовать модуль sgMail в своем приложении Node.js:

const sgMail = require("@sendgrid/mail");

Прежде чем вы сможете начать отправлять электронные письма, вам необходимо установить ключ API SendGrid. Вы можете получить ключ API, зарегистрировав учетную запись SendGrid и создав новый ключ API на панели управления SendGrid. Получив ключ API, вы можете установить его в своем приложении Node.js следующим образом:

sgMail.setApiKey("YOUR_SENDGRID_API_KEY");

Завершив настройку, давайте рассмотрим различные способы отправки электронной почты с помощью sgMail.

1. Отправить простое электронное письмо

Самый простой способ отправить электронное письмо с помощью sgMail — предоставить необходимые данные, такие как отправитель, получатель, тема и тело сообщения. Вот пример:

const msg = {
  to: "recipient@example.com",
  from: "sender@example.com",
  subject: "Hello from sgMail",
  text: "This is a test email sent using sgMail.",
};
sgMail.send(msg)
  .then(() => {
    console.log("Email sent successfully");
  })
  .catch((error) => {
    console.error(error);
  });

2. Отправьте электронное письмо с HTML-контентом

sgMail позволяет отправлять электронные письма с содержимым HTML, что полезно для создания визуально привлекательных и отформатированных сообщений. Вместо свойства textвы можете использовать свойство html, чтобы указать HTML-содержимое электронного письма. Вот пример:

const msg = {
  to: "recipient@example.com",
  from: "sender@example.com",
  subject: "HTML Email Example",
  html: "<h1>Hello from sgMail</h1><p>This is an HTML email sent using sgMail.</p>",
};
sgMail.send(msg)
  .then(() => {
    console.log("Email sent successfully");
  })
  .catch((error) => {
    console.error(error);
  });

3. Отправить электронное письмо с вложениями

sgMail позволяет отправлять электронные письма с вложенными файлами. Вы можете указать одно или несколько вложений, используя свойство attachments, которое должно представлять собой массив объектов, содержащих свойства filenameи content. Вот пример:

Buffer.from(“…здесь находится содержимое файла…”),
contentType: “application/pdf”,
},
],
};
sgMail.send(msg)
.then(() =>{
console.log(“Электронное письмо отправлено успешно”);
} )
.catch((error) =>{
console.error(error);
});

4. Отправляйте электронные письма с помощью шаблонов

sgMail поддерживает шаблоны электронной почты, позволяющие отделить содержимое электронной почты от кода. Вы можете определить шаблоны электронной почты, используя различные системы шаблонов, такие как Handlebars или EJS. Вот пример использования шаблонизатора Handlebars: