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

Рабочее ТЗ на 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;
- команда знает, где отслеживать жалобы и технические ошибки.
В итоге хорошее ТЗ связывает бизнес-событие с конкретной аудиторией, действиями и проверяемым результатом. В нём видно, кто и с какими правами запускает шаги, как сценарий реагирует на сбой и отзыв согласия, какие условия проверяются на приемке и что исполнитель передаёт заказчику. Такая детализация не обещает рост конверсии сама по себе. Она убирает дорогие догадки и даёт команде основу для тестов, оптимизации и безопасного развития автоматизации.