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

> Что делает адаптер совместимости, кому нужна эта инструкция и как она устроена.

# Адаптер совместимости V2 → V4

**Адаптер совместимости** принимает запросы клиентов старой платформы V2 в их прежней форме и превращает их в кампании V4. Клиент не меняет ни тела запросов, ни разбор ответов: он шлёт всё тот же JSON по своему прежнему адресу, а звонит уже текущая платформа.

> [!NOTE]
>
> **Для кого эта инструкция.** Для клиентов V2, которые продолжают слать API-запросы в форме V2, для их интеграторов и для сотрудников платформы, которые заводят таких клиентов и следят за их кампаниями: администраторов корневой организации и разработчиков агентов.

> [!WARNING]
>
> **Адаптер всегда отвечает HTTP 200** с телом в форме V2 — в том числе на отказы и внутренние сбои: интеграции V2 ломаются на любом другом статусе. Об успехе или ошибке говорит только поле `type` в теле ответа. Тексты ответов в этой инструкции совпадают с текстами инсталляции V2 `v2-mx` байт в байт; тексты, которых в V2 не было, помечены «добавлено платформой».

## Как это работает

Клиент V2 продолжает слать запросы по своему прежнему адресу, а платформа направляет их в адаптер. Клиент входит логином и паролем V2, которые заведены как **учётная запись адаптера**.

* Запрос `create` проходит те же проверки, что в V2, и становится кампанией в организации учётной записи. Один набор признаков «учётная запись, скрипт, имя, час старта, день, попытки» даёт одну кампанию в день; следующие запросы с теми же признаками добавляют в неё партии звонков.
* `delete` и `delete_phone_number` снимают контакты с обзвона.
* `details` отдаёт выгрузку звонков за день по шаблону отчёта.
* Поля строки запроса становятся переменными агента по карте из **реестра совместимости**.

```
система клиента  --запрос в форме V2-->  адаптер
                                           |  вход, лимиты
                                           |  проверки V2: ключи, значения, часы
                                           |  реестр: скрипт -> агент, поля -> переменные
                                           v
                                         кампания V4
                                           |
система клиента  <--ответ в форме V2, всегда HTTP 200--
```

## Что настраивается до первого запроса

Перед первым запросом клиента администратор платформы заводит:

* **учётную запись адаптера** — логин и пароль клиента из V2, организацию V4, в которой будут жить его кампании, и дефолты обзвона на случай, когда запрос не передал параметр. Как её завести — [Учётные записи адаптера](https://docs.hubtalk.ai/ru/v4/compat-adapter/accounts.md);
* **реестр совместимости** — по одной строке на каждое имя скрипта, которое клиент шлёт в `data[].type`: какой агент звонит, какие поля несёт строка запроса и как они попадают к агенту. Как его собрать — [Реестр совместимости](https://docs.hubtalk.ai/ru/v4/compat-adapter/registry.md).

Логин и пароль адаптера действуют **только для запросов адаптера**. Они не пускают в кабинет и не открывают публичный [Web API](https://docs.hubtalk.ai/ru/v4/web-api.md); ключ Web API и вход в кабинет, в свою очередь, не открывают адаптер.

## Термины

| Термин | Значение |
| - | - |
| Адаптер совместимости | Вход, который принимает запросы V2 в их исходной форме. |
| Учётная запись адаптера | Логин и пароль клиента V2 плюс организация V4 и дефолты обзвона. Действует только для запросов адаптера. |
| Система | Инсталляция старой платформы: **V2 · MX** или **V2 · KZ**. Первая волна клиентов — MX. |
| Реестр совместимости | Скрипты учётной записи: имя скрипта V2 → агент V4, схема полей строки запроса, карта переменных, правила повторов, привязка набора. |
| Скрипт | Строка реестра. Имя скрипта — это поле `type` в строке `data[]` запроса клиента. |
| Кампания адаптера совместимости | Обычная кампания V4, созданная запросом клиента. В кабинете помечена источником «адаптер совместимости». |
| Идентификатор контакта адаптера | Девятизначное число от 100 000 000, которое клиент получает в ответ на `create` и передаёт в `delete`. |
| Выгрузка за день | Операция `details`: звонки одного дня по шаблону выгрузки учётной записи. |
| Хранилище паролей адаптера | Отдельное защищённое хранилище, где лежат пароли учётных записей адаптера. В базе кабинета пароли не хранятся. |

## Пометка «в логах»

Иногда причина отказа видна только в журнале приложения, а не в кабинете. В инструкции такие места помечены словами **«в логах»**. Журнал читают инженеры платформы: если нужен такой разбор, передайте им логин клиента, операцию и время запроса. Всё, что можно увидеть в кабинете, описано через кабинет. Что именно пишется в журнал — в разделе [Что видно только в логах](https://docs.hubtalk.ai/ru/v4/compat-adapter/monitoring-calls.md#что-видно-только-в-логах).

## Разделы

> [card] [API для клиента V2](https://docs.hubtalk.ai/ru/v4/compat-adapter/request.md)
>
> Адрес, тело запроса, вход и лимиты, операции `create`, `delete`, `details`, отличия от V2.

> [card] [Настройка](https://docs.hubtalk.ai/ru/v4/compat-adapter/accounts.md)
>
> Учётные записи адаптера и реестр совместимости: заведение, поля и переменные, правила повторов.

> [card] [Мониторинг](https://docs.hubtalk.ai/ru/v4/compat-adapter/monitoring.md)
>
> Как найти кампанию адаптера, контакты, снятия, звонки и выгрузки.

> [card] [FAQ](https://docs.hubtalk.ai/ru/v4/compat-adapter/faq-variables.md)
>
> Что идёт не так: переменные, пустая очередь, часы, вебхуки, вход.


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