Reportistica - Reportistica cronologica - Personalizzata

Questo articolo è destinato ai professionisti IT e agli amministratori di Teams che vogliono creare report cronologici personalizzati al di fuori di Power BI per Teams Agenti telefonici, Operatori automatici e Code chiamata.

Revisione della pianificazione e delle licenze

Pianificazione

• Panoramica dell'agente telefonico di Teams, dell'operatore automatico e della coda delle chiamate
• Utenti autorizzati
• Flussi di chiamata annidati
• Considerazioni sulla creazione di report

Licenze

• Operatore automatico e coda delle chiamate

Panoramica

Il servizio VAAC (Voice Applications Analytics Collector) consente di accedere a tutti i dati cronologici dell'agente telefonico di Teams, dell'operatore automatico e della coda delle chiamate con qualsiasi strumento che supporti la connessione agli endpoint HTTP.

Esistono tre passaggi:

1. Autenticazione
2. Creazione di una query valida
3. Lettura del risultato

Passaggio 1 - Autenticazione

Un token di accesso deve essere recuperato e quindi inviato con tutte le richieste successive.

URL di autenticazione:

https://login.microsoftonline.com/{{tenantID}}/oauth2/token

Sostituire {{tenantID}} con l'ID tenant.

Il corpo della richiesta deve contenere quanto segue:

Passaggio 2 - Creazione di una query valida

Una query valida è costituita da diversi attributi in un oggetto 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":"VAAC Custom Query"
   },
   "LimitResultRowsCount":100000
}

Campi obbligatori

• Filtri: utilizzato per filtrare i dati restituiti da VAAC: qualsiasi dimensione in cui Filters Support può Y essere filtrata
  • DataModelName deve essere una delle dimensioni supportate
  • Il valore deve essere nel formato corretto (datetime, stringa, numero e così via)
  • Operandi:
    • 0 - Uguale a
    • 1 - Diverso da
    • 2 - Contiene
    • 3 - Inizia con
    • 4 - Maggiore di
    • 5 - Maggiore o uguale a
    • 6 - Minore di
    • 7 - Minore o uguale a
    • 8 - Non contiene
    • 9 - Non inizia con
• Dimensioni:
  • DataModelName deve essere una delle dimensioni Common, Auto Handler o Call Queue supportate.
• Misure:
  • DataModelName dovrebbe essere una delle misure supportate.
• Parametri: Attualmente è supportato solo UserAgent.
• LimitResultRowsCount: il numero massimo di righe restituite da VAAC

Comprimere la query JSON

L'API VAAC accetta solo stringhe compresse con GZIP o con codifica Base64 come input.

Usa qualsiasi sito Web in grado di comprimere il BLOB JSON usando GZIP o Base64. Ad esempio:

• GZIP
• Base64

L'output GZIP dovrebbe essere simile a questo:

H4sIAAAAAAAACq2SQWsCMRCF7/6KkLNC3EoPe9u6FISuFbW9lB4GM9TQbEaSCSLif+9mV4uCBwXnMkze5L0vkH1PCCFfjWX0QeZfaWxqf+xJLIGhIo12CjXKPM0o+2cLn2BjEjKVZQM1Gqjhhfy+QQ9Oy3x0PDz0H5HypK6nPJ9SUv9uV2RpanTBkLvxiUVkKpjRaXA80ejY8E7eg3/hUBqPKya/WyD41bpCXpP+tzvjrBBC9NjA8o2ks8VyuiQGWxkXGcNdkO3FMVg7puj4GtAMfLPa/Y2Tk/wI6IufhjHl0xa9eJmIEsMv06Y16cLlm6kNzzFEy3Pahi4kH6pUvcMfrAhUU3oCAAA=

L'output Base64 dovrebbe essere simile a questo:

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 la query JSON compressa

La query JSON compressa GZIP o Base64 deve essere codificata in URL.

L'output codificato dell'URL GZIP è simile al seguente:

