sendMail

await crafttechApi.sendMail(title, body, emails, fileName, conf);

Описание

Отправляет письмо с вложенными файлами на электронную почту через SMTP-сервер.

Не путать с sendByMail, который использует Р7-Органайзер для отправки писем.

Параметры

• title (string) — заголовок письма;
• body (object) — тело письма, объект с полями:
  • text — текст, оставляем пустой строкой;
  • html — HTML-разметка;
• emails (string) — массив с тремя строками; каждая такая строка написана через запятую без пробелов:
  • recipients — список получателей;
  • cc — список получателей в копии;
  • bcc — скрытые скопии;
• fileName (string) — пути до файлов одной строкой через запятую, которые будут приложены к письму;
• conf (obj) — настройки для почтового сервиса, с которого будет отправляться письмо:
  • host — сервер исходящей почты (SMTP-сервер);
  • port — порт;
  • auth — аутентификация:
    • user — имя пользователя;
    • pass — пароль приложения.

Пример тела письма:

const body = {
  text: "",
  html: `
  <h1>Здравствуйте</h1>
  <p>
    Я ваше <strong>письмо</strong>
  `,
};

Пример массива с электронными почтами:

[
  ["mainmail@mail.com"].join(","), // получатели
  ["copymail@mail.com", "copymailtwo@mail.com"].join(","), // копии
  ["blindcopymail@mail.com", "blindcopymailtwo@mail.com"].join(","), // скрытые копии
];

Пример настройки для почтового сервиса:

const conf = {
  host: "smtp.mail.ru",
  port: 465,
  auth: {
    user: "r7alerts@mail.ru",
    pass: "SYE0bc7MYsc0sJTP1Bec",
  },
};

Возвращает

• true | false (boolean) — логическая истина true в случае успешного отправления письма.

Пример

const result = await crafttechApi.sendMail(
  "Заголовок письма",
  body,
  [
    ["mainmail@mail.com"].join(","),
    ["copymail@mail.com", "copymailtwo@mail.com"].join(","),
    ["blindcopymail@mail.com", "blindcopymailtwo@mail.com"].join(","),
  ],
  conf
);

if (result) {
  console.log("Письмо успешно отправлено!");
} else {
  console.log("Письмо не отправлено.");
}