Шаблоны по умолчанию (администратор платформы)

← Оглавление

Раздел «Шаблоны по умолчанию» — стартовые тексты, с которых организации начинают: SMS с кодом входа в мобильное приложение и шаблоны уведомлений о бонусах. Администратор платформы правит их здесь, а организация получает копию — обычный свой шаблон в разделе «Шаблоны», который дальше меняет сама. Сообщения клиентам всегда уходят по шаблону организации: правка текста по умолчанию не меняет того, что организации уже отправляют, пока вы явно не обновите текст у организаций.

Раздел виден только роли Администратор платформы (PLATFORM_ADMIN). Остальной гайд написан для сотрудников организаций, эта страница — для команды платформы.

Зачем это#

• Требование оператора — без выпуска новой версии. SMS-провайдеры и операторы связи предъявляют требования к тексту: например, модерация Eskiz.uz требует, чтобы SMS с кодом называла цель кода и ресурс. Стартовый текст для всех новых организаций меняется на этой странице.
• Вычитка переводов. Тексты на русском, узбекском и английском правит владелец продукта или переводчик прямо в интерфейсе.
• Обновление без сюрпризов. Новый текст получают организации, которые начнут пользоваться шаблоном после сохранения. Тем, кто уже получил копию и не менял её, текст обновляется, только если отметить это при сохранении. Шаблоны, которые организация изменила, платформа не трогает.

Где найти#

После входа администратор платформы попадает в платформенную часть админки. В её боковом меню — «Пользователи», «Организации», «Журнал запросов» и последним пункт «Шаблоны по умолчанию» (см. «Меню администратора платформы»). Адрес страницы — /platform/default-templates от адреса админки.

Раздел открывается только Администратору платформы. Поддержке (SUPPORT) и сотрудникам организаций пункт меню не показывается.

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

Заголовок страницы — «Шаблоны по умолчанию», подзаголовок — «Тексты, с которых организации начинают: код входа в приложение и уведомления о бонусах». Под ним — напоминание «Правка меняет текст для новых копий. Организации, которые уже получили копию, обновятся, только если отметить это при сохранении» и ссылка «Как устроены шаблоны по умолчанию» на эту страницу гайда.

Ниже — карточка на каждое назначение текста:

Метка «Системный» (подсказка «Копия одна на организацию, ей пользуется платформа») означает, что у организации ровно одна копия этого текста и отправляет её сама платформа — по ней уходят SMS с кодом входа.

В карточке — таблица: строка — канал, колонки — языки «Русский», «Oʻzbekcha» и «English». Viber и WhatsApp помечены «Пока не отправляется»: тексты для них есть и организация может создать по ним шаблон, но сообщения в эти мессенджеры пока не доставляются. Telegram отправляется через ботов организаций. В ячейке:

• ссылка «Версия N» — открывает редактор текста; номер растёт с каждым сохранением;
• дата и время последней правки;
• кто сохранил текст или «исходный текст» — текст платформы, который ещё никто не правил.

Строки таблицы не кликабельны: текст открывается ссылкой «Версия N» в колонке нужного языка.

Всего на странице 75 текстов: код входа — на трёх языках, уведомления — 4 вида × 6 каналов × 3 языка. Если текста на каком-то языке нет (так бывает у назначения, которое появилось в новой версии платформы), в ячейке вместо версии — ссылка «Добавить текст» с подсказкой «Организации с этим языком получают русский текст», а в русской колонке — «Без русского текста организации без текста на своём языке не получат копию». Канал, которого эта версия админки не знает, показывается без ссылки, с подсказкой «Канал не поддерживается этой версией админки».

Шаблоны по умолчанию хранит сервис сообщений. Если он недоступен, вместо карточек — «Сервис сообщений недоступен» с пояснением «Шаблоны по умолчанию хранит сервис сообщений: сейчас их нельзя ни посмотреть, ни изменить» и кнопкой «Повторить».

