Отчеты об истории автосекретаря и очереди вызовов

Шаблон Power BI "Автосекретарь" & "Журнал очереди вызовов" предоставляет три отчета, которые позволяют организациям сообщать о количестве вызовов, обработанных автосекретарями и очередями вызовов. Он также предоставляет аналитические сведения о производительности агента.

Версия 3.2.1 опубликована 23 июня 2025 г.

Новые возможности этого выпуска:

• Устранена проблема, связанная с авторизованным пользователем с разрешением "Метрики очереди вызовов", для параметра "Историческиеметрики очереди вызовов" задано значение "Все", а отчет возвращается к отчетам по учетной записи ресурсов. Авторизованные пользователи теперь могут просматривать отчет по автосекретарю и имени очереди вызовов в любое время.
• Устранена проблема, связанная с назначениями переполнения, времени ожидания или отсутствия агента, из-за которой вызовы не учитываются, когда голосовое приложение было назначением маршрутизации.
• Устранена проблема в отчете всплывающей подсказки на временной шкале агента, в результате которой отображались все вызовы агента, а не только вызовы в выбранном диапазоне дат.
• Устранена проблема на временной шкале агента, которая приводила к отображению отдельных вызовов агента вместо суммы вызовов агента.

Обзор

Шаблон Power BI "Автосекретарь Teams & очереди вызовов" содержит следующие три отчета:

• В отчете автосекретаря отображается аналитика вызовов, поступающих в автосекретаря.
• В отчете Очередь вызовов отображается аналитика звонков, поступающих в очереди звонков.
• В отчете Временная шкала агента отображается временная шкала представление агентов, активных в вызовах очереди вызовов.

В этих отчетах используются данные из службы "Сборщик аналитики голосовых приложений" (VAAC).

Предварительные требования для V3.x.x

Power BI Desktop

Необходимо установить Power BI Desktop. Вы можете установить и использовать бесплатную версию из Microsoft Store.

Служба Power BI

Эти отчеты можно опубликовать в служба Power BI.

После публикации отчета:

1. Перейдите к параметрам набора данных.
2. Разверните раздел Учетные данные источника данных .
3. Выберите Изменить учетные данные.
4. Задайте для метода проверки подлинности значениеOAuth2.
5. Убедитесь, что пропустить тестовое подключение включено.
6. Выберите Войти и укажите свои учетные данные.

По завершении вы сможете настроить запланированное обновление набора данных.

Разрешения доступа

Используйте один из следующих методов для управления доступом к историческим отчетам:

• Политика голосовых приложений

  Чтобы управлять тем, о каких автосекретарях, очередях звонков и агентах пользователи могут сообщать, не предоставляя им доступ к Центру администрирования Teams, создайте политику голосовых приложений, которая предоставляет им доступ к историческим отчетам и назначает их в качестве авторизованного пользователя соответствующим автосекретарям и очередям звонков. Как администратор вы можете создать политику голосовых приложений в Центре администрирования группы или с помощью PowerShell.

  Дополнительные сведения о создании политики голосовых приложений см. в статье Управление политиками голосовых приложений в Microsoft Teams.

  Кончик

  Мы рекомендуем использовать политику голосовых приложений для управления доступом к историческим отчетам. С помощью политики голосовых приложений и авторизованных пользователей можно управлять автосекретарями, очередями вызовов и агентами, о которых пользователь может сообщать. При необходимости политика по-прежнему позволяет пользователю сообщать обо всех автосекретарях, очередях вызовов и агентах без предоставления доступа к Центру администрирования Teams.

• Конвейер панели мониторинга качества вызовов (CQD) [устаревшая версия]

  Если вы хотите, чтобы пользователь сообщал обо всех автосекретарях, очередях вызовов и агентах в клиенте и предоставить пользователю доступ к Центру администрирования Teams для запуска других отчетов об использовании, назначьте пользователю роль доступа CQD с полями "Просмотр отчетов" и "Просмотр EUII " для параметра "Да".

  Дополнительные сведения см. в разделе Роль доступа CQD.

  Примечание.

  Если пользователю назначена роль доступа CQD и политика голосовых приложений, роль CQD имеет приоритет, и пользователь может видеть все автосекретари, очереди вызовов и агенты в клиенте.

Установка классической версии 3.x.x

В следующих шагах предполагается, что клиент Power BI Desktop установлен на компьютере и что ваша учетная запись Teams настроена как авторизованный пользователь или ей назначена роль доступа CQD.

