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

# Контакты, звонки и отчёты

> Состояния контактов адаптера и снятия, звонки в истории, обзор звонка, отчёты и что видно только в логах.

# Контакты, звонки и отчёты

## Контакты и снятия

Блок **«Контакты кампании»** на карточке кампании: поиск по номеру, по группе договора и третье поле **«Поиск по идентификатору контакта адаптера»** (точное совпадение). Клик по строке разворачивает её: сверху «Идентификатор контакта адаптера» и «Внешний идентификатор (foreign\_id)», ниже — переменные контакта. Ссылка из обзора звонка открывает карточку с уже заполненным полем поиска и развёрнутой строкой.

![Контакты кампании: поиск по идентификатору и развёрнутая строка](https://mintcdn.com/hubtalk/imXtUGq2OJsLMMCI/images/v4_adapter_campaign_contacts.png?fit=max\&auto=format\&n=imXtUGq2OJsLMMCI\&q=85\&s=223ba5a108d754111293398bf49d6863)

1. Поле «Поиск по идентификатору контакта адаптера»: только цифры, точное совпадение.
2. Состояние контакта и причина удержания: «Ожидает · Вне рабочих часов · Повтор не раньше: …».
3. Развёрнутая строка: идентификатор контакта адаптера и внешний идентификатор (`foreign_id`).
4. Переменные контакта: поля из карты скрипта и `rl_today`.

| Состояние | Что значит |
| - | - |
| Ожидает | Ждёт набора. Причина удержания — в строке: «Вне рабочих часов», «Достигнут частотный кап», «Повтор не раньше: …». |
| В наборе | Набирается или идёт разговор. `delete` в этот момент ставит отметку снятия: разговор доигрывается, новых попыток не будет. |
| Ожидает оценки | Правила повторов ждут результата анализа разговора. |
| Завершён / Попытки исчерпаны | Успех или исчерпаны попытки. «Попытки исчерпаны» с нулём попыток означает, что окно закрылось раньше, чем контакт набрали. |
| Исключён | «Снят по требованию клиента» — `delete` или `delete_phone_number`; «Запрос адаптера совместимости не принят» — откат неудавшегося запроса; прочие причины — реестр «Не звонить», частотная политика, дедупликация. |

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

## История и обзор звонка

![История, отфильтрованная по идентификатору контакта адаптера](https://mintcdn.com/hubtalk/imXtUGq2OJsLMMCI/images/v4_adapter_history_filtered.png?fit=max\&auto=format\&n=imXtUGq2OJsLMMCI\&q=85\&s=6395e6ae8cfa4038cc7c65c80f6c09f8)

Звонок контакта адаптера в Истории, отфильтрованной по ID контакта.

1. «Ещё фильтры» со счётчиком применённых фильтров.
2. Чип «Идентификатор контакта адаптера: …»; клик открывает панель фильтров на этом поле, крестик снимает фильтр.
3. Бейдж «Адаптер совместимости» под именем агента у звонков кампании адаптера.

![Панель «Ещё фильтры» с полем идентификатора](https://mintcdn.com/hubtalk/imXtUGq2OJsLMMCI/images/v4_adapter_history_more_filters.png?fit=max\&auto=format\&n=imXtUGq2OJsLMMCI\&q=85\&s=3115f029c9f9c9e256a2e7d87af54f09)

1. Поле «Идентификатор контакта адаптера» стоит последним: только цифры, точное совпадение; применяется кнопкой «Показать звонки». Тот же фильтр переносится в панель экспорта отчёта.

Панель звонка — вкладки **«Транскрипт»**, **«Обзор»**, **«Данные»**. Общее устройство — [Карточка звонка](https://docs.hubtalk.ai/ru/v4/platform/campaign-history/call-details).

* **Обзор** → секция «Адаптер совместимости»: учётная запись с системой, скрипт реестра, идентификатор контакта и ссылка «Открыть контакт в кампании» — она переключает организацию и открывает карточку кампании с развёрнутой строкой контакта.
* **Данные** → «Переменные, переданные агенту»: итоговый набор переменных звонка, включая `rl_today`, поля из карты и переменные платформы (`today`, `call_date`, `from_number`…). Здесь же «Webhook-доставки» с попытками и кнопкой повтора.
* **Транскрипт** → события функций до и после звонка, решение `call_decision`, инциденты наблюдателей.

![Панель звонка, вкладка «Обзор», секция «Адаптер совместимости»](https://mintcdn.com/hubtalk/imXtUGq2OJsLMMCI/images/v4_adapter_call_overview.png?fit=max\&auto=format\&n=imXtUGq2OJsLMMCI\&q=85\&s=8cd382ad71634e5f811b16b7a79c0d17)

1. Вкладки панели звонка: Транскрипт, Обзор, Данные.
2. Секция «Адаптер совместимости»: учётная запись, скрипт реестра, идентификатор контакта.
3. «Открыть контакт в кампании»: переключает организацию и открывает карточку с развёрнутой строкой контакта.
4. Бейдж в строке списка у звонков кампании адаптера.

## Отчёты и выгрузка за день

* В конструкторе отчётов по звонкам есть колонки **«Идентификатор контакта адаптера»** и **«Скрипт реестра»**. Фильтр «Идентификатор контакта адаптера» из истории переносится в панель экспорта и восстанавливается кнопкой «Изменить и выгрузить». См. [Отчёты](https://docs.hubtalk.ai/ru/v4/platform/campaign-history/reports.md).
* Операция [`details`](https://docs.hubtalk.ai/ru/v4/compat-adapter/details) клиента отдаёт выгрузку за день по шаблону из учётной записи: только звонки кампаний адаптера этой учётной записи, день — по поясу организации. Без шаблона клиент получает «The export template configuration is missing or invalid».

## Что видно только в логах

Каждый запрос клиента оставляет в журнале приложения одну итоговую строку, а причины отказов и откатов — отдельные предупреждения. В кабинете этого нет. Если разбор упирается в такую причину, попросите инженеров платформы посмотреть журнал по логину клиента и времени запроса. Что они там увидят:

| Сообщение в логах | Смысл |
| - | - |
| Итог запроса: операция, исход, число строк, длительность | Был ли запрос вообще и чем закончился: успех, отказ входа, лимит, ошибка данных, внутренний сбой. |
| `login refused … reason=…` | Причина отказа входа: неверный пароль, неизвестный логин, учётная запись отключена, лимит. |
| `end 21:30 cut to 21:00` | Конец кампании срезан до окна; клиент получил в ответе ключ `notice`. |
| `row 2 skipped, fields amount_due` | Строка отброшена по `flag_ignore_errors: skip`, названы поля без значений. |
| `request … rolled back: …` | Откат запроса с причиной: отказ создания кампании (например, неоднозначная привязка), блокер запуска (например, сигнатурная переменная без значения), отказ партии. |


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