mail-nation

Управляем почтой: от домена до конверсий

ТЗ на email-автоматизацию: сценарии, приемка и права

Автоматизация может отправлять письма по расписанию и при событиях в CRM, менять поля контакта и передавать данные во внешние системы. Но если в ТЗ записано только «настроить welcome-цепочку»

ТЗ на email-автоматизацию: сценарии, приемка и права

Рабочее ТЗ на email-автоматизацию описывает всю логику: событие запуска, фильтры, задержки, ветвления, отправки, остановку сценария и права доступа. Отдельно в нём фиксируют, как проверять готовый workflow и кому принадлежат код, шаблоны и настройки. Это помогает оценивать результат по поведению системы, а не по обещанию «всё настроено».

Сценарий как последовательность условий и действий

Начните с бизнес-цели. Например, вернуть пользователя к незавершённой покупке, познакомить нового подписчика с продуктом или передать лид менеджеру после реакции на письмо. Цель нужна не для красивого вступления в документ: она помогает выбрать событие, аудиторию и метрику. Для брошенной корзины это может быть завершение заказа, для welcome-сценария — переход к целевому действию.

Затем разложите идею на элементы, которые можно настроить и проверить:

1. Триггер. Какое событие запускает сценарий: создание контакта, изменение поля, ответ лида, наступление даты или расписание. Уточните источник события и момент, когда CRM или ESP его считает зафиксированным.

2. Фильтры входа. Какие контакты допускаются в сценарий. Например, есть ли подтверждённая подписка, подходит ли регион, заполнено ли нужное поле, не находится ли контакт уже в другой активной цепочке.

3. Ветвления. Какие условия определяют дальнейший маршрут. Условие должно опираться на конкретное поле или событие: совершил ли пользователь покупку, кликнул ли по ссылке, ответил ли менеджеру.

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

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

6. Условия выхода. Когда контакт больше не должен получать сообщения: покупка, отписка, удаление из аудитории, ответ менеджеру или окончание цепочки.

Такой перечень удобно перенести в таблицу. Она помогает заметить пробелы до разработки, когда исправление логики обходится дешевле, чем повторная настройка и пересборка сегментов.

ЭлементЧто указать в ТЗКак проверить
ТриггерИсточник, событие и условия запускаСоздать тестовую запись или событие и проверить запуск
ФильтрыПоля и значения, необходимые для входаПроверить подходящий и неподходящий контакты
ЗадержкаИнтервал и правило расчёта времениСверить запланированное время в истории выполнения
ВетвлениеУсловие и маршрут для каждого результатаПройти обе ветки на тестовых данных
ОтправкаШаблон, отправитель, аудитория и ограниченияПроверить фактическое письмо и запись об отправке
ВыходСобытия, прекращающие сценарийВызвать событие и убедиться, что следующие шаги не исполняются

Не оставляйте спорные слова без определения. «Сразу» может означать отправку в момент события или после фоновой обработки. «Активный клиент» — статус в CRM, покупка за выбранный период или отсутствие возврата. Чем меньше таких формулировок, тем меньше расхождений между бизнесом и разработкой.

В ТЗ должна быть описана не картинка сценария, а поведение системы при каждом значимом событии.

Для сложной цепочки добавьте текстовое описание маршрута и названия полей так, как они называются в CRM. Если аналитик говорит о «дате первой покупки», а автоматизация проверяет поле «Последний заказ», это разные условия и потенциально разные когорты. Согласуйте источник данных заранее, особенно если поля синхронизируются между сайтом, CRM и платформой рассылок.

Права выполнения и обработка ошибок

Автоматизация часто работает в фоне, поэтому у неё есть контекст прав: от чьего имени выполняются действия и какие записи этот пользователь может менять. В документации Frappe CRM, например, предусмотрены варианты Automation User, Triggering User и Document Owner. Это особенности конкретной CRM, а не универсальная схема для всех платформ, но сам вопрос стоит включать в ТЗ для любой системы.

