Что показывает страница
Выберите дату, при необходимости сузьте до одного агента — и Агентика отрисует три блока изGET /api/v1/organizations/reports/daily:
Метрики
Распределение dispositions — чем закончились звонки за день, в штуках и процентах от общего числа запусков. Disposition берётся из поля
mapped_call_disposition каждого запуска. На графике показываются топ-5 dispositions, всё остальное схлопывается в один сегмент Other. Запуск, у которого вообще нет gathered context, учитывается в «Всего запусков», но не попадает в это распределение.
Распределение длительностей — запуски по продолжительности звонка:
Проценты здесь считаются от числа запусков с известной длительностью, а не от общего числа запусков. Поэтому в день, когда часть звонков не состоялась, база для процентов меньше.
Фильтр по агенту
Выпадающий список агентов наполняется изGET /api/v1/organizations/reports/workflows — там перечислены все агенты организации. Выбор агента добавляет к запросу workflow_id и ограничивает этим агентом все метрики и графики. Вариант «Все агенты» отправляет запрос без фильтра — по всей организации.
Семантика часового пояса
«День» — неочевидное понятие для системы, которая хранит всё в UTC, поэтому отчёт принимает IANA-часовой пояс вместе с датой:00:00:00–23:59:59.999999) в этом часовом поясе, переводит обе границы в UTC и выбирает запуски, начавшиеся внутри окна. Смените часовой пояс — и та же календарная дата покроет другой набор звонков: звонок в 01:00 по Москве в Europe/London относится уже к предыдущему дню.
Страница не спрашивает часовой пояс: она берёт настройку часового пояса организации (Настройки → Предпочтения, см. Организации). Если в организации она не задана, страница отчётов использует запасное значение America/New_York — поэтому задайте настройку, прежде чем доверять границам суток.
Дата должна быть в формате
YYYY-MM-DD, иначе запрос отклоняется с ошибкой 400 Invalid date format. Use YYYY-MM-DD. Календарь также не даёт выбрать будущие даты.Переход к запускам за день
Если за выбранный день есть запуски, появляется кнопка Скачать CSV. Она вызываетGET /api/v1/organizations/reports/daily/runs с теми же date, timezone и необязательным workflow_id и возвращает по строке на каждый запуск:
workflow_runs_<дата>_<агент>.csv) содержит номер телефона, disposition, длительность и прямую ссылку на каждый запуск — откройте его, чтобы прочитать transcript и послушать запись. Если нужны сырые строки, включая created_at, которого нет в CSV, обращайтесь к endpoint напрямую.