Интеграция
Получение лидов из Marquiz → Отправка e-mail через свой ящик
В этой инструкции мы по шагам с примерами разберём, как настроить оба сервиса и связать их между собой:
- Настройка получения лидов из Marquiz: указание числа вопросов квиза, копирование URL вебхука и подключение Webhooks в интеграциях.
- Настройка отправки письма через свой почтовый ящик: подключение, получатели, тема, сообщение, HTML-версия и подстановка данных из сценария.
Отдельные инструкции: источник «Получение лидов из Marquiz» · действие «Отправка e-mail через свой ящик»
Создание подключений
Если вы ещё не создавали нужные подключения - не пропускайте этот блок: без них настроить интеграцию не получится. Если подключения уже есть в WebJack, можно сразу перейти к настройке источника и действия ниже.
Подключение электронной почты
Где создать подключение
- В меню слева выберите «Подключения».
- Нажмите «+» и выберите тип «Электронная почта».
- Укажите «Способ» подключения и заполните поля.
- Нажмите «Подключить».
SMTP (логин и пароль)
Подходит для любого почтового сервера, в том числе Яндекс и Gmail. В поле «Способ» выберите «SMTP (логин и пароль)».
| Поле | Что указать |
|---|---|
| «Название» | Произвольное имя подключения в проекте (необязательно) |
| «SMTP-сервер» | Адрес сервера исходящей почты |
| «Порт» | Обычно 587 (STARTTLS) или 465 (SSL/TLS) |
| «Шифрование» | STARTTLS для порта 587, SSL/TLS для порта 465 |
| «Логин» | Полный адрес почты |
| «Пароль» | Пароль приложения (не основной пароль от аккаунта) |
| «Адрес отправителя» | Email в поле «От» (если не заполнить - подставится логин) |
Яндекс Почта (SMTP)
Рекомендуемые параметры:
- «SMTP-сервер»:
smtp.yandex.ru - «Порт»:
465 - «Шифрование»: SSL/TLS (альтернатива: порт
587и STARTTLS) - «Логин»: ваш адрес, например
name@yandex.ru - «Пароль»: пароль приложения (см. ниже)
- «Адрес отправителя»: тот же адрес, что и логин
Пароль приложения (Яндекс)
- Войдите в аккаунт на id.yandex.ru.
- Откройте «Безопасность».
- Включите двухфакторную аутентификацию, если она ещё не включена - без неё пароли приложений недоступны.
- В разделе «Пароли приложений» нажмите «Создать».
- Выберите тип «Почта» (или укажите название, например «WebJack»).
- Скопируйте сгенерированный пароль и вставьте его в поле «Пароль» при создании подключения.
Gmail (SMTP)
Рекомендуемые параметры:
- «SMTP-сервер»:
smtp.gmail.com - «Порт»:
465 - «Шифрование»: SSL/TLS (альтернатива: порт
587и STARTTLS) - «Логин»: ваш адрес
@gmail.comили корпоративный Google Workspace - «Пароль»: пароль приложения Google (см. ниже)
- «Адрес отправителя»: тот же адрес, что и логин
Пароль приложения (Google)
- Откройте настройки Google-аккаунта.
- Перейдите в «Безопасность».
- Включите двухэтапную аутентификацию, если она ещё не включена.
- Откройте страницу «Пароли приложений».
- Создайте пароль: приложение - «Почта», устройство - «Другое» (например, «WebJack»).
- Google покажет 16-символьный пароль - скопируйте его в поле «Пароль» (пробелы можно не вводить).
Редактирование SMTP-подключения
После создания можно изменить сервер, порт, логин и пароль в карточке подключения. При сохранении сервис снова проверит SMTP-соединение.
Яндекс Почта (OAuth)
Без ручного ввода SMTP-параметров и пароля приложения - достаточно войти в аккаунт Яндекса и разрешить отправку писем.
- В форме подключения в поле «Способ» выберите «Яндекс Почта».
- При желании укажите «Название» подключения.
- Нажмите «Подключить».
- Откроется страница авторизации Яндекса - войдите в нужный аккаунт.
- Подтвердите доступ приложению к отправке писем (доступ к SMTP Яндекс.Почты).
- После успешной авторизации вы вернётесь в сервис - подключение создастся автоматически.
Сервис сохранит адрес отправителя из вашего аккаунта Яндекса. SMTP-параметры подставляются автоматически, редактировать их не нужно.
Частые проблемы
Создайте обработку
В левом меню откройте «Обработки» и нажмите «+».
В списке типов источника выберите «Лиды Marquiz» и нажмите кнопку «Выбрать».
Источник «Лиды Marquiz»
Заявки из квизов Marquiz начнут поступать на URL вебхука. Укажите число вопросов квиза, сохраните форму и скопируйте URL для Webhooks в Marquiz.
Количество вопросов
- В поле «Количество вопросов» укажите, сколько вопросов в квизе Marquiz.
- Нажмите «Сохранить».
URL источника
- Откройте вкладку «Источник данных».
- Скопируйте «URL» - его нужно указать в настройках Webhooks в Marquiz.
Webhooks в Marquiz
- В Marquiz откройте настройки нужного квиза.
- В меню выберите «Интеграции» → «Прочее» → «Webhooks».
- Вставьте скопированный «URL» в поле вебхука.
- Нажмите «Сохранить».
Действие «Отправить e-mail через свой ящик»
Письмо отправляется с адреса, указанного в подключении «Электронная почта». В форме действия вы выберете это подключение, зададите получателей, тему и текст, подставив данные из предыдущих шагов сценария.
Перейдите в обработке во вкладку "Действия" и нажмите на кнопку "Добавить действие"
Подключение
- В поле «Подключение» выберите ранее созданное подключение типа «Электронная почта», через которое будет отправляться письмо.
Адрес и получатели
- В поле «От (имя)» при необходимости укажите отображаемое имя отправителя, например «Отдел продаж». Сам email-адрес задаётся в подключении и в действии не меняется.
- В поле «Получатель» укажите один или несколько адресов. Чтобы подставить адрес из данных сценария, выберите переменную в панели справа и вставьте её в поле.
- При необходимости заполните «Копия», «Скрытая копия» и «Обратный адрес» - в каждом поле можно указать один или несколько адресов.
Тема и содержание
- В поле «Тема» задайте заголовок письма - текстом или с переменными из панели справа.
- В поле «Сообщение» соберите основной текст письма из текста и данных предыдущих шагов.
- Если нужна HTML-разметка, заполните «HTML-версия». Если поле пустое, получатели увидят только текст из «Сообщения».
Сохранение
- Нажмите «Сохранить».
Запустите обработку
- В обработку начнут поступать данные из настроенного источника.
- По очереди выполнятся все добавленные действия.
- Входящие данные, статус и история отобразятся в «Истории операций».