> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hubtalk.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Учётные записи адаптера

> Заведение и изменение учётной записи адаптера: логин, пароль, организация, дефолты обзвона, отключение и отказы при сохранении.

# Учётные записи адаптера

**Учётная запись адаптера** — это логин и пароль, которыми клиент V2 входит в адаптер. Она привязана к организации V4 и хранит дефолты обзвона, которые подставляются в кампанию, когда запрос клиента не передал параметр.

> [!NOTE]
>
> **Что нужно знать до начала**
>
> * Логин и пароль учётной записи действуют только в адаптере. В кабинет и в Web API они не пускают, а токен кабинета и ключ Web API не открывают адаптер.
> * Пароль лежит в хранилище паролей адаптера и больше нигде не записан: сгенерированный пароль показывается один раз.
> * Организация учётной записи — источник агентов, шаблонов отчёта и привязок набора для всех её скриптов. Пока у учётной записи нет скриптов, организацию можно сменить, потом нельзя.

## Кто видит раздел и где он

Раздел **«Адаптер совместимости»** находится в меню кабинета в группе **«Администрирование»**, после пункта «Пакет рынка». Его видит только **администратор корневой организации**. У разработчика корневой организации и у пользователей клиентских организаций этого пункта нет.

В разделе две вкладки: **«Учётные записи»** и **«Реестры совместимости»**. Выбранная вкладка, учётная запись и фильтры сохраняются в адресе страницы, поэтому ссылку можно отправить коллеге.

