Как отправить Email из сценария и обработать результат

Функция доступна только рабочим пространствам закрытой Email-беты. Если Email выключен, ноды не выполняют внешнюю отправку.

Перед началом

Должны быть готовы:

• Email-канал;
• подтвержденный домен;
• активный отправитель;
• тема подписки;
• опубликованная ревизия шаблона;
• подтвержденное согласие контакта по теме.

Если хотя бы одна часть не готова, письмо попадет в безопасную ветку Заблокировано или публикация цепочки будет остановлена.

Шаг 1. Создайте и опубликуйте шаблон

Откройте Email-шаблоны, создайте шаблон, задайте тему и прехедер. Вставьте HTML или импортируйте файл до 1 МБ.

Нажмите Предпросмотр, затем Сохранить ревизию. После проверки нажмите Опубликовать последнюю.

Визуальный drag-and-drop редактор пока закрыт. Для рабочей подготовки используйте HTML-редактор или импорт.

Шаг 2. Добавьте ноду Отправить Email

В конструкторе откройте раздел Сообщения и добавьте Отправить Email.

Для Email-цепочки канал, отправитель и тема подписки уже зафиксированы и недоступны для произвольной замены. Для сценария другого канала выберите готовый Email-канал явно.

Настройте:

1. Опубликованную ревизию шаблона.
2. Email получателя. По умолчанию используется {{contact_email}}.
3. При необходимости тему и прехедер для этой ноды.
4. Отслеживание открытий и кликов.
5. Префикс переменных результата, по умолчанию email.

Шаг 3. Разведите две ветки

У ноды два выхода:

• В очереди: доставка и фоновая задача надежно записаны в базе;
• Заблокировано: письмо остановлено до отправки.

Ветку Заблокировано завершите безопасно. Можно поставить внутреннюю метку, передать задачу оператору или закончить сценарий. Не соединяйте ее с циклом мгновенной повторной отправки.

При стандартном префиксе доступны переменные:

• {{email_delivery_id}};
• {{email_job_id}}, только если фоновая задача создана;
• {{email_status}};
• {{email_block_reason}}.

{{email_status}} после этой ноды равен queued или blocked. При блокировке {{email_job_id}} остается пустым, потому что задача отправки не создается. Статус не подтверждает прием или доставку.

Шаг 4. Дождитесь подтвержденного события

Из выхода В очереди добавьте ноду Ожидать Email событие.

В поле Delivery ID оставьте {{email_delivery_id}}. Затем выберите событие:

• принято к обработке;
• доставлено;
• ошибка доставки;
• открыто;
• клик;
• жалоба;
• отписка.

Укажите таймаут от 1 минуты до 7 суток. Для клика можно добавить точный публичный HTTPS URL. Фильтр URL недоступен для других событий.

Нода продолжит только одну ветку:

• Событие, если подтверждение записано вовремя;
• Таймаут, если срок истек первым.

Открытия являются оценочным сигналом, потому что почтовые приложения могут загружать изображения автоматически. Для сильного сигнала интереса чаще используйте подтвержденный клик.

Шаг 5. Добавьте отписку по теме

Нода Отписать от Email записывает отписку текущего контакта от выбранной темы. В Email-цепочке тема совпадает с привязкой цепочки и не меняется.

Выходы:

• Отписан: создано новое событие отписки;
• Уже отписан: активной подписки не было, адрес отсутствует или отписка уже записана.

Нода не удаляет контакт, не очищает его Email и не снимает жалобу или hard bounce.

Почему письмо блокируется

Частые причины:

• у контакта нет корректного Email;
• нет подтвержденного согласия по теме;
• контакт отписан;
• есть жалоба, hard bounce или ручная блокировка;
• домен, отправитель или канал потерял готовность;
• шаблон не опубликован;
• включена аварийная пауза;
• живая отправка еще не разрешена для проекта.

Strelo повторно проверяет согласие, блокировки и готовность непосредственно перед внешним вызовом. Это защищает контакт, если он отписался уже после постановки письма в очередь.

Если не получается

• Ноды Email нет в палитре: проект не включен в закрытую бету или нет готового Email-канала.
• Шаблон не виден: опубликуйте нужную ревизию.
• Выход всегда Заблокировано: проверьте {{email_block_reason}} и карточку готовности в настройках Email.
• Ожидание сразу ошибается: в Delivery ID нет корректного {{email_delivery_id}}.
• Клик не завершает ожидание: проверьте, что выбран Клик и точный URL совпадает после нормализации.
• Переход в другую Email-цепочку запрещен: у цепочек не совпадают канал, отправитель или тема подписки.