H4sIAAAAAAAACq2SQWsCMRCF7%2F6KkLNC3EoPe9u6FISuFbW9lB4GM9TQbEaSCSLif%2B9mV4uCBwXnMkze5L0vkH1PCCFfjWX0QeZfaWxqf%2BxJLIGhIo12CjXKPM0o%2B2cLn2BjEjKVZQM1Gqjhhfy%2BQQ9Oy3x0PDz0H5HypK6nPJ9SUv9uV2RpanTBkLvxiUVkKpjRaXA80ejY8E7eg3%2FhUBqPKya%2FWyD41bpCXpP%2BtzvjrBBC9NjA8o2ks8VyuiQGWxkXGcNdkO3FMVg7puj4GtAMfLPa%2FY2Tk%2FwI6IufhjHl0xa9eJmIEsMv06Y16cLlm6kNzzFEy3Pahi4kH6pUvcMfrAhUU3oCAAA%3D

L'output codificato URL Base64 è simile al seguente:

%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

L'URL della richiesta finale sarà simile al seguente:

https://api.interfaces.records.teams.microsoft.com/Teams.VoiceAnalytics/getanalytics?query=H4sIAAAAAAAACq2SQWsCMRCF7%2F6KkLNC3EoPe9u6FISuFbW9lB4GM9TQbEaSCSLif%2B9mV4uCBwXnMkze5L0vkH1PCCFfjWX0QeZfaWxqf%2BxJLIGhIo12CjXKPM0o%2B2cLn2BjEjKVZQM1Gqjhhfy%2BQQ9Oy3x0PDz0H5HypK6nPJ9SUv9uV2RpanTBkLvxiUVkKpjRaXA80ejY8E7eg3%2FhUBqPKya%2FWyD41bpCXpP%2BtzvjrBBC9NjA8o2ks8VyuiQGWxkXGcNdkO3FMVg7puj4GtAMfLPa%2FY2Tk%2FwI6IufhjHl0xa9eJmIEsMv06Y16cLlm6kNzzFEy3Pahi4kH6pUvcMfrAhUU3oCAAA%3D

Passaggio 3: lettura del risultato

Dopo aver inviato il tuo input, ci sono un paio di possibili risultati:

• Se l'input non è valido, viene restituito un messaggio di errore con il motivo effettivo

• Se l'input è valido, il risultato sarà simile al seguente:

  

  In questo caso, i dati si trovano nel campo "dataResult" nello stesso ordine richiesto negli attributi di dimensione e misure della query.

Dimensioni e misure disponibili

Sono disponibili le seguenti dimensioni e misure.

Dimensioni comuni

Queste dimensioni sono comuni sia agli operatori automatici che alle code di chiamata:

Dimensioni dell'operatore automatico

Dimensioni coda di chiamata

Misure

Esempio

Qualsiasi applicazione in grado di accedere ai servizi Web RESTful può utilizzare l'API VAAC per recuperare i dati cronologici. Nell'esempio seguente viene utilizzato Postman .

Preparazione

1. Scarica e installa Postman.

2. Scaricare ed espandere il filepostman.zip .

3. Importare la cartella postman in Postman.

   

Accesso a VAAC tramite Postman

1. Selezionare VAAC - msit in alto a destra nell'elenco a discesa Nessun ambiente .

2. Seleziona Ambienti nel menu della barra a sinistra.

3. Selezionare VAAC - msit in Globali.

4. Sostituire userName, password e tenantId con le credenziali applicabili.

5. Seleziona Reimposta tutto nell'angolo in alto a destra.

6. Selezionare Salva.

   

7. Seleziona Raccolte nel menu della barra a sinistra.

8. Selezionare Config API Access Token - prod e passare alla scheda Corpo .

9. Seleziona Invia.

   Viene restituito un token di accesso.

   

   Se non viene restituito un token di accesso, controllare le credenziali per assicurarsi che dispongano delle autorizzazioni necessarie.

10. Selezionare VAAC ConfigAPI Prod e passare alla scheda Params .

    • Comprimere la query come descritto
    • URL codificare il risultato compresso come descritto

11. Compilare la stringa di query .

12. Seleziona Invia.