Vediamo quali passaggi seguire per creare una nuova applicazione su Microsoft Azure da utilizzare per l’Identity Provider esterno.
Prima di procedere con la configurazione, ricorda che è necessario effettuare l’accesso al portale https://portal.azure, utilizzando un account amministrativo.
Per la sincronizzazione delle rubriche, è indispensabiledisporre di un account Microsoft con licenza Microsoft 365 Business Standard.
Creazione WebApps Microsoft
1. Clicca su Registrazioni app
2. Clicca su Nuova registrazione
3. Assegna un nome all’applicazione
4. Seleziona Web come piattaforma
5. Inserisci l’URI TVox nel formato “https://tvox.miodominio.com/system/external_accounts/microsoft“
6. Clicca su Registra per finalizzare la configurazione
7. Clicca su Autorizzazioni API
8. Clicca su Aggiungi un’autorizzazione
9. Clicca su API usate dall’organizzazione
10. Seleziona Office 365 Exchange Online
11. Clicca su Autorizzazioni delegate
12. Seleziona User -> User.Read e Aggiungi autorizzazioni
13. Clicca su Certificati e segreti
14. Clicca su Nuovo segreto client
15. Compila la Descrizione e Aggiungi
16. Conserva ora il Valore
Assicurati di conservare la Client Secret, il cui valore è rappresentato dal contenuto del campo Valore. Questo valore sarà consultabile solo durante la fase di creazione.
17. Clicca su Configurazione del token
18. Clicca su Aggiungi un’attestazione facoltativa
19. Clicca su ID
20. Selezione upn e clicca su Aggiungi
21. Clicca su Aggiungi dopo aver messo la spunta
22. Il nuovo token è creato
23. Clicca su Autorizzazioni API
24. Clicca su Panoramica
25. Clicca su Endpoint
Conserva ID Applicazione (client), insieme a Client Secret (link). Questi valori saranno utilizzati su OCC per la creazione delle credenziali applicazione.
OCC
Una volta configurata la tua WebApp di Azure, è importante tenere a portata di mano sia il Client ID che il Client Secret. Potrai quindi accedere ad OCC per creare una nuova rubrica interna dove andrai a sincronizzare i contatti telefonici di Microsoft Teams abilitando la presence su TVox. Ricorda che sarà necessario associare la rubrica almeno a un servizio o a un utente per garantire che venga importata al momento della prima schedulazione.
L’integrazione completa prevede un trunk verso Microsoft Teams per permettere agli operatori di interagire telefonicamente.
5. Seleziona il servizio di autenticazione Microsoft
6. Compila Nome / Client ID e Client secret
Assegna un nome identificativo alle tue credenziali applicative. Il Client ID e il Client secret sono quelli che hai precedentemente conservato durante la creazione della WebApp su Azure. L’Url di callback sarà automaticamente proposto da TVox.
Salva le nuove credenziali una volta che hai compilato tutti i campi necessari.
7. Spostati nella Tab “Account esterni”
8. Clicca su Nuovo
9. Crea un Nuovo account
Compila come segue:
Servizio di autenticazione: Microsoft
Nome: un nome per te significativo
Credenziali applicazione: le credenziali create precedentemente
10. Imposta lo Scopo
Assicurati di impostare lo Scopo con il valore T4YOU/BLF, attivando il flag su entrambi i valori (BLF e T4YOU)
Una volta completato, conferma il nuovo account esterno.
11. Esegui l’autenticazione con l’account esterno
A questo punto, procedi con l’autenticazione su Microsoft utilizzando un utente licenziato Microsoft Office 365 standard.
12. Accedi alla sezione “Rubriche”
13. Clicca su Nuovo
14. Associa i servizi alla nuova rubrica interna
15. Configura una Nuova sorgente MICROSOFT OFFICE 365
16. Assegna un nome alla nuova sorgente
17. Associa un Account Microsoft da utilizzare per recuperare i contatti *
Configurazione Isola con centrale Microsoft Teams
Vediamo quali passaggi seguire per creare una nuova applicazione su Microsoft Azure da utilizzare per l’Identity Provider esterno.
Prima di procedere con la configurazione, ricorda che è necessario effettuare l’accesso al portale https://portal.azure, utilizzando un account amministrativo.
Per la sincronizzazione delle rubriche, è indispensabile disporre di un account Microsoft con licenza Microsoft 365 Business Standard.
Creazione WebApps Microsoft
1. Clicca su Registrazioni app
2. Clicca su Nuova registrazione
3. Assegna un nome all’applicazione
4. Seleziona Web come piattaforma
5. Inserisci l’URI TVox nel formato “https://tvox.miodominio.com/system/external_accounts/microsoft“
6. Clicca su Registra per finalizzare la configurazione
7. Clicca su Autorizzazioni API
8. Clicca su Aggiungi un’autorizzazione
9. Clicca su API usate dall’organizzazione
10. Seleziona Office 365 Exchange Online
11. Clicca su Autorizzazioni delegate
12. Seleziona User -> User.Read e Aggiungi autorizzazioni
13. Clicca su Certificati e segreti
14. Clicca su Nuovo segreto client
15. Compila la Descrizione e Aggiungi
16. Conserva ora il Valore
Assicurati di conservare la Client Secret, il cui valore è rappresentato dal contenuto del campo Valore. Questo valore sarà consultabile solo durante la fase di creazione.
17. Clicca su Configurazione del token
18. Clicca su Aggiungi un’attestazione facoltativa
19. Clicca su ID
20. Selezione upn e clicca su Aggiungi
21. Clicca su Aggiungi dopo aver messo la spunta
22. Il nuovo token è creato
23. Clicca su Autorizzazioni API
24. Clicca su Panoramica
25. Clicca su Endpoint
Conserva ID Applicazione (client), insieme a Client Secret (link). Questi valori saranno utilizzati su OCC per la creazione delle credenziali applicazione.
OCC
Una volta configurata la tua WebApp di Azure, è importante tenere a portata di mano sia il Client ID che il Client Secret. Potrai quindi accedere ad OCC per creare una nuova rubrica interna dove andrai a sincronizzare i contatti telefonici di Microsoft Teams abilitando la presence su TVox. Ricorda che sarà necessario associare la rubrica almeno a un servizio o a un utente per garantire che venga importata al momento della prima schedulazione.
L’integrazione completa prevede un trunk verso Microsoft Teams per permettere agli operatori di interagire telefonicamente.
Per la corretta configurazione del trunk, ti invito a consultare l’apposita sezione nella guida: https://tdoc.teleniasoftware.com/it/24/projects/Microsoft/MSTeams/FunzioniIntegrazione.html
1. Su OCC, cerca la sezione “Account esterni”
2. Clicca su Account esterni
3. Accedi alla tab “Credenziali applicazione”
4. Clicca su Nuovo
5. Seleziona il servizio di autenticazione Microsoft
6. Compila Nome / Client ID e Client secret
Assegna un nome identificativo alle tue credenziali applicative. Il Client ID e il Client secret sono quelli che hai precedentemente conservato durante la creazione della WebApp su Azure. L’Url di callback sarà automaticamente proposto da TVox.
Salva le nuove credenziali una volta che hai compilato tutti i campi necessari.
7. Spostati nella Tab “Account esterni”
8. Clicca su Nuovo
9. Crea un Nuovo account
Compila come segue:
Servizio di autenticazione: Microsoft
Nome: un nome per te significativo
Credenziali applicazione: le credenziali create precedentemente
10. Imposta lo Scopo
Assicurati di impostare lo Scopo con il valore T4YOU/BLF, attivando il flag su entrambi i valori (BLF e T4YOU)
Una volta completato, conferma il nuovo account esterno.
11. Esegui l’autenticazione con l’account esterno
A questo punto, procedi con l’autenticazione su Microsoft utilizzando un utente licenziato Microsoft Office 365 standard.
12. Accedi alla sezione “Rubriche”
13. Clicca su Nuovo
14. Associa i servizi alla nuova rubrica interna
15. Configura una Nuova sorgente MICROSOFT OFFICE 365
16. Assegna un nome alla nuova sorgente
17. Associa un Account Microsoft da utilizzare per recuperare i contatti *
18. Seleziona l’account esterno precedentemente creato
19. Configura la nuova sorgente
Compila come segue:
Nome della sorgente: assegna un nome significativo per identificarla
Account Microsoft: utilizza l’account esterno creato precedentemente
Gruppi di contatti scaricabili…: Contatti
20. Nella Tab “Presence” configura MSTEAMS
21. Seleziona l’account esterno precedentemente creato
Client
A questo punto, sei pronto per consultare la tua nuova rubrica interna Teams direttamente da TVox WebClient.
Gli stati di “presence” rappresentati su TVox per Teams sono i seguenti:
🟢 Libero
🔴 Occupato
⛔ DND (Do Not Disturb)
🟠 Torno subito
🟠 Risulta Assente
✖️ Risulta offline