- 06.04.2025
- 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. Базовый пример конфигурации

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

3. Практические примеры
3.1. Добавление UTM-меток

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

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

4. Особенности работы
4.1. Порядок выполнения правил
Правила с более высоким
priority
выполняются первымиПри одинаковом приоритете — сверху вниз в конфиге
4.2. Обработка ошибок
Некорректные regex-паттерны логируются в
/var/log/mailerq/rewrite_errors.log
Письма с ошибками обработки помечаются специальным заголовком:
X-Rewrite-Error: Failed to apply rule 'utm_builder'
Wellcome To Finbuzz
5. Доступ к модулю в веб-консоли
5.1. Навигация к модулю
Откройте веб-консоль MailerQ (обычно на порту
8486
)В главном меню выберите: Контент → Rewrite Rules
Перед вами откроется интерфейс управления правилами
5.2. Преимущества веб-интерфейса
Визуальный редактор правил (не нужно редактировать JSON вручную)
Тестовый режим — предпросмотр изменений перед применением
История изменений — кто и когда менял правила
График применения — статистика по сработавшим правилам

Rewrite Rules в MailerQ — это единый механизм с двумя интерфейсами:
Веб-консоль — для оперативного управления и мониторинга
config.json — для сложных сценариев и автоматизации
Совет: Начинайте с веб-интерфейса, а для продвинутых сценариев переходите к файловой конфигурации.