Зафиксируйте:

  • пользователя или роль, от имени которых выполняются шаги;
  • какие объекты и поля разрешено читать и изменять;
  • кто может редактировать, запускать, отключать и удалять workflow;
  • кто получает уведомление при ошибке;
  • где команда смотрит журнал запусков и результаты действий.

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

Отдельный пункт — поведение при сбое. В одной системе ошибка на шаге останавливает дальнейшее выполнение; в другой могут быть предусмотрены повторные попытки или отдельная ветка ошибки. Не предполагайте, что такие правила одинаковы у разных CRM и ESP. Запишите ожидаемое поведение для каждого критичного действия: не удалось отправить письмо, не обновилось поле, вернулся отказ от webhook, отсутствует обязательное значение.

В Frappe CRM, согласно документации платформы, при ошибке выполнение останавливается на проблемном шаге, а следующие шаги не исполняются. После десяти последовательных неудачных запусков автоматизация отключается автоматически. Если проект использует эту CRM, эти условия стоит отразить в инструкции сопровождения и тестах. Для другой платформы нужно запросить её собственные правила.

Полезно заранее договориться, как команда отличает техническую ошибку от ожидаемого пропуска. Контакт без согласия не должен восприниматься как сбой отправки: это корректное исключение из аудитории. Ошибка подключения к внешней системе — другой случай. В журнале или отчёте должны быть видны причина пропуска, завершённый шаг и состояние сценария. Иначе маркетолог видит только недобор отправок и не понимает, нужна ли правка сегмента, доступа или интеграции.

Согласие и отписка входят в логику сценария

Согласие нельзя оставлять на усмотрение исполнителя или прятать в описании бизнес-процесса. В ТЗ укажите, какое поле или событие подтверждает разрешение на конкретный вид коммуникации, где хранится источник согласия и как контакт исключается из рассылки после отзыва. Конкретные требования зависят от юрисдикции и ситуации обработки данных.

Европейская комиссия описывает согласие в рамках GDPR как свободное, информированное, данное для конкретной цели и выраженное ясным утвердительным действием. Там же указана необходимость предоставить возможность отозвать согласие так же легко, как его дать. В руководстве британского ICO по PECR для электронного маркетинга отмечено, что согласие должно охватывать соответствующий вид email-маркетинга. Если используется купленный список, организация должна иметь возможность подтвердить, кто, когда и как дал согласие, и что оно охватывает её и email-канал. Эти источники относятся к своим правовым рамкам; переносить их положения на любую страну без проверки применимых правил не следует.

В техническом задании стоит описать обработку таких ситуаций:

  • контакт отписался от маркетинговых писем;
  • согласие отозвано через форму или обращение в поддержку;
  • у контакта есть согласие на один тип сообщений, но нет на другой;
  • повторное событие пытается вернуть отписавшегося в активный сценарий;
  • контакт попал в сегмент из внешнего источника, а подтверждение основания для отправки отсутствует.

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

Для маркетинговых и подписных писем в ТЗ опишите и видимую ссылку для отписки, и техническую поддержку one-click unsubscribe, если она требуется для выбранного канала и аудитории. Google указывает заголовки List-Unsubscribe-Post и List-Unsubscribe для one-click отписки; видимая ссылка в теле маркетингового письма также должна присутствовать. Приёмка должна подтверждать, что ссылка ведёт к нужному процессу и отписка действительно исключает контакт из дальнейших маркетинговых отправок.

Приемка: проверяем сценарий, а не только тестовое письмо

Критерии приемки email-рассылки лучше записать до начала разработки. Иначе на финальном просмотре команда спорит о том, что значит «работает корректно»: письмо появилось в редакторе или вся цепочка отрабатывает при реальных условиях.

