Отправить письма

Этот адаптер позволяет отправлять электронные письма из ioBroker

Текущий релиз
3.0.0
Разработчик
bluefox, iobroker-community-adapters
Лицензия
MIT

Отправляйте электронные письма из ioBroker. С помощью этого адаптера вы не можете проверять электронные письма, только отправлять их.

Для обеспечения функциональности адаптер использует Nodemailer .

Этот адаптер использует библиотеки Sentry для автоматического сообщения разработчикам об исключениях и ошибках в коде. Более подробную информацию, а также инструкции по отключению отправки сообщений об ошибках см. в документации Sentry-Plugin ! Система отчетности Sentry используется начиная с js-controller 3.0.

ВАЖНО: При переходе с версии 1.xx на 2.xx вам может потребоваться повторно ввести свои учетные данные, если возникнут проблемы с подключением.

Примечания, касающиеся конкретного поставщика услуг электронной почты.

Гмайл

Важно: если в вашей учетной записи Gmail включена двухфакторная аутентификация (2FA), вам необходимо использовать пароль приложения вместо обычного пароля Gmail. Для Gmail с 2FA приложение nodemailer всегда требовало этого.

Чтобы настроить Gmail с двухфакторной аутентификацией:

  1. Включите двухфакторную аутентификацию в настройках своего аккаунта Google.
  2. Создайте пароль приложения специально для почтового адаптера ioBroker.
  3. В настройках адаптера используйте свой адрес Gmail в качестве имени пользователя, а сгенерированный пароль приложения — в качестве пароля.

Для учетных записей без двухфакторной аутентификации может потребоваться настроить параметр «Разрешить менее защищенные приложения» в параметрах вашей учетной записи Gmail. Также может потребоваться разблокировать вашу учетную запись, разрешив доступ к вашей учетной записи Google, чтобы использовать протокол SMTP.

mail.ee

Для работы с почтовым сервисом mail.ee не используйте свои обычные учетные данные для входа в веб-почту. Вместо этого:

  • Имя пользователя : Используйте свой полный адрес электронной почты (например,username@mail.ee )
  • Пароль : Используйте специальный пароль IMAP/SMTP (а не пароль от вашей веб-почты).
    • Чтобы узнать свой пароль IMAP/SMTP: войдите в свою учетную запись веб-почты mail.ee и перейдите по ссылке https://posti.mail.ee/prefs?group=enable_pop3

Использование

Для отправки электронных писем из ScriptEngine просто напишите:

// send email to all instances of email adapter
sendTo('email', 'Email body');

// send email to specific instance of email adapter
sendTo("email.1", 'Email body');

// To specify subject or other options
sendTo('email', {
    from:    'iobroker@mydomain.com',
    to:      'aabbcc@gmail.com, xxyyzz@gmail.com', // comma separated multiple recipients.
    subject: 'Message from ioBroker',
    text:    'This is test email to you!',
});

// To send attachments
sendTo('email', {
    attachments: [
        {
            path: '/pathToImage/picture1.jpg', // use file on disk as attachment
        },
        {
            filename: 'license.txt',
            path: 'https://raw.github.com/andris9/Nodemailer/master/LICENSE', // use URL as an attachment
        },
    ]
});

// To send in html format
sendTo('email', {
    html: '<p>Embedded image: <img src='cid:image1'/></p>',
    attachments:[
        {
            path: 'path/to/file/image1.jpg',
            cid: 'image1',
        },
    ]
});

Для отправки электронных писем с другого адаптера используйтеadapter.sendTo функция.

Поддерживаемые услуги

  • 1und1 / ionos
  • АОЛ
  • DebugMail.io
  • DynectEmail
  • FastMail
  • ГандиМейл
  • Гмайл
  • Годадди
  • GodaddyAsia
  • GodaddyEurope
  • hot.ee
  • Hotmail
  • iCloud
  • сит
  • mail.ee
  • Mail.ru
  • Почтовая пушка
  • Mailjet
  • Мандрилл
  • Навер
  • Office365
  • OpenMailBox
  • Почтовый штемпель
  • QQ
  • QQex
  • SendCloud
  • SendGrid
  • СЭС
  • SES-US-EAST-1
  • SES-US-WEST-2
  • SES-EU-WEST-1
  • t-online.de
  • Спаркпост
  • Яху
  • Яндекс
  • Зоохо
  • Настройки пользователя (сервер, порт и параметры безопасности задаются вручную)

Для получения информации о других сервисах см. документацию Nodemailer :[https://github.com/nodemailer/nodemailer](https://github.com/nodemailer/nodemailer)

Changelog

WORK IN PROGRESS

  • (@GermanBluefox) Migrated the build script (tasks.js => tasks.mts) to TypeScript
  • (@GermanBluefox) Migrated blockly to TypeScript

3.0.0 (2026-08-03)

  • (copilot) Adapter requires node.js >= 22 now
  • (copilot) Adapter requires admin >= 8.0.0 now
  • (copilot) Adapter requires js-controller >= 6.0.11 now
  • (@copilot) Set up GitHub Copilot instructions with centralized ioBroker template (v0.5.7) and weekly monitoring workflow
  • (@ipod86) Added configurable number of file attachments to the Blockly email block via plus/minus buttons
  • (@GermanBluefox) Migrated to admin 8

2.0.5-alpha.0 (2025-10-06)

  • (@copilot) Fixed SMTP relay anonymous access by ignoring user and password when empty
  • (@copilot) Fixed Office365 OAuth email sending from scripts by ensuring fresh tokens are used
  • (mcm1957) Dependencies have been updated

2.0.4 (2025-04-15)

  • (@mcm1957) From email address is not equal to the configured email address for authentication. changed to debug level.
  • (mcm1957) Dependencies have been updated

2.0.3 (2025-03-24)

  • (@GermanBluefox) Added t-online.de to the list of supported services

2.0.2 (2025-03-14)

  • (@GermanBluefox) Renamed dist folder to build
  • (@GermanBluefox) Fixing pass decoding

License

The MIT License (MIT)

Copyright (c) 2014-2026 bluefox

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.