Как организация получает текст#

Шаблон по умолчанию сам никому не отправляется. Организация получает его копию — обычный шаблон в своём разделе «Шаблоны»:

• Код входа в приложение — копия появляется сама при первом запросе кода из мобильного приложения или сайта организации (см. «Мобильное приложение и SDK»), одна на организацию. Её название — из поля «Название» текста по умолчанию, сейчас system.app-login-code.
• Уведомления о бонусах — копию создаёт кнопка «Создать шаблон» в карточке уведомления (см. «Уведомления о бонусах»); каждое нажатие — новая копия текущей версии.

Язык копии — по настройке «Язык» организации (см. «Основные настройки»): узбекский — текст из колонки «Oʻzbekcha», английский — из «English», любой другой — из «Русский». Если текста на языке организации нет, копируется русский. Если нет и русского, копии не будет: «Создать шаблон» покажет организации «Текста по умолчанию для этого канала нет — обратитесь к администратору платформы», а вход в приложение по SMS-коду не заработает — приложение получит ошибку «доставка SMS недоступна».

Копия совпадает с текстом по умолчанию дословно, вместе с переменными. Название организации подставляется вместо {{tenant.name}} при каждой отправке, поэтому копия остаётся верной и после переименования организации.

Дальше копия — шаблон организации: её можно править, переименовать, выключить. Копия считается неизменённой, пока её тема, текст и параметры push или письма совпадают с версией, с которой она создана; название и включённость не учитываются. Правка текста по умолчанию существующие копии не меняет. Обновить их можно только явно, при сохранении, и только неизменённые (см. «Обновить текст у организаций»).

Прежние тексты кода входа. У организаций, которые подключили приложение до появления этого раздела, шаблон кода входа мог остаться с прежним текстом платформы — например, «Код для входа: …» или «Acme: код для входа …». Такой шаблон при следующем запросе кода сам получает текущий текст по умолчанию на языке организации, независимо от того, обновляете ли вы текст у организаций. Шаблон, который организация переписала сама, не трогается.

Редактор шаблона#

Заголовок редактора — назначение, канал и язык, например «Код входа в приложение · SMS · Русский». Над полями:

• версия: «Версия 2 · 22.10.2026, 14:15 · Иван Петров» — номер, дата и автор последней правки; у текста, который ещё никто не правил, — «Исходный текст платформы · версия 1»;
• копии у организаций: «Копий у организаций: 41 шаблон у 41 организации», «Не изменены: 33 (из них на прежних версиях: 30)», «Изменены организациями: 6»; если копий нет — «Копий пока нет: организации получат этот текст при первом использовании»;
• у кода входа, если у кого-то остался прежний текст, — предупреждение «У 2 организаций прежний текст кода входа: при следующем запросе кода они получат текст по умолчанию на своём языке».

Сведения о копиях — на момент открытия редактора; перед сохранением админка перечитывает их сама.

Поля:

• «Название» с подсказкой «Так будет называться шаблон у организации». Это название получают новые копии; у существующих копий оно не меняется, даже когда вы обновляете у них текст.
• Поля канала — те же, что у шаблона организации. У SMS — текст со счётчиком частей и блоком «Текст для модерации» (ниже). У push — «Заголовок», «Текст», «Картинка», «Ссылка при нажатии» и блок «Дополнительно», справа — превью «Как увидит клиент» (см. «Push-шаблон»). У email — «Тема», формат «Текст | HTML» и текстовая версия (см. «Email-шаблон: текст или HTML»). У Telegram — текст с разметкой Telegram, проверкой тегов и счётчиком «из 4096» (см. «Telegram-шаблон»); стартовые тексты платформы — без разметки. У Viber и WhatsApp — только «Содержимое». Канал выбрать нельзя: он задан строкой таблицы.
• Под полями — правила переменных назначения и справочник «Доступные переменные».

