# Пользовательские поля

Пользовательские поля для заявок позволяют администраторам собирать дополнительную информацию о клиенте, которая фиксируется не в профиле, а непосредственно в заявке в момент её создания.

В отличие от полей направлений и валют, пользовательские поля:

* являются глобальными (применяются ко всем направлениям);
* фиксируются в заявке и не изменяются при последующих операциях;
* сохраняются в истории заявки и используются для обработки, проверки и аналитики.

Используйте пользовательские поля, чтобы запросить у клиентов:

* контактные данные (например, Telegram, WhatsApp, никнеймы);
* идентификаторы и служебные данные;
* дополнительные сведения, необходимые для выполнения заявки;
* любую информацию, которая относится к пользователю, но важна именно в контексте конкретной заявки.

Количество и тип пользовательских полей не ограничены.

В панели управления перейдите в раздел: **"Пользователи — Пользовательские поля".**

{% tabs %}
{% tab title="Настройка" %}

<figure><img src="/files/Jorg6CjEvGqhYhz8YEb6" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="На сайте" %}

<figure><img src="/files/FtPz3JL5IbkUdT4nnwcw" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="В карточке заявки" %}

<figure><img src="/files/Sa4H3EtPYyA1dBtz3GO4" alt="" width="563"><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

***

## Создание нового пользовательского поля

<figure><img src="/files/rxvccYhb09LLI2cImb84" alt="" width="563"><figcaption></figcaption></figure>

Нажмите кнопку **«Добавить поле»,** расположенную в правом верхнем углу.

В открывшемся окне заполните поле:

* **Название —** укажите название поля, которое будет отображаться клиентам.

  Можно вводить название сразу на нескольких языках, переключаясь между вкладками (например, RU / EN).

Нажмите кнопку **«Добавить»**, чтобы сохранить созданное поле.

После этого поле появится в общем списке пользовательских полей.

***

### Редактирование пользовательского поля

<figure><img src="/files/SwfU9pG6gt2JlkxwAswM" alt=""><figcaption></figcaption></figure>

1. Найдите нужное поле в списке.
2. Нажмите на его название, чтобы перейти в режим редактирования.

***

### Настройка пользовательского поля

<figure><img src="/files/LjzAIneWtozYzFnlyZhj" alt="" width="375"><figcaption></figcaption></figure>

В режиме редактирования доступны следующие параметры:

{% stepper %}
{% step %}

### Название поля

Название, которое будет отображаться клиенту в форме оформления заявки.

Поддерживает мультиязычность.
{% endstep %}

{% step %}

### ID ключа

Уникальный идентификатор поля, используемый системой.

{% hint style="info" %}

## Важно:

Пожалуйста, заполняйте поле ID ключа, строго следуя рекомендациям ниже. Корректно заданный ключ гарантирует правильную работу системы.
{% endhint %}

**Примеры корректных ключей:**

* telegram
* passport
* lastname
* firstname
* user\_email

**Общие рекомендации:**

* Используйте **только латинские буквы в нижнем регистре**, цифры и символ \_.
* Не используйте пробелы и специальные символы.
* Убедитесь, что ключ **уникален** и не повторяется в системе.
  {% endstep %}

{% step %}

### Мин. / Макс. количество символов

Позволяет задать ограничения на длину вводимого значения.

* Минимум — минимальное допустимое количество символов.
* Максимум — максимальное допустимое количество символов.

Если значения не указаны, ограничения не применяются.
{% endstep %}

{% step %}

### Обязательное поле

Если включено, клиент **обязан заполнить** данное поле при создании заявки.

Если выключено — поле становится необязательным.
{% endstep %}

{% step %}

### Удалять пробелы

Если включено, все пробелы в вводимом значении будут автоматически удалены перед сохранением данных.

**Полезно для:**

* идентификаторов;
* логинов;
* номеров аккаунтов.
  {% endstep %}

{% step %}

### Начинается с / Заканчивается на

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

**Например:**

* номер телефона должен начинаться с +;
* код должен заканчиваться определённой последовательностью символов.
  {% endstep %}

{% step %}

### Тип валидатора

Позволяет применить готовую проверку формата данных.

Доступные варианты (пример):

* ФИО (RU / EN);
* номер телефона;
* Telegram-никнейм;
* IBAN;
* и другие.

При ошибке валидации клиенту будет показано корректное сообщение с примером.
{% endstep %}

{% step %}

### Статус

Определяет, активно ли поле.

* **Включено —** поле отображается клиентам и участвует в проверках.
* **Выключено —** поле игнорируется системой и не отображается в форме заявки.
  {% endstep %}
  {% endstepper %}

***

### Как работают пользовательские поля в заявке

* Все пользовательские поля относятся к типу `user_order`.
* Значения этих полей фиксируются в момент создания заявки.
* Даже если пользователь изменит свои данные позже, в заявке останется сохранённый снимок данных.
* Пользовательские поля отображаются в деталях заявки отдельным блоком перед основной информацией о клиенте.

***

### Важно знать

* Пользовательские поля **не зависят от направления обмена.**
* Поля валидируются перед созданием заявки.
* Все значения сохраняются в системе как часть заявки и доступны для просмотра администраторам.
* Система полностью поддерживает расширение: в будущем можно добавить другие типы пользовательских полей без изменения текущей логики.


---

# 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://docs.iexexchanger.com/osnovnye/dop.-polya/polzovatelskie-polya.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.