Шаблоны уведомлений заказов

📧 Общее описание

Раздел "Шаблоны уведомлений заказов" предназначен для создания и управления шаблонами SMS и Email уведомлений, которые автоматически отправляются клиентам при изменении статуса заказа. Каждый шаблон привязан к определенному статусу заказа и содержит текст для SMS и Email уведомлений.

Доступ к разделу осуществляется через главное меню в разделе "Шаблоны" или через кнопку "Шаблоны" на странице наряд-заказов.

📋 Список шаблонов

На странице отображается таблица со всеми созданными шаблонами:

  • ID — уникальный идентификатор шаблона
  • Статус — статус заказа, для которого создан шаблон
  • Действия — кнопки для редактирования и удаления шаблона
💡 Важно: Для каждого статуса заказа можно создать только один шаблон. Если шаблон для статуса уже существует, он не будет отображаться в списке доступных статусов при создании нового шаблона.
📸 Скриншот списка шаблонов: Кликните на изображение для просмотра в полном размере
Список шаблонов уведомлений

Справа в шапке списка, помимо «Создать», есть кнопка «Настройка» — оформление обёртки email (см. ниже).

✉️ Оформление письма (шапка и подвал)

Маршрут: /order-notification-templates/layout. Открывается кнопкой «Настройка» на странице «Шаблоны уведомлений» (/order-notification-templates).

Заголовок экрана: «Оформление письма», подзаголовок: «Шапка и подвал для писем „статус заказа“. Шаблоны в списке задают только тело письма.» Кнопка «К шаблонам» возвращает к списку шаблонов.