Правила каналов те же, что у шаблонов организаций: SMS — не длиннее 1 000 символов и 6 частей, у письма обязательна тема, у push проверяются ссылки, ключ схлопывания и дополнительные данные.

Переменные#

Справочник «Доступные переменные» показывает ровно те переменные, которые платформа заполнит при отправке этого назначения и канала. Клик по переменной вставляет её туда, где стоит курсор, при наведении — описание.

Админка проверяет правила на ходу и показывает итог над справочником:

• нет обязательной переменной — «Нет обязательной переменной: {{auth.code}}. Без неё текст не сохранить», под полем текста — «Нет обязательной переменной». SMS кода входа без кода бесполезна, поэтому такой текст не сохраняется;
• недопустимая переменная — «Эти переменные здесь не заполняются: {{order.number}} — уберите их», под полем, где она стоит, — «Переменная здесь не заполняется». Сохранить нельзя: клиент получил бы пустое место. Проверяются тема, текст, текстовая версия письма, а у push — ещё ссылка при нажатии, ключ схлопывания и значения дополнительных данных;
• нет рекомендуемой переменной — предупреждение «Рекомендуется добавить {{tenant.name}}» с пояснением; у кода входа — «Без названия организации SMS-провайдер может не утвердить текст кода: правила операторов требуют назвать ресурс». Сохранять можно.

Те же правила сервер проверяет при сохранении: если админка что-то пропустит, ошибка появится под полем.

{{tenant.name}} — название организации. Платформа подставляет его при отправке из карточки организации: без фигурных скобок и невидимых символов, с одиночными пробелами, не длиннее 30 символов (длинное название обрезается). Название меняет администратор платформы (см. «Переименование организации»).

Длина SMS#

Счётчик под текстом SMS — тот же, что у шаблона организации (см. «Длина, части и кодировка»), но предел всегда платформенный: «… SMS из 6». SMS-провайдер у каждой организации свой; если его предел меньше, организация увидит это в своей копии.

Сервер при проверке считает каждую переменную одним символом, а название организации — до 30 символов, и кириллица переводит всю SMS в Юникод: до 70 знаков в одной SMS и по 67 в частях длинной. Поэтому, если в тексте есть {{tenant.name}}, под счётчиком — оценка худшего случая: «Если название организации — 30 букв кириллицей: N SMS из 6». Например, русский текст кода входа по умолчанию с названием «Acme» укладывается в одну SMS, а с названием из 30 кириллических букв — в две, и такие организации платят за код вдвое больше. Если и худший случай длиннее 6 частей, строка красная, а под ней — «У такой организации SMS не уйдёт»: сохранить текст можно, но у организации с длинным названием SMS после подстановки окажется длиннее 6 частей и не отправится.

Текст для модерации#

Если SMS-провайдер организации утверждает тексты (так делает, например, Eskiz.uz, см. «Eskiz.uz: модерация текстов»), он отправляет только утверждённые. Под счётчиком SMS — свёрнутый блок «Текст для модерации». На этой странице он есть у каждого SMS-текста и не зависит от подключений организаций:

• пояснение «Если SMS-провайдер организации утверждает тексты, организация отправит на модерацию свою копию — с настоящим названием вместо «Acme». Любое изменение текста — новая модерация»;
• текст с примерами вместо переменных: название организации — «Acme», код — «123456», остальные — примеры справочника («Анна», «1500» — суммы без пробела между разрядами, как в SMS), например «Код для входа в приложение Acme: 123456. Никому не сообщайте.», и кнопка «Скопировать»;
• переменные без примера — строкой «Нет примеров для переменных … — замените их вручную»;
• ссылка «Как пройти модерацию» — на эту страницу гайда.

