Custom SMTP модуль добавляет в проект возможность отправки e-mail сообщений.
Установка и настройка
Чтобы установить данный модуль в проект, в разделе Modules нужно найти Custom SMTP и нажать Install.
После установки, требуется настроить модуль для дальнейшей работы.
- Login (обязательно) - адрес электронной почты в выбранном почтовом сервисе, с которой будут отправляться электронные письма.
- Password (обязательно) - пароль от электронной почты.
- Server address (обязательно) - адрес сервера почтовой службы, предназначенной для отправки исходящих сообщений. По умолчанию: smtp.gmail.com (почтовая служба Google).
- Server port (обязательно) - номер порта адреса сервера почтовой службы, предназначенной для отправки исходящих сообщений. По умолчанию, для почтовой службы Google: 587.
- Use TLS (не обязательно)- включение использования TLS (transport layer security - протокол защиты транспортного уровня). Выключено по умолчанию.
- From Name (не обязательно)- имя отправителя, которое будет использоваться по умолчанию.
По умолчанию, при установке модуля, генерируется следующий БП (только для бэкэнда):
- Custom SMTP: Send email - отвечает за отправку email сообщений;
- Subject [string] - тема письма;
- Body [text] - текст письма;
- To [email array] - массив email адресов получателей;
- Сс [email array] - массив email адресов, которым будет отправлена копию письма;
- From_name [string] - имя отправителя;
- Bcc [email array] - скрытые получатели письма, чьи адреса не показываются другим получателям;
Пример использования
Рассмотрим простой пример отправки текста письма на введенную почту, при нажатии на кнопку.
В качестве почтового сервиса используется Google (Gmail). Почту, с которой будет происходить рассылка, необходимо сначала настроить и разрешить с неё рассылку сторонним приложениям. Для этого нужно выполнить следующие шаги:
- Открыть настройки аккаунта Gmail
- Перейти на влкадку Forwarding and POP/IMAP
- Включить IMAP Access
- Сохранить изменения
После настройки аккаунта Gmail, необходимо установить модуль в проекте AppMaster и настроить его для работы с данным аккаунтом Gmail.
Как только модуль настроен, требуется создать Endpoint для работы с автосгенерированным БП Custom SMTP: Send email.
- В разделе Endpoints создать группу
- В данной группе создать новый Endpoint
- Настроить его, как на примере ниже
После, можно приступить к созданию фронтенда приложения. В рамках данного примера, дизайн выглядит следующим образом (поля Input Text и Input Email для получения текста письма и адреса почты, на которую будет отправлено письмо при нажатии кнопки).
Отправка происходит по событию onClick на кнопке и БП выглядит следующим образом:
- InputEmail Get Properties - берёт значение адреса почты из инпута;
- To Array - преобразует его в массив, т.к. Server request POST /sendemail/ принимает массив адресов (поле to);
- InputText Get Properties - берёт значение текста письма из инпута;
- Server request POST /sendemail/ - принимает значения из инпутов и обращается к эндпоинту по адресу /sendemail/, для вызовы БП Custom SMTP: Send email.