Модуль Custom SMTP добавляет базовые настройки, позволяющие отправлять электронные письма прямо из вашего приложения.
Чтобы форма для отправки писем появилась в приложении, нужно добавить недостающие настройки и необходимые элементы. Алгоритм действий будет следующим:
- Добавьте страницу или окно, где будет располагаться форма письма.
- Подключите модуль, добавьте в него параметры SMTP-сервера, а также свой логин и пароль.
- Создайте бизнес-процесс, конечную точку и форму, связанные с модулем.
Покажем, как это сделать в веб-приложении на примере почтового сервиса Gmail.
Создать страницу
Зайдите в редактор и создайте новую страницу, с которой будете публиковать. Укажите название вашей страницы («Заголовок»), ее адрес («URL страницы») и группы пользователей, которым разрешено отправлять сообщения («Показать для групп»). Нажмите «Сохранить».
Сохраните изменения и перейдите к блоку модуля.
Добавление и настройка модуля
Найдите модуль Custom SMTP на вкладке Marketplace и нажмите кнопку «Установить», чтобы добавить его в приложение.
Перейдите на вкладку «Установленные», где находятся все модули, установленные в вашем приложении, и нажмите на поле «Пользовательский SMTP», чтобы открыть его настройки. Слева отображается основная информация о модуле и кнопка его удаления из приложения. Справа расположены поля, которые необходимо заполнить:
- В поля «Логин» и «Пароль» введите данные почтового ящика, с которого будете отправлять сообщения.
- Укажите параметры SMTP-соединения — они разные для каждого почтового сервиса. По умолчанию в модуль добавлены настройки Gmail.
- В поле «От кого» введите имя, которое будет отображаться для получателей ваших писем.
Важный! Чтобы отправлять сообщения через Gmail, вам необходимо включить сторонние приложения в вашей учетной записи Google.
Подробнее о том, что такое модули, как их обновлять и настраивать, смотрите в нашей документации .
Не забудьте сохранить изменения.
Создание бизнес-процесса, конечной точки и формы
Бизнес-процесс , конечная точка и форма — это взаимосвязанные элементы, которые важно настроить последовательно. Взаимодействуя друг с другом, они завершат настройку вашего приложения — и на странице появится форма для отправки сообщения.
Подробнее об этих элементах можно прочитать в нашей документации .
Бизнес-процесс
Перейдите на вкладку «Бизнес-логика» и нажмите на кнопку создания нового бизнес-процесса.
Введите название процесса (обязательно), его описание (необязательно) и нажмите кнопку «Создать».
Каждый бизнес-процесс в редакторе визуально разделен на блоки — составные части, отвечающие за разные функции. При создании нового процесса в нем автоматически появляются «Начало» и «Конец». Все остальные блоки, которые вы можете добавить, будут отображаться слева.
После установки модуль «Пользовательский SMTP» добавил в этот список «Пользовательский SMTP: Отправить письмо». Чтобы включить этот блок в бизнес-процесс, перетащите его в поле редактора с помощью указателя мыши. Появится окно «Пользовательский SMTP: Отправить письмо», поля которого содержат переменные, от которых зависит содержимое вашей будущей формы отправки сообщения:
- «Тема» — тема письма;
- «Тело» — поле с текстом письма;
- "Кому" - адрес получателя;
- "Копия" - адрес для отправки копии;
- "От имени" - имя отправителя;
- «Скрытая копия» — это адрес для отправки скрытой копии.
Теперь нужно связать «Старт», «Пользовательский SMTP: Отправить письмо» и «Конец» — чтобы показать, что они составляют единый бизнес-процесс:
1. Наведите указатель мыши на поле «Старт» в блоке «Старт», зажмите левую кнопку мыши и проведите пальцем к полю «В» в блоке «Пользовательский SMTP: Отправить письмо» — соединение между блоки.
2. Аналогичным образом создайте связь между полем «Исходящие» блока «Пользовательский SMTP: Отправить письмо» и полем «Конец» блока «Конец».
Теперь в блоке «Старт» нужно создать новые поля (переменные) и связать их с переменными в блоке «Пользовательский SMTP: Отправить письмо». Поля, которые вы добавите в блок «Старт», появятся в вашей форме отправки сообщений. Представьте, что вы не будете рассылать копии и слепые копии, поэтому блок «Старт» будет содержать следующие поля:
- «Отправитель» (имя отправителя) — связан с from_name;
- «Адрес» (кому было отправлено) — связано с «кому»;
- «Тема» (тема); - связанные с "темой" (имена переменных в разных блоках могут совпадать);
- «Сообщение» (текст письма) — связано с «телом».
Чтобы связать переменные, они должны соответствовать друг другу по типу. Тип переменной можно просмотреть, щелкнув блок, в котором она содержится, и открыв меню редактирования.
В полях блоков рядом с каждой переменной есть иконка, цвет и форма которой зависят от ее типа — для удобства навигации в них. В нашем примере есть два типа переменных:
- "Subject", "body" и "from_name" имеют тип "String",
- Кому, копия и скрытая копия имеют тип массива электронной почты.
Создание переменных
Для создания первой переменной в блоке «Старт» нажмите на нее — отобразится список (пока он пустой). Нажмите на «+».
В открывшемся окне введите имя переменной: имя «отправитель», тип «Строка». Нажмите «Создать».
Аналогичным образом добавьте «адрес», «тема» и «сообщение». Теперь список переменных в блоке «Старт» выглядит так:
Свяжите их с соответствующими переменными в блоке Custom SMTP: Send Email:
Вот как в итоге должны выглядеть отношения между переменными. Сохраните изменения и перейдите к созданию конечной точки.
Конечная точка
Нажмите «Создать конечную точку» — вы окажетесь в настройках на вкладке «Бизнес-логика», здесь нужно указать следующие настройки:
- «Endpoint route» — название конечной точки, под которым вы будете понимать ее функцию;
- «Endpoint Groups» — название группы, в которой он будет находиться;
- "Тип запроса" - выберите "POST";
- «Бизнес-процесс» — выберите созданный вами бизнес-процесс send_email.
Затем перейдите на вкладку «Промежуточное ПО».
На вкладке «Middleware» нужно настроить права на выполнение действий с этой конечной точкой (и, следовательно, на запуск связанного с ней бизнес-процесса). Другими словами, вы укажете, кто может отправлять электронные письма из вашего приложения. Для этого необходимо изменить настройку токена авторизации «Token Auth».
Внимание! Если этот параметр не изменить, то все пользователи будут иметь право отправлять электронные письма!
Нажмите на значок шестеренки рядом с «Token Auth». В открывшемся окне включите селектор, в поле «Разрешенные группы» выберите группу «Администраторы» (или любую другую, которой вы хотите дать доступ). Нажмите "Сохранить"
Теперь сохраните конечную точку, нажав «Создать».
Настроены процессы отправки сообщений. Теперь вы можете создать визуальное представление формы отправки сообщений.
Форма
Для создания формы вернитесь в редактор веб-приложения на созданную ранее вкладку. Перетащите элемент формы на холст страницы.
В открывшемся окне нажмите «Создать запись», в поле «Сохранить запись в» отобразится список доступных конечных точек — выберите ту, которую вы только что создали. Нажмите «Назначить».
Созданная вами форма появится на холсте. Нажмите на изображение шестеренки, чтобы перейти к ее настройкам.
На вкладке «Внешний вид и стоимость» введите название формы в поле «Название». Здесь же можно изменить его внешний вид и посмотреть имя, под которым оно записано в настройках.
На вкладке "Данные" - информация о режиме формы и конечной точки. Также здесь можно изменить расположение полей, перемещая их относительно друг друга.
Расположите поля в логическом порядке: отправитель, адрес, тема, сообщение. Чтобы изменить подробные настройки для каждого поля (например, его название) — нажмите на значок шестеренки рядом с ним. Нажмите «Сохранить», чтобы сохранить изменения.
Добавление кнопки на форму
Чтобы форма работала, необходимо добавить кнопку подтверждения отправки. Используйте элемент «Кнопка» — перетащите его указателем мыши в область под формой.
Откройте настройки кнопки, нажав на нее. На вкладке «Look & Feel» измените «Label» (название кнопки, которое будет видно в приложении) и «Name» (название, которое будет отображаться в настройках).
На вкладке «Триггеры» добавьте действие на триггер onClick: в поле «Цель» выберите свою форму, в поле «Действие» выберите «Отправить форму». Нажмите «Сохранить».
Сохранение, публикация и проверка
Сохраните все внесенные изменения, опубликуйте их, нажмите на иконку перехода к приложению.
Введите данные для отправки сообщения. Если вы оставите поле отправителя пустым, автоматически будет добавлено имя, введенное вами в настройках модуля. Отправьте тестовое сообщение на любой адрес электронной почты, к которому у вас есть доступ.
После отправки должно появиться подтверждающее сообщение, а у адресата в папке «Входящие» появится письмо с указанными данными.
Если вы все сделали по инструкции, но вместо подтверждения выходит ошибка или письмо попадает в папку "Спам", напишите в наш телеграм-канал техподдержки.