Выполните следующие действия.

1. Скачайте и сохраните файл журналов отчетов об очереди вызовов & Teams V3.2.1.zip на компьютере.

2. Откройте ZIP-файл.

3. Teams Auto Attendant & Call Queue Historical Reports V3.2.1.pbit Откройте файл шаблона. Power BI Desktop должно запуститься.

4. Выберите язык и смещение в формате UTC.

   

   • Язык: выберите язык и уровень отчета.
     • Выберите Per Call , чтобы получить все отдельные записи вызовов.
     • Выберите Per Day , чтобы получить агрегированный итог за каждый день.
   • Смещение UTC. Выберите смещение в формате UTC, представляющее часовой пояс, в который представлены отчеты. Допустимо только в том случае, если для уровня отчета задано значение Per Call

   За день и за звонок

   • Отчет о каждом вызове получает отдельные записи звонков для каждого автосекретаря, очереди вызовов и агента, для которого авторизован пользователь, и делает их доступными в клиенте Power BI. Отчеты по каждому вызову также позволяют отображать записи звонков в локальном часовом поясе, выбранном пользователем. Для некоторых клиентов, особенно тех, кто использует роль доступа CQD для управления доступом, отчеты за звонок могут привести к превышению ограничения по умолчанию 90 000 или 400 000 на запись запроса. В этом случае следует выбрать параметр отчетов за день.

   • Отчет за день получает одну ежедневную сводную запись для каждого автосекретаря, очереди вызовов и агента. Такая отчетность приводит к уменьшению количества записей, возвращаемых клиенту, что снижает вероятность достижения ограничения по умолчанию 90 000 или 400 000 записей запроса. Отчеты за день основаны только на utc-00:00 день (00:00:00-23:59:59 UTC), а любое смещение UTC, предоставленное пользователем, игнорируется.

Шаги 5–8 выполняются только один раз, при первой загрузке шаблона.

5. Настройте проверку подлинности источников данных.

   • Выберите Файл, Параметры и параметры, а затем Параметры источника данных.

   

6. Выполните следующие действия для каждого из двух указанных источников данных.

   • Выберите источник данных.

   • Выберите Изменить разрешения, а затем — Изменить.

   • Выберите Учетная запись организации , а затем Вход (или Вход от имени другого пользователя).

     

   • Войдите с помощью учетной записи Teams.

7. Нажмите кнопку Сохранить, затем ОК и Закрыть.

8. Выберите Обновить на панели ленты и обновления данных.

В зависимости от параметров Power BI Desktop также может появиться следующее всплывающее окно:

Установите флажок Игнорировать уровни конфиденциальности . Все данные поступают из базы данных исторических отчетов, и нежелательной передачи данных не происходит.

Задержка данных для автосекретаря и аналитики очереди вызовов

Данные обычно доступны в течение 30 минут после завершения вызова, но бывают случаи, когда их появление может занять несколько часов.

Чтобы просмотреть новые данные, необходимо обновить отчет.

Отчеты об истории автосекретаря и очереди вызовов

Отчет аналитики облачного автосекретаря

Толкование отчета

Notes

• Администраторы. Чтобы просмотреть вызовы для определенного автосекретаря, выберите все учетные записи ресурсов, назначенные данному автосекретарю. Например, если полное имя учетной записи ресурса — [email protected], то это значение равно : aa_test

Известные проблемы

1. Сообщается только о вызовах и действиях вызывающего в первом автосекретаре, который отвечает на вызов. Вызовы и действия вызывающего абонента в связанных автосекретарях (когда один автосекретарь передает другому автосекретарю) не сообщаются.
2. Журнал звонков доступен только за 28 дней. Данные автосекретаря считаются персональными данными и регулируются политиками хранения конфиденциальности данных.
3. Селектор даты иногда отображает даты за пределами диапазона доступных данных, что приводит к пустому отчету. Измените даты на последние 28 дней, чтобы устранить проблему.
4. Администраторы видят вложенных автосекретарей, которым не назначены учетные записи ресурсов, о которых сообщает guid автосекретаря, а не имя пользователя учетной записи ресурса.

Отчет аналитики очереди вызовов в облаке

Толкование отчета

Notes

1. Чтобы просмотреть вызовы для определенной очереди звонков, выберите все учетные записи ресурсов, назначенные этой очереди звонков. Если полное имя учетной записи ресурса равно [email protected], то это значение равно : cq_test.

Известные проблемы

