> ## 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.

# Реестр совместимости

> Что такое реестр, как он связан с запросом клиента, вкладка реестров, скрипт и агент, привязка набора.

# Реестр совместимости

**Реестр совместимости** — список скриптов одной учётной записи адаптера. Каждый скрипт говорит:

* какой агент V4 отвечает на имя скрипта из запроса клиента;
* как разобрать поля строки запроса и какие из них стать переменными агента — см. [Поля и переменные](https://docs.hubtalk.ai/ru/v4/compat-adapter/registry-fields.md);
* по каким правилам перезванивать — см. [Правила повторов, сохранение и правка](https://docs.hubtalk.ai/ru/v4/compat-adapter/registry-rules.md);
* через какой транк набирать — см. [Привязка набора](#привязка-набора).

## Как реестр связан с запросом

Клиент V2 шлёт в адаптер запрос вида:

```json theme={null}
{
  "user": "user_turbopeso", "pass": "…",
  "type": "create", "cname": "morning", "start_hour": 10, "ending_hour": 20, "try": 2, "speed": 5,
  "data": [
    {"phone_number": "5215512345678", "type": "soft_script", "gender_voice": "female", "language": "es",
     "client_name": "Ana", "amount_due": "1200", "due_date": "15.10.2026"}
  ]
}
```

* Верхний `type` — операция: `create`, `delete`, `delete_phone_number`, `details`.
* `data[].type` — **имя скрипта**. По нему адаптер находит строку реестра у этой учётной записи, и только у неё. Сравнение с учётом регистра и ровно по символам.
* Общие поля строки для системы MX обязательны всегда и идут первыми: `phone_number` (11–13 цифр), `type`, `gender_voice` (`male`/`female`), `language` (`en`/`ru`/`es`). Дальше идут поля схемы скрипта в порядке реестра.
* Строка с незнакомым скриптом, со скриптом без агента, с архивным или неопубликованным агентом получает ошибку `{"line":"1", "fields":["type"]}`, и весь запрос отклоняется до любой записи.

Одна кампания создаётся на набор признаков «учётная запись, скрипт, `cname`, час и минута старта, день, попытки». Повторные запросы с теми же признаками в тот же день добавляют строки в ту же кампанию партиями.

## Вкладка «Реестры совместимости»

![Вкладка «Реестры совместимости»](https://mintcdn.com/hubtalk/9SxcddfCLJ4c6sdY/images/v4_adapter_registry_list.png?fit=max\&auto=format\&n=9SxcddfCLJ4c6sdY\&q=85\&s=4baba2fe92f5554bb8cb89a2287a20de)

1. Выбор учётной записи: «логин · система · организация».
2. Статус учётной записи.
3. **«Добавить скрипт»**. У архивной организации кнопка выключена.
4. Сводка: число скриптов и дефолты обзвона учётной записи.
5. Агент V4 со статусом: версия, «скрыт», «в архиве», «не опубликован», «нет агента».
6. Привязка набора: «Авто по агенту» или «транк · сабгруппа · номер».
7. Карандаш — изменить, корзина — удалить с подтверждением.

В списке скриптов выбранной учётной записи видны скрипт, агент V4, классификация, привязка набора, число полей и правила повторов.

Если учётных записей ещё нет, вкладка показывает «Сначала заведите учётную запись». Если у записи нет скриптов — подсказку «Имя нового скрипта пишется ровно как в поле `data[].type` запроса клиента» и кнопку «Добавить скрипт».

> [!WARNING]
>
> **Статус агента в столбце: блокер или нет?**
>
> * **«скрыт»** — нормально: скрытие управляет видимостью агента в кабинете, а не отключает его.
> * **«в архиве»**, **«не опубликован»**, **«нет агента»** — запросы клиента с этим скриптом получают ошибку по полю `type`. Направьте скрипт на действующего опубликованного агента.
>
> Пока учётная запись активна, её скрипты защищают своих агентов от архивации и удаления.

## Вкладка «Скрипт и агент»

Кнопка **«Добавить скрипт»** открывает окно «Новый скрипт реестра» с четырьмя вкладками: **«Скрипт и агент»**, **«Поля и переменные»**, **«Правила повторов»**, **«Маршрутизация»**. Внизу окна всегда видны сводка, текст отказа и кнопки.

![Новый скрипт реестра, вкладка «Скрипт и агент»](https://mintcdn.com/hubtalk/9SxcddfCLJ4c6sdY/images/v4_adapter_registry_script_new.png?fit=max\&auto=format\&n=9SxcddfCLJ4c6sdY\&q=85\&s=b4fc697d2682e15ea271a17cfa39681f)

1. Имя скрипта — ровно как в `data[].type`, регистр важен.
2. Агент V4 — только опубликованные агенты организации учётной записи.
3. Классификация — цель обзвона, обязательна.
4. Порог короткого разговора для отчёта V2; пусто — 15 секунд.
5. Привязка набора: «Авто по агенту» или «Явная».
6. Сводка: что получит агент, правила, привязка.
7. «Добавить скрипт» выключена, пока что-то не заполнено; подсказка называет, что именно.

**1. Имя скрипта**

Ровно как в поле `data[].type` запроса. Регистр важен: `Soft_Script` и `soft_script` — разные скрипты. До 100 символов. Пробелы по краям сохраняются как есть, и кабинет об этом предупредит: тогда запросы клиента обязаны приходить с теми же пробелами. Имя уникально внутри учётной записи.

**2. Агент V4**

Список открывается поверх окна. Сверху группа **«Похоже на имя скрипта»** — до пяти агентов, подобранных по имени, ниже — **«Все агенты организации»**. Подходят только опубликованные агенты организации учётной записи; скрытые тоже подходят. После выбора под полем появится: «Опубликованная версия vN. Карта переменных сверяется с ней; новая публикация агента скрипт не перепроверит».

**3. Классификация**

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

**4. Порог короткого разговора в отчёте, с**

От 1 до 300; пусто — 15, как в V2. Разговор короче порога выгрузка [`details`](https://docs.hubtalk.ai/ru/v4/compat-adapter/details) считает «hung up». На набор не влияет.

**5. Привязка набора**

См. [следующий раздел](#привязка-набора). Обычно достаточно «Авто по агенту», если у агента ровно одна сабгруппа в организации.

![Выбор агента](https://mintcdn.com/hubtalk/9SxcddfCLJ4c6sdY/images/v4_adapter_registry_agent_picker.png?fit=max\&auto=format\&n=9SxcddfCLJ4c6sdY\&q=85\&s=3a5c17043c4d7ab96146396f92ce0efb)

Список агентов открывается поверх окна: сверху «Похоже на имя скрипта», ниже все агенты организации. Строка списка — «имя · vN · скрыт».

## Привязка набора

Привязка определяет, через какой SIP-транк, какую сабгруппу и с какого номера идут звонки по кампаниям этого скрипта. Про транки и сабгруппы — [Телефония](https://docs.hubtalk.ai/ru/v4/platform/telephony.md).

* **«Авто по агенту»** — берётся единственная сабгруппа агента в организации. Кабинет сразу показывает, что получится:
  * «Ядро возьмёт единственную сабгруппу агента — …» — всё в порядке;
  * «У агента нет сабгрупп в организации учётной записи: ядро не сможет запустить кампанию»;
  * «Агент привязан к N сабгруппам … Задайте привязку явно».
* **«Явная»** — три поля: **SIP-транк**, **Сабгруппа** (только те, к которым привязан агент) и **Исходящий номер** («По политике сабгруппы» или конкретный номер из её пула). Смена транка сбрасывает сабгруппу и номер.

![Явная привязка набора](https://mintcdn.com/hubtalk/9SxcddfCLJ4c6sdY/images/v4_adapter_registry_binding.png?fit=max\&auto=format\&n=9SxcddfCLJ4c6sdY\&q=85\&s=4ef3393b79558a20741b92335dae446d)

1. Переключатель «Авто по агенту» / «Явная».
2. SIP-транк организации.
3. Сабгруппа — только привязанные к агенту.
4. Исходящий номер из пула сабгруппы или по её политике.
5. Сводка показывает вид привязки: «авто, однозначна», «авто, неоднозначна», «авто, сабгрупп нет», «явная, …».

> [!WARNING]
>
> **Неоднозначная привязка — самый частый отказ при первом запросе.** Если у агента несколько сабгрупп, а привязка «Авто по агенту», скрипт сохранится, но первый же `create` клиента получит «Internal error, try again later»: кампания создастся и тут же отменится. Смотрите на сводку внизу окна: «привязка: авто, неоднозначна» означает, что привязку надо задать явно.


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