Шаблоны сообщений в Konso Dispatch

bolt

TL;DR

check_circleШаблоны сообщений — переиспользуемые заготовки текстов, хранящиеся в Dispatch централизованно
check_circleФорматирование зависит от канала: Markdown для мессенджеров (Telegram, VK, Max), HTML или plain text для email
check_circleШаблоны поддерживают переменные — динамические данные подставляются в текст при отправке
check_circleИзменение шаблона в одном месте применяется ко всем сообщениям, которые его используют
check_circleСтандартизация шаблонов сокращает время внедрения и исключает разнобой в формулировках

Что такое шаблоны сообщений

Шаблон сообщения — это заготовка текста с опциональными переменными, которую Dispatch подставляет при отправке. Вместо того чтобы формировать тело сообщения в коде приложения, вы храните шаблоны в одном месте и ссылаетесь на них по имени или идентификатору. Это решает сразу несколько проблем: разработчики не дублируют тексты уведомлений в разных сервисах, нетехнические сотрудники могут редактировать тексты без деплоя, а все сообщения выглядят единообразно независимо от канала доставки.

Форматирование для мессенджеров

Telegram, VK и Max поддерживают Markdown-разметку — облегчённый синтаксис для структурирования текста без HTML. Dispatch передаёт текст шаблона в канал как есть, поэтому разметка должна соответствовать требованиям конкретного мессенджера.

Поддерживаемые элементы Markdown для мессенджеров

check_circle**жирный текст** — для выделения важных значений и заголовков
check_circle_курсив_ — для дополнительного контекста или примечаний
check_circle`моноширинный текст` — для технических значений: кодов ошибок, ID, путей
check_circle```блок кода``` — для многострочных технических данных (stack trace, JSON)
check_circle[текст ссылки](URL) — для ссылок на дашборды, логи или внешние ресурсы

lightbulb

Особенность Telegram

Telegram поддерживает два режима парсинга: MarkdownV2 и HTML. Konso Dispatch использует MarkdownV2 — в нём нужно экранировать специальные символы: . ! ( ) [ ] { } + - = | > #

Форматирование для email

Email-шаблоны в Dispatch состоят из двух частей: subject (тема письма) и тело сообщения. Тело может быть в двух форматах — plain text или HTML. Plain text используют для простых транзакционных уведомлений, HTML — для форматированных писем с логотипом, таблицами и кнопками.

Форматирование по каналам

Канал	Формат текста	Поддерживаемые элементы	Ограничения
Telegram	MarkdownV2	Жирный, курсив, моноширинный, блок кода, ссылки	Лимит 4096 символов, нужно экранировать спецсимволы
VK	Plain text + ссылки	Ссылки через URL, базовый текст	Ограниченная поддержка форматирования в сообщениях
Max	Plain text	Текст, ссылки	Минимальное форматирование
Email (plain)	Plain text	Текст, переносы строк	Нет визуального оформления
Email (HTML)	HTML	Полный HTML, CSS inline-стили	Inline CSS, нет внешних stylesheet
SMS	Plain text	Только текст	Лимит 160 символов на сегмент, нет ссылок

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

Шаблоны поддерживают переменные — плейсхолдеры, которые заменяются реальными значениями при отправке. Это позволяет одним шаблоном покрыть все сообщения одного типа: алерт о падении сервиса, уведомление о новом заказе или отчёт за период. Переменные передаются в запросе отправки сообщения вместе с телом — Dispatch подставляет их в шаблон перед доставкой в канал.

Когда использовать шаблоны

check_circleПовторяющиеся уведомления одного типа (алерты, отчёты, подтверждения) — шаблон пишется один раз
check_circleСообщения, текст которых может меняться без деплоя — редактируете шаблон в UI, не трогая код
check_circleУнификация коммуникаций — все алерты выглядят одинаково вне зависимости от того, какой сервис их отправляет
check_circleМультиканальные сценарии — один шаблон адаптируете под Telegram и Email, каждый со своим форматированием

Типичные ошибки при работе с шаблонами

check_circleИспользовать HTML-теги в Telegram — мессенджер их не рендерит, они появятся как текст
check_circleНе экранировать спецсимволы в Telegram MarkdownV2 — сообщение не отправится или придёт с ошибкой
check_circleХранить тексты уведомлений прямо в коде — при изменении нужен деплой
check_circleОдин шаблон для всех каналов без адаптации — Markdown в email выглядит как сырой текст
check_circleНе тестировать длинные SMS-шаблоны — сообщение разбивается на несколько частей и стоит дороже

Стандартизируйте коммуникации с Dispatch

Настройте шаблоны сообщений один раз и используйте их во всех каналах доставки

Открыть Dispatch arrow_forward

Частые вопросы

Можно ли использовать один шаблон для Telegram и email одновременно? expand_more

Технически — да, но не рекомендуется. Markdown-разметка для Telegram и HTML для email несовместимы: Markdown-символы в email будут отображаться как текст, а HTML-теги в Telegram — как сырой код. Лучше создать отдельные шаблоны для каждого канала.

Сколько переменных можно использовать в одном шаблоне? expand_more

Ограничений по количеству переменных нет. Главное — передать соответствующие значения в запросе отправки. Если переменная не передана, плейсхолдер останется в тексте как есть.

Как изменить шаблон без деплоя приложения? expand_more

Шаблоны редактируются через интерфейс Dispatch или API. Приложение ссылается на шаблон по имени или ID — после обновления шаблона все новые сообщения автоматически используют новый текст без изменений в коде.

Есть ли ограничения по длине шаблона? expand_more

Ограничения зависят от канала доставки. Telegram: 4096 символов на сообщение. SMS: 160 символов на сегмент (длинные сообщения разбиваются и тарифицируются как несколько SMS). Для email и мессенджеров VK и Max практических ограничений нет.

Поддерживаются ли условные блоки в шаблонах (if/else)? expand_more

Базовые шаблоны Dispatch поддерживают подстановку переменных. Для сложной условной логики рекомендуется формировать тело сообщения на стороне приложения и передавать уже готовый текст в запросе.