sendByMail

await crafttechApi.sendByMail(title, body, email, (fileName = "null"));

Описание

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

Поддерживается только на Astra Linux.

Не путать с sendMail, который использует ручную настройку почтового сервиса через SMTP-сервер для отправки писем.

Параметры

• title (string) — заголовок письма;
• body (object) — тело письма, объект с полями:
  • text — текст, оставляем пустой строкой;
  • html — HTML-разметка;
• emails (string) — массив с максимум тремя элементами:
  • recipients — список получателей (обязательный), перечисляются в массиве строк, строки без пробелов;
  • cc — список получателей в копии (либо пустой массив), перечисляются в массиве строк, строки без пробелов;
  • bcc — скрытые скопии (либо пустой массив), перечисляются в массиве строк, строки без пробелов;
• fileName (string) — пути до файлов одной строкой через запятую, которые будут приложены к письму. Если вложений нет - передаётся пустая строка.

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

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

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

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

Возвращает

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

Пример

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

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

Пример 2 (только основной адресат)

const result = await crafttechApi.sendByMail(
  'Заголовок письма',
{
  text: '',
  html: `<h1>Здравствуйте</h1>`,
}
[
     ['mainmail@mail.com', 'mainmailtwo@mail.com'],
     [],
     [],
  ],
  ['file.md', 'file.py'].join(','),
)

Пример 3 (только основной адресат)

const result = await crafttechApi.sendByMail(
  "Заголовок письма",
  {
    text: "",
    html: `<h1>Здравствуйте</h1>`,
  }[["mainmail@mail.com", "mainmailtwo@mail.com"]],
  ["file.md", "file.py"].join(",")
);