Microsoft Teams Attendant Console

Il controllo dello stato di presence telefonica degli utenti attestati su Microsoft Teams è basato sull’utilizzo delle Microsoft Graph API.

Per garantire l’accesso alle suddette API l’amministratore di Microsoft Teams deve:

• Registrare una nuova applicazione
• Tramite OCC eseguire il login con un utente adeguato per delegare ai servizi TVox l’accesso alla presence degli utenti.

Creazione App Microsoft Teams

1. L’amministratore effettua il login sul portale Azure: https://portal.azure.com
2. Selezionare lo strumento Registrazioni per l'App o andare all’indirizzo App Registration

3. Premere su «Nuova registrazione».

4. Dare un nome all’applicazione e premere Registra e attendere la creazione.

5. Dai dettagli dell’App copiare il valore ID applicazione (App ID) e salvarselo. Questo valore dovrà essere successivamente inserito in OCC.

Nota

L’App ID può essere recuperato in qualsiasi momento.

6. Dal menu laterale selezionare Certificati e segreti.
7. Nella sezione Segreti client premere Nuovo segreto client

8. Dare un nome qualsiasi al segreto e come Scadenza selezionare una scadenza, ad esempio 24 Mesi. Premere Aggiungi.

9. Copiare e salvare in un posto sicuro il valore del segreto (App Secret).

Attenzione

Non sarà più possibile recuperare il valore del segreto in futuro. In caso di smarrimento del segreto sarà necessario crearne uno nuovo e riconfigurare le credenziali su OCC.

10. Entrare nella sezione Autorizzazione API.

12. Premere su Aggiungi un'autorizzazione.

13. Selezionare le API Microsoft Graph dall’elenco.

14. Scegliere le autorizzazioni di tipo Autorizzazioni delegate.

15. Nella input box di ricerca inserire offline_access, selezionare la checkbox corrispondente al permesso offline_access nell’elenco in basso.

16. Cercare e aggiungere anche i permessi:
    • openid
    • Presence.Read.All
    • User.ReadBasic.All
17. Premere Aggiungi autorizzazioni
18. L’elenco autorizzazioni si presenterà come nella prossima immagine.
19. Premere il pulsante Concedi consenso amministratore per 'Nome Azienda' per attivare i permessi.

18. A questo punto se è tutto corretto la lista dei permessi indicherà che sono stati concessi dall’amministratore.

19. I valori di App ID e App Secret ora possono essere utilizzati in OCC per creare le credenziali che saranno utilizzati dal TVox per leggere lo stato di presence dei contatti Microsoft Teams

Configurazione TConsole 5

TConsole 5 può utilizzare il BLF di Microsoft Teams® per vedere gli stati di presence degli utenti.

Per riuscire ad utilizzare il BLF Microsoft Teams® su TConsole 5 è necessario installare un TConsole con versione a partire dalla 5.7.27 e un TConsoleServerStd con versione a partire dalla 3.1.4 ed effettuare le seguenti configurazioni:

Nella sezione [SIPBLFSERVER]:

SIPBLFSERVER_IP=<IP_TVOX>
SIPBLFSERVER_PORT=6598

Nella sezione [BLF]:

Type=MSTEAMS
SkipFileDevices=YES

SkipFileDevices va valorizzato a YES, e in questo modo si esclude l’utilizzo del file devices. Il mapping tra DN e username verrà fatto direttamente sulle rubriche. Sulle rubriche dovrà quindi essere riservata una colonna in cui viene salvato lo username di cui richiedere la presence e nella sezione di configurazione della rubrica in RunInt.ini/RubEst.ini come colonna della presence da monitorare dovrà essere posta la colonna in cui risiede lo username. Ad esempio se lo username da monitorare viene posto in LIBERO_1, nella sezione [MASTER] di RubInt.ini/RubEst.ini il field 0 dovrà essere configurato come segue:

0=LIBERO_1,19