Перейти к основному содержимому

Переменные в шаблонах SMS-сообщений

Обновлено: 16 декабря 2025

Переменные в шаблоне SMS-сообщения — это элементы в тексте сообщения, вместо которых можно автоматически подставлять необходимые значения при отправке сообщения.

Например, имя, сумму, дату или номер заказа.

Требования к формату текста шаблона​

Формат текста шаблона должен соответствовать требованиям операторов:

  • не допускаются пустые шаблоны;
  • текст не должен содержать переносов строки и неразрывных пробелов;
  • переменные должны быть оформлены по следующим правилам:
    • выражение переменной должно быть отделено пробелом от предыдущего и последующег текста;
    • выражение начинается со знака процента;
    • тип переменной записывается строчной буквой w или d;
    • цифровые параметры переменной указываются в фигурных скобках и разделяются запятой, причем первый параметр всегда равен единице, а второй должен быть больше единицы;
    • между символами в выражении не должно быть пробелов.
warning

Несоблюдение правил приводит к ошибке Неверный формат шаблона.

Примеры правильной записи переменных​

%w %d %w+ %d+ %w{1,4} %d{1,2}

warning

Мегафон Теле2 МТС Переменная %w+ не поддерживается операторами Мегафон, Теле2 и МТС.

Возможные ошибки форматирования текста шаблонов​

  • Пустой шаблон.
  • Шаблон содержит перенос строки.
  • Шаблон содержит неразрывные пробелы.
  • Нет пробелов до и/или после переменной. Отделите переменную от текста пробелами.
  • Удалите пробел перед скобками в записи переменной.
  • Неверное обозначение переменной. Тип переменной записывается строчной буквой. Примеры правильной записи: %w, %d.
  • Неверное значение параметра последовательности. Первое значение всегда равно 1. Пример правильной записи: %w{1,3}.
  • Неверный разделитель параметров последовательности (значений в скобках). Используйте запятую. Пример правильной записи: %w{1,3}.
  • Последовательность с параметрами {1,1} недопустима в шаблонах данного оператора.