Блок «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-инъекций), так что многострочные адреса работать не будут.