Этот текст нужен, чтобы увидеть SMS целиком и заранее согласовать формулировку с провайдером. Отправлять его на модерацию от имени организации нельзя: «Acme» — выдуманное название. Модерация идёт в аккаунте каждой организации у её провайдера, и утверждает организация свою копию — с настоящим названием. В шаблоне организации блок «Текст для модерации» показывает именно такой текст (см. «Шаблоны»).

Любая правка SMS-текста по умолчанию для организаций — новый текст: те, кто получит копию после сохранения или кому вы обновите текст, должны утвердить его заново.

Превью#

• Push — превью «Как увидит клиент» справа от полей обновляется на ходу, с примерами вместо переменных (название организации — «Acme»).
• SMS и email — под формой карточка «Превью SMS» или «Превью письма»: текст так, как его соберёт сервер при отправке, — у SMS с числом частей и кодировкой, у письма с темой, подвалом отписки на языке текста и образцом ссылки отписки. Поля значений переменных заполнены примерами с подсказкой «Значения переменных для превью; название организации и код — примеры»; поменяйте значения и нажмите «Обновить превью». Кнопок тестовой отправки нет: тестовое SMS и письмо уходят через подключения организации, а у текста по умолчанию организации нет.
• Превью SMS и письма строится по сохранённой версии. При несохранённых правках над ним — «Превью строится по сохранённой версии. Сохраните изменения, чтобы проверить их». После сохранения админка возвращается к списку: чтобы посмотреть превью новой версии, откройте текст снова. У текста, которого ещё нет, превью появится после первого сохранения.
• Telegram — карточка «Превью Telegram» под формой: сообщение «пузырём» с разметкой, длиной «N из 4096» и теми же полями значений переменных, тоже по сохранённой версии.
• У Viber и WhatsApp превью нет.

Сохранение и ошибки#

Кнопка «Сохранить» внизу страницы неактивна, пока в форме ничего не изменено, — иначе получилась бы новая версия с тем же текстом. Исключение — текст, которого на этом языке ещё нет: над формой — «Текста на этом языке ещё нет: организации с этим языком получают русский» и «Форма заполнена русским текстом — переведите его и сохраните», и сохранить его можно сразу. Первое сохранение создаёт версию 1.

По «Сохранить» админка:

1. проверяет поля и правила переменных — ошибки появляются под полями, запрос не уходит;
2. перечитывает текст и число копий: если тем временем текст сохранил другой администратор, показывает конфликт версий (см. «Если текст изменил другой администратор») и ничего не сохраняет;
3. если есть неизменённые копии — открывает окно «Обновить текст у организаций?», иначе сохраняет сразу.

После сохранения — сообщение «Сохранено: версия N» (если текст обновлён у организаций — «Сохранено: версия N. Текст обновлён в M шаблонах организаций») и возврат к списку. Сохранение с обновлением копий у многих организаций может занять несколько десятков секунд.

Если сохранить не удалось:

• ошибка в поле — пояснение под полем; если сервер не принял значение по причине, которую админка не знает, — «Сервер не принял значение»; ошибка вне полей формы — сообщение «Не удалось сохранить»;
• «Этого шаблона больше нет в каталоге» — назначение, канал или язык убраны в новой версии платформы; админка возвращается к списку;
• «Сервис сообщений недоступен» — форма с правками остаётся на экране. Сохранение могло пройти, хотя ответ не дошёл, поэтому админка не повторяет запрос, а перечитывает текст. Когда сервис снова доступен, нажмите «Сохранить» ещё раз: если первое сохранение всё-таки прошло, появится «Текст изменил другой администратор — ваши правки не сохранены» — это ваша же сохранённая версия, нажмите «Загрузить текущую версию» и проверьте текст;
• «Не удалось сохранить» — прочие ошибки сервера; админка тоже перечитывает текст, поэтому повторное «Сохранить» ведёт себя так же, как в предыдущем пункте.

Обновить текст у организаций#

Если у текста есть неизменённые копии, перед сохранением открывается окно «Обновить текст у организаций?»:

