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

# Колонки отчёта

> Пресеты, транскрипт колонкой, конструктор колонок и колонки для переезжающих с прошлой версии.

# Колонки отчёта

## Пресеты колонок

При запросе отчёта выберите пресет колонок:

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

## Транскрипт колонкой

Пресет **«Полный»** несёт колонку с транскриптом целиком: весь диалог одной ячейкой, `Agent:` и `User:` в порядке реплик, с пометками прерванного и непроизнесённого. В XLSX ячейка идёт с переносами строк и фиксированной шириной колонки, чтобы файл оставался читаемым.

Транскрипт попадает в файл только тогда, когда колонку действительно выбрали: явный список колонок переопределяет пресет целиком, поэтому «Полный» с урезанным списком транскриптов не несёт.

## Конструктор колонок

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

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

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

#### Колонки для тех, кто переезжает с прошлой версии

В каталоге есть 19 колонок, которые нужны, чтобы файл выглядел так же, как на платформе, с которой вы переходите:

* **«Результат v2»** — пять колонок со статусом и результатом звонка в том виде и теми словами, в каких их писала прошлая версия.
* **«Кампания»** — колонки про кампанию, контакт и попытку: идентификатор и название кампании, номер контакта в том написании, в каком вы его загрузили, имя, внешний ключ, номер строки в файле, номер попытки и признаки последней и засчитанной попытки, плюс внутренние идентификаторы контакта и попытки.
* В группе **«Звонок»** — пол голоса и язык начала разговора, в **«Содержании»** — две формы транскрипта прошлой платформы и отдельная колонка с одной только речью абонента.

**Ни одна из них не входит в пресеты.** В отчёте, где вы не выбирали колонки явно, их не будет: эти источники читаются, только когда колонку попросили.

<Note>
  **Одна колонка сойдётся не полностью, и это не ошибка.** При сверке с боевыми данными три колонки из четырёх совпали со старой платформой на 100 %, четвёртая — на 69 %. Причина в самой старой платформе: там это значение после выгрузки переписывала стратегия дозвона. Полного совпадения по ней достичь нельзя, и лучше знать об этом до первой сверки файлов, а не после.
</Note>

Заголовки внутри файла по умолчанию — ключи колонок (`session_id`, `started_at`), а не читаемые подписи из интерфейса: на них завязаны разборщики на вашей стороне, и переименовать их по умолчанию значило бы молча сломать интеграции. Если читаемая шапка нужна, задайте её сами — см. [Подписи колонок](/ru/v4/platform/campaign-history/report-templates#подписи-колонок).

<img src="https://mintcdn.com/hubtalk/9ArMFeq_K4HZh-Td/images/v4_report_column_builder.png?fit=max&auto=format&n=9ArMFeq_K4HZh-Td&q=85&s=1ccf5ab68370944add88425ee3ffe5e0" alt="Конструктор колонок: слева каталог с группами и поиском, справа выбранные колонки по порядку" width="1200" height="1162" data-path="images/v4_report_column_builder.png" />

<Note>
  **Колонки выбираются каталогом, а не списком ключей через запятую.** Каталог показывает всё доступное, включая ваши кастомные поля пост-аналитики, и подставляет ключ сам. Если вы собираете отчёты через API, ключи колонок там те же.
</Note>
