Подписчик один раз оставил email, но получает два приветственных письма с одинаковым содержанием. Источником может быть не редактор шаблона, а два независимых события подписки: форма, импорт в CRM, автоматическое создание контакта или повторно доставленный webhook. Правильная задача — гарантировать контролируемую однократную обработку подходящего события, не теряя настоящие повторные подписки и не блокируя письма навсегда без правила.
Что выяснить перед передачей или разработкой
Соберите полную последовательность событий: идентификатор контакта, источник согласия, время формы, событие синхронизации, триггер автоматизации и ID отправленного письма. Идентификатор лучше хранить внутренний, без публикации адреса получателя в журнале для подрядчика. Уточните, что означает «одна подписка»: новый адрес в списке, новый подтверждённый opt-in или новый статус участника кампании. Импорт старой базы и повторное подтверждение согласия — разные основания, а автоматические цепочки часто запускаются по изменению группы или тегов.
Для смежного понимания исходных условий полезен материал Приветственная email-цепочка: что отправить после подписки и как оценить результат, однако нынешняя задача не дублирует его: идемпотентность запуска email-сценария, а не содержание welcome-писем или дубли интернет-заказов. Перед настройкой определите первичный источник статуса согласия и ответственного за его изменение.
Практическая организация решения
Выберите стабильный ключ запуска, например campaign_id + contact_id + consent_epoch, и сохраняйте состояние обработки до отправки либо в транзакционной схеме с возможностью надёжного восстановления. Нельзя просто удалять повторное событие без регистрации результата: если первый запуск аварийно завершился, подписчик не должен остаться без писем. Для webhook учитывайте повторную доставку, одновременные запросы и задержки CRM. Регистр отправок должен показывать начальный запуск, попытки, успешную обработку и осознанный повтор после нового основания.
Профильное направление Email-маркетинг и автоматические цепочки может включать обсуждаемую задачу. Если отдельные правки относятся к Техническая поддержка и доработка сайта, их включают в предложение только после проверки зависимости. Согласуйте не только выходной файл или интерфейс, но и способ самостоятельной проверки, повторного использования и восстановления после ошибки.
Заполненный условный реестр четырёх сценариев
Условная система связывает campaign_id, внутренний contact_id и номер эпохи согласия consent_epoch. Бизнес-правило для примера: welcome запускают один раз после подтверждённого согласия на конкретную кампанию; импорт существующего контакта сам по себе не является новым согласием. Ниже приведены ожидаемые результаты модели, не фактические отправки клиентам.
- A — первая подписка из формы. Исходные записи: контакт P-017, кампания W-01, новое подтверждённое согласие epoch=1, событие form-F101. Ключ W-01/P-017/1 ещё отсутствует. Решение: атомарно зарегистрировать ключ и одно задание. Ожидаемо: 1 созданная цепочка, статус «запланировано», после подтверждения провайдера — «отправка принята»; фактическое попадание во входящие не гарантируется. Исключение: нет подтверждённого согласия → 0 запусков, причина в журнале.
- B — webhook доставлен повторно. Два события E-207 и E-207-retry с одним business-key W-01/P-017/1 приходят с задержкой либо одновременно. Первый обработчик создаёт задание, второй получает уже существующий идентификатор и записывает «duplicate». Ожидаемо: 1 цепочка, 1 уникальный ключ, 1 запись о пропуске. Исключение: первый обработчик упал до отправки → состояние «ошибка, допустим повтор», а не вечное «отправлено»; при неопределённом статусе после вызова почтового API сначала сверяют его message ID, чтобы случайно не отправить второй экземпляр.
- C — импорт старого контакта. Контакт P-031 уже в подтверждённой кампании W-01, epoch=1, ранее отправка зарегистрирована. CRM импортирует строку I-551 и повторно добавляет тег. Решение: обновить допустимые профильные поля, сохранить историю согласия, но не создавать новый welcome. Ожидаемо: 0 новых цепочек, запись «импорт без нового согласия». Исключение: если импорту неизвестна история или отсутствует достаточное основание для отправки, контакт отправляют на проверку/подтверждение, а не автоматически в цепочку.
- D — отписка и последующее новое согласие. Контакт P-017 отписался; затем через форму дал новое подтверждённое согласие W-01, epoch=2. Согласно выбранной для примера политике это новая эпоха участия. Ключ W-01/P-017/2 отличен от старого; ожидаемо: 1 новая цепочка и сохранённая история двух эпох. Исключение: повторное добавление тега без согласия или неподтверждённая форма → 0 запусков; старую отписку нельзя просто стереть.
Для каждого пункта контрольные поля журнала: source_event_id, business-key, consent_status, workflow_id, state, provider_message_id (если выдан), причина пропуска и время. Приёмка сравнивает ожидаемое число созданных цепочек с журналом; это не обещание единственной фактической доставки письма внешним провайдером.
Негативный сценарий: что нельзя считать решением
Плохое исправление — сделать глобальный признак welcome_sent=true навсегда и считать задачу решённой. Тогда новая кампания или законная повторная подписка могут не получить письмо, а неудачная первая попытка потеряется. Другая ошибка — обрабатывать два параллельных события без атомарной проверки ключа. Нужно проверить гонку и согласованный порядок повторной доставки, не обещая невозможной абсолютной однократности в любой внешней системе.
В материале Интеграция повторно создаёт заказы в магазине: как организовать ключ операции и безопасный повтор рассмотрен соседний вопрос; для настоящей задачи важнее не смешивать границы решений. Если спорная операция уже выполнена, сначала зафиксируйте её состояние и согласуйте безопасную коррекцию, затем повторите контрольный тест.
Критерии приёмки
Четыре сценария имеют ожидаемое количество запусков, повтор не создаёт вторую активную цепочку, авария обработки допускает безопасное восстановление, а события согласия не теряются. У ответственного есть журнал с ключом, статусом и причиной исключения. Оценивать содержимое приветственных писем следует отдельно от корректности запуска.
Определите смысл одного запуска до написания кода
Подписка может быть получена через сайт, импорт в CRM и ручное добавление тега, причём все три действия происходят вокруг одного человека. Если каждое трактовать как новую подписку, цепочка запустится несколько раз. Согласуйте бизнес-событие, например первое подтверждённое согласие на конкретную рассылку, и отдельно — случаи, когда новая подписка после отписки считается новой эпохой участия. В журнале нужно хранить источник, момент, внутренний ID контакта и статус согласия. Адрес электронной почты не следует размещать в общедоступных технических логах и скриншотах.
Выберите ключ идемпотентности, состоящий из стабильных идентификаторов и явно согласованного периода согласия. Если один webhook доставлен дважды, обработчик должен распознать повтор, а не отправить два приветственных письма. Но простой флаг «отправлено навсегда» тоже опасен: он мешает корректной повторной подписке в будущем и не объясняет, что произошло при ошибке первой отправки. Состояния должны различать ожидание, обработку, успешное завершение, повтор и ошибку с возможностью безопасного восстановления.
Гонка между двумя обработчиками
Представьте, что сайт и CRM одновременно передают событие для одного контакта. Оба обработчика видят «цепочка ещё не начата» и каждый создаёт собственное задание. Проверка в памяти одного процесса не защитит от такой гонки. Нужна согласованная операция записи ключа и статуса в постоянном хранилище либо другой механизм, который обеспечивает защиту от параллельного создания одного и того же задания. Конкретная архитектура зависит от стека. После этого проверьте, что повторный запрос возвращает существующий результат, а не создаёт новый сценарий.
Если задание создано, но перед отправкой произошёл сбой, важно не считать цепочку успешно доставленной. Для теста искусственно воспроизведите сбой между сохранением события и отправкой письма, затем восстановите обработку. Две разные системы могут не поддерживать общую транзакцию; тогда журнал и стратегия повторов должны однозначно показывать, какие действия уже выполнены. Не обещайте абсолютной однократности доставки внешнего email, если провайдер не предоставляет соответствующих механизмов подтверждения.
Четыре сценария и контроль согласия
В рабочем регистре согласий сохраняйте не только текущий флаг подписки, но и происхождение каждой эпохи участия: форму, импорт с доказанным основанием, повторное подтверждение или отписку. Если CRM и сайт сообщают разные статусы, зафиксируйте правило разрешения конфликта и поместите контакт в очередь проверки, не отправляя welcome наугад. Решение о повторном приветствии после новой подписки — политика коммуникации, а не побочный эффект технического ключа.
Для оператора составьте понятный журнал: ID кампании, ID контакта, первичное событие, решение «запущено или пропущено», причина и статус отправки. При ошибке он должен иметь возможность проверить ситуацию без чтения исходного кода. Для повторной диагностики используйте тестовый адрес, а не письмо реального клиента. Приёмка состоит в сохранении верного согласия и предсказуемых запусков, а не в механическом сокращении количества отправленных писем.
Когда обратиться за индивидуальным расчётом
Для диагностики двух welcome-цепочек пригодятся обезличенные идентификаторы четырёх тестовых событий, статусы согласий и экспорт журнала отправки. Работа включает схему ключа идемпотентности и аварийного повтора без заявлений о гарантированной доставке внешнего email. Описания услуги и объёма возможных работ доступны в Состав работ и порядок индивидуального предложения; через Обсудить задачу и запросить индивидуальную оценку можно обсудить индивидуальный состав и проверку результата без неподтверждённых гарантий.