# Как составить шаблон сообщения?

Обычно  текст сообщения состоит из статической и переменной части. Рассмотрим пример сообщения:

```
Ваш код авторизации для входа в личный кабинет: 1234
```

Код должен быть уникальным в каждом новом отправленном сообщении - это переменная часть сообщения. А остальной текст всегда один и тот же - это статическая часть

Для составления шаблона переменную часть нужно заменить операндой:

```
Ваш код авторизации для входа в личный кабинет: %d
```

#### Какими бывают операнды

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

| Операнда | Значение                                                                                                                                                                                                                                                                                                                                                                                                          | Пример шаблона                                                                                   | Пример сообщения                                                                                      |
| -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------- |
| %w       | <p>Любой непрерывный (без пробелов) набор  букв, цифр и спецсимволы\*<br>Используйте эту операнду, чтобы замаскировать одно слово или число</p>                                                                                                                                                                                                                                                                   | заказ %w на сумму %w руб успешно принят сумма к оплате %w                                        | заказ АВ123 на сумму 4000 руб успешно принят сумма к оплате 4000                                      |
| %d       | <p>Любой непрерывный (без пробелов) набор цифр и символов\*<br>Используйте эту оперануду, чтобы замаскировать число</p>                                                                                                                                                                                                                                                                                           | заказ %w на сумму %d руб успешно принят сумма к оплате %d                                        | заказ АВ123 на сумму 4000 руб успешно принят сумма к оплате 4000                                      |
| %w{1,n}  | <p>Ограниченная последовательность слов (состоящих из букв, цифр или спецсимволов\*), разделенных пробелом. </p><p>Вместо n нужно указать общее количество слов, </p><p>n – целое число, которое не может быть меньше двух и больше 10 (для транзакционных шаблонов) или больше 15 (для остальных шаблонов)</p><p><br>Используйте эту операнду, чтобы замаскировать два и более подряд идущих слова или числа</p> | заказ %w на сумму %w{1,2} успешно принят сумма к оплате %d                                       | Заказ АВ123 на сумму 4000 руб успешно принят Сумма к оплате 4000                                      |
| %d{1,n}  | <p>Ограниченная последовательность чисел (состоящих из цифр или спецсимволов\*), разделенных пробелом. Вместо n нужно указать общее количество слов, </p><p>n – целое число, которое не может быть меньше двух и больше 10 (для транзакционных шаблонов) или больше 15 (для остальных шаблонов)<br><br>Используйте эту операнду, чтобы замаскировать два и более подряд идущих слова или числа</p>                | заказ %w на сумму %w{1,2} успешно принят сумма к оплате %d. Свяжитесь с нами по телефону %d{1,2} | Заказ АВ123 на сумму 4000 руб успешно принят Сумма к оплате 4000. Свяжитесь с нами по телефону 123 15 |

\* допустимые спецсимволы: № . , : ; - \_ \` & ^ ? { } \[ ] < > / \ | ! @ # $ % ^ \* ( ) + = \~

#### Правила составления шаблонов

1. **НЕЛЬЗЯ** использовать несколько однотипных операнд подряд.&#x20;

Например: операнды %d %d следует заменить операндой %d{1,2}.&#x20;

Операнды %d %w{1,2} следует заменить операндой %w{1,3}.

2. **НЕЛЬЗЯ** использовать операнду %w+. Мы не рекомендуем использовать операнду %d+
3. Операнды вида %w{1,n} и %d{1,n} обязательно должны иметь открывающую и закрывающую скобки.
4. Для указания даты, телефона, пароля желательно использование операнды %d или %d{1,n}.
5. Шаблон должен без затруднений идентифицироваться с текстом конечного сообщения.
6. **НЕЛЬЗЯ** начинать и/или заканчивать смс пробелами, иначе сообщение автоматически учитывается как несоответствующее шаблону.
7. Шаблоны регистронезависимы (оплата=ОПЛАТА=Оплата и т.д.) и будут добавлены в систему в нижнем регистре и без спецсимволов. На применение шаблонов к текстам сообщений это не повлияет, т.к. проверка попадает текст под шаблон или нет производится без учета спецсимволов в тексте и в нижнем регистре.
8. Если для загружаемого шаблона в системе будет найдет точно такой же шаблон (на то же имя отправителя и того же оператора), то такой шаблон добавлен не будет.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://faq.docs.direct.i-dgtl.ru/rabota-s-rassylkami/rabota-s-imenami-otpravitelei-i-shablonami/kak-sostavit-shablon-soobsheniya.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
