🪟 Connessione Microsoft 365

Il connettore Microsoft 365 è un insieme di credenziali di terze parti che collega la tua piattaforma Voome al tuo tenant Microsoft Entra (Azure AD). Una volta configurato, Voome può leggere per tuo conto i calendari e le sale della tua organizzazione e, se vuoi, i contenuti di Power BI, SharePoint e OneDrive.

Configuri la connessione da un unico modulo in Voome (Settings → Platform → Third Party Credentials → aggiungi una connessione Microsoft 365). Il modulo è diviso in tre passaggi. Questa guida ti accompagna nella registrazione dell'app corrispondente in Azure e ti mostra dove inserire ogni valore in Voome.

Cosa puoi abilitare

Funzionalità	Passaggio in Voome	Permessi Microsoft coinvolti
Agenda Microsoft Sync	Step 1 (obbligatorio)	Calendario e sale di Microsoft Graph
Booking Microsoft Sync	Step 1 (obbligatorio)	Calendario e sale di Microsoft Graph
Power BI Dashboards	Step 2 (facoltativo, delegato)	Power BI Service
SharePoint	Step 2 (facoltativo, delegato)	Siti SharePoint
OneDrive Document Sync	Step 2 (facoltativo, delegato)	Microsoft Graph + utente delegato

Lo Step 1 è sempre obbligatorio

La sincronizzazione di calendario e prenotazioni dello Step 1 è la base della connessione. I campi delegati dello Step 2 si aggiungono allo Step 1, non lo sostituiscono mai.

Prima di iniziare

Ti servono:

• Un tenant Microsoft Entra (Azure AD).
• Un account con i permessi per registrare applicazioni e concedere il consenso amministratore in quel tenant (di solito un Global Administrator o un Application Administrator).
• Il modulo di connessione di Voome aperto, così da copiare da lì il Redirect URI e incollarvi i valori di Azure.

Direzione della relazione di trust

La registrazione dell'applicazione stabilisce una relazione di trust unidirezionale: la tua app si fida della Microsoft identity platform, non il contrario.

---

Parte 1: registra l'app in Microsoft Entra (Azure AD)

1. Registra l'applicazione

1. Accedi al portale di Azure.
2. Se hai accesso a più tenant, usa il filtro Directory + subscription nel menu in alto per selezionare il tenant in cui vuoi registrare l'app.
3. Cerca e seleziona Microsoft Entra ID (in precedenza Azure Active Directory).
4. In Manage, seleziona App registrations → New registration.
5. Inserisci un Name visualizzato, ad esempio Voome Connector.
6. Scegli chi può usare l'applicazione (il sign-in audience). Per una singola organizzazione, la scelta abituale è Accounts in this organizational directory only.
7. Per ora lascia vuoto il campo Redirect URI. Lo aggiungerai nel passaggio successivo.
8. Seleziona Register.

Dopo la registrazione, il pannello Overview mostra l'Application (client) ID e il Directory (tenant) ID. Li copierai entrambi in Voome più avanti.

2. Aggiungi il Redirect URI

1. In Voome, apri Step 1 · Connect to Microsoft e copia il Redirect URI. Ha questo aspetto:

   https://cms.voome.com/signin/ms/voome/

2. Nel portale di Azure, apri la tua app (Voome Connector) e in Manage seleziona Authentication.

3. Seleziona Add a platform → Web.

4. Incolla nel campo Redirect URIs il Redirect URI che hai copiato da Voome.

5. Seleziona Configure.

Copia l'URI dal modulo del tuo tenant

Copia sempre il Redirect URI dal modulo di Voome invece di digitarlo a mano. Così hai la garanzia che corrisponda esattamente, come Microsoft richiede perché l'accesso vada a buon fine.

3. Crea un client secret

Il client secret permette all'applicazione di autenticarsi da sola, senza alcuna interazione dell'utente durante l'esecuzione.

1. Nella tua app, seleziona Certificates & secrets → New client secret.
2. Aggiungi una description (ad esempio Voome).
3. Scegli una expiry. Scegli il periodo più lungo consentito dalla tua policy di sicurezza, perché alla scadenza del secret la connessione smette di funzionare.
4. Seleziona Add.
5. Copia subito il Value del secret.

Copia ora il Value del secret, non il Secret ID

Il Value del secret viene mostrato una sola volta e non può essere recuperato dopo che hai lasciato la pagina. Assicurati di copiare il Value e non il Secret ID: sono diversi, e a Voome serve il Value.

4. Configura i permessi API

1. Nella tua app, in Manage, seleziona API permissions → Add a permission.
2. Aggiungi i permessi qui sotto per le funzionalità che intendi usare, poi seleziona Add permissions per ciascun gruppo.

Obbligatori: Microsoft Graph (Delegated)

Fanno funzionare la sincronizzazione di Agenda e Booking e servono per ogni connessione.

• User.Read
• Calendars.ReadWrite
• Calendars.ReadWrite.Shared
• Place.Read.All
• email
• offline_access
• profile

Facoltativi: Office 365 Exchange Online (Delegated)

Aggiungili solo se devi sincronizzare i calendari di Exchange Online.

• Calendars.ReadWrite.All
• Calendars.ReadWrite.Shared

Facoltativi: Power BI Service (Delegated)

Aggiungili solo se vuoi incorporare contenuti Power BI.

• Dashboard.Read.All
• Report.Read.All

Facoltativi: SharePoint (Delegated)

Aggiungili solo se devi sincronizzare SharePoint.

• Sites.Read.All
• Sites.Read.Shared

5. Concedi il consenso amministratore

Torna alla pagina API permissions, seleziona Grant admin consent for <your tenant> e conferma. In questo modo concedi il consenso ai permessi configurati per conto dell'intera organizzazione, e ai singoli utenti non verrà chiesto in seguito.

suggerimento

Concedere il consenso amministratore è fortemente consigliato. Senza, i permessi delegati restano nello stato "not granted" e la connessione potrebbe non funzionare.

---

Parte 2: inserisci i valori in Voome

Torna al modulo Microsoft 365 Connection di Voome e compilalo.

Nome delle credenziali

Dai alla connessione un nome riconoscibile (ad esempio Contoso Microsoft 365). È solo un'etichetta all'interno di Voome.

Step 1 · Connect to Microsoft (sempre obbligatorio)

Questi valori provengono dalla registrazione dell'app che hai appena creato.

Campo	Dove trovarlo
Redirect URI	Già fornito da Voome. L'hai incollato in Azure nella Parte 1, passaggio 2.
Azure Tenant Id	Il Directory (tenant) ID nella pagina Overview dell'app. Usa il valore letterale organizations per il processo di delega utente.
Application Id (client_id)	L'Application (client) ID nella pagina Overview dell'app.
Application Secret (client_secret)	Il Value del secret da Certificates & secrets (non il Secret ID).

Step 2 · Delegated access (facoltativo)

Compila questa parte solo per le funzionalità che agiscono per conto di un utente: Power BI Dashboards, SharePoint e OneDrive Document Sync.

Campo	Descrizione
Delegated Access User	Il login dell'utente Microsoft per conto del quale agisce la connessione.
Delegated Access Password	La password di quell'utente.

Verifica la connessione Power BI

Per verificare che le credenziali delegate riescano a raggiungere Power BI, incolla un ID di dashboard o di report valido (nel formato XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX) nel campo Test Power BI connection e seleziona Test PowerBI.

Salva

Seleziona Save. La connessione è ora disponibile per le funzionalità di Voome che hai abilitato.

---

Risoluzione dei problemi

• L'accesso non riesce con un errore di reindirizzamento. Il Redirect URI in Azure non corrisponde esattamente a quello di Voome. Copialo di nuovo dal modulo di Voome e verifica che sia aggiunto sotto la piattaforma Web.
• I permessi risultano "not granted". Torna in API permissions e seleziona Grant admin consent.
• La connessione funzionava, poi ha smesso. Probabilmente il client secret è scaduto. Crea un nuovo secret in Certificates & secrets e incollane il Value in Voome.
• Il test di Power BI non riesce. Verifica che l'utente delegato dello Step 2 abbia accesso al report, che i permessi di Power BI Service siano stati aggiunti e che il consenso amministratore sia stato concesso.