• «Новый текст получат организации, которые начнут пользоваться шаблоном после сохранения» — так происходит всегда;
• флажок, по умолчанию выключен: у кода входа — «Обновить текст у N организаций, которые его не меняли», у уведомлений — «Обновить текст в N шаблонах организаций, которые его не меняли» (у организации может быть несколько копий одного уведомления);
• «Шаблоны, которые организации изменили (K), не обновятся» — если такие есть;
• у SMS при отмеченном флажке — предупреждение «Если SMS-провайдер организации утверждает тексты, обновлённый текст нужно утвердить заново — до этого такие SMS не уходят», у кода входа ещё — «Клиенты этих организаций не смогут войти в приложение, пока провайдер не утвердит новый текст»;
• у кода входа, если у кого-то остался прежний текст, — «У N организаций прежний текст кода входа — они получат текст по умолчанию при следующем запросе кода, независимо от флажка», у SMS — с напоминанием «Если SMS-провайдер организации утверждает тексты, этот текст тоже нужно утвердить».

«Сохранить» сохраняет новую версию и, если флажок отмечен, обновляет копии; «Отмена» возвращает к форме без сохранения. Пока идёт сохранение, окно не закрывается.

Кого обновит флажок:

N в подписи флажка — все неизменённые копии этого языка: и текущей версии, и прежних.

Когда отмечать флажок. Тексты push и писем обновлять обычно безопасно. С SMS осторожнее: если провайдер организации модерирует тексты, обновлённый текст перестанет отправляться, пока организация его не утвердит, а для кода входа это значит, что её клиенты не смогут войти в приложение. Админка не показывает, у каких организаций провайдер модерирует тексты, поэтому перед обновлением SMS-текста предупредите организации, чтобы они утвердили новый текст у провайдера.

Если текст изменил другой администратор#

Два администратора могут открыть один текст одновременно. Если другой сохранил свою версию раньше, при вашем «Сохранить» над формой появится красное предупреждение «Текст изменил другой администратор — ваши правки не сохранены» с пояснением «Загрузите текущую версию. До этого ваши правки остаются на экране — их можно скопировать» и кнопкой «Загрузить текущую версию»:

1. Скопируйте свои правки — после загрузки они пропадут.
2. Нажмите «Загрузить текущую версию»: форма откроется заново с текстом, который сохранил другой администратор, и свежими сведениями о копиях.
3. Перенесите правки и сохраните ещё раз.

Чужая версия не перезаписывается молча: правки двух администраторов не теряют друг друга.

Переименование организации#

Название организации меняет администратор платформы: «Организации» → «Редактировать» → окно «Редактирование организации», поле «Название организации». Название обязательно, не длиннее 120 символов, и в нём должна быть буква, цифра или знак — иначе «В названии должна быть буква, цифра или знак — не только пробелы и фигурные скобки». Те же правила действуют при создании организации.

Название подставляется в сообщения вместо {{tenant.name}} — в SMS с кодом входа, уведомления, рассылки и цепочки организации. Поэтому, как только название в поле отличается от прежнего, окно предупреждает: «Название подставляется в сообщения вместо {{tenant.name}} (не длиннее 30 символов)» и «Если SMS-провайдер организации утверждает тексты, SMS с названием нужно утвердить заново — до этого они не уходят, в том числе коды входа в приложение».

Новое название появляется в сообщениях в течение минуты. В сообщения попадают первые 30 символов названия (без фигурных скобок и невидимых символов): если название длинное, проверьте, как оно выглядит обрезанным.

Переименование организации, у которой провайдер модерирует SMS, согласуйте с ней заранее: после переименования SMS с названием — в том числе коды входа в приложение — не уходят, пока организация не утвердит тексты с новым названием. Готовый текст с настоящим названием она найдёт в блоке «Текст для модерации» своего шаблона (см. «Шаблоны»).

Кто что может#

← Оглавление