> ## 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.
# Дашборд
> Настраиваемые дашборды из каталога виджетов: что считается и за какой период.
# Дашборд
Раздел **Дашборд** — это операционная сводка по звонкам организации: сколько звонков было, сколько дошли до разговора, чем они закончились, что происходит прямо сейчас. Дашборд собирается из карточек, каждая карточка — это виджет из каталога со своими настройками.
## С чем вы столкнётесь сразу
У каждой организации есть дашборд **«Обзор»**, который платформа создаёт сама: 16 карточек, закрывающих обычный набор вопросов. Его не нужно собирать — он уже готов, и его можно править как любой свой: переименовать, переставить карточки, что-то убрать, что-то добавить.
* **Дашбордов может быть до 10** на организацию, имя уникально внутри организации.
* **Карточек — до 30** на дашборд.
* **Ровно один дашборд — основной**, он помечен звездой и открывается по умолчанию. Последний дашборд удалить нельзя: экрану нужно что-то показывать.
Дашборды — общие для организации: то, что вы создали или переименовали, видят все коллеги. Это не личная настройка.
## Период и фильтры
В шапке — период (**Сегодня**, **7 дней**, **30 дней** или свой), фильтр по агентам и фильтр по кампаниям. Все три:
* **не сохраняются в дашборде** — это ваш способ смотреть, а не свойство карточек. Коллега, открывший тот же дашборд, увидит свой период;
* **живут в адресе страницы** — ссылку с нужным периодом, агентами и кампаниями можно отправить коллеге;
* **действуют на все карточки сразу**. Своего периода у карточки нет.
Фильтр по кампаниям устроен так же, как фильтр по агентам: мультиселект с поиском по названию, список — те же кампании, что в Истории. Два фильтра складываются **по И**: агент + кампания дают звонки этого агента в этой кампании. Ссылка с карточки в Историю несёт кампанию, когда выбрана ровно одна.
Свой период — не длиннее **92 дней**. Даты считаются в часовом поясе организации (или в вашем, если вы его переопределили); пояс показан в подсказке к датам.
**Пресет пересчитывается на каждом обновлении.** Страница, открытая вечером и оставленная до утра, после полуночи покажет новые «7 дней», а не замороженное вчерашнее окно. Поэтому в адресе хранится `7d`, а не пара дат.
## Что считается звонком
Это главное, что стоит знать до того, как сверять цифры дашборда с чем-нибудь ещё.
* **Единица счёта — звонок, а не попытка набора.** Три набора одного контакта, из которых ответили на третий, — это три попытки кампании и один разговор. Попытки живут в карточке кампании, а не здесь.
* **Считаются только телефонные звонки в боевом режиме.** Условий два, и они независимы. **Канал — телефон:** чат, голосовой тест из кабинета, звонок с сайта и WhatsApp не считаются вовсе. **Режим — боевой:** не считается и настоящий телефонный звонок, сделанный в тестовом режиме. Ни в «Звонков», ни в «Звонков в эфире» такие разговоры не входят.
* **Единственное исключение — карточка «Кампании в работе»**: она смотрит на кампании и их попытки, потому что ровно за этим её и открывают.
**Не сверяйте «Звонков» на дашборде с числом строк в Истории напрямую.** История показывает все каналы и оба режима, дашборд — только боевую телефонию. Расхождение здесь не ошибка, а разные вопросы.
## Каталог виджетов
Кнопка **«Добавить карточку»** открывает каталог. Виджеты сгруппированы по тому, на какой вопрос отвечают. Внизу окна видно, сколько карточек на дашборде уже занято из тридцати.
У виджета в каталоге стоят значки допустимого: **замок** с подписью «только вх» или «только исх» — направление жёстко задано и в настройках не меняется; иконки рядом — какие типы графика виджет умеет.
### Сейчас
| Виджет | Что показывает |
| --------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| **Звонков в эфире** | Телефонные звонки, идущие прямо сейчас. |
| **Агентов в работе** | Сколько агентов сейчас держат хотя бы один звонок. |
| **Кампании в работе** | Таблица запущенных кампаний: контактов, пройдено, темп. В подписи — сколько кампаний на паузе и сколько запланировано. |
| **Недавние агенты** | Последние изменённые агенты и их версия. |
| **Недавние сессии** | Последние сессии с исходом и длительностью; строка ведёт в Историю. |
### Объём
| Виджет | Что показывает |
| -------------------------- | ---------------------------------------------------------------------------------------- |
| **Звонков** | Сколько звонков было за период. |
| **Дозвонились** | Сколько исходящих дошли до разговора, числом и долей. |
| **AI решил без оператора** | Доля входящих, закрытых без перевода на человека. |
| **Время разговора** | Суммарное время разговоров; в подписи — среднее на состоявшийся звонок. |
| **Цель достигнута** | Доля разговоров, где цель признана достигнутой, — от **оценённых**, а не от всех. |
| **Звонки по кампаниям** | Звонки за период по кампаниям: топ-5, хвост и отдельная строка для звонков вне кампаний. |
### Исход
| Виджет | Что показывает |
| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| **Итог набора** | Кольцо по исходящим: разговор, перевод, автоответчик, недозвон, ошибка. |
| **Итог обращения** | Кольцо по входящим: AI решил, перевод, сброс до ответа, ошибка. Автоответчика и недозвона у входящих не бывает — подпись об этом говорит. |
| **Почему не дозвонились** | Причины недозвона по частоте: топ-5 и «прочее». |
| **Тональность** | Три тональности по данным пост-аналитики; рядом — какую долю звонков аналитика вообще оценила. |
| **Поле аналитики** | Распределение значений вашего поля пост-аналитики — см. ниже. |
### Время
| Виджет | Что показывает |
| -------------------------- | ------------------------------------------------------------------- |
| **Длительность разговора** | Распределение по пяти диапазонам длительности; средняя — в подписи. |
| **Звонки по часам** | 24 колонки по часам суток в вашем поясе; пик — в подписи. |
| **Динамика по дням** | Линия: звонки и дозвон по дням, неделям или месяцам. |
### Агенты
| Виджет | Что показывает |
| ------------------- | ---------------------------------------------------------------------------------------------- |
| **Активные агенты** | Таблица агентов с активностью за период: в эфире, звонков, дозвон, средняя длительность, цель. |
У карточки настраиваются **направление** (исходящие, входящие или оба), **тип графика** (число, кольцо, полосы, колонки, линия, таблица) и **шаг** (день, неделя, месяц). Недопустимые сочетания в форме не выбираются, а не выбираются и дают прочерк: кольцо рисует только доли, складывающиеся в 100 %, а шаг «час» есть только у «Звонков по часам».
## Виджет «Поле аналитики»
Отдельно стоит карточка, показывающая распределение значений **вашего** поля пост-аналитики — того, что агент извлекает из разговора после звонка.
* **Одна карточка — один агент и одно поле.** Поля разных агентов с одинаковым именем не складываются: гарантии, что это одно и то же поле, нет.
* **Считаются поля со структурой**: списки значений и «да/нет» дают распределение (кольцо, полосы или таблица, топ-5 и «прочее»), числовые — среднее и число измерений. Свободный текст и списки в каталоге не предлагаются: распределение по свободному тексту — это не распределение.
* Клик по значению ведёт в Историю, суженную по этому агенту и этому значению.
Карточка настраивается в отдельном окне: слева параметры, справа — превью на живых данных за 7 дней. Недоступные значения задизейблены: пока не выбран агент, поле выбрать нельзя.
**Числа берутся из звонков, а описание поля — из агента.** Это разные источники, и путать их не стоит.
**Что считается** — значения, записанные на завершённых боевых звонках. Настройки агента их не меняют: категории строятся из того, что реально прозвучало, топ-5 и «прочее». Значение, которое вы убрали из списка у агента, из карточки не исчезнет — звонки с ним были.
**Что берётся из агента** — только объявление поля: есть ли оно у него сейчас и какого оно типа. Отсюда два следствия:
* **убрали поле у агента** — карточка скажет, что её настройки больше не поддерживаются. Причём сразу, даже если правку ещё не опубликовали и боевые звонки продолжают писать это поле;
* **сменили тип поля** (список значений ↔ число) — карточка переключится с распределения на среднее или обратно.
Это осознанный размен: читать для каждой карточки ту версию, которой шёл каждый звонок, значило бы поднимать историю версий на каждом пересчёте.
## Три состояния значения
Карточка никогда не показывает придуманное число. Различайте три вещи:
* **Число** — посчитано. Ноль здесь настоящий: ноль звонков в эфире и 0 % при известном ненулевом знаменателе — это значение, а не пустота.
* **Прочерк «—»** — посчитать точно нельзя, и подсказка называет причину: исторические данные ещё загружаются, свод пересчитывается, источник недоступен, почасовые данные не считаются в поясе с дробным смещением часа.
* **Пустое состояние с подписью** — считать нечего: наблюдений за период не было либо знаменатель нулевой (например, ни один звонок не был оценён на достижение цели).
Разница между прочерком и нулём принципиальна: неверное число хуже прочерка, и платформа скорее откажется отвечать, чем покажет ноль там, где на самом деле «не знаю».
**Сразу после включения дашборда часть карточек за прошлые периоды покажет прочерк «Исторические данные ещё загружаются».** Платформа пересчитывает историю звонков в фоне; карточки «сейчас» работают с первой минуты, периодные наполняются по мере счёта. Это разовое состояние после обновления, а не постоянное поведение.
## Сравнение с прошлым периодом
У числовых карточек под значением стоит сравнение — «к прошлым 7 дням» или «к прошлым 30 дням». Окно сдвигается ровно на столько же календарных дней назад и обрезается тем же временем суток: сравниваются «7 дней до сейчас» и «7 дней до этого же момента неделей раньше».
Для **«Сегодня»** и для своего периода сравнения нет. «К вчера до этого часа» — это другой вопрос, и смешивать его с первым значило бы подписывать одной строкой две разные величины.
## Раскладка
Кнопка **«Изменить раскладку»** включает режим правки: у карточек появляются ручки, их можно перетаскивать и менять размер за края и углы. Сетка — 12 колонок.
* **Пробелы сохраняются.** Платформа не уплотняет раскладку за вас: если вы оставили пустое место, оно останется. Сдвигаются только те соседи, на которых карточка реально наехала.
* **Правки копятся и уходят одним сохранением.** **«Отмена»** возвращает всё к сохранённому состоянию, уход со страницы с несохранёнными правками требует подтверждения.
* **С клавиатуры:** пробел или Enter начинает перемещение или изменение размера, стрелки двигают по шагам, Enter завершает, Escape отменяет текущее движение.
* **На узком экране** карточки выстраиваются в одну колонку в порядке чтения, а ручек нет. Сохранённая раскладка при этом не меняется — меняется только показ.
## Свежесть данных
Данные активной вкладки обновляются **каждые 30 секунд**; при возврате в окно или после восстановления связи — сразу. Фоновые вкладки не опрашивают сервер.
Если очередное обновление не удалось, карточки остаются с прежними значениями и явной пометкой, что это последние доступные данные. Живое значение не выдаётся за новое.
## Роли
* **Администратор** и **разработчик** правят дашборды полностью.
* **Участник** видит дашборды, переключает вкладки, крутит период и фильтр — но **не правит**: кнопок добавления, меню карточки и меню дашборда у него нет вовсе. Они не заблокированы, их нет, — см. [Роли и доступ](/ru/v4/platform/roles).