Rewrite Rules в MailerQ: модификация писем на лету

Rewrite Rules в MailerQ: модификация писем на лету

Полное руководство по Rewrite Rules в MailerQ: модификация писем на лету

Модуль Rewrite Rules в MailerQ — это мощный инструмент для динамического изменения содержимого электронных писем перед отправкой. С его помощью можно:

  • Массово заменять ссылки и текст в письмах

  • Добавлять UTM-метки для трекинга

  • Корректировать заголовки для улучшения доставляемости

  • Персонализировать контент на основе данных получателя

В этой статье мы детально разберем все аспекты работы с Rewrite Rules.


1. Основные возможности модуля

1.1. Что можно модифицировать?

  • Тело письма (HTML и plain-text версии)

  • Заголовки (Subject, From, To и другие)

  • Ссылки (добавление параметров, замена доменов)

  • Вложения (названия и содержимое)

1.2. Типы преобразований

  • Текстовые замены — глобальная замена строк

  • Регулярные выражения — сложные паттерны замены

  • Шаблонизация — вставка переменных (например, {user_id})

  • Условные правила — применение изменений только при определенных условиях


2. Настройка через config.json

2.1. Базовый пример конфигурации

Rewrite Rules в MailerQ: модификация писем на лету

2.2. Параметры правил

Rewrite Rules в MailerQ: модификация писем на лету

3. Практические примеры

3.1. Добавление UTM-меток

3.2. Замена домена изображений

3.3. Динамический Subject

4. Особенности работы

4.1. Порядок выполнения правил

  1. Правила с более высоким priority выполняются первыми

  2. При одинаковом приоритете — сверху вниз в конфиге

4.2. Обработка ошибок

  • Некорректные regex-паттерны логируются в /var/log/mailerq/rewrite_errors.log

  • Письма с ошибками обработки помечаются специальным заголовком:
    X-Rewrite-Error: Failed to apply rule 'utm_builder'

Wellcome To Finbuzz

5. Доступ к модулю в веб-консоли

5.1. Навигация к модулю

  1. Откройте веб-консоль MailerQ (обычно на порту 8486)

  2. В главном меню выберите: Контент → Rewrite Rules

  3. Перед вами откроется интерфейс управления правилами

5.2. Преимущества веб-интерфейса

  • Визуальный редактор правил (не нужно редактировать JSON вручную)

  • Тестовый режим — предпросмотр изменений перед применением

  • История изменений — кто и когда менял правила

  • График применения — статистика по сработавшим правилам

Rewrite Rules в MailerQ — это единый механизм с двумя интерфейсами:

  • Веб-консоль — для оперативного управления и мониторинга

  • config.json — для сложных сценариев и автоматизации

Совет: Начинайте с веб-интерфейса, а для продвинутых сценариев переходите к файловой конфигурации.

MailerQ 5.14.4 в курсе НР 2025