Блок «Email»
Блок отправляет клиенту обычное email-письмо прямо из воронки — это omnichannel-канал в дополнение к мессенджерам. Тема письма и адрес настраиваются в самом блоке, а текст письма берётся из вкладки «Сообщение» этого же блока.
Письмо уходит через SMTP, который заранее настроен в разделе Email → Настройки проекта. Если SMTP не настроен или отправка не удалась, воронка не прерывается — клиент просто не получит письмо, а переход к следующему блоку произойдёт как обычно.
Когда использовать
- Подтверждение заказа, бронирования или регистрации на email клиента
- Дублирование важного сообщения на почту (чек, договор, инструкция)
- Уведомления для тех клиентов, у кого есть email в карточке
- Сценарии, где нужен официальный канал помимо мессенджера
Настройки
- Кому (обязательное) — адрес получателя. По умолчанию `#{client.email}` (берётся email клиента). Можно вписать конкретный адрес или другую переменную. Поддерживается подстановка переменных.
- Тема письма (обязательное) — заголовок письма. Поддерживает переменные. Если тема пустая — письмо не отправляется.
- Имя отправителя (необязательное) — отображаемое имя в поле «От кого». Если не указать, подставится имя из настроек SMTP проекта.
- Текст письма — задаётся не в этом блоке, а во вкладке «Сообщение» того же блока. Именно его движок отправляет в теле письма (с подстановкой переменных).
Как работает
При входе в блок движок:
- Подставляет переменные в адрес, тему и текст (поле `text` из вкладки «Сообщение»).
- Проверяет получателя: если адрес пустой или в нём нет символа `@` — письмо пропускается, в лог пишется предупреждение.
- Проверяет тему: если она пустая — письмо пропускается.
- Ищет в проекте SMTP-настройку, помеченную как «по умолчанию» и активную. Если такой нет — отправка пропускается.
- Отправляет письмо: имя отправителя берётся из блока (или из SMTP), адрес отправителя — из SMTP. Тело уходит и в виде простого текста, и в виде простого HTML (переводы строк превращаются в `<br>`).
У блока один выход — после попытки отправки воронка всегда идёт дальше по единственной ветке. Отдельных веток «успех / ошибка» нет. Любая ошибка SMTP перехватывается и логируется, но не останавливает воронку. Блок не пишет результат отправки в переменные.
Пример
Клиент оформил заказ в Telegram-боте. После блока оплаты ставим блок «Email»:
- Кому: `#{client.email}`
- Тема: `Заказ №#{order_id} подтверждён`
- Имя отправителя: `Магазин ромашка`
- Во вкладке «Сообщение»: `Здравствуйте, #{client.name}! Ваш заказ №#{order_id} принят и оплачен. Спасибо за покупку!`
Клиент получает письмо на почту, а бот тем временем продолжает воронку — например, отправляет трек-номер в чат.
Частые ошибки
- Не настроен SMTP по умолчанию. Письмо молча не отправится: блок ищет SMTP-настройку с флагом «по умолчанию» и активную. Без неё ничего не уйдёт, ошибки в чате не будет — проверяйте логи и раздел Email → Настройки проекта.
- Пустой адрес или нет email у клиента. Если `#{client.email}` пустой или в адресе нет `@`, письмо пропускается. Для надёжности ставьте перед блоком проверку, что email вообще есть.
- Забыли заполнить тему или текст. Без темы письмо не отправляется вообще. Текст письма задаётся во вкладке «Сообщение», а не в полях блока — если её не заполнить, уйдёт пустое тело.
- Переносы строк и спецсимволы в адресе/теме/имени отправителя удаляются (защита от header-инъекций), так что многострочные адреса работать не будут.