Отчеты об истории автосекретаря и очереди вызовов
Важно!
Клиентам GCC High и DoD необходимо использовать отчеты об истории автосекретаря и очереди вызовов для GCC High и DoD.
Этот шаблон Power BI предоставляет три отчета, которые позволяют организациям сообщать о количестве вызовов, обработанных автосекретарями и очередями вызовов. Он также предоставляет аналитические сведения о производительности агента.
Версия 3.1.8 опубликована 12 августа 2024 г.
Шаблон Power BI "Автосекретарь Teams & очереди вызовов" предоставляет следующие три отчета:
- В отчете автосекретаря отображается аналитика вызовов, поступающих в автосекретаря.
- В отчете Очередь вызовов отображается аналитика звонков, поступающих в очереди звонков.
- В отчете Временная шкала агента отображается временная шкала представление агентов, активных в вызовах очереди вызовов.
В этих отчетах используются данные из службы "Сборщик аналитики голосовых приложений" (VAAC).
Предварительные требования для V3.x.x
Power BI Desktop
Необходимо установить Power BI Desktop. Вы можете установить и использовать бесплатную версию из Microsoft Store.
Важно!
Power BI Desktop обновляется и выпускается ежемесячно, включая отзывы клиентов и новые функции. Поддерживается только последняя версия Power BI Desktop. Клиентам, которые обращаются в службу поддержки по Power BI Desktop, будет предложено обновиться до последней версии. Последнюю версию Power BI Desktop можно получить из Магазина Windows или в виде одного исполняемого файла со всеми поддерживаемыми языками, скачиваемыми и устанавливаемыми на компьютере.
Служба Power BI
Эти отчеты можно опубликовать в служба Power BI.
После публикации отчета:
- Перейдите к параметрам набора данных.
- Разверните раздел Учетные данные источника данных .
- Выберите Изменить учетные данные.
- Задайте для метода проверки подлинности значение
OAuth2
. - Убедитесь, что пропустить тестовое подключение включено.
- Выберите Войти и укажите свои учетные данные.
По завершении вы сможете настроить запланированное обновление набора данных.
Разрешения доступа
Используйте один из следующих методов для управления доступом к историческим отчетам:
Политика голосовых приложений
Чтобы управлять тем, о каких автосекретарях, очередях звонков и агентах пользователи могут сообщать, не предоставляя им доступ к Центру администрирования Teams, создайте политику голосовых приложений, которая предоставляет им доступ к историческим отчетам и назначает их в качестве авторизованного пользователя соответствующим автосекретарям и очередям звонков. Как администратор вы можете создать политику голосовых приложений в Центре администрирования группы или с помощью PowerShell.
Дополнительные сведения о создании политики голосовых приложений см. в статье Управление политиками голосовых приложений в Microsoft Teams.
Кончик
Рекомендуется использовать политику голосовых приложений для управления доступом. С помощью политики голосовых приложений и авторизованных пользователей можно управлять автосекретарями, очередями вызовов и агентами, о которых пользователь может сообщать. При необходимости политика по-прежнему позволяет пользователю сообщать обо всех автосекретарях, очередях вызовов и агентах без предоставления доступа к Центру администрирования Teams.
Конвейер панели мониторинга качества вызовов (CQD) [устаревшая версия]
Если вы хотите, чтобы пользователь сообщал обо всех автосекретарях, очередях вызовов и агентах в клиенте и предоставить пользователю доступ к Центру администрирования Teams для запуска других отчетов об использовании, назначьте пользователю роль доступа CQD с полями "Просмотр отчетов" и "Просмотр EUII " для параметра "Да".
Дополнительные сведения см. в разделе Роль доступа CQD.
Примечание.
Если пользователю назначена роль доступа CQD и политика голосовых приложений, роль CQD будет выполняться заранее, и пользователь увидит все автосекретари, очереди вызовов и агенты в клиенте.
Установка классической версии 3.x.x
В следующих шагах предполагается, что клиент Power BI Desktop установлен на компьютере и что у вашей учетной записи есть необходимые разрешения для доступа к конвейеру данных CQD.
Выполните следующие действия.
Скачайте и сохраните файл журналов отчетов об очереди вызовов & Teams V3.1.8.zip на компьютере.
Откройте ZIP-файл.
Teams Auto Attendant & Call Queue Historical Reports V3.1.8.pbit
Откройте файл шаблона. Power BI Desktop должно запуститься.Выберите Источник данных, Уровень отчета и Смещение в формате UTC.
-
DataSource: выберите
api.interfaces.records.teams.microsoft.com
запись. -
Уровень отчета:
- Выберите
Per Call
(по умолчанию), чтобы получить все отдельные записи вызовов. - Выберите
Per Day
, чтобы получить агрегированный итог за каждый день.
- Выберите
-
Смещение UTC. Выберите смещение в формате UTC, представляющее часовой пояс, в который представлены отчеты. Допустимо только в том случае, если для уровня отчета задано значение
Per Call
За день и за звонок
Отчет о каждом вызове получает отдельные записи звонков для каждого автосекретаря, очереди вызовов и агента, для которого авторизован пользователь, и делает их доступными в клиенте Power BI. Отчеты по каждому вызову также позволяют отображать записи звонков в локальном часовом поясе, выбранном пользователем. Для некоторых клиентов, особенно тех, кто использует роль доступа CQD для управления доступом, отчеты за звонок могут привести к превышению ограничения по умолчанию 90 000 или 200 000 на запись запроса. В этом случае следует выбрать параметр отчетов за день.
Отчет за день получает одну ежедневную сводную запись для каждого автосекретаря, очереди вызовов и агента. Это приводит к уменьшению количества записей, возвращаемых клиенту, что снижает вероятность достижения ограничения по умолчанию 90 000 или 200 000 на запись запроса. Отчеты за день основаны только на utc-00:00 день (00:00:00-23:59:59 UTC), а любое смещение UTC, предоставленное пользователем, игнорируется.
-
DataSource: выберите
Войдите с помощью учетной записи Teams.
- Выберите Файл, Параметры и параметры, а затем Параметры источника данных.
- Выберите Изменить разрешения, а затем — Изменить.
- Выберите Учетная запись организации, а затем — Войти.
- Нажмите кнопку Сохранить, затем ОК и Закрыть.
Выберите Обновить на панели ленты и обновления данных.
Задержка данных для автосекретаря и аналитики очереди вызовов
Данные обычно доступны в течение 30 минут после завершения вызова, но бывают случаи, когда их появление может занять несколько часов.
Чтобы просмотреть новые данные, необходимо обновить отчет.
Отчеты об истории автосекретаря и очереди вызовов
Отчет аналитики облачного автосекретаря
Толкование отчета
Выноска | Название | Описание |
---|---|---|
1 | Дата | Дата начала и окончания отчета. Используйте этот ползунок, чтобы выбрать диапазон дат для отчета. См. сведения об известных проблемах |
2 | Диапазон времени | Начальный и конечный часы отчета. Отчет охватывает все даты и время от начальной даты или часа начала до даты окончания или часа окончания. Используйте этот ползунок, чтобы выбрать диапазон времени для отчета. |
3 | Учетные записи ресурсов автосекретаря | Учетные записи ресурсов, о которые необходимо сообщить. Чтобы просмотреть вызовы для определенного автосекретаря, выберите все учетные записи ресурсов, назначенные данному автосекретарю. Если полное имя учетной записи ресурса равно aa_test@microsoft.com, то это значение равно : aa_test По умолчанию: Все |
4 | Быстрая статистика —> входящие звонки | В разбивке показано общее количество вызовов, полученных между начальной датой или часом начала и датой окончания или часом окончания. СОВЕТ. Наведите указатель мыши на любую метрику в этом разделе, чтобы отобразить подсказку с отдельными вызовами, составляющими итог. |
5a | Быстрая статистика —> статистика использования | В разбивке отображается средняя продолжительность вызова в автосекретаре и среднее количество действий вызывающего абонента. |
5b | Количество действий вызывающего объекта | Разбивка по количеству действий вызывающего объекта (нажатия клавиш, голосовых команд) |
6 | Быстрая статистика —> метод поиска в каталоге | В разбивке показано, как вызывающими абонентами использовался параметр "Поиск по каталогу". Этот раздел отчета пуст, если автосекретарь не настроен для этой службы или если вызывающие не используют его. Определения условных обозначений метода поиска каталогов:
|
7 | Результаты вызова | Разбивка показывает обработку звонка, полученную вызывающими. Определения условных обозначений результатов вызова:
СОВЕТ. Наведите указатель мыши на любую метрику в этом разделе, чтобы отобразить подсказку с отдельными вызовами, составляющими итог. |
8 | В разбивке показаны пути вызывающего абонента через автосекретарь и конечный результат вызова. Определения столбцов:
СОВЕТ. Наведите указатель мыши на любую метрику в этом разделе, чтобы отобразить подсказку с отдельными вызовами, составляющими итог. |
Известные проблемы
- Сообщается только о вызовах и действиях вызывающего в первом автосекретаре, который отвечает на вызов. Вызовы и действия вызывающего абонента в связанных автосекретарях (когда один автосекретарь передает другому автосекретарю) не сообщаются.
- Отображается имя учетной записи ресурса автосекретаря вместо имени автосекретаря. Чтобы отобразить весь трафик для автосекретаря, необходимо выбрать все учетные записи ресурсов, назначенные автосекретарю.
- Журнал звонков доступен только за 28 дней. Данные автосекретаря считаются персональными данными и регулируются политиками хранения конфиденциальности данных.
- Селектор даты иногда отображает даты за пределами диапазона доступных данных, что приводит к пустому отчету. Измените даты на последние 28 дней, чтобы устранить проблему.
Отчет аналитики очереди вызовов в облаке
Толкование отчета
Выноска | Название | Описание |
---|---|---|
1 | Дата | Дата начала и окончания отчета. Используйте этот ползунок, чтобы выбрать диапазон дат для отчета. См. сведения об известных проблемах |
2 | Диапазон времени | Начальный и конечный часы отчета. Отчет охватывает все даты и время от начальной даты или часа начала до даты окончания или часа окончания. Используйте этот ползунок, чтобы выбрать диапазон времени для отчета. |
3 | Учетные записи ресурсов очереди вызовов | Учетные записи ресурсов, о которые необходимо сообщить. Чтобы просмотреть вызовы для определенной очереди звонков, выберите все учетные записи ресурсов, назначенные этой очереди звонков. Если полное имя учетной записи ресурса равно cq_test@microsoft.com, то это значение равно : cq_test По умолчанию: Все |
4 | Быстрая статистика —> входящие звонки | В разбивке показано общее количество вызовов, полученных между начальной датой или часом начала и датой окончания или часом окончания. СОВЕТ. Наведите указатель мыши на любую метрику в этом разделе, чтобы отобразить подсказку с отдельными вызовами, составляющими итог. |
5 | Быстрая статистика —> среднее время ожидания (в секундах) | В разбивке отображается средняя продолжительность звонка в очереди вызовов до того, как абоненту будет дан ответ или он откажется. |
6 | Результаты вызова | Разбивка показывает обработку звонка, полученную вызывающими. Определения условных обозначений результатов вызова:
СОВЕТ. Наведите указатель мыши на любую метрику в этом разделе, чтобы отобразить подсказку с отдельными вызовами, составляющими итог. |
7 | Количество вызовов, количество отмененных вызовов, количество согласия агента | В разбивке показано количество вызовов, полученных и отмененных в час, а также максимальное число агентов, которые были зарегистрированы в очереди звонков в это время. |
8 | Средняя продолжительность сеанса (в секундах) | Разбивка показывает, как долго ожидались вызовы перед каждым результатом вызова.
|
9 | Назначение "Переполнение вызовов", "Время ожидания", "Нет агентов" | В разбивке показано, куда были отправлены вызовы, получившие обработку исключений "Переполнение вызовов", "Время ожидания вызова" или "Нет агентов".
|
Известные проблемы
- Сообщается только о вызовах и действиях вызывающего абонента в первой очереди вызовов, которая отвечает на вызов. Вызовы в связанных очередях вызовов (когда одна очередь звонков передается в другую очередь вызовов) не сообщаются.
- Отображается имя учетной записи ресурса очереди вызовов вместо имени очереди вызовов. Чтобы отобразить весь трафик для очереди звонков, необходимо выбрать все учетные записи ресурсов, назначенные очереди звонков.
- Журнал звонков доступен только за 28 дней. Данные очереди звонков считаются персональными данными и регулируются политиками конфиденциальности данных.
- Селектор даты иногда отображает даты за пределами диапазона доступных данных, что приводит к пустому отчету. Измените даты на последние 28 дней, чтобы устранить проблему.
Отчет о временной шкале агента очереди вызовов в облаке
Толкование отчета
Выноска | Название | Описание |
---|---|---|
1 | Дата | Дата начала и окончания отчета. Используйте этот ползунок, чтобы выбрать диапазон дат для отчета. См. сведения об известных проблемах |
2 | Имя пользователя агента | Агенты, о которые нужно сообщить. Если полное имя пользователя равно user@microsoft.com, то это значение равно: user По умолчанию: Все |
3 | Учетные записи ресурсов очереди вызовов | Учетные записи ресурсов, о которые необходимо сообщить. Чтобы просмотреть вызовы для определенной очереди звонков, выберите все учетные записи ресурсов, назначенные этой очереди звонков. По умолчанию: Все |
4 | Быстрая статистика —> входящие звонки | В разбивке показано общее количество ответов на вызовы, среднее количество вызовов, ответов на каждый агент и средняя продолжительность обработаемых вызовов. СОВЕТ. Наведите указатель мыши на любую метрику в этом разделе, чтобы отобразить подсказку с отдельными вызовами, составляющими итог. |
5 | Вызовы с ответом (по дате) | В разбивке показано количество вызовов с ответами агента по дате |
6 | В разбивке показано, сколько вызовов каждый агент в очереди ответил, и средняя продолжительность вызова для этих вызовов. | |
7 | Ответы на вызовы (по часам) | В разбивке по часам отображается количество вызовов с ответами на запросы агента |
8 | В разбивке показано количество вызовов, на которые отвечает агент, по очереди вызовов. Определения столбцов:
|
Известные проблемы
- Журнал звонков доступен только за 28 дней. Очередь звонков и данные агента считаются персональными данными и регулируются политиками конфиденциальности данных.
- Отображается имя учетной записи ресурса очереди вызовов вместо имени очереди вызовов. Чтобы отобразить весь трафик для очереди звонков, необходимо выбрать все учетные записи ресурсов, назначенные очереди звонков.
- Отображается имя участника-пользователя агента вместо имени пользователя.
- Селектор даты иногда отображает даты за пределами диапазона доступных данных, что приводит к пустому отчету. Измените даты на последние 28 дней, чтобы устранить проблему.
- В некоторых сценариях количество вызовов, от которых отвечает агент, может отличаться от количества вызовов, отображаемого в журнале вызовов клиента Teams. Журнал вызовов клиента Teams является правильным. Поддержка изучается, но в настоящее время не существует предполагаемого времени на восстановление.
- Когда агент отвечает на вызов в другой очереди вызовов из-за перенаправления через обработку исключений переполнения вызовов, вызов учитывается в исходной очереди вызовов, в которой возникло исключение, а не в той, в которой он ответил на вызов.
- Обратные вызовы, обрабатываемые агентами, не регистрируются, что приводит к расхождению между количеством вызовов, на которые ответили в отчете очереди вызовов, и отчете о временной шкале агента.
- Подсказка агента, показывающая отдельные вызовы агента, показывает все вызовы, а не только вызовы в выбранном диапазоне дат.
Автосекретарь и определения полей журналов очереди вызовов
Описание поля таблицы fAutoAttendant
Имя | Тип данных | Описание |
---|---|---|
Имя AA | СМС | Имя учетной записи ресурса, присоединенной к автосекретарю Если полное имя учетной записи ресурса равно aa_test@microsoft.com, то это значение равно : aa_test |
AA Start Date Local | Дата | Дата начала вызова автосекретаря — локальная (на основе выбранного смещения в формате UTC) |
Час начала AA | Целое число | Час начала вызова автосекретаря — локальный (на основе выбранного смещения в формате UTC) |
Локальное время начала AA | Дата и время | Время начала вызова автосекретаря — local (на основе выбранного смещения UTC) |
Время начала AA в формате UTC | Дата и время | Время начала вызова автосекретаря — UTC |
AACallerActionCount | Целое число | Суммирование: Сумма Количество действий, выбранных вызывающим в автосекретаре во время вызова |
AACallerActionCountAverage (Measure) | Целое число | Среднее значение AACallerActionCount — ноль вместо пустого |
AACallFlow | СМС | См. статью Измерения автосекретаря —> AutoAttendantCallFlow |
AACallResult | СМС | См. статью Измерения автосекретаря —> AutoAttendantCallResult |
AACallResultLegend | СМС | Элементы условных обозначений для AACallResult. Возможные значения
|
AAChainDuration | Десятичное число | Суммирование: Сумма Длительность вызова в автосекретаре |
AAChainDurationAverage (Measure) | Десятичное число | Среднее значение AAChainDuration — ноль вместо пустого |
AAChainIndex | Целое число | |
AAConnectivityType | СМС | См. общие измерения —> PSTNConnectivityType. |
AACount | Целое число | Итог: Sum Количество автосекретарей, участвующих в вызове |
AADirectorySearchMethod | СМС | См. раздел Измерения автосекретаря —> AutoAttendantDirectorySearchMethod |
AADirectorySearchMethodCountDTMF (Measure) | Целое число | Число вызовов, которые использовали DTMF для поиска в каталоге , — ноль, а не пустой |
AADirectorySearchMethodCountVoice (Measure) | Целое число | Количество вызовов, которые использовали голосовую связь для поиска в каталоге, — ноль, а не пустой |
AADirectorySearchMethodLegend | СМС | Элементы условных обозначений для AADirectorySearchMethod. Возможные значения
|
AATransferAction | СМС | См . статью Измерения автосекретаря —> AutoAttendantTransferAction |
Длительность звонка в секундах | Целое число | Длительность звонка |
Локальное время окончания звонка | Дата и время | Время окончания вызова — локальный (на основе выбранного смещения в формате UTC) |
Время окончания звонка в формате UTC | Дата и время | Время окончания вызова — UTC |
Локальное время начала звонка | Дата и время | Время начала вызова — локальный (на основе выбранного смещения в формате UTC) |
Время начала звонка в формате UTC | Дата и время | Время начала звонка — UTC |
ConferenceID (только в день) | СМС | Используется для устранения неполадок — укажите эти сведения при открытии билета. |
DialogID (только в день) | СМС | Используется для устранения неполадок — укажите эти сведения при открытии билета. |
DocumentID (только в день) | СМС | Используется для устранения неполадок — укажите эти сведения при открытии билета. |
ММ-ДД | СМС | Вызов автосекретаря месяц-день |
PSTNMinutes | Целое число | Суммирование: Сумма Общее использование минут |
TotalCallCount | Целое число | Суммирование: Сумма Всегда 1 — используется для предоставления суммы всех вызовов |
TotalCallCountSum (Measure) | Целое число | Сумма totalCallCount |
Отчет аналитики очереди вызовов в облаке
Описание поля таблицы fCallQueueAnalytics
Имя | Тип данных | Описание |
---|---|---|
Число вызовов | Целое число | Суммирование: Сумма Число звонков |
Число вызовов отменено | Целое число | Суммирование: Сумма Количество отмененных вызовов |
Сумма количества вызовов (мера) | Целое число | Сумма счетчика вызовов — ноль, а не пустая |
Отброшенная сумма счетчика вызовов (мера) | Целое число | Число вызовов отменено — ноль вместо пустого |
Длительность звонка в секундах | Целое число | Суммирование: Сумма Длительность звонка |
Avg длительность звонка в секундах (мера) | Пока число | Средняя длительность звонка в секундах |
Локальное время окончания звонка | Дата и время | Время окончания вызова — локальный (на основе выбранного смещения в формате UTC) |
Время окончания звонка в формате UTC | Дата и время | Время окончания вызова — UTC |
Число агентов очереди вызовов | Целое число | Суммирование: Сумма Количество агентов, настроенных в очереди вызовов |
Количество согласия агента очереди вызовов | Целое число | Суммирование: Сумма Количество агентов, согласились на очередь вызовов |
Результат вызова очереди вызовов | СМС | См. статью Измерения очереди вызовов —> CallQueueCallResult |
Условные обозначения результата вызова очереди вызовов | СМС | Элементы условных обозначений для результата очереди вызовов. Возможные значения
|
Тип целевого объекта очереди вызовов | СМС | См. статью Измерения очереди вызовов —> CallQueueTargetType |
Условные обозначения целевого типа очереди вызовов | СМС | Элементы условных обозначений для типа целевого объекта очереди вызовов. Возможные значения
|
Локальное время начала звонка | Дата и время | Время начала вызова — локальный (на основе выбранного смещения в формате UTC) |
Время начала звонка в формате UTC | Дата и время | Время начала звонка — UTC |
ConferenceID (только для каждого звонка) | СМС | Используется для устранения неполадок — укажите эти сведения при открытии билета. |
Имя CQ | СМС | Имя учетной записи ресурса, присоединенной к очереди вызовов Если полное имя учетной записи ресурса равно cq_test@microsoft.com, то это значение равно : cq_test |
CQHour | Целое число | Час начала вызова очереди звонков |
Дата | Дата и время | Дата и время начала вызова очереди вызовов (час) |
DateTimeCQName | СМС | Уникальный ключ для фильтрации в fCallQueueFinalStateAction |
DialogID (только для каждого вызова) | СМС | Используется для устранения неполадок — укажите эти сведения при открытии билета. |
DocumentID (только для каждого вызова) | СМС | Используется для устранения неполадок — укажите эти сведения при открытии билета. |
Тип подключения ТСОП | СМС | См. общие измерения —> PSTNConnectivityType. |
Общее количество минут ТСОП | Целое число | Суммирование: Сумма Общее использование минут для вызовов ТСОП |
Описание поля таблицы fCallQueueFinalStateAction
Имя | Тип данных | Описание |
---|---|---|
Средняя длительность вызова (в секундах) | Десятичное число | Суммирование: Сумма Средняя длительность вызова в секундах для отмененных вызовов |
Средняя продолжительность вызова (секунды) Средняя (мера) | Целое число | Среднее значение средней продолжительности звонка (в секундах) — ноль вместо пустого |
Средняя длительность очереди звонков (с) | Десятичное число | Суммирование: Сумма Среднее время ожидания в секундах для ответов на звонки |
Средняя длительность очереди звонков (с) (мера) | Целое число | Среднее значение средней продолжительности очереди звонков (с) — ноль вместо пустого |
Число вызовов | Целое число | Суммирование: Сумма Число звонков |
Результат вызова очереди вызовов | СМС | См. статью Измерения очереди вызовов —> CallQueueCallResult |
Условные обозначения результата вызова очереди вызовов | СМС | Элементы условных обозначений для результата вызова очереди вызовов. Возможные значения
|
Действие конечного состояния очереди вызовов | СМС | См . статью Измерения очереди вызовов —> CallQueueFinalStateAction |
Имя CQ | СМС | Имя учетной записи ресурса, присоединенной к очереди вызовов Если полное имя учетной записи ресурса равно cq_test@microsoft.com, то это значение равно : cq_test |
CQHour | Число | Час, в который состоялся звонок |
Дата | Дата и время | Дата и время начала вызова очереди вызовов (час) |
DateTimeCQName | СМС | Уникальный ключ для фильтрации в fCallQueueFinalStateAction |
IsAbandoned | Значение true/false | Значение true, если вызывающий объект зависает, прежде чем агент ответит |
Локальная дата | Дата и время | Локальная дата и время (на основе выбранного смещения в формате UTC) |
Дата UTC | Дата и время | Дата и время в формате UTC |
Отчет о временной шкале агента очереди вызовов в облаке
Описание поля таблицы fAgentTimelineAnalytics
Имя | Тип данных | Описание |
---|---|---|
Имя агента | СМС | Имя участника-пользователя Если полное имя пользователя равно user@microsoft.com, то это значение равно: user |
AgentTimelineAnalyticsSummaryLink | СМС | Используется для связывания с fAgentTimelineAnalyticsSummary для всплывающей подсказки |
Длительность вызова (ЧЧ:ММ:СС) | СМС | Длительность вызова (в минутах), преобразованная в ЧЧ:ММ:СС |
Длительность звонка (в минутах) | Целое число | Суммирование: Сумма Общая продолжительность вызовов очереди вызовов с ответами в минутах |
Длительность вызова (в секунду) | Целое число | Суммирование: Сумма Общая продолжительность вызовов очереди вызовов с ответами в секундах |
Локальное время окончания звонка | Дата и время | Время окончания вызова — локальный (на основе выбранного смещения в формате UTC) |
Время окончания звонка в формате UTC | Дата и время | Время окончания вызова — UTC |
Локальное время начала звонка | Дата и время | Время начала вызова — локальный (на основе выбранного смещения в формате UTC) |
Время начала звонка в формате UTC | Дата и время | Время начала звонка — UTC |
ConferenceID | СМС | Используется для устранения неполадок — укажите эти сведения при открытии билета. |
Имя CQ | СМС | Имя учетной записи ресурса, присоединенной к очереди вызовов Если полное имя учетной записи ресурса равно cq_test@microsoft.com, то это значение равно : cq_test |
DateTime | DateTime | Дата звонка |
DialogID | СМС | Используется для устранения неполадок — укажите эти сведения при открытии билета. |
DocumentID | СМС | Используется для устранения неполадок — укажите эти сведения при открытии билета. |
Hour (Measure) | Целое число | Час звонка |
Общее число вызовов | Целое число | Суммирование: Сумма Количество вызовов, представленных агенту |
Описание поля таблицы fAgentTimelineAnalytics
Имя | Тип данных | Описание |
---|---|---|
Имя агента | СМС | Имя участника-пользователя Если полное имя пользователя равно user@microsoft.com, то это значение равно: user |
AgentTimelineAnalyticsLink | СМС | Используется для связывания с fAgentTimelineAnalytics для всплывающих подсказок |
Средняя длительность вызова (в секундах) | Десятичное число | Суммирование: Сумма Средняя продолжительность вызовов очереди вызовов с ответами в секундах |
Средняя продолжительность вызова (в секундах) — ноль вместо пустой (мера) | Целое число | Средняя длительность вызова (в секундах) — ноль вместо пустого |
Имя CQ | СМС | Имя учетной записи ресурса, присоединенной к очереди вызовов Если полное имя учетной записи ресурса равно cq_test@microsoft.com, то это значение равно : cq_test |
Дата | Дата | Дата звонка |
Hour | Целое число | Час звонка |
ММ-ДД | СМС | Месяц и день звонка |
Общее число вызовов | Целое число | Суммирование: Сумма Количество вызовов, представленных агенту |
Общее число вызовов, разделенное на количество имен агента (measure) | Целое число | Среднее число вызовов на агент |
Сумма общего числа вызовов (мера) | Целое число | Сумма общего числа вызовов — ноль вместо пустого |
Общая длительность вызова (ЧЧ:ММ:СС) | СМС | Длительность вызова (в минутах), преобразованная в ЧЧ:ММ:СС |
Общая длительность звонка (в минутах) | Целое число | Суммирование: Сумма Общая продолжительность вызовов очереди вызовов с ответами в минутах |
Ограничения данных
Каждая вкладка отчета извлекает данные для всех автосекретарей, очередей вызовов или агентов, для которых пользователь авторизован в клиенте для выбранного диапазона дат. Это извлечение данных происходит независимо от конкретных учетных записей ресурсов или агента, выбранных в отчете. Фильтрация для отображения только запрошенных сведений выполняется локально.
Каждая вкладка отчета ограничена получением 90 000 строк.
Если ежедневно обрабатывается большое количество вызовов, в отчете могут отображаться не все вызовы за все дни в выбранном диапазоне дат. Уведомление об исключении отсутствует. Попробуйте сократить диапазон дат, чтобы избежать этой проблемы.
Если сокращения диапазона дат недостаточно, можно увеличить количество строк, которые можно извлечь, изменив отчет следующим образом:
- Выберите Преобразовать данные на панели ленты, чтобы открыть Редактор Power Query.
- Выберите LimitResultRowsCount в левой части экрана.
- Измените значение в поле справа на большее число.
- Закройте окно Редактор Power Query.
- При появлении запроса на применение изменений выберите Да . Отчет должен обновляться автоматически.
- Сохраните отчет.
Максимальное число возвращаемых строк — 200 000.
Установка значения, превышающего 200 000, не оказывает влияния, так как это значение является жестко заданным ограничением на сервере.
Увеличение ограничения приводит к увеличению времени выполнения и ответа.
Ограничения времени выполнения отчета
Увеличение максимального числа возвращаемых строк приводит к увеличению времени выполнения и отклика, что означает, что отчет может завершиться до возврата данных. Время выполнения отчета можно увеличить, изменив отчет следующим образом:
- Выберите преобразование данных на панели ленты, чтобы открыть Редактор Power Query.
- Выберите ReportExecutionMinutes в левой части экрана.
- Измените значение в поле справа на большее число.
- Закройте окно Редактор Power Query.
- При появлении запроса на применение изменений выберите Да . Отчет должен обновляться автоматически.
- Сохраните отчет.
Настройка
Вы можете настроить определенные аспекты визуализации отчетов, такие как добавление или удаление полей для отображения в различных визуализациях, изменение типа диаграммы и многое другое.
Изменение цветовой схемы
В следующих шагах предполагается, что вы уже выполнили шаги по установке.
Выполните следующие действия.
Выберите вкладку Вид на ленте.
Выберите цветовую схему в раскрывающемся списке.
Измерения и измерения
Доступны следующие измерения и измерения.
Общие измерения
Эти измерения являются общими для автосекретарей и очередей вызовов:
Имя (тип) | Возможные значения | Описание |
---|---|---|
ConferenceId (Текст) |
Глобальный уникальный идентификатор (GUID) | Идентификатор вызова |
Дата (DateTime) |
Дата звонка (UTC) | |
DialogId (Текст) |
Глобальный уникальный идентификатор (GUID) | Идентификатор вызова |
DocumentId (Текст) |
Глобальный уникальный идентификатор (GUID) | Идентификатор вызова |
Duration (Длительность) (Целое число) |
Длительность вызова в секундах | |
EndTime (DateTime) |
Время окончания вызова (UTC) | |
FirstIsCaller (Логическое значение) |
Классификация первой и второй конечных точек | |
FirstUPN (Текст) |
Имя участника-пользователя (UPN) пользователя первой конечной точки | |
Hour (Текст) |
Час запущенного звонка (UTC) | |
Minute (Текст) |
Минутный звонок запущен (UTC) | |
PSTNCallDuration (Целое число) |
Длительность вызова | |
PSTNCallType (Текст) |
||
Внешняя | Вызов поступает извне клиента | |
Internal | Вызов поступает из клиента | |
PSTNConnectivityType (Текст) |
||
CallingPlan | Звонок поступил на номер плана звонков | |
DirectRouting | Звонок поступил по номеру прямой маршрутизации | |
Вызов ACS | Звонок поступил из Интернета (click2call) | |
Второй (Текст) |
Второй вызов запущен (UTC) | |
SecondUPN (Текст) |
Имя участника-пользователя (UPN) пользователя второй конечной точки | |
Идентификатор клиента (Текст) |
Идентификатор клиента | |
Метка времени (DateTime) |
Запись времени была написана (UTC) | |
UserStartTimeUTC (DateTime) |
Время начала вызова (UTC) |
Измерения автосекретаря
Имя (тип) | Возможные значения | Описание |
---|---|---|
AutoAttendantCallFlow (Текст) |
Инкапсулирует различные состояния вызова автосекретаря | |
abs_search | Выполнен поиск по телефону | |
объявление | Объявление было воспроизведено | |
automatic_menu | Маршрутизация звонков по умолчанию | |
call_termination | Вызов завершен, см. раздел AutoAttendantCallResult | |
call_transfer | Звонок был передан, см. раздел AutoAttendantCallResult | |
first_level_menu | Состояние перехода — можно игнорировать | |
main_menu | Приветственное сообщение было воспроизведено | |
speech_input_confirmation | Звонящий использовал голосовой ввод | |
user_selection | Звонящий использовал запись клавиши сенсорного тона | |
AutoAttendantCallResult (Текст) |
Окончательный результат вызова | |
failed_to_establish_media | Не удалось установить медиа-часть звонка | |
failover_to_operator | Вызов, передаваемый оператору, как правило, из-за системной ошибки | |
oaa_chain_too_long | Слишком много ног в АА | |
oaa_session_too_long | Сеанс AA длился слишком долго | |
service_declined | AA не принял звонок | |
service_terminated | Конфигурация AA отключает вызов или завис вызов | |
terminated_automatic_selection | Конфигурация AA отключает вызовы | |
terminated_no_operator | Все завершены из-за ошибки, оператор не определен | |
terminated_transfer_failed | Вызов завершен из-за сбоя передачи — обычно на внешний номер | |
transfer_in_progress | Передача AA-AA> | |
transferred_to_operator | Вызов передан оператору | |
transferred_to_cq | Звонок перешел в очередь вызовов | |
transferred_to_receptionist | То же, что и transferred_to_operator | |
transferred_to_self | Вызов был возвращен в начало AA | |
transferred_to_shared_voicemail | Звонок был перемещен на общую голосовую почту | |
transferred_to_user | Звонок был передан пользователю | |
неизвестный | Произошло неизвестное условие | |
user_terminated | Вызывающий повесил трубку | |
AutoAttendantCallerActionCounts (Целое число) |
Количество действий (клавиша сенсорного ввода или голосовые записи), выполненных вызывающим абонентом | |
AutoAttendantChainDurationInSecs (Реальное число) |
Количество секунд, в течение которых вызов оставался в этой части потока вызовов | |
AutoAttendantChainIndex (Целое число) |
||
AutoAttendantChainStartTime (DateTime) |
Время начала этой части потока вызовов | |
AutoAttendantCount (Целое число) |
Сколько автосекретарей переехал вызов | |
AutoAttendantDirectorySearchMethod (Текст) |
Метод поиска по каталогу | |
abs_search_dtmf | Сенсорный тон | |
abs_search_voice | Голос | |
AutoAttendantId (Текст) |
GUID автосекретаря | |
AutoAttendantIdentity (Текст) |
Универсальный код ресурса (URI) учетной записи ресурсов, на который поступил вызов | |
AutoAttendantTransferAction (Текст) |
Тип целевого объекта передачи вызовов | |
АА | Перенос в AA | |
CQ | Перенос в CQ | |
external_pstn | Перенос на внешний номер | |
общая голосовая почта | Перенос в общую голосовую почту | |
Неизвестный | Неизвестное действие | |
HasAA (Логическое значение) |
Участвует ли AA в вызове |
Измерения очереди вызовов
Имя (тип) | Возможные значения | Описание |
---|---|---|
CallQueueAgentCount (Целое число) |
Количество агентов в очереди вызовов | |
CallQueueAgentOptInCount (Целое число) |
Количество агентов, согласились на очередь звонков | |
CallQueueCallResult (Текст) |
Конечное состояние вызова очереди вызовов | |
agent_joined_conference | Ответ на звонок — CQ в режиме конференции | |
callback_call_timed_out | Истекло время ожидания обратного звонка | |
Отказался | ||
бессвязный | ||
error | ||
неудавшийся | ||
Недопустимый | ||
переполнение | Выполнено условие переполнения | |
timed_out | Условие ожидания выполнено | |
no_agent | Условие агента не выполнено | |
transferred_to_agent | Ответ на вызов — CQ в режиме передачи | |
transferred_to_callback_caller | Обратный вызов, ответ на который отвечает агент | |
CallQueueDurationSeconds (Реальное число) |
Длительность звонка в очереди звонков | |
CallQueueFinalStateAction (Текст) |
Окончательное действие очереди вызовов | |
разъединять | time_out вызовы | |
disconnect_with_busy | переполненные вызовы | |
failed_to_accept_call | Очереди звонков не удалось принять звонок | |
вперёд | Звонок переадресован пользователю в организации или извне | |
shared_voicemail | Звонок отправлен на общую голосовую почту | |
другой | Возникло другое условие | |
голосовая почта | Звонок отправлен на личную голосовую почту | |
CallQueueId (Текст) |
GUID очереди вызовов | |
CallQueueIdentity (Текст) |
Универсальный код ресурса (URI) учетной записи ресурсов, на который поступил вызов | |
CallQueueTargetType (Текст) |
Целевой объект перенаправления вызовов | |
ApplicationEndpoint | Другие голосовые приложения | |
почтовый ящик. | Общая голосовая почта | |
Other | Возникло другое условие | |
Телефон | Внешняя передача | |
Пользователь | Пользователь в клиенте | |
HasCQ (Логическое значение) |
Участвует ли CQ в вызове | |
TransferredFromCQId (Текст) |
Вызов с идентификатором GUID очереди вызовов передан из | |
TransferredFromCallQueueIdentity (Текст) |
Универсальный код ресурса (URI) учетной записи ресурса, из который был передан вызов |
Измерения
Имя (тип) | Возможные значения | Описание |
---|---|---|
AvgAutoAttendantChainDurationSeconds (Реальное число) |
Средняя длительность вызова в каждой части потока вызовов автосекретаря | |
AvgCallDuration (Реальное число) |
Средняя длительность вызова в секундах | |
AvgCallQueueDurationSeconds (Реальное число) |
Средняя продолжительность очереди звонков в секундах | |
PSTNTotalMinutes (Реальное число) |
Общая длительность звонка в минутах | |
TotalAudioStreamDuration (Реальное число) |
||
TotalCallCount (Целое число) |
Общее количество звонков |
Создание допустимого запроса
Допустимый запрос состоит из нескольких атрибутов в объекте JSON:
{
"Filters":[
{
"DataModelName":"Date",
"Value":"2022-04-01",
"Operand":4
},
{
"DataModelName":"Date",
"Value":"2022-04-30",
"Operand":6
}
],
"Dimensions":[
{
"DataModelName":"AutoAttendantIdentity"
},
{
"DataModelName":"AutoAttendantDirectorySearchMethod"
}
],
"Measurements":[
{
"DataModelName":"PSTNTotalMinutes"
},
{
"DataModelName":"TotalCallCount"
}
],
"Parameters":{
"UserAgent":"Power BI Desktop"
},
"LimitResultRowsCount":100000
}
Обязательные поля
Фильтры: используются для фильтрации данных, возвращаемых VAAC
- DataModelName должен быть одним из поддерживаемых измерений
- Значение должно быть в правильном формате (datetime, string, number и т. д.)
-
Операнды:
- 0 — равно
- 1 — не равно
- 2 . Содержит
- 3 . Начинается с
- 4 - Больше чем
- 5 — больше или равно
- 6 — меньше, чем
- 7 — меньше или равно
- 8 — не содержит
- 9 — не начинается с
Размеры:
- DataModelName должен быть одним из поддерживаемых измерений
Измерения:
- DataModelName должен быть одним из поддерживаемых измерений.
Параметры: в настоящее время поддерживается только UserAgent.
LimitResultRowsCount: максимальное число строк, возвращаемых VAAC.
Доступ к VAAC за пределами Power BI
Любое приложение, которое может получить доступ к веб-службам RESTful, может использовать API VAAC для получения исторических данных. В следующем примере используется Postman .
Подготовка
- Скачайте Postman.
- Импортируйте папку
postman
из скачанных инструкций ZIP-файла в Postman.
Доступ к VAAC с помощью Postman
Выберите VAAC — msit в верхнем правом раскрывающемся списке Нет среды .
Выберите Среды в меню слева.
Выберите VAAC — msit в разделе Глобальные.
Замените userName, password и tenantId соответствующими учетными данными.
Выберите Сбросить все в правом верхнем углу.
Нажмите Сохранить.
Выберите Коллекции в меню слева.
Выберите Config API Access Token — Prod и перейдите на вкладку Текст .
Нажмите кнопку Отправить.
Возвращается маркер доступа.
Если маркер доступа не возвращается, проверка учетные данные, чтобы они имели достаточные разрешения.
Выберите VAAC ConfigAPI Prod и перейдите на вкладку Params (Параметры ).
- Сжатие запроса в виде контура
- URL-адрес кодирует сжатый результат, как показано в схеме
Заполните строку запроса .
Нажмите кнопку Отправить.
Чтение результата
После отправки входных данных можно получить несколько возможных результатов:
Если входные данные недопустимы, возвращается сообщение об ошибке с фактической причиной.
Если входные данные допустимы, результат выглядит следующим образом:
В этом случае данные в поле dataResult в том же порядке, что и в атрибутах измерения запроса и измерений.
Сжатие запроса JSON
API VAAC принимает в качестве входных данных только строки в кодировке GZip или Base64.
Найдите любой веб-сайт для сжатия большого двоичного объекта JSON с помощью GZIP или Base64.
Выходные данные GZIP должны выглядеть следующим образом:
H4sIAAAAAAAACq2SQWsCMRCF7/6KkLNC3EoPe9u6FISuFbW9lB4GM9TQbEaSCSLif+9mV4uCBwXnMkze5L0vkH1PCCFfjWX0QeZfaWxqf+xJLIGhIo12CjXKPM0o+2cLn2BjEjKVZQM1Gqjhhfy+QQ9Oy3x0PDz0H5HypK6nPJ9SUv9uV2RpanTBkLvxiUVkKpjRaXA80ejY8E7eg3/hUBqPKya/WyD41bpCXpP+tzvjrBBC9NjA8o2ks8VyuiQGWxkXGcNdkO3FMVg7puj4GtAMfLPa/Y2Tk/wI6IufhjHl0xa9eJmIEsMv06Y16cLlm6kNzzFEy3Pahi4kH6pUvcMfrAhUU3oCAAA=
Выходные данные Base64 должны выглядеть следующим образом:
ew==
IkZpbHRlcnMiOls=
ew==
IkRhdGFNb2RlbE5hbWUiOiJEYXRlIiw=
IlZhbHVlIjoiMjAyMi0wNC0wMSIs
Ik9wZXJhbmQiOjQ=
fSw=
ew==
IkRhdGFNb2RlbE5hbWUiOiJEYXRlIiw=
IlZhbHVlIjoiMjAyMi0wNC0zMCIs
Ik9wZXJhbmQiOjY=
fQ==
XSw=
IkRpbWVuc2lvbnMiOls=
ew==
IkRhdGFNb2RlbE5hbWUiOiJBdXRvQXR0ZW5kYW50SWRlbnRpdHki
fSw=
ew==
IkRhdGFNb2RlbE5hbWUiOiJBdXRvQXR0ZW5kYW50RGlyZWN0b3J5U2VhcmNoTWV0aG9kIg==
fQ==
XSw=
Ik1lYXN1cmVtZW50cyI6Ww==
ew==
IkRhdGFNb2RlbE5hbWUiOiJQU1ROVG90YWxNaW51dGVzIg==
fSw=
ew==
IkRhdGFNb2RlbE5hbWUiOiJUb3RhbENhbGxDb3VudCI=
fQ==
XSw=
IlBhcmFtZXRlcnMiOns=
IlVzZXJBZ2VudCI6IlBvd2VyIEJJIERlc2t0b3Ai
fSw=
IkxpbWl0UmVzdWx0Um93c0NvdW50IjoxMDAwMDA=
fQ==
URL-Encode сжатый запрос JSON
Сжатый запрос JSON GZIP или Base64 должен быть закодирован в формате URL-адреса.
Выходные данные в кодировке URL-адреса GZIP выглядят следующим образом:
H4sIAAAAAAAACq2SQWsCMRCF7%2F6KkLNC3EoPe9u6FISuFbW9lB4GM9TQbEaSCSLif%2B9mV4uCBwXnMkze5L0vkH1PCCFfjWX0QeZfaWxqf%2BxJLIGhIo12CjXKPM0o%2B2cLn2BjEjKVZQM1Gqjhhfy%2BQQ9Oy3x0PDz0H5HypK6nPJ9SUv9uV2RpanTBkLvxiUVkKpjRaXA80ejY8E7eg3%2FhUBqPKya%2FWyD41bpCXpP%2BtzvjrBBC9NjA8o2ks8VyuiQGWxkXGcNdkO3FMVg7puj4GtAMfLPa%2FY2Tk%2FwI6IufhjHl0xa9eJmIEsMv06Y16cLlm6kNzzFEy3Pahi4kH6pUvcMfrAhUU3oCAAA%3D
Выходные данные в кодировке BASE64 URL-адреса выглядят следующим образом:
%0Aew%3D%3D%0AIkZpbHRlcnMiOls%3D%0Aew%3D%3D%0AIkRhdGFNb2RlbE5hbWUiOiJEYXRlIiw%3D%0AIlZhbHVlIjoiMjAyMi0wNC0wMSIs%0AIk9wZXJhbmQiOjQ%3D%0AfSw%3D%0Aew%3D%3D%0AIkRhdGFNb2RlbE5hbWUiOiJEYXRlIiw%3D%0AIlZhbHVlIjoiMjAyMi0wNC0zMCIs%0AIk9wZXJhbmQiOjY%3D%0AfQ%3D%3D%0AXSw%3D%0AIkRpbWVuc2lvbnMiOls%3D%0Aew%3D%3D%0AIkRhdGFNb2RlbE5hbWUiOiJBdXRvQXR0ZW5kYW50SWRlbnRpdHki%0AfSw%3D%0Aew%3D%3D%0AIkRhdGFNb2RlbE5hbWUiOiJBdXRvQXR0ZW5kYW50RGlyZWN0b3J5U2VhcmNoTWV0aG9kIg%3D%3D%0AfQ%3D%3D%0AXSw%3D%0AIk1lYXN1cmVtZW50cyI6Ww%3D%3D%0Aew%3D%3D%0AIkRhdGFNb2RlbE5hbWUiOiJQU1ROVG90YWxNaW51dGVzIg%3D%3D%0AfSw%3D%0Aew%3D%3D%0AIkRhdGFNb2RlbE5hbWUiOiJUb3RhbENhbGxDb3VudCI%3D%0AfQ%3D%3D%0AXSw%3D%0AIlBhcmFtZXRlcnMiOns%3D%0AIlVzZXJBZ2VudCI6IlBvd2VyIEJJIERlc2t0b3Ai%0AfSw%3D%0AIkxpbWl0UmVzdWx0Um93c0NvdW50IjoxMDAwMDA%3D%0AfQ%3D%3D
Важно!
API VAAC может возвращать не более 200 000 строк на запрос.
Запросы в систему регулируются на основе IP-адреса, выполняющего вызов, распознанного удостоверения клиента в заголовке проверки подлинности, а также вызывающей службы, чтобы предотвратить монополизацию ресурсов одним клиентом, клиентом или службой.
Журнал версии 3.x.x и состояние поддержки
Подробный список изменений см. в статье Автосекретарь Teams & Отчеты об изменениях— Log.docx изменений в скачанном ZIP-файле.
Версия | Дата публикации | Поддерживается | Имя файла | Описание |
---|---|---|---|---|
3.1.8 | 12 августа 2024 г. | Да | Автосекретарь Teams & отчеты об очереди вызовов версии 3.1.7 | Исправление ошибок для среза даты на вкладке "Очередь вызовов" |
3.1.7 | 15 июля 2024 г. | Нет | Автосекретарь Teams & отчеты об очереди вызовов версии 3.1.7 | Улучшена поддержка авторизованных пользователей, удалены исходные шаблоны отчетов |
3.1.6 | 15 апреля 2024 г. | Нет | Автосекретарь Teams & исторические отчеты об очередях вызовов версии 3.1.6 | Поддержка click2call, обратного вызова, авторизованных пользователей и некоторых визуальных элементов, измененных из-за устаревания |
3.1.5 | 29 января 2024 г. | Нет | Автосекретарь Teams & исторические отчеты о очереди вызовов версии 3.1.5 | Исправлена ошибка логики запросов за день для fAgentTimelineAnalytics и fAgentTimelineAnalyticsSummary |
3.1.4 | 24 января 2024 г. | Нет | Автосекретарь Teams & исторические отчеты об очереди вызовов версии 3.1.4 | Отчеты по дням для клиентов с большим объемом, улучшения специальных возможностей для средств чтения с экрана |