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

# История и отчёты

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

# История и отчёты

На странице **«История»** собраны звонки и чаты всех агентов. Здесь можно просматривать разговоры, проверять их статусы и результаты, настраивать фильтры и скачивать отчёты.

Эта страница — про **поиск нужного разговора**. Что показывает карточка найденного звонка и как скачать выгрузку — на отдельных страницах, список внизу.

## Таблица истории

В таблице отображаются:

* **Агент** — агент, который вёл разговор. Под именем показана первая реплика абонента, чтобы строки различались с одного взгляда.
* **Канал** — откуда пришёл разговор; расшифровка значений — [ниже](#каналы-разговора).
* **Дата** — дата и время разговора.
* **Длительность** — длительность разговора. У недозвона она **пустая**: соединения не было. При переводе на живого оператора длительность считается до момента передачи клиента — разговор с оператором в неё не входит.
* **Ходы** — количество ходов диалога.
* **Статус** — чем закончился разговор: **«Состоялся»**, **«Недозвон»** или **«Сбой платформы»**, а у незавершённого — **«активна»**. Под статусом стоит причина завершения, например «Агент завершил (флоу пройден)».
* **Тональность** — оценка пост-аналитики: позитивная, нейтральная или негативная. Если аналитика не запускалась, так и написано — **«не запускалась»**.
* **Здоровье** — технический вердикт: **«ОК»**, **«Предупреждение»** или **«Ошибка»**.
* **Режим** — `live` для боевого разговора и `test` для теста из кабинета.

<img src="https://mintcdn.com/hubtalk/9ArMFeq_K4HZh-Td/images/v4_history_table.png?fit=max&auto=format&n=9ArMFeq_K4HZh-Td&q=85&s=c0baee3e440a7dbd35c3d85d9fe4a93a" alt="Таблица истории с фильтрами сверху" width="1440" height="900" data-path="images/v4_history_table.png" />

Нажмите на строку, чтобы открыть [детали разговора](/ru/v4/platform/campaign-history/call-details).

### Каналы разговора

Канал отвечает на вопрос «откуда пришёл этот разговор». Он стоит и в колонке таблицы, и в шапке карточки звонка, и в фильтре, и в выгрузке отчёта — значение везде одно и то же.

| Значение   | В кабинете | Откуда пришёл разговор                                                                                                                                                                                       |
| ---------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `phone`    | телефон    | Звонок по телефонной линии через SIP — входящий на ваш номер или исходящий из кампании. **Это боевой трафик.**                                                                                               |
| `web`      | web-звонок | Разговор из браузера посетителя: виджет на вашем сайте, [демо-ссылка](/ru/v4/platform/demo-links) или ваш собственный код на [браузерном SDK](/ru/v4/web-api). Микрофона хватает, телефонная линия не нужна. |
| `chat`     | чат        | Текстовый тест из кабинета — вкладка «Чат» в панели тестирования агента.                                                                                                                                     |
| `voice`    | голос      | Голосовой тест из кабинета — вы говорите с агентом через микрофон компьютера, не занимая телефонную линию.                                                                                                   |
| `whatsapp` | WhatsApp   | Переписка из WhatsApp.                                                                                                                                                                                       |

<Note>
  **Канал и режим — разные вопросы.** Канал говорит, по какой линии пришёл разговор, **«Режим»** — боевой он или тестовый. Тесты из кабинета (`chat` и `voice`) всегда идут в режиме `test`, а вот `phone` и `web` бывают обоими: тестовый звонок на свой же номер — это `phone` + `test`.

  Отсюда самое частое расхождение в цифрах: [дашборд](/ru/v4/platform/dashboard) считает только `phone` в режиме `live`, а История показывает все каналы и оба режима. Числа не сойдутся, и это не ошибка.
</Note>

## Фильтры

Фильтры стоят в шапке страницы, в этом порядке:

* **Поиск по тексту транскриптов** — ищет по словам, которые прозвучали в разговоре.
* **Все агенты** — выбор агента. В списке только живые агенты: удалённые и архивные из него убраны. Их звонки из истории не исчезли — они по-прежнему находятся прямым фильтром.
* **Все кампании** — сужает историю до одной кампании. Звонки разрешаются через журнал попыток кампании, поэтому звонок принадлежит той кампании, которая его действительно набрала.
* **Все каналы** — чат, голос, телефон, web-звонок или WhatsApp; что означает каждый, написано [выше](#каналы-разговора).
* **Все режимы** — **«Боевой»** или **«Тестовый»**.
* **Все направления** — входящий или исходящий.
* **номер…** — поиск по номеру телефона: номер целиком или его хвост (последние 10 цифр или с кодом страны), в любом формате. Лишние цифры перед номером его не найдут, поиск идёт не по подстроке. Одиннадцатизначный ввод через **8** и через **7** — одно и то же написание: номер, записанный с восьмёркой, находится и семёркой. Ввод короче 10 цифр не находит ничего, и под полем появляется подсказка **«Нужен целый номер — минимум 10 цифр»**. Тот же фильтр действует и на [отчёт](/ru/v4/platform/campaign-history/reports).
* **Статус: все** — «Состоялся», «Недозвон» или «Сбой платформы».
* **Причина: все** — причина завершения звонка: от «Агент завершил (флоу пройден)» и «Абонент положил трубку» до «Занято», «Автоответчик» и «Провайдер недоступен».
* **Любая тональность** — позитивная, нейтральная или негативная.
* **Аналитика: любая** — оставить только звонки с завершённой пост-аналитикой.
* **Любая успешность** — успешен звонок или нет, по оценке пост-аналитики.
* **Инциденты: неважно** — с инцидентами наблюдателя или без них.
* **Любая серьёзность** — низкая, средняя или высокая серьёзность инцидента.
* **Любой статус ревью** — открыт, просмотрен, решён или ложное срабатывание.
* **Здоровье: любое** — технический вердикт: ОК, предупреждение или ошибка.
* **код причины…** — фильтр по коду причины вердикта, например `rag_degraded`.
* **Трафик: весь** — **«Только нагрузочные»** или **«Только боевые»**. Это про нагрузочное тестирование платформы, а не про режим звонка: боевой и тестовый разделяет фильтр **«Все режимы»**.
* **поле=значение** — фильтр по извлечённому полю, например `appointment_booked=false`.
* **Выберите период** — период отображения.
* **Сбросить фильтры** — возвращает список в исходный вид; кнопка неактивна, пока ни один фильтр не задан.

Фильтры можно комбинировать, чтобы найти конкретный разговор кампании или группу звонков для анализа. Фильтры кампании и инцидентов сужают **одну и ту же** выборку и пересекаются: выбранная кампания вместе с **«С инцидентами»** даёт инциденты этой кампании, а она же с **«Без инцидентов»** — остальные её звонки.

<Note>
  **Фильтры живут в адресе страницы.** Ссылку на найденную выборку можно отправить коллеге — он увидит тот же список, а не пустую Историю.
</Note>

## Что дальше

<CardGroup cols={2}>
  <Card title="Детали звонка" icon="waveform-lines" href="/ru/v4/platform/campaign-history/call-details">
    Транскрипт и события, задержки хода диалога, пост-аналитика, технический вердикт, код оператора, запись разговора и вебхук-доставки.
  </Card>

  <Card title="Отчёты: как скачать" icon="file-arrow-down" href="/ru/v4/platform/campaign-history/reports">
    Что попадает в файл, за какой период он выгружается и как устроена очередь сборки.
  </Card>

  <Card title="Отчёт по обзвону" icon="bullhorn" href="/ru/v4/platform/campaign-history/campaign-report">
    Выгрузка в границах одной кампании, поле «Обзвон» и готовые формы для перехода с прошлой версии.
  </Card>

  <Card title="Колонки отчёта" icon="table-columns" href="/ru/v4/platform/campaign-history/report-columns">
    Пресеты, транскрипт колонкой, конструктор колонок и колонки для тех, кто переезжает.
  </Card>

  <Card title="Шаблон отчёта" icon="file-pen" href="/ru/v4/platform/campaign-history/report-templates">
    Подписи колонок, замена значений, служебные колонки, структура и язык файла.
  </Card>
</CardGroup>
