> For the complete documentation index, see [llms.txt](https://docs.iexexchanger.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iexexchanger.com/guide/obmen/shablony-teksta.md).

# Шаблоны текста

аздел «Шаблоны текста» нужен для централизованного управления стандартными текстами, которые отображаются клиенту при обмене: в описании валюты, направлении обмена, процессе оплаты и на странице заявки.

Путь в панели управления: «Основное» — «Шаблоны текста»

Это не раздел e-mail или Telegram-уведомлений. Он отвечает именно за тексты, которые связаны с валютами, направлениями обмена и карточкой заявки клиента.

### Для чего нужны шаблоны текста

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

<table><thead><tr><th width="284.39453125">Задача</th><th>Что даёт</th></tr></thead><tbody><tr><td>Единые инструкции</td><td>Можно один раз создать общий текст оплаты</td></tr><tr><td>Быстрая настройка</td><td>Не нужно редактировать каждое направление отдельно</td></tr><tr><td>Гибкое применение</td><td>Можно применить шаблон ко всем или только к выбранным валютам/направлениям</td></tr><tr><td>Защита индивидуальных текстов</td><td>Можно подставлять шаблон только если свой текст пустой</td></tr><tr><td>Мультиязычность</td><td>Текст можно заполнить на разных языках</td></tr><tr><td>Удобное сопровождение</td><td>Проще обновлять инструкции и описания в одном месте</td></tr></tbody></table>

## Области шаблонов

В разделе есть две основные области:

<table><thead><tr><th width="212.87890625">Область</th><th>Для чего используется</th></tr></thead><tbody><tr><td>Валюта</td><td>Для текстов, связанных с конкретной валютой</td></tr><tr><td>Направление</td><td><p></p><p>Для текстов, связанных с конкретным направлением обмена</p></td></tr></tbody></table>

{% stepper %}
{% step %}

### Область «Валюта»

Шаблоны области «Валюта» применяются к текстам валют.

Например, можно создать общую инструкцию по оплате для банковских карт, криптовалют или наличных валют.

Доступные типы текста:

<table><thead><tr><th width="290.04296875">Тип текста</th><th>Где используется</th></tr></thead><tbody><tr><td>Инструкция по оплате</td><td>Показывается клиенту в процессе оплаты</td></tr><tr><td>Описание обмена</td><td>Используется в описании обмена по валюте</td></tr><tr><td>Дополнительный текст оплаты для «Отдаю»</td><td>Дополнительный текст для валюты, которую клиент отдаёт</td></tr><tr><td>Дополнительный текст оплаты для «Получаю»</td><td>Дополнительный текст для валюты, которую клиент получает</td></tr></tbody></table>
{% endstep %}

{% step %}

### Область «Направление»

Шаблоны области «Направление» применяются к конкретным направлениям обмена.

Например: Сбербанк RUB → USDT TRC20.

Доступные типы текста:

<table><thead><tr><th width="317.9140625">Тип текста</th><th>Где используется</th></tr></thead><tbody><tr><td>Инструкция по оплате</td><td>Показывается клиенту при оплате заявки</td></tr><tr><td>Описание обмена</td><td>Отображается в описании направления</td></tr><tr><td>Дополнительное описание обмена</td><td>Дополнительный информационный текст по направлению</td></tr><tr><td>Формальное описание перед вводом данных</td><td>Показывается клиенту перед заполнением формы</td></tr><tr><td>Дополнительный текст в процессе оплаты</td><td>Показывается на странице оплаты заявки</td></tr><tr><td>Текст для статуса «Заявка выполнена»</td><td>Показывается после успешного завершения заявки</td></tr><tr><td>Текст для статуса «Заявка отклонена»</td><td>Показывается при отклонении заявки</td></tr></tbody></table>
{% endstep %}
{% endstepper %}

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

Чтобы создать шаблон:

1. Откройте **«Основное» — «Шаблоны текста».**
2. Нажмите **«Добавить шаблон».**
3. Выберите область: валюта или направление.
4. Выберите тип текста.
5. Укажите правило применения.
6. Заполните текст шаблона.
7. При необходимости настройте ограничения применения.
8. Включите статус шаблона.
9. Сохраните изменения.

## Поля шаблона

<table><thead><tr><th width="254.203125">Поле</th><th>Описание</th></tr></thead><tbody><tr><td>Статус</td><td>Включает или отключает шаблон</td></tr><tr><td>Область</td><td>Определяет, к чему относится шаблон: валюта или направление</td></tr><tr><td>Тип текста</td><td>Определяет, какой именно текст заменяет или дополняет шаблон</td></tr><tr><td>Правило применения</td><td>Определяет, когда использовать шаблон</td></tr><tr><td>Текст шаблона</td><td>Основной текст, который увидит клиент</td></tr><tr><td>Ограничения применения</td><td>Указывает, где именно шаблон должен работать</td></tr><tr><td>Языки</td><td>Позволяют заполнить текст на разных языках</td></tr></tbody></table>

## Правила применения

Правило применения определяет, как система будет выбирать итоговый текст для клиента.

<table><thead><tr><th width="210.38671875">Правило</th><th>Как работает</th><th>Когда использовать</th></tr></thead><tbody><tr><td>Только текст сущности</td><td>Используется только текст из самой валюты или направления. Шаблон не подставляется</td><td>Если шаблон нужно сохранить, но временно не применять</td></tr><tr><td>Всегда шаблон</td><td>Клиенту всегда показывается текст шаблона</td><td>Если нужно принудительно использовать единый текст</td></tr><tr><td>Шаблон, если текст пустой</td><td>Сначала используется текст валюты/направления. Если он пустой — подставляется шаблон</td><td>Самый безопасный режим для общих инструкций</td></tr></tbody></table>

### Рекомендуемый режим

Для большинства случаев лучше использовать: **Шаблон, если текст пустой**

Так система не перезапишет индивидуальные тексты, которые уже заполнены внутри валюты или направления.

## Ограничения применения

Ограничения определяют, где именно будет работать шаблон.

Если ограничения не выбраны, шаблон считается глобальным и может применяться ко всем подходящим валютам или направлениям выбранного типа.

<table><thead><tr><th width="254.609375">Ограничение</th><th>Для какой области доступно</th></tr></thead><tbody><tr><td>Конкретные валюты</td><td>Валюта</td></tr><tr><td>Группы валют</td><td>Валюта</td></tr><tr><td>Конкретные направления</td><td>Направление</td></tr></tbody></table>

Если выбрано несколько ограничений, работает логика **ИЛИ**.

Например, шаблон применится, если подходит хотя бы одно условие:

<table><thead><tr><th width="321.203125">Условие</th><th>Результат</th></tr></thead><tbody><tr><td>Выбрана конкретная валюта</td><td>Шаблон подходит</td></tr><tr><td>Валюта входит в выбранную группу</td><td>Шаблон подходит</td></tr><tr><td>Выбрано конкретное направление</td><td>Шаблон подходит</td></tr></tbody></table>

{% hint style="info" %}

## Важное ограничение

В системе может быть только один шаблон для одной пары: **область + тип текста**

Например, нельзя создать два разных шаблона: **Валюта → Инструкция по оплате**

Если такой шаблон уже существует, нужно редактировать его, а не создавать новый. А уже внутри шаблона настраиваются ограничения: для каких валют, групп валют или направлений он будет работать.
{% endhint %}

## Где клиент видит эти тексты

{% stepper %}
{% step %}

### Карточка направления обмена

Когда клиент выбирает направление обмена, система может показать:

<table><thead><tr><th width="303.85546875">Текст</th><th>Откуда может браться</th></tr></thead><tbody><tr><td>Описание обмена</td><td>Из направления, валюты или шаблона</td></tr><tr><td>Дополнительное описание обмена</td><td>Из направления или шаблона</td></tr><tr><td>Формальное описание перед вводом данных</td><td>Из направления или шаблона</td></tr><tr><td>Описание валюты</td><td>Из валюты или шаблона</td></tr></tbody></table>
{% endstep %}

{% step %}

### Процесс оплаты заявки

После создания заявки клиент может видеть:

| Текст                                     | Для чего нужен                              |
| ----------------------------------------- | ------------------------------------------- |
| Инструкция по оплате                      | Объясняет, куда и как платить               |
| Дополнительный текст в процессе оплаты    | Даёт уточнения по оплате                    |
| Дополнительный текст оплаты для «Отдаю»   | Поясняет сторону, которую клиент отправляет |
| Дополнительный текст оплаты для «Получаю» | Поясняет сторону, которую клиент получает   |

Эти тексты особенно важны, потому что клиент по ним понимает, какие действия нужно выполнить для оплаты заявки.
{% endstep %}

{% step %}

### Страница заявки

После завершения или отклонения заявки система может показать отдельные тексты:

<table><thead><tr><th width="246.4765625">Статус заявки</th><th>Какой текст можно вывести</th></tr></thead><tbody><tr><td>Заявка выполнена</td><td>Текст для успешного завершения</td></tr><tr><td>Заявка отклонена</td><td>Текст для отклонённой заявки</td></tr></tbody></table>
{% endstep %}
{% endstepper %}

## Как система выбирает итоговый текст

Система выбирает текст по такой логике:

1. Проверяет, есть ли подходящий активный шаблон.
2. Проверяет область и тип текста.
3. Проверяет ограничения применения.
4. Проверяет правило применения.
5. Выбирает итоговый текст: из валюты, направления или шаблона.
6. Показывает готовый текст клиенту.

{% stepper %}
{% step %}

### Пример логики

| Ситуация                                                           | Что увидит клиент                           |
| ------------------------------------------------------------------ | ------------------------------------------- |
| В направлении есть свой текст, шаблон работает «если текст пустой» | Текст направления                           |
| В направлении текст пустой, есть подходящий шаблон                 | Текст шаблона                               |
| В направлении есть свой текст, но шаблон работает «всегда шаблон»  | Текст шаблона                               |
| Шаблон выключен                                                    | Индивидуальный текст валюты или направления |
| Нет шаблона и нет индивидуального текста                           | Текст не отображается                       |
| {% endstep %}                                                      |                                             |
| {% endstepper %}                                                   |                                             |

## Связь с валютами и направлениями

Внутри валют и направлений также есть собственные текстовые поля.

Раздел «Шаблоны текста» не удаляет эти поля и не заменяет их навсегда. Он работает вместе с ними.

<table><thead><tr><th width="240.16015625">Где заполнен текст</th><th>Как используется</th></tr></thead><tbody><tr><td>В валюте</td><td>Используется для текстов валюты</td></tr><tr><td>В направлении</td><td>Используется для текстов направления</td></tr><tr><td>В шаблоне</td><td>Используется по правилу применения</td></tr></tbody></table>

## Источник текста: направление или валюта

В настройках валюты и направления могут быть дополнительные переключатели, которые определяют, откуда брать текст.

Возможные варианты:

<table><thead><tr><th width="253.6171875">Вариант</th><th>Как работает</th></tr></thead><tbody><tr><td>Авто</td><td>Система сама выбирает подходящий текст</td></tr><tr><td>Только из направления</td><td>Используется текст направления</td></tr><tr><td>Только из валюты</td><td>Используется текст валюты</td></tr></tbody></table>

Важно: эти настройки управляют выбором между текстом валюты и направлением. А шаблон применяется отдельно по своему правилу.

## Теги в текстах

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

Пример текста:

```
Заявка №[public_id] создана [created_at].
Оплатите [income_amount] [income_code] по реквизитам: [account].
После проверки вы получите [outcome_amount] [outcome_code].
```

## Статус шаблона

<table><thead><tr><th width="207.78515625">Статус</th><th>Что означает</th></tr></thead><tbody><tr><td>Включён</td><td>Шаблон участвует в подборе текста</td></tr><tr><td>Выключен</td><td>Шаблон хранится в админке, но не используется на сайте</td></tr></tbody></table>

Если шаблон выключен, клиент его не увидит.

## Примеры использования

{% stepper %}
{% step %}

### Общая инструкция по оплате для всех валют

<table><thead><tr><th width="258.56640625">Поле</th><th>Значение</th></tr></thead><tbody><tr><td>Область</td><td>Валюта</td></tr><tr><td>Тип текста</td><td>Инструкция по оплате</td></tr><tr><td>Правило применения</td><td>Шаблон, если текст пустой</td></tr><tr><td>Ограничения</td><td>Не выбраны</td></tr><tr><td>Статус</td><td>Включён</td></tr></tbody></table>

Результат: если у валюты нет своей инструкции, клиент увидит общий шаблон.
{% endstep %}

{% step %}

### Инструкция только для криптовалют

<table><thead><tr><th width="248.6640625">Поле</th><th>Значение</th></tr></thead><tbody><tr><td>Область</td><td>Валюта</td></tr><tr><td>Тип текста</td><td>Инструкция по оплате</td></tr><tr><td>Правило применения</td><td>Шаблон, если текст пустой</td></tr><tr><td>Ограничение</td><td>Группа валют: Криптовалюты</td></tr></tbody></table>

Результат: шаблон будет применяться только к валютам из выбранной группы.
{% endstep %}

{% step %}

### Текст для отклонённой заявки

<table><thead><tr><th width="262.765625">Поле</th><th>Значение</th></tr></thead><tbody><tr><td>Область</td><td>Направление</td></tr><tr><td>Тип текста</td><td>Текст для статуса «Заявка отклонена»</td></tr><tr><td>Правило применения</td><td>Всегда шаблон</td></tr><tr><td>Ограничение</td><td>Конкретные направления</td></tr><tr><td>Статус</td><td>Включён</td></tr></tbody></table>

Результат: при отклонении заявки клиент увидит заданный текст.
{% endstep %}
{% endstepper %}

## Рекомендации

| Ситуация                                          | Рекомендация                                                   |
| ------------------------------------------------- | -------------------------------------------------------------- |
| Нужно общее описание для всех                     | Используйте глобальный шаблон                                  |
| Нужно сохранить индивидуальные тексты             | Выбирайте «Шаблон, если текст пустой»                          |
| Нужно принудительно заменить текст                | Выбирайте «Всегда шаблон»                                      |
| Нужно временно отключить шаблон                   | Отключите статус шаблона                                       |
| Нужно настроить разные тексты для крипты и банков | Используйте группы валют                                       |
| Нужно настроить текст для одного направления      | Используйте область «Направление» и ограничение по направлению |
| Проект мультиязычный                              | Заполняйте текст для каждого языка                             |

## Частые ошибки

| Ошибка                                            | Что сделать                                                                      |
| ------------------------------------------------- | -------------------------------------------------------------------------------- |
| Создаётся второй шаблон с той же областью и типом | Отредактировать существующий шаблон                                              |
| Шаблон не отображается клиенту                    | Проверить статус, правило применения и ограничения                               |
| Показывается текст направления, а не шаблон       | Возможно выбран режим «Шаблон, если текст пустой» и в направлении уже есть текст |
| Шаблон применяется слишком широко                 | Добавить ограничения по валютам, группам или направлениям                        |
| Теги не подставились                              | Проверить правильность написания тега                                            |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.iexexchanger.com/guide/obmen/shablony-teksta.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.