1. Сообщается только о вызовах и действиях вызывающего абонента в первой очереди вызовов, которая отвечает на вызов. Вызовы в связанных очередях вызовов (когда одна очередь звонков передается в другую очередь вызовов) не сообщаются.
2. Журнал звонков доступен только за 28 дней. Данные очереди звонков считаются персональными данными и регулируются политиками конфиденциальности данных.
3. Селектор даты иногда отображает даты за пределами диапазона доступных данных, что приводит к пустому отчету. Измените даты на последние 28 дней, чтобы устранить проблему.
4. Администраторы видят вложенные очереди вызовов, которым не назначены учетные записи ресурсов, сообщили об учетной записи ресурса, которая перенесла вызов.

Отчет о временной шкале агента очереди вызовов в облаке

Толкование отчета

Notes

• Чтобы просмотреть вызовы для определенной очереди звонков, выберите все учетные записи ресурсов, назначенные этой очереди звонков. Если полное имя учетной записи ресурса равно [email protected], то это значение равно : cq_test.

Известные проблемы

1. Журнал звонков доступен только за 28 дней. Очередь звонков и данные агента считаются персональными данными и регулируются политиками хранения конфиденциальности данных.
2. Отображается имя участника-пользователя агента вместо имени пользователя.
3. Селектор даты иногда отображает даты за пределами диапазона доступных данных, что приводит к пустому отчету. Измените даты на последние 28 дней, чтобы устранить проблему.
4. В некоторых сценариях количество вызовов, от которых отвечает агент, может отличаться от количества вызовов, отображаемого в журнале вызовов клиента Teams. Журнал вызовов клиента Teams является правильным. Поддержка изучается, но в настоящее время не существует предполагаемого времени на восстановление.
5. Когда агент отвечает на вызов в другой очереди вызовов из-за перенаправления через обработку исключений переполнения вызовов, вызов учитывается в исходной очереди вызовов, в которой возникло исключение, а не в той, в которой он ответил на вызов.
6. Обратные вызовы, обрабатываемые агентами, не фиксируются, что приводит к расхождению между количеством вызовов, на которые ответили в отчете очереди вызовов, и в отчете о временной шкале агента.
7. Администраторы видят вложенные очереди вызовов, которым не назначены учетные записи ресурсов, сообщили об учетной записи ресурса, которая перенесла вызов.

Локализация

Поддерживаемые языковые стандарты

Известные проблемы локализации

1. Выбранный язык применяется только к отчетам, а не к компонентам и подсказкам Power BI. Power BI по умолчанию использует тот же язык, что и классический компьютер Windows.

   Чтобы изменить язык Power BI, выберите:

   • Файл
   • Параметры и параметры
   • Параметры
   • Региональные параметры
   • Язык приложения
     • По умолчанию задано значение "Использовать язык интерфейса Windows по умолчанию"
     • Выберите нужный язык в раскрывающемся списке.
       • Примечание. Список языков, представленных здесь, может отличаться от языков, доступных для шаблона отчета.

2. Имя ZIP-файла и фактические файлы шаблонов отчетов находятся только на английском языке.

3. На экране-заставке отображается имя файла (см. no 2) и слова "Language" и "UTC Offset" только на английском языке.

4. На экране обновления отображаются имена таблиц только на английском языке.

5. Имена вкладок отчета доступны только на английском языке.

6. Ссылка на документацию использует язык, заданный в браузере, который может отличаться от языка, выбранного для отчета.

7. Информация, предоставленная клиентом, не локализована.

8. Условные обозначения в визуальном элементе "Очередь звонков — громкость вызовов", "Отмененные вызовы" и "Число согласия агента" отображаются только на английском языке.

Проблемы 2–6— это ограничения соглашений об именовании файлов, экран-заставка в Power BI и принцип работы браузеров. Эти проблемы не будут устранены.

Автосекретарь и определения полей журналов очереди вызовов

Описание поля таблицы fAutoAttendant

Отчет аналитики очереди вызовов в облаке

Описание поля таблицы fCallQueueAnalytics

Описание поля таблицы fCallQueueFinalStateAction

Отчет о временной шкале агента очереди вызовов в облаке

Описание поля таблицы fAgentTimelineAnalytics

Описание поля таблицы fAgentTimelineAnalytics

Ограничения данных

Каждая вкладка отчета извлекает данные для всех автосекретарей, очередей вызовов или агентов, для которых пользователь авторизован в клиенте для выбранного диапазона дат. Это извлечение данных происходит независимо от конкретных учетных записей ресурсов или агента, выбранных в отчете. Фильтрация для отображения только запрошенных сведений выполняется локально.