Разбейте проверку на уровни:

  • Событие и вход в сценарий. Тестовый контакт с нужными данными запускает автоматизацию один раз или с согласованной частотой. Контакт, не прошедший фильтры, не входит.
  • Маршруты. Проверяются каждая ветка и условия перехода. Для развилки по покупке нужны тестовые случаи с покупкой и без неё.
  • Время. Сверяется задержка между событием и действием, часовой пояс и отправка по расписанию. Если точное время зависит от очереди платформы, это ограничение нужно описать отдельно.
  • Содержание и персонализация. Проверяются тема, прехедер, отправитель, ссылки, значения подстановок и поведение при пустом поле. Тестовое письмо должно показывать, что получит сегмент, а не только как выглядит шаблон с заполненными демо-данными.
  • Остановка. Отписка, покупка или другое заданное событие прекращают дальнейшие маркетинговые отправки, если так определена логика.
  • Ошибки и журнал. Проверяется, где видна причина сбоя, как команда узнаёт о проблеме и что происходит с последующими шагами.

К каждому пункту добавьте тестовые данные и ожидаемый результат. Формулировка «проверить приветственную цепочку» слишком расплывчата. Лучше указать: создать контакт с подтверждённым согласием и заданным источником; убедиться, что он входит в сценарий; изменить статус после первого письма; проверить, что дальнейшее действие соответствует настроенной ветке. Параллельно проверить контакт без согласия и контакт с уже выполненным целевым действием.

Метрики тоже требуют методики. Если в ТЗ указан кликрейт, зафиксируйте, какое событие считается кликом и на какой аудитории он рассчитывается. Для конверсии укажите целевое событие и окно атрибуции, согласованное командой. Универсальных нормативов опенрейта, клика или продаж для всех баз и отраслей нет, поэтому не превращайте прогноз в критерий технической приемки. Автоматизация может обеспечить корректную отправку и сбор событий; бизнес-результат зависит также от сегмента, предложения, базы и других условий.

В Frappe CRM автоматизацию нельзя включить, пока в ней нет хотя бы одного действия. Это хороший пример технического условия, которое нужно проверять в конкретной платформе: требования к публикации, активации и обязательным полям у ESP различаются. В итоговый протокол внесите версию сценария, дату проверки, тестовые контакты, пройденные ветки и список дефектов. Тогда после изменения условий можно понять, что именно проверяли до релиза.

Права на код, настройки и материалы

Под «правами на код email-маркетинга» в проекте часто подразумевают сразу несколько разных вещей: кому принадлежат написанные скрипты и интеграции, кто вправе менять сценарии, можно ли повторно использовать шаблоны, кто получает доступ к исходным файлам и документации. Одной фразы «все права передаются заказчику» может оказаться недостаточно, если не перечислено, что именно создано и в каком виде это передаётся.

Составьте перечень результатов, которые исполнитель должен передать и которые стороны должны описать в договоре или приложении к нему. Например:

  • конфигурации автоматизаций и экспортируемые workflow, если платформа позволяет их выгрузить;
  • скрипты, webhook и интеграционный код;
  • шаблоны писем, исходные макеты и тексты;
  • настройки событий, полей, сегментов и триггеров;
  • схема данных и описание зависимостей;
  • инструкции по запуску, изменению, отключению и восстановлению сценария;
  • перечень сторонних библиотек, компонентов и аккаунтов, используемых в решении.

Затем задайте практические вопросы: в чьём аккаунте создаются автоматизации, кто будет администратором после сдачи, как заказчик получает исходники, в каком формате передаются настройки и кто имеет право вносить изменения. Если интеграция собрана в аккаунте подрядчика или завязана на его ключи доступа, передача результата может потребовать отдельных шагов. Этот риск проще убрать архитектурно ещё до запуска.

Условия об интеллектуальных правах зависят от договора и применимого законодательства. Техническое ТЗ не заменяет юридические формулировки, но может точно определить объём результата и порядок передачи материалов. Отделите созданное специально для проекта от инструментов и компонентов, которые исполнитель использует повторно, и заранее согласуйте права и ограничения для обеих категорий. Не оставляйте вопрос «кому принадлежит автоматизация» на финальный акт: к этому моменту часть сценария уже может зависеть от аккаунтов, шаблонов и кода, созданных вне доступа заказчика.

