Introduzione
Per chi utilizza Microsoft Teams per la collaborazione e la formazione online, Docebo può integrarsi con questo strumento, in modo che gli utenti possano accedere delle sessioni di collaborazione o di formazione online direttamente dai corsi webinar della piattaforma.
È necessario essere in possesso di un account Microsoft Teams attivo (non un account trial) e approvare i termini e le condizioni del contratto per configurare correttamente questa integrazione.
Attivare la App Microsoft Teams in Docebo
Attivare la app Microsoft Teams come descritto nell'articolo della Knowledge Base dedicato alla gestione di applicazioni e funzionalità. La app si trova nella tab Videoconferenza.
Creare e Configurare la App di Docebo in Microsoft Teams
Per configurare Docebo in Microsoft Teams, connettersi a Microsoft Azure e cliccare App Registration nell’area Azure Services. Se questa opzione non è nell’elenco, cercarla nella ricerca globale del portale. Ciccare New Registration e definire il nome dell’app.
Spostarsi ora alla piattaforma Docebo per creare il proprio account di Microsoft Teams. Connettersi come Superadmin e accedere al Menu Amministrazione dall’icona ingranaggio. Identificare la sezione Microsoft Teams e selezionare Gestione. Nella pagina di configurazione, cliccare Nuovo Account in alto a destra.
Copiare l’URL di reindirizzamento Oauth Microsoft Teams visualizzato nella parte superiore del pannello e incollarlo nel campo Redirect URI (optional) nella procedura di creazione dell’account in Microsoft Teams e cliccare Register per completare la creazione dell’app.
Attenzione: Il Redirect URI è definito in base al dominio a cui si connette l'utente. Quando si utilizza la app Dominio Personalizzato, assicurarsi di utilizzare l'URL del dominio personalizzato e non l'URL https://[platform name].docebosaas.com/
Microsoft Azure creerà una pagina per la nuova app. L’Application (client) ID e il Directory (tenant) ID visualizzati nell’area Essentials della pagina sono necessari per la creazione dell’account Microsoft Teams in Docebo. Spostarsi alla tab Certificates & Secrets del menu Manage nel menu di sinistra della pagina per generare il Client Secret, necessario per la creazione dell’account di Microsoft Teams in Docebo.
Copiare il Client ID in un posto sicuro, non sarà più visibile dopo aver lasciato la pagina.
Spostarsi alla tab API Permissions e cliccare Add Permissions, e quindi Microsoft Graph nell’elenco Commonly used Microsoft APIs. Cliccare l’opzione Delegated Permissions e selezionare:
- l’opzione
offline_access
nel menu OpenID - l'opzione
read.user
nel menu OpenID - l’opzione
OnlineMeetings.ReadWrite
nel menu OnlineMeetings - l'opzine
OnlineMeetings.ReadWrite
nel menu OnlineMeetings
Se l'opzione Mostra il calendario di meeting dell'istruttore è attiva per l'account Microsoft Teams, è necessario attivare anche il permesso che segue in Azure:
Calendars.ReadWrite
Cliccare Add Permissions.
Una volta aggiunti i permessi, premere Grant admin consent for Docebo in cima alla tabella, e rispondere Yes al pop-up che si aprirà.
Utilizzando lo stesso account usato per accedere a Microsoft Azure per registrare l'applicazione, aprire Outlook e condividere il calendario con Persone della mia organizzazione con privilegi di modifica.
Tornare ora a Docebo per completare e attivare l’integrazione.
Configurare Microsoft Teams in Docebo
Tornare alla piattaforma Docebo dove è iniziata la creazione dell’account di Microsoft Teams. Nel pannello di destra, digitare il nome e la descrizione dell’account, quindi incollare il Client ID, il Tenant ID e il Client Secret generati per la app creata in Microsoft Azure. Selezionare il tipo di sessione, Meeting o Event in base al tipo di eventi che saranno gestiti dall’account che si sta creando. È possibile creare e gestire più account Docebo con lo stesso account di Microsoft Teams, creando più app in Microsoft Teams.
Definire il numero massimo di sessioni per corso (fino a 999), il numero massimo di sessioni gestibili dall’account e il numero massimo di room attive contemporaneamente. Il numero massimo di room attive contemporaneamente è quello concordato nella propria licenza Microsoft Teams.
Premere Crea per terminare. Si sarà reindirizzati a Microsoft Teams per l'associazione dell'account con l'app. Una volta associato l’account, è possibile configurare sessioni webinar per corsi ILT.
Gestire gli Account Microsoft Teams in Docebo
È possibile eseguire nuovamente l'associazione fra l’account di Microsoft Teams creato in Docebo con l’account di Microsoft Teams. Connettersi in Docebo con l’utente che ha configurato l’account da associare, quindi accedere alla pagina di gestione di Microsoft Teams dal Menu Amministrazione, identificare l’account nell’elenco degli account disponibili, cliccare sul menu ellipsis in fondo alla riga dell’account e selezionare Associa. Questa operazione potrebbe richiedere alcuni secondi.
È possibile modificare i dettagli dell’account in qualsiasi momento, cliccando sul menu ellipsis in fondo alla riga dell’account, e selezionando Modifica. Per eliminare l’account, selezionare Elimina sempre dal menu ellipsis.
Quando si modificano il Client ID, il Tenant ID e il Client Secret dell’account, è necessario sincronizzarlo nuovamente con Microsoft Teams selezionando l’opzione Associa e salvando le modifiche.
Attenzione: ogni volta che si modificano i permessi, è necessario generare un nuovo secret in Azure, reinserirlo in piattaforma e associare nuovamente l'applicazione.
Riassociare Docebo per Microsoft Teams con Azure
Questo capitolo è una guida per gli utenti che utilizzano questa integrazione da prima del 23 febbraio 2022. Quanto descritto in questo capitolo deve essere eseguito solo dopo l'aggiornamento di Docebo per Microsoft team incluso nel rilascio mensile di febbraio 2022. È obbligatorio riassociare la propria istanza il prima possibile dopo il rilascio di febbraio, la mancata riassociazione potrebbe causare problemi durante l'utilizzo di Docebo per Microsoft Teams.
Il rilascio del 23 febbraio 2022 include delle migliorie all'integrazione di Docebo per Microsoft Teams. Con questo aggiornamento sarà possibile aggiungere gli istruttori ai corsi ILT (Instructor-Led Training) di tipo webinar senza che sia necessario che questi abbiano i privilegi di amministratori in Microsoft Azure, minimizzando i potenziali rischi all'infrastruttura. Affinché questo aggiornamento sia effettivo, è necessario riassociare la propria integrazione di Docebo per Microsoft Teams con Azure in base alle istruzioni che seguono.
Preparazione
Aprire Microsoft Azure nel proprio browser e connettersi al pannello Amministratore utilizzando le credenziali di Microsoft, quindi aprire un'altra tab o un'altra finestra senza chiudere la tab o la finestra di Azure, e accedere al Menu Amministrazione dall'icona ingranaggio in alto a destra, quindi cliccare Gestione nell'area Microsoft Teams nella propria piattaforma.
Per semplificare, in queste istruzioni faremo riferimento alla tab Microsoft Azure come "tab Azure" e alla tab di Docebo per Microsoft Teams come "tab Docebo".
Processo di Associazione
Nella tab Azure, accedere alla tab Overview e copiare l'Application (client) ID.
Accedere ora alla tab API Permissions. Cliccare il menu ellipsis nella riga Microsoft Graph e selezionare Revoke All Admin Consents. Cliccare quindi Yes remove nella finestra pop-up.
Sempre dalla tab Azure, accedere alla tab Certificates and Secrets e cliccare New Client Secret. Nel pannello a scomparsa, definire una descrizione e modificare il periodo di validità nel menu a tendina definendolo a 24 mesi, quindi premere Add. Il nuovo codice Client Secret sarà visualizzato vicino alla descrizione appena inserita. Copiare il codice.
Passare alla tab Docebo, cliccare il menu ellipsis vicino all'account che si desidera riassociare e selezionare Modifica. Incollare il nuovo Client Secret nel campo Client Secret e premere Conferma. La piattaforma eseguirà un'associazione automatica con il server di Microsoft, confermata da un messaggio di successo.
Per qualsiasi domanda, contattare il Servizio Clienti di Docebo dall'Help Center.
Note Importanti
- Gli istruttori che lanciano un nuovo webinar devono assicurarsi di essere connessi all'istanza di Microsoft Teams associata alla app Docebo per Microsoft Teams. Se non utilizzano l'account corretto, o se non sono connessi non parteciperanno al webinar come istruttori, ma come partecipanti.
- Affinché un utente Docebo possa partecipare a un webinar come istruttore in Microsoft Teams, l'account deve essere associato a un account individuale in Azure. L'Istruttore della sessione sarà definito dall'account MS Teams basato su Azure e l'account MS Teams creato in Docebo verrà utilizzato per avviare la sessione. Questo non si applica agli utenti che desiderano partecipare a un webinar come studenti.
- L’integrazione è disponibile per Microsoft Teams SaaS, non supporta implementazioni on-premise.
- Solo l'account associato all'integrazione Docebo - Microsoft Teams può essere l'organizzatore di un evento.
- È possibile utilizzare le breakout room nell'applicazione di Microsoft Teams. Non sono supportate nell'integrazione se utilizzate in Webview.
- I diritti di relatore vengono assegnati dall'istruttore che avvia la riunione.
- Scopri di più sugli strumenti webinar per i corsi ILT dai dispositivi mobili.
- Per utilizzare le API di Microsoft Teams in Docebo, è necessario disporre di una licenza di Office 365 (la licenza deve essere come minimo Office 365 Basic) per l'utente Azure che che sarà associato alla piattaforma Docebo. Maggiori informazioni sul sito Microsoft.