![Вкладка «Учётные записи»](https://mintcdn.com/hubtalk/imXtUGq2OJsLMMCI/images/v4_adapter_accounts_list.png?fit=max\&auto=format\&n=imXtUGq2OJsLMMCI\&q=85\&s=63e40e517e45333241d824ee0f9fd2d2)

1. Вкладки раздела: «Учётные записи» и «Реестры совместимости».
2. **«Завести учётную запись»**.
3. Фильтры списка: система, организация, «Показать отключённые», «Сбросить фильтры».
4. Статус: «Активна» или «Отключена с …».
5. Действия строки: «Реестр», карандаш «Изменить», кнопка питания «Отключить» или «Активировать». Рядом — кнопка «Кампании».

В списке видны логин, система, организация, статус и кто завёл запись.

> [!WARNING]
>
> **Плашка «Хранилище паролей адаптера недоступно».** Если она висит над вкладками, на этом контуре хранилище паролей адаптера не настроено или не отвечает. Пока так, нельзя заводить учётные записи, менять пароль и логин, отключать и активировать. Остальные поля учётных записей и реестры работают. Кнопка **«Проверить снова»** перечитывает состояние; ответ может обновиться с задержкой до минуты. Если плашка не уходит, обратитесь к инженерам платформы.

## Заведение учётной записи

Перед заведением узнайте у клиента его логин V2 **ровно так, как он пишет его в запросах**, и решите с бизнесом, оставляете ли прежний пароль V2 или выдаёте новый. Перенести прежний пароль из V2 автоматически нельзя — его надо ввести вручную.

**1. Откройте раздел и нажмите «Завести учётную запись»**

Кнопка в правом верхнем углу. Пока в разделе пусто, она стоит внутри пустой карточки списка.

**2. Выберите систему**

**V2 · MX** или **V2 · KZ**. От системы зависят общие поля запроса и уникальность логина: один и тот же логин может существовать и в MX, и в KZ. После сохранения система не меняется.

**3. Введите логин**

Ровно как в запросах клиента: это поле `user` в теле запроса. Регистр не важен — `User_Freedom` и `user_freedom` — один логин. Пробелы запрещены, длина до 150 символов.

**4. Задайте пароль или нажмите «Сгенерировать»**

Ручной пароль: не пустой, не из одних пробелов, до 255 символов; подходит любой прежний пароль клиента. Сгенерированный пароль покажется один раз после сохранения. Пока выбрана генерация, поле показывает «Сгенерируется при сохранении»; вернуться к ручному вводу можно ссылкой «Ввести вручную».

**5. Выберите организацию V4**

Дерево организаций с поиском. Из организации берутся агенты для скриптов, шаблоны отчёта и привязки набора. Архивную организацию выбрать нельзя.

**6. Заполните блок «Для ядра адаптера»**

* **Отображаемое имя** — имя клиента в V2, до 255 символов. Справочное поле, агенту не передаётся.
* **Ответ на create** — форма ответа клиенту: «Список идентификаторов» (`{"type":"success","data":[100000001,…]}`) или «Пары batch\_id и foreign\_id» (`[{"batch_id":100000001,"foreign_id":"…"}]`). Выбирайте ту, которую разбирает код клиента.
* **Шаблон выгрузки** — шаблон отчёта организации, по которому строится ответ на `details`. Без шаблона `details` возвращает отказ. Для общей формы V2 есть системный шаблон `sys-api-v2`, для формы moneyman — `sys-api-moneyman`.
* **Номер из «не звонить»** — что делать со строкой, номер которой есть в реестре «Не звонить» организации: «Пропускать номер, как в V2» (строка получает идентификатор, но контакт не создаётся) или «Отклонять весь запрос» (клиент получает ошибку по полю `phone_number`).

**7. Проверьте дефолты обзвона**

Они подставляются в кампанию, когда запрос не передал параметр:

| Поле | Значение |
| - | - |
| Попыток | 1–30, но не больше предела организации |
| Скорость | Ступени организации, по умолчанию 20 в минуту |
| Режим авто-скорости | По умолчанию выключен. Включён — каждая новая кампания аккаунта создаётся с [авто-скоростью](https://docs.hubtalk.ai/ru/v4/platform/campaign-launch.md#авто-скорость): скорость пересчитывается каждые 10 минут из оставшихся контактов, ожидаемых перезвонов и оставшихся часов окна, не выше 200 в минуту. Скорость выше и `speed` из запроса остаются запасными. Уже созданные кампании не меняются. |
| Интервал между попытками | По умолчанию 15 минут |
| Окно обзвона | По умолчанию 08:00–21:00 |
| Час старта | По умолчанию 09:00, внутри окна |
| Повторная загрузка | «Не проверять», «Пропускать номер, уже загруженный сегодня» или «Пропускать номер с тем же foreign\_id, загруженный сегодня» |

Окно обязано укладываться в окно обзвона организации, иначе сохранение отклонится.

**8. Нажмите «Завести»**

Учётная запись создаётся вместе с паролем в хранилище. Если хранилище отказало, записи не будет, а причина появится внизу окна.

![Окно «Новая учётная запись адаптера»](https://mintcdn.com/hubtalk/imXtUGq2OJsLMMCI/images/v4_adapter_account_create.png?fit=max\&auto=format\&n=imXtUGq2OJsLMMCI\&q=85\&s=605dc50ec7394a68234188d35b0c45cd)

Слева — вход и организация, справа — настройки для ядра адаптера и дефолты обзвона.

1. Система: V2 · MX или V2 · KZ. После сохранения не меняется.
2. Логин ровно как в запросах клиента, без пробелов, до 150 символов.
3. Пароль вручную или «Сгенерировать»: сгенерированный покажется один раз.
4. Организация V4: источник агентов, шаблонов и привязок.
5. Отображаемое имя клиента в V2, справочно.
6. Форма ответа на `create`: список идентификаторов или пары `batch_id`/`foreign_id`.
7. Шаблон выгрузки для операции `details`.
8. Что делать с номером из реестра «Не звонить».
9. Дефолты обзвона: попытки, скорость, интервал.
10. Окно обзвона: часы, которые может прислать запрос.
11. Повторная загрузка: проверка номеров, загруженных сегодня.
12. **«Завести»**.

### Что проверить сразу после заведения

* Передайте клиенту логин, пароль и адрес адаптера. Самый дешёвый способ проверить вход — запрос `{"user":"…","pass":"…","type":"delete","data":[1]}`: адаптер отвечает эхом `{"type":"deleted", "data": [1]}` и ничего не снимает.
* Заведите [реестр](https://docs.hubtalk.ai/ru/v4/compat-adapter/registry.md): без скриптов любой `create` клиента получит ошибку по полю `type`. Кнопка **«Открыть реестр»** есть прямо в окне с показанным паролем.

## Пароль: показ один раз и смена

Если пароль генерировался, после «Завести» откроется окно **«Учётная запись заведена»** с паролем и кнопкой «Копировать». Скопируйте пароль сразу: он показывается один раз и больше нигде не хранится. Потеряли — задайте новый в окне изменения учётной записи.

![Поле пароля после выбора генерации](https://mintcdn.com/hubtalk/imXtUGq2OJsLMMCI/images/v4_adapter_account_password_generate.png?fit=max\&auto=format\&n=imXtUGq2OJsLMMCI\&q=85\&s=9c65bc6a52f871ca7e3a52db644a3f5a)

1. После «Сгенерировать» поле показывает «Сгенерируется при сохранении». Ссылка «Ввести вручную» возвращает ручной ввод.

Смена пароля — из окна изменения: кнопка **«Задать новый пароль»** рядом с пометкой «задан». Откроется небольшое окно **«Новый пароль для \<логин>»** с тем же полем пароля и кнопкой «Сгенерировать»; «Сохранить пароль» применяет его.

![Окно нового пароля](https://mintcdn.com/hubtalk/imXtUGq2OJsLMMCI/images/v4_adapter_account_new_password.png?fit=max\&auto=format\&n=imXtUGq2OJsLMMCI\&q=85\&s=85bc5edd987dc0f913ab1dc8516b38ae)

> [!WARNING]
>
> **Прежний пароль перестаёт работать в течение минуты.** После смены пароля прежний может приниматься ещё до минуты — так устроено хранилище паролей. Через минуту работает только новый.

## Изменение учётной записи

Карандаш в строке списка открывает окно **«Учётная запись \<логин>»**. В заголовке — система, внутренний номер записи и кто её завёл.

![Окно изменения учётной записи](https://mintcdn.com/hubtalk/imXtUGq2OJsLMMCI/images/v4_adapter_account_edit.png?fit=max\&auto=format\&n=imXtUGq2OJsLMMCI\&q=85\&s=ab0c55483ee24f664ff3cee24f996732)

1. Система не меняется.
2. Логин можно сменить.
3. Пароль: «задан» и кнопка «Задать новый пароль».
4. Организация заблокирована, пока у учётной записи есть скрипты.
5. Отображаемое имя, ответ на `create`, шаблон выгрузки, режим «не звонить» меняются в любой момент.
6. Окно обзвона с подсказкой «окно организации …»: шире него задать нельзя.
7. «Отключить учётную запись».
8. «Сохранить».

| Поле | Что меняется для клиента |
| - | - |
| Логин | Клиент должен присылать новый логин в поле `user`. |
| Организация | Меняется только у учётной записи без скриптов. При переносе заново проверяются окно обзвона и шаблон выгрузки в новой организации. |
| Ответ на create | Со следующего запроса клиент получает другую форму ответа. Согласуйте с клиентом заранее. |
| Шаблон выгрузки | Влияет только на `details`. Можно задать позже. |
| Номер из «не звонить» | Действует со следующего `create`. |
| Дефолты обзвона | Действуют на следующие кампании. Уже созданные не меняются. |

## Отключение и активация

Кнопка питания в строке списка или кнопка **«Отключить учётную запись»** в окне изменения открывает подтверждение. **Удалить учётную запись нельзя**: отключение — единственный способ закрыть клиенту вход.

![Подтверждение отключения](https://mintcdn.com/hubtalk/imXtUGq2OJsLMMCI/images/v4_adapter_account_disable.png?fit=max\&auto=format\&n=imXtUGq2OJsLMMCI\&q=85\&s=5564e838a42e5ceb14731ebda77ed6b3)

* **Отключение.** Клиент сразу получает на любой запрос `{"type":"error", "data":"Authentication failed"}`. Скрипты реестра остаются, но перестают защищать своих агентов от архивации и удаления.
* **Активация.** Вход возвращается в течение минуты. Скрипты снова защищают своих агентов.
* Отключённая запись видна в списке, если включён фильтр **«Показать отключённые»**: строка затемнена, в статусе «Отключена с …». На вкладке реестров у неё висит плашка «Учётная запись отключена».

## Отказы при сохранении

Ошибки проверки в самом окне только подсвечивают поле. Отказы сервера показываются текстом внизу окна.

| Текст отказа | Причина и что сделать |
| - | - |
| Неизвестная система старой платформы | Выберите систему из списка. |
| Логин не должен быть пустым, не должен содержать пробелов… | Уберите пробелы, сократите до 150 символов. |
| Этот логин уже занят в выбранной системе старой платформы | Логины сравниваются без учёта регистра. Включите «Показать отключённые»: возможно, запись уже есть и её надо активировать, а не заводить новую. |
| Пароль не должен быть пустым… | Введите пароль или выберите генерацию. |
| Организация не найдена или находится в архиве | Выберите действующую организацию. |
| У учётной записи есть скрипты реестра (N)… | Удалите скрипты реестра и перенесите запись или заведите новую учётную запись в нужной организации. |
| Шаблон отчёта не найден в организации учётной записи | Шаблон выбран из другой организации или удалён. Выберите заново. |
| Параметр обзвона … вне допустимых пределов | Попытки — от 1 до предела организации; скорость — из ступеней организации; интервал больше нуля, если попыток больше одной; начало окна раньше конца; час старта внутри окна. |
| Окно обзвона … шире допустимого окна … (источник: …) | Окно учётной записи выходит за окно организации. Сузьте его: за пределами окна организации звонков всё равно не будет. |
| Keycloak отклонил операцию с учётной записью | Временная ошибка. Повторите через минуту; если повторяется — обратитесь к инженерам платформы. |
| Хранилище паролей адаптера совместимости в Keycloak недоступно… | См. плашку [выше](#кто-видит-раздел-и-где-он). |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.