Доставляемость и требования Gmail

Техническое задание на email-рассылку должно включать аутентификацию отправителя и параметры передачи писем. Это особенно важно, если сценарий будет регулярно отправлять сообщения на Gmail: хорошая логика цепочки не компенсирует проблемы с доменом и репутацией.

Google указывает, что все отправители на личные аккаунты Gmail должны настроить SPF или DKIM. Для отправителей, которые превышают 5 000 сообщений в день на аккаунты Gmail, перечислены дополнительные требования: SPF, DKIM и DMARC, выравнивание домена From с SPF- или DKIM-доменом и поддержка one-click unsubscribe для маркетинговых и подписных сообщений. Для таких массовых отправителей показатель спам-жалоб в Postmaster Tools должен быть ниже 0,30%. Google также указывает передачу почты по TLS и соответствие RFC 5322.

Порог 5 000 сообщений в день относится к требованиям Google для отправителей на Gmail, а не к универсальному лимиту рассылок или законодательному порогу. В ТЗ зафиксируйте, кто отвечает за DNS-записи, какой домен используется в адресе From, как проверяется выравнивание и кто контролирует Postmaster Tools. Если настройку DNS выполняет отдельная команда, включите её в план работ и зависимостей, а не оставляйте как устное условие запуска.

Перед релизом проверьте, что:

  • домен отправителя аутентифицирован и нужные записи опубликованы;
  • адрес From согласован с доменом аутентификации в объёме, который требуется для выбранного типа отправителя;
  • маркетинговое письмо содержит видимую ссылку отписки, а техническая one-click отписка реализована там, где она требуется;
  • тестовое письмо передаётся с TLS;
  • команда знает, где отслеживать жалобы и технические ошибки.

В итоге хорошее ТЗ связывает бизнес-событие с конкретной аудиторией, действиями и проверяемым результатом. В нём видно, кто и с какими правами запускает шаги, как сценарий реагирует на сбой и отзыв согласия, какие условия проверяются на приемке и что исполнитель передаёт заказчику. Такая детализация не обещает рост конверсии сама по себе. Она убирает дорогие догадки и даёт команде основу для тестов, оптимизации и безопасного развития автоматизации.

Частые вопросы

Что должно быть в ТЗ на email-автоматизацию?
Укажите бизнес-цель, событие запуска и его источник, фильтры входа, ветвления, задержки, действия и условия выхода. Также зафиксируйте права выполнения, обработку ошибок, правила согласия и отписки, критерии приемки и состав передаваемых материалов.
Как проверить email-автоматизацию перед запуском?
Проверьте входящие и исключённые контакты, каждую ветку сценария, время действий, содержание и персонализацию писем, остановку после заданного события и отображение ошибок в журнале. Для каждого пункта задайте тестовые данные и ожидаемый результат.
Что проверить в сценарии после отписки контакта?
В ТЗ нужно указать, какое событие или поле фиксирует отписку и как контакт исключается из дальнейших маркетинговых отправок. На приемке следует проверить, что повторное событие не возвращает отписавшегося в активный сценарий, если так определена логика.
Какие требования Google предъявляет к массовым отправителям на Gmail?
Для отправителей, которые превышают 5 000 сообщений в день на аккаунты Gmail, Google перечисляет требования SPF, DKIM и DMARC, выравнивание домена From с SPF- или DKIM-доменом и поддержку one-click unsubscribe для маркетинговых и подписных сообщений. Показатель спам-жалоб в Postmaster Tools должен быть ниже 0,30%; также Google указывает передачу почты по TLS и соответствие RFC 5322.
Что нужно передать заказчику после настройки email-автоматизации?
В перечень можно включить конфигурации и экспортируемые workflow, скрипты и интеграционный код, шаблоны и исходные макеты, настройки событий и сегментов, схему данных и инструкции по сопровождению. В ТЗ также стоит определить аккаунт, где создаются автоматизации, порядок передачи исходников и права на повторно используемые компоненты.