Каждая вкладка отчета ограничена получением 90 000 строк.

Если ежедневно обрабатывается большое количество вызовов, в отчете могут отображаться не все вызовы за все дни в выбранном диапазоне дат. Уведомление об исключении отсутствует. Попробуйте сократить диапазон дат, чтобы избежать этой проблемы.

Если сокращения диапазона дат недостаточно, можно увеличить количество строк, которые можно извлечь, изменив отчет следующим образом:

1. Выберите Преобразовать данные на панели ленты, чтобы открыть Редактор Power Query.
2. Выберите LimitResultRowsCount в левой части экрана.
3. Измените значение в поле справа на большее число.
4. Закройте окно Редактор Power Query.
5. При появлении запроса на применение изменений выберите Да . Отчет должен обновляться автоматически.
6. Сохраните отчет.

Максимальное число возвращаемых строк — 400 000.

Установка значения, превышающего 400 000, не оказывает влияния, так как это значение является жестко заданным ограничением на сервере.

Увеличение ограничения приводит к увеличению времени выполнения и ответа.

Ограничения времени выполнения отчета

Увеличение максимального числа возвращаемых строк приводит к увеличению времени выполнения и отклика, что означает, что отчет может завершиться до возврата данных. Время выполнения отчета можно увеличить, изменив отчет следующим образом:

1. Выберите преобразование данных на панели ленты, чтобы открыть Редактор Power Query.
2. Выберите ReportExecutionMinutes в левой части экрана.
3. Измените значение в поле справа на большее число.
4. Закройте окно Редактор Power Query.
5. При появлении запроса на применение изменений выберите Да . Отчет должен обновляться автоматически.
6. Сохраните отчет.

Настройка

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

Изменение цветовой схемы

В следующих шагах предполагается, что вы уже выполнили шаги по установке.

Выполните следующие действия.

1. Выберите вкладку Вид на ленте.

   

2. Выберите цветовую схему в раскрывающемся списке.

   

Измерения и измерения

Доступны следующие измерения и измерения.

Общие измерения

Эти измерения являются общими для автосекретарей и очередей вызовов:

Измерения автосекретаря

Измерения очереди вызовов

Измерения

Создание допустимого запроса

Допустимый запрос состоит из нескольких атрибутов в объекте 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 .

Подготовка

1. Скачайте Postman.
2. Импортируйте папку postman из скачанных инструкций ZIP-файла в Postman.

Доступ к VAAC с помощью Postman

1. Выберите VAAC — msit в верхнем правом раскрывающемся списке Нет среды .

2. Выберите Среды в меню слева.

3. Выберите VAAC — msit в разделе Глобальные.

4. Замените userName, password и tenantId соответствующими учетными данными.

5. Выберите Сбросить все в правом верхнем углу.

6. Нажмите Сохранить.

   

7. Выберите Коллекции в меню слева.

8. Выберите Config API Access Token — Prod и перейдите на вкладку Текст .

9. Нажмите кнопку Отправить.

   Возвращается маркер доступа.

   

   Если маркер доступа не возвращается, проверка учетные данные, чтобы они имели достаточные разрешения.

10. Выберите VAAC ConfigAPI Prod и перейдите на вкладку Params (Параметры ).

    • Сжатие запроса в виде контура
    • URL-адрес кодирует сжатый результат, как показано в схеме

11. Заполните строку запроса .

12. Нажмите кнопку Отправить.

Чтение результата

После отправки входных данных можно получить несколько возможных результатов:

• Если входные данные недопустимы, возвращается сообщение об ошибке с фактической причиной.

• Если входные данные допустимы, результат выглядит следующим образом:

  

  В этом случае данные в поле dataResult в том же порядке, что и в атрибутах измерения запроса и измерений.

Сжатие запроса JSON

API VAAC принимает в качестве входных данных только строки в кодировке GZip или Base64.

Найдите любой веб-сайт для сжатия большого двоичного объекта JSON с помощью GZIP или Base64.

• 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

Журнал версии 3.x.x и состояние поддержки

Подробный список изменений см. в статье Автосекретарь Teams & Отчеты об изменениях— Log.docx изменений в скачанном ZIP-файле.

Статьи по теме

• Метрики автосекретаря и очереди вызовов в режиме реального времени
• Планирование для авторизованных пользователей
• Управление приложением Очереди