Шаблоны из таблицы задают только тело письма; шапка и подвал добавляются автоматически (если включено), плюс блок «Личный кабинет» и при необходимости глобальный подвал из настроек компании.

  • Переключатель «Добавлять шапку и подвал в письмо»
  • «Цвета градиента шапки (135°)» — поля «Первый цвет ([gradient_start])» и «Второй цвет ([gradient_end])» (по умолчанию в подсказке: #667eea → #764ba2)
  • Панель «Доступные переменные для шапки и подвала» — плейсхолдеры в квадратных скобках (например [brand_name], [status_label], [gradient_start])
  • Редакторы «HTML шапки (одна строка таблицы <tr>…</tr>)» и «HTML подвала (одна строка таблицы <tr>…</tr>)» с предпросмотром
  • Кнопки «Сохранить» и «Сбросить к значениям по умолчанию»
💡 Основной цвет CRM для писем задаётся в Настройки → Прочее (плейсхолдер [primary_color] в справке на экране оформления).

➕ Создание шаблона

Для создания нового шаблона:

  1. Нажмите кнопку "Создать" в правом верхнем углу страницы
  2. Выберите "Статус заказа" из списка доступных статусов
  3. Заполните "Шаблон для СМС" — текст SMS уведомления
  4. Заполните "Шаблон для e-mail" — текст Email уведомления (можно использовать HTML)
  5. Нажмите кнопку "Сохранить"
⚠️ Внимание: Кнопка "Создать" отображается только если есть доступные статусы, для которых еще не созданы шаблоны.
📸 Скриншот формы создания шаблона: Кликните на изображение для просмотра в полном размере
Создание шаблона

✏️ Редактирование шаблона

Для редактирования существующего шаблона:

  1. Найдите нужный шаблон в таблице
  2. Нажмите кнопку "Редактировать" (иконка карандаша)
  3. Внесите изменения в шаблоны SMS и Email
  4. Нажмите кнопку "Сохранить"
💡 Совет: При редактировании шаблона статус заказа изменить нельзя — он привязан к шаблону при создании.
📸 Скриншот формы редактирования шаблона: Кликните на изображение для просмотра в полном размере
Редактирование шаблона

🗑️ Удаление шаблона

Для удаления шаблона:

  1. Найдите нужный шаблон в таблице
  2. Нажмите кнопку "Удалить" (иконка корзины)
  3. Подтвердите удаление в диалоговом окне
⚠️ Внимание: Удаление шаблона безвозвратно. После удаления шаблона для соответствующего статуса заказа уведомления отправляться не будут.

📝 Переменные в шаблонах

В шаблонах SMS и Email можно использовать специальные переменные, которые автоматически заменяются на реальные данные заказа:

Данные клиента

  • [fio] — Фамилия Имя Отчество клиента
  • [email] — Email адрес клиента
  • [phone] — Телефон клиента

Данные заказа

  • [status] — Статус наряд-заказа
  • [number] — Номер заказа
  • [url] — Ссылка на заказ

Финансовые данные

  • [total] — Сумма заказа без наценки и скидки
  • [discount] — Размер скидки (число в процентах)
  • [totalDiscount] — Сумма заказа с учётом скидки
  • [markup] — Размер наценки (число в процентах)
  • [totalMarkup] — Сумма заказа с учётом наценки
  • [totalAfterMarkup] — Сумма заказа с учётом наценки и скидки

Предоплата

  • [prepayment] — Процент предоплаты
  • [prepaymentLeft] — Остаток предоплаты в процентах
  • [prepaymentSum] — Сумма предоплаты (X% от суммы заказа с учетом наценки и скидки)

Дополнительная информация

  • [account_details] — Реквизиты счёта, если указаны
  • [address] — Адрес доставки
  • [tkLink] — Трек-номер. Если выбрана доставка СДЭК, подставит ссылку для отслеживания
  • [qr] — QR-код
💡 Пример использования переменных: 
Здравствуйте, [fio]!
Ваш заказ #[number] переведен в статус "[status]".
Сумма заказа: [totalAfterMarkup] ₽
Ссылка на заказ: [url]
📸 Скриншот списка переменных: Кликните на изображение для просмотра в полном размере
Переменные шаблона

📧 Шаблон для Email

Шаблон для Email поддерживает HTML разметку:

  • Форматирование текста — жирный, курсив, подчеркивание
  • Заголовки — различные уровни заголовков
  • Списки — маркированные и нумерованные
  • Таблицы — для структурирования данных
  • Изображения — вставка изображений
  • Ссылки — гиперссылки на внешние ресурсы
💡 Совет: Используйте HTML редактор для создания красиво оформленных Email уведомлений. Редактор поддерживает все стандартные возможности форматирования текста.

📱 Шаблон для SMS

Шаблон для SMS имеет ограничения:

  • Только текст — HTML разметка не поддерживается
  • Ограничение длины — рекомендуется не более 160 символов для одной SMS
  • Краткость — важная информация должна быть в начале сообщения
💡 Совет: Для SMS используйте короткие и информативные сообщения. Укажите номер заказа, статус и ссылку на заказ.

🚀 Использование шаблонов

Шаблоны автоматически используются при отправке уведомлений клиентам:

  1. Откройте страницу наряд-заказа
  2. В разделе "Уведомления" нажмите кнопку "Уведомить по SMS" или "Уведомить по email"
  3. Система автоматически выберет шаблон, соответствующий текущему статусу заказа
  4. Переменные в шаблоне будут заменены на реальные данные заказа
  5. Уведомление будет отправлено клиенту
💡 Важно: Если для статуса заказа не создан шаблон, уведомление не будет отправлено. Убедитесь, что для всех важных статусов созданы шаблоны.

📊 История отправки уведомлений

В разделе уведомлений на странице заказа отображается история всех отправленных уведомлений:

  • Дата и время — когда было отправлено уведомление
  • Канал — SMS или Email
  • Статус — успешно отправлено или ошибка
  • Получатель — кому было отправлено уведомление

💡 Практические советы

  • Создавайте шаблоны для всех важных статусов заказа (Новый, В производстве, Готов, Отгружен и т.д.)
  • Используйте переменные для персонализации уведомлений
  • Для Email используйте HTML форматирование для лучшей читаемости
  • Для SMS делайте сообщения короткими и информативными
  • Всегда включайте номер заказа и ссылку на заказ в уведомлениях
  • Регулярно проверяйте историю отправки уведомлений для контроля доставки
  • Тестируйте шаблоны перед использованием в продакшене