Collega deskbird con Google Workspace per sincronizzare la disponibilità e le prenotazioni delle sale riunioni tra deskbird e il tuo Google Calendar. Una volta collegato, gli utenti possono prenotare le sale direttamente in deskbird mentre tutte le prenotazioni restano sincronizzate con i calendari delle sale di Google.
- Prerequisiti
- Consenti l'app deskbird in Google Admin
- Configura la delega a livello di dominio in Google Admin
- Collega Google in deskbird
- Importa sale riunioni
- Prenotazione sale riunioni cross-tenant
- Domande frequenti
1. Prerequisiti
- Diritti di amministratore: ti serve un account Google Workspace con ruolo di Super Admin.
- Usa un browser: completa la configurazione da un browser web.
- Il provider del calendario è la fonte ufficiale: le prenotazioni delle sale vengono accettate o rifiutate dal calendario risorsa della sala in Google. Se Google rifiuta una prenotazione, verrà rimossa da deskbird.
2. Consenti l'app deskbird in Google Admin
Se la tua organizzazione limita l'accesso di terze parti ai servizi Google, Google blocca l'accesso a deskbird prima che possa richiedere dati del calendario. Per evitare questo, aggiungi il client OAuth di deskbird in Controllo accesso app e contrassegnalo come Trusted (Attendibile).
- Apri la console di amministrazione Google e vai su Sicurezza > Controllo accesso e dati > Controlli API. Puoi anche usare questo link diretto: https://admin.google.com/ac/owl/list?tab=configuredApps
- In Controllo accesso app, clicca su Gestisci accesso app di terze parti.
- Nell'elenco App configurate, clicca su Configura nuova app.
- Seleziona Nome app OAuth o ID client.
- Incolla l'ID client OAuth di deskbird e clicca su Cerca:
929555102891-2emfk9l7f3v6kafmlbo4k88ipj276r4r.apps.googleusercontent.com- Passa con il mouse sull'app deskbird nei risultati e clicca su Seleziona.
- Spunta la casella per l'ID client di deskbird e clicca su Seleziona.
- Definisci l'ambito della configurazione: applicala a tutta l'organizzazione o solo alle unità organizzative i cui utenti useranno deskbird.
- Seleziona
Trustede clicca su Configura.
Dopo la configurazione, deskbird apparirà nell'elenco App configurate con tipo Web, l'ID client sopra indicato e l'ambito di accesso che hai selezionato.
💡 Google offre tre livelli di accesso. Trusted permette a un'app di richiedere qualsiasi servizio Google, inclusi quelli con restrizioni. Limited consente solo servizi non soggetti a restrizioni, mentre Blocked nega completamente l'accesso. deskbird richiede Trusted perché la sincronizzazione delle sale usa ambiti Calendar e Directory con restrizioni.
⚠️ Importante: l'ID client usato qui non è lo stesso che viene usato per la delega a livello di dominio nella sezione successiva. Entrambi i passaggi sono necessari e ognuno usa il proprio ID.
💡 Configurare l'app richiede il privilegio di amministratore Impostazioni servizio, incluso nel ruolo di Super Admin. L'elenco App a cui si è avuto accesso si aggiorna 24–48 ore dopo che un token è stato concesso o revocato, quindi le modifiche recenti potrebbero non essere subito visibili.
3. Configura la delega a livello di dominio in Google Admin
- Apri la console di amministrazione Google (Super Admin richiesto).
- Vai su Sicurezza > Controllo accesso e dati > Controlli API.
- In Delega a livello di dominio, clicca su Gestisci delega a livello di dominio.
- Clicca su Aggiungi nuovo.
- Inserisci ID client: 108092835268664080778
- In OAuth Scopes, aggiungi i seguenti ambiti e clicca su Autorizza:
https://www.googleapis.com/auth/admin.directory.resource.calendar.readonly
https://www.googleapis.com/auth/admin.directory.user.readonly
https://www.googleapis.com/auth/userinfo.email
https://www.googleapis.com/auth/calendar.events4. Collega Google in deskbird
- Vai su Admin > Integrazioni.
- Clicca su Collega (o Aggiorna sincronizzazione se hai già una connessione).
- Seleziona Google.
- Accedi con il tuo account Google admin.
- Dai il consenso a tutti i permessi richiesti e segui i passaggi a schermo.
5. Importa sale riunioni
Dopo aver collegato Google Workspace, puoi importare le tue sale in deskbird:
- Vai su Admin > Piani e spazi.
- Clicca su + Aggiungi area e seleziona sala riunioni.
- Scegli Importa sala da Microsoft o Google.
- Seleziona le sale dal tenant collegato e importale.
⚠️ Importante: perché le sale compaiano nell'elenco di importazione, devono essere configurate come risorsa in Google Workspace e usare la categoria CONFERENCE_ROOM.
💡 Una volta importate le sale, puoi creare link per videoconferenze quando prenoti sale riunioni in deskbird (a seconda della configurazione del provider).
💡 La ricerca rispetta esattamente il nome della sala (inclusi ortografia e punteggiatura). Inserisci il nome della sala come appare nella directory del provider.
6. Prenotazione sale riunioni cross-tenant
In un ambiente Google multi-tenant, spesso le policy di sicurezza impediscono agli utenti di un tenant di prenotare risorse (come le sale riunioni) direttamente in un altro tenant. deskbird risolve questo problema offrendo un livello di prenotazione unificato che funziona su tutti i tuoi tenant.
💡 La multi-tenancy è disponibile con il Rooms Plus plan. Puoi aggiungere più tenant Google e Microsoft. Per aggiungere un altro tenant, vai su Admin > Integrazioni, apri la sincronizzazione esistente e clicca su Aggiorna sincronizzazione.
Come funziona
- Visibilità unificata: tutti gli utenti, indipendentemente dal tenant di appartenenza, possono vedere la disponibilità in tempo reale di ogni sala riunioni in tutta l'organizzazione.
-
Logica di prenotazione di fallback: se un utente non ha il permesso diretto di prenotare una sala specifica, deskbird usa un meccanismo di fallback. Utilizza l'
admin_emailcollegata a quella risorsa calendario per facilitare la prenotazione. - Trasparente per gli utenti: le prenotazioni vengono elaborate istantaneamente in backend. Gli utenti devono solo selezionare una sala e confermare — deskbird gestisce la sincronizzazione cross-tenant in modo trasparente.
Vantaggi principali
- Nessuna configurazione complessa: elimina la necessità di configurazioni cross-domain complesse o gestione di account ospite per ogni utente.
- Unica fonte ufficiale: previene le doppie prenotazioni assicurando che tutti i tenant leggano gli stessi dati di calendario in tempo reale.
- Nessun intervento IT richiesto: gli utenti possono prenotare sale su qualsiasi tenant collegato senza bisogno dell'intervento dell'IT.
7. Domande frequenti
In Google Calendar, gli stati di pianificazione appaiono come voci di luogo di lavoro per Ufficio e Lavoro da mobile. Assente e qualsiasi stato personalizzato vengono mostrati come eventi per l'intera giornata. Per maggiori dettagli, vedi Sincronizza i calendari con gli stati di pianificazione.
Questo errore proviene da Google, non da deskbird: una policy della console di amministrazione sta bloccando la richiesta di accesso. Controlla quanto segue:
- L'ID client OAuth di deskbird è configurato come
Trustedin Sicurezza > Controllo accesso e dati > Controlli API > Controllo accesso app. - La configurazione copre l'unità organizzativa a cui appartengono gli utenti interessati. Gli utenti spostati in un'altra unità organizzativa potrebbero perdere l'accesso.
- L'accesso API di terze parti non è bloccato globalmente in Controlli API > Impostazioni > App di terze parti non configurate.
Hanno scopi diversi. L'ID che termina con .apps.googleusercontent.com è l'ID client OAuth usato per autorizzare l'app deskbird in Controllo accesso app. L'ID numerico è l'ID client del service account usato per autorizzare gli ambiti richiesti in Delega a livello di dominio. Entrambe le configurazioni sono necessarie per la sincronizzazione delle sale riunioni.
Assicurati che la sala sia configurata come risorsa in Google Workspace e usi la categoria CONFERENCE_ROOM. Controlla anche che la delega a livello di dominio sia stata configurata correttamente e che tutti gli ambiti richiesti siano stati autorizzati.
Sì. Google è la fonte ufficiale per l'accettazione delle sale. Se il calendario della sala rifiuta una richiesta di prenotazione, la prenotazione non resterà in deskbird.