> For the complete documentation index, see [llms.txt](https://library.zoom.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://library.zoom.com/technical-library/it/angolo-admin/third-party-integrations/zoom-calendaring-integration-explainer/zoom-calendaring-endpoints.md). # Endpoint di Zoom Calendaring ### Servizio di calendario Web Il Servizio di calendario Web è il cuore della capacità di Zoom di fornire informazioni di calendario a tutte le app Zoom. #### Quali informazioni memorizza Zoom? Il Servizio di Calendaring Web di Zoom memorizza gli oggetti necessari per autenticare il provider di calendario di ciascun utente. Ciò significa che Zoom memorizza il refresh token quando le organizzazioni utilizzano OAuth per collegare Outlook o Google Calendar ai Servizi Zoom. Significa anche, per le organizzazioni che utilizzano l’autenticazione Basic in Exchange On-Premises, che Zoom memorizza l’account Nome utente e la password. | Eventi sincronizzati | | ----------------------------------- | | `partecipanti omessi` | | `descrizione` | | `nome visualizzato` (partecipante) | | `e-mail` (partecipante) | | `Sede di lavoro fissa` | | `iCalUID` | | `Posizione` | | `nome visualizzato` (organizzatore) | | `e-mail` (organizzatore) | | `riepilogo` | | `proposta di tempo` | | `Luogo di lavoro abilitato` | Quando la Sincronizza calendario bidirezionale è abilitata, Zoom non conserva i dati di eventi del calendario esterni (da Microsoft 365 o Google Calendar) nel proprio database.\ \ Invece, il servizio monitora una finestra mobile di 18 mesi di attività del calendario (fino a 6 mesi nel passato e 12 mesi nel futuro). Se si verificano modifiche all’interno di questa finestra, Zoom riceve notifiche di Modifica dal provider del calendario e recupera i dati aggiornati dell’evento su richiesta per elaborare gli aggiornamenti corrispondenti della riunione Zoom. Il servizio di riunione viene quindi informato per applicare le modifiche necessarie. Gli amministratori possono Configura questa Funzionalità a livello di account o di gruppo utente. Consulta il nostro [documentazione di assistenza](https://support.zoom.us/hc/en-us/articles/8522918261645-Enabling-bi-directional-calendar-sync) per ulteriori informazioni. #### Come sono protetti i token e le credenziali memorizzati? I token e le credenziali memorizzati sono crittografati a riposo tramite crittografia AES-GCM a 256 bit. Questi dati sono considerati contenuto del cliente e soggetti alle politiche e agli standard di controllo degli accessi di Zoom. Questi controlli sono valutati da società di audit indipendenti, come indicato nelle nostre certificazioni e attestazioni di sicurezza, come la SOC 2. L’Access privilegiato ai dati e ai sistemi dell’infrastruttura viene registrato, monitorato e controllato tramite autenticazione multifattoriale e controlli di Access con Privilegio minimo. #### Come è protetto il traffico tra le app e il provider del calendario? Le comunicazioni tra i provider di calendario e qualsiasi software Zoom — app desktop/mobile di Zoom, servizio calendario web di Zoom, strumenti di pianificazione e il Connettore API — sono crittografate in transito usando TLS 1.2. #### Per quanto tempo è valido un token OAuth? Zoom richiederà token di accesso che scadono dopo 1 ora e token di aggiornamento che scadono dopo 90 giorni, ma i provider di calendari potrebbero fornire token con limiti alternativi. Segui le istruzioni del tuo provider se devi modificare i valori predefiniti. #### Posso revocare un token OAuth o una credenziale? Gli amministratori di Zoom possono Scegli di rimuovere l'integrazione del calendario da un singolo account Zoom in qualsiasi momento, il che può bloccare il funzionamento del calendario dell'utente. Elimina immediatamente eventuali token o credenziali memorizzati per quell'utente. Gli amministratori di Microsoft 365 possono rimuovere l'accesso al calendario di Zoom da tutti gli account utente eliminando l'applicazione Zoom nel portale Applicazione Enterprise di Entra ID, mentre gli amministratori di Google Area di lavoro possono revocare l'accesso utilizzando la Console della piattaforma cloud Google. #### Posso limitare la capacità di Zoom di scrivere dati del calendario o del contatto a un provider? Dopo la configurazione iniziale, gli amministratori di Zoom possono Scegli tra le autorizzazioni di lettura e lettura/scrittura sia per il calendario sia per i contatti quando si effettua la Connessione tramite i metodi di Microsoft 365. Gli amministratori possono anche limitare le integrazioni di Google area di lavoro per i calendari utente. ### App desktop e mobile #### Le app Zoom memorizzano dati di calendario o di contatto? Le app Zoom conservano le informazioni di calendario nella memoria temporanea (RAM) e non salvano alcun elemento sul disco locale. Questo include token di autenticazione, credenziali, informazioni sugli eventi del calendario e dati di contatto. Questi dati non sono più disponibili una volta che il client esce. #### Cosa accade al momento dell'accesso? Le app Zoom avviano un aggiornamento completo a ogni accesso per raccogliere l'elenco dei prossimi eventi. Ciò comporta la ricezione del proprio token di accesso OAuth o delle credenziali archiviate dal Servizio di calendario Web Zoom e l'uso di quell'oggetto per aggiornare direttamente i dati degli eventi dal fornitore del calendario. Se il token di accesso non è valido, il Servizio di calendario Web Zoom utilizzerà il token di aggiornamento per richiedere e passare un nuovo token di accesso al client. #### Come fa il client a sapere di aggiornare il proprio elenco di eventi in arrivo? Il Servizio di calendario Web Zoom si iscrive a un webhook del fornitore del calendario per ogni utente dopo che il calendario è stato collegato nel portale Web. Questi webhook notificano il Servizio di calendario Web di eventuali modifiche, così può poi notificare al client Zoom che è necessario un aggiornamento. Infine, il client Zoom richiederà un aggiornamento direttamente al fornitore del calendario. Le app che non ricevono una notifica di aggiornamento aggiorneranno il proprio elenco di eventi ogni 30 minuti. #### Quali dettagli della riunione sono disponibili al cliente? Zoom Apps mostra i dati della riunione dopo aver ripulito gli eventi che analizza, il che significa che ha scartato tutti gli attributi che non usa. Gli attributi Evento salvati per l'uso e quelli scartati sono descritti nella tabella seguente. | Salvati per mostrare nel client | Scartati e non conservati | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ | | | | | \*Solo quando la cattura Evento basata su AI Companion 2.0 è abilitata | | #### Vengono memorizzati dati di calendario nei log del client? Zoom Apps non registreranno dati sensibili del calendario come token, credenziali o Evento in alcun log del client. ### Strumenti di pianificazione Zoom offre una varietà di strumenti per semplificare l'esperienza di pianificazione della riunione Zoom con i prodotti Microsoft e Google. Questi prodotti includono integrazioni native di pianificazione per Google area di lavoro e Microsoft 365, oppure estensioni software da usare con Seleziona browser e Outlook. #### Come funzionano gli strumenti di pianificazione? Tutti gli strumenti di pianificazione, tranne il Plug-in di Outlook, inviano direttamente richieste API sia al provider di calendaring sia al Servizio Web di Calendaring di Zoom. Il Plug-in di Outlook si distingue perché pianifica una riunione tramite il Client Zoom Desktop, che invia la richiesta API al Servizio Web di Calendaring di Zoom per conto del Plugin. #### Quali informazioni vengono inviate a Zoom quando si pianifica con uno strumento? I soli dati conservati quando si utilizza uno strumento di pianificazione sono le informazioni necessarie per pianificare una riunione. Ad esempio, quando un utente pianifica una riunione Zoom utilizzando il componente aggiuntivo di Microsoft 365, il componente aggiuntivo userà l'oggetto dell'Evento, la data, l'ora, il fuso orario e il flag di ricorrenza per pianificare la riunione Zoom. Il componente aggiuntivo di Zoom non richiede né usa dettagli aggiuntivi come il corpo o l'elenco dei partecipante. #### Ci sono requisiti di firewall o sicurezza? Gli strumenti di pianificazione non richiedono ulteriori modifiche al firewall o alla sicurezza oltre a quelle già necessarie per le integrazioni di calendaring. L'elenco completo dei requisiti è documentato in [regole di rete e firewall per Zoom](https://support.zoom.us/hc/en-us/articles/201362683-Network-firewall-or-proxy-server-settings-for-Zoom). #### Qual è la differenza tra il Plug-in di Outlook e il componente aggiuntivo di Outlook? Il Plug-in di Outlook è installato sul dispositivo di un utente finale e aiuta gli utenti a pianificare Zoom Meetings tramite il proprio client Outlook. Il Plugin comunica con il client desktop di Zoom Workplace tramite un canale di comunicazione interprocesso (IPC). Usando questo IPC, il Plugin invia pianificazioni al Servizio Web di Calendaring di Zoom tramite le risorse del client. Per offrire la migliore esperienza ai nostri utenti, nel rispetto delle policy e delle linee guida stabilite da Apple e Microsoft, Zoom raccomanda vivamente la distribuzione e l'utilizzo del componente aggiuntivo Zoom per Outlook. Il componente aggiuntivo offre una distribuzione più semplice e Soluzioni di gestione amministrativa più robuste, è supportato attivamente da Microsoft e soddisfa meglio i requisiti di sicurezza recentemente rafforzati di fornitori come Apple. {% hint style="danger" %} **Avvertimento** Nuovi miglioramenti delle funzionalità non verranno implementati per il Plugin di Zoom per Outlook. Si consiglia vivamente di migrare al componente aggiuntivo di Zoom per Outlook. {% endhint %} Il componente aggiuntivo di Outlook è un'applicazione basata sul web che non richiede l'installazione locale sulle macchine dell'utente e appare invece come una app web integrata, Disponibile sia nel client locale sia in Outlook sul web. Il componente aggiuntivo opera tramite API web che comunicano direttamente con il Calendaring Web Service di Zoom. Il Plugin e l’Aggiungi-in offrono funzionalità simili, ma l’Aggiungi-in richiede che il set di requisiti v1.8 dell’API JavaScript di Outlook — una versione che esiste solo nelle versioni moderne di Outlook e non è Disponibile per Exchange Server on-premises — sia Disponibile. Ciò significa: * Il componente Aggiungi-in di Outlook non può essere usato per la pianificazione delegata con Exchange Server locale. * I delegati devono usare il client Microsoft 365 Outlook, Outlook 2021 o successivo per Mac/PC, oppure Outlook sul Web per Pianificare riunioni per conto di un altro utente. #### Come posso identificare l'applicazione ufficiale Zoom Aggiungi-in? L'applicazione ufficiale Zoom per Outlook disponibile dal [negozio Microsoft AppSource](https://appsource.microsoft.com/en-us/product/office/WA104381712?tab=Overview) si installa nella directory delle app Enterprise di Entra ID con il nome “Zoom-Office-Aggiungi-in-SSO” e con l'ID applicazione ce63c970-e2d7-45e6-bee1-80c330b0800b. #### Devo aggiornare il Plug-in di Outlook o il componente aggiuntivo? A partire da gennaio 2025, Microsoft ha iniziato a sostituire i token legacy di Exchange Online con l’autenticazione app annidata (NAA). Gli amministratori di Zoom, in collaborazione con gli amministratori di Entra, devono Configura NAA all’interno del Zoom web portal seguendo le istruzioni nell’articolo di Assistenza [Configurazione dell'autenticazione delle app annidate per i componenti aggiuntivi di Office](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0078410). {% hint style="info" %} **Nota** L'autenticazione delle app annidate (NAA) è supportata solo con Exchange Online. Le organizzazioni che utilizzano Exchange 2019 (o altre versioni locali di Exchange) dovranno continuare a utilizzare i token di identità utente Exchange legacy e i token di callback, poiché non sono bloccati negli ambienti locali. {% endhint %} Altrimenti, il componente aggiuntivo Zoom per Outlook è un'applicazione basata sul web che non richiede l'installazione locale sulle macchine degli utenti e invece appare come un'applicazione web integrata che opera tramite API web per comunicare con il Servizio di calendaring web di Zoom. Il componente aggiuntivo è Disponibile per le app Outlook di Windows e macOS, le app Outlook di Android e iOS e Outlook sul web. Il componente aggiuntivo può essere configurato e distribuito in massa dagli amministratori di Outlook oppure installato da ciascun utente. Il Plug-in di Outlook funziona come un software installato, soggetto a occasionali aggiornamenti e miglioramenti. Di conseguenza, il Plugin richiede la gestione delle versioni e aggiornamenti nel tempo. {% hint style="info" %} **Nota** L'autenticazione dell'app nidificata non è richiesta per il Plug-in di Outlook. {% endhint %} #### Quale strumento di pianificazione è più adatto al mio ambiente? **Google area di lavoro** Le organizzazioni che utilizzano Google Workspace possono abilitare facilmente tutti gli utenti per Pianificare Zoom Meetings tramite Google Calendar installando l’app Zoom for GSuite da Google Workspace Marketplace. L’app è gestita in modo centralizzato e si aggiorna automaticamente mentre Zoom invia miglioramenti a Google. In alternativa, le estensioni basate su browser sono anche Disponibile per l'uso, ma sono generalmente più adatte agli utenti con account personali perché richiedono un'installazione locale, aggiornamenti periodici e non sono gestite centralmente. **Microsoft** Per le organizzazioni che utilizzano Microsoft 365 o Exchange Server on-premises, l'opzione migliore dipende sia dall'ambiente sia da come è configurata l'integrazione del calendario. Il componente aggiuntivo Zoom per Outlook è lo strumento preferito per gli ambienti Microsoft 365, sia che tu stia utilizzando le versioni desktop, web o mobile di Outlook. Il componente aggiuntivo richiede Outlook per Microsoft 365, Outlook 2013 o versioni successive per Windows, oppure Outlook 2016 o versioni successive per Mac. La Sincronizza bidirezionale del calendario garantisce aggiornamenti del calendario senza interruzioni ed è abilitata in modo predefinito quando si integrano i calendari. Ciò consente a Zoom di riflettere automaticamente le modifiche apportate agli eventi del calendario di Outlook—come orari riprogrammati o cancellazioni—senza richiedere agli utenti di aggiornare o rimuovere manualmente le riunioni tramite il componente aggiuntivo. Questo è particolarmente importante perché i link delle riunioni Zoom possono scadere se le modifiche non vengono acquisite, in particolare quando una riunione viene spostata di oltre 30 giorni rispetto alla data originale. Gli ID riunione in genere scadono dopo 30 giorni, a meno che non facciano parte di una serie ricorrente. La moderna API JavaScript (v1.8), che alimenta l'automazione basata su Evento come OnAppointmentSend, non è supportata dai seguenti ambienti e app: * Ambienti Exchange on-premises * Outlook classico connesso a M365 * Outlook mobile su iOS e Android Di conseguenza, Zoom non può rilevare o aggiornare automaticamente le riunioni tramite il componente aggiuntivo in queste configurazioni. Senza Sincronizza bidirezionale o automazione basata su API, anche le riunioni ricorrenti potrebbero non riflettere le modifiche, portando a link Zoom scaduti o non validi. Il Plug-in Zoom Outlook è supportato solo sui sistemi Windows. Offre una sincronizzazione avanzata delle riunioni tramite Integrazioni dirette con l'app Zoom Workplace, aggirando i limiti delle API Microsoft. Sebbene sia consigliato per i sistemi Windows senza Sincronizza bidirezionale, presenta alcuni vincoli notevoli: * Richiede aggiornamenti MSI gestiti dall'IT * Pianificazione delle riunioni più lenta * Nessuna Assistenza per macOS o dispositivi mobili ### Zoom Rooms L'integrazione del calendario di Zoom Rooms viene eseguita indipendentemente dalle Integrazioni del client desktop o mobile dell'utente. Dopo la configurazione, gli eventi del calendario vengono visualizzati sugli schermi di Zoom Rooms, inclusi schermi televisivi, interfacce di pianificazione e pannelli di controllo. Gli utenti possono avviare o partecipare alle riunioni a un solo tocco sul controller della stanza. #### Panoramica della configurazione Le Integrazioni di calendario di Zoom Rooms prevedono due livelli di configurazione distinti. Il primo livello è richiesto indipendentemente dal metodo di autenticazione che si Seleziona. **Livello 1: configurazione della cassetta postale delle risorse di Exchange (richiesta per tutti i metodi)** Prima di configurare l'autenticazione, gli amministratori devono configurare le cassette postali delle risorse di Exchange Online per ogni Zoom Room. Ciò include la configurazione della cassetta postale delle risorse in Exchange Online e l'aggiornamento delle regole di elaborazione del calendario tramite Exchange Online PowerShell. Per impostazione predefinito, Exchange Online imposta diverse proprietà di elaborazione del calendario su `True`, il che fa sì che Exchange rimuova i dettagli della riunione, quali l'oggetto, le informazioni sull'organizzatore e i commenti, dalle voci del calendario nelle cassette postali delle risorse. Zoom Rooms necessita che questi dettagli vengano preservati per mostrare informazioni Evento significative sugli schermi e sui controller delle stanze. Gli amministratori devono aggiornare le seguenti proprietà di elaborazione del calendario a `False` per ogni cassetta postale delle risorse di Zoom Room utilizzando il `Set-CalendarProcessing` cmdlet: * `DeleteSubject` * `AddOrganizerToSubject` * `DeleteComments` * `RemovePrivateProperty` Questa configurazione deve essere ripetuta per ogni cassetta postale della risorsa. Per la procedura completa di PowerShell, inclusi i passaggi di convalida, consulta l'articolo di Assistenza Zoom [Configurazione di Zoom Rooms con Office 365](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0063474\&DeviceId=70283b61-c13a-475f-ab4d-4a89b1632c1b\&SessionId=1782321876035).Questo livello è richiesto indipendentemente dal metodo di autenticazione che Seleziona in Livello 2. **Livello 2: selezione del metodo di autenticazione** Dopo aver configurato la cassetta postale della risorsa, gli amministratori Seleziona un metodo di autenticazione per Abilita l'accesso ai dati del calendario per Zoom Rooms: {% stepper %} {% step %} *Autorizzazioni dell'applicazione (Microsoft Graph API)* * **CONSIGLIATO**: Questo metodo utilizza il flusso delle credenziali del client OAuth 2.0 tramite un'iscrizione dell'app Azure con consenso dell'admin. Non richiede un account di servizio dedicato. {% endstep %} {% step %} *Access delegato completo (Microsoft Graph API)* * Questo metodo utilizza il flusso del codice di autorizzazione OAuth 2.0 con autorizzazioni delegate della casella di posta. Richiede un account di servizio dedicato e maggiore impegno per la configurazione iniziale e la manutenzione. {% endstep %} {% endstepper %} Zoom consiglia Microsoft Graph API con Autorizzazioni dell'applicazione come metodo di Integrazioni Standard. Questa raccomandazione è in linea con il piano di Microsoft di rimuovere i protocolli Exchange Web Services (EWS). Il metodo Graph API offre la connessione più stabile tra Zoom Rooms e il calendario di Microsoft 365. {% hint style="info" %} Le organizzazioni che utilizzano sistemi di sala conferenze di terze parti (come Cisco, Poly e Lifesize) devono completare passaggi aggiuntivi tramite il Connettore Zoom Enhanced API per garantire il corretto funzionamento del calendario e della riunione. Per ulteriori informazioni sulla configurazione dell'accesso al calendario per Zoom Rooms, consulta il nostro documento M365 Calendaring Field Guide. {% endhint %} #### Quali metodi posso usare per concedere Access alle caselle di posta delle sale? Le Integrazioni del calendario di Zoom Rooms si basano su Microsoft Graph API (MGAPI). Microsoft ha iniziato [la dismissione graduale dei metodi Exchange Web Services (EWS)](https://techcommunity.microsoft.com/blog/exchange/retirement-of-exchange-web-services-in-exchange-online/3924440) che in precedenza erano disponibili per connettere i dati di Microsoft 365 con i Servizi Zoom. Zoom considera questi metodi EWS come opzioni legacy. Google area di lavoro dispone di un solo metodo per l'applicazione delle Autorizzazione. #### Quali Autorizzazione sono richieste per l'account di servizio? La specifica Autorizzazione varia a seconda del metodo selezionato. Ogni opzione e le Autorizzazione richieste sono dettagliate nella tabella seguente: | Fornitore | Metodo | Autorizzazione richieste | | --------------------------------------- | ------------------------------------------------------ | ---------------------------------------------------------------------- | | Microsoft 365/Microsoft Exchange Server | Autorizzazioni dell'applicazione (Microsoft Graph API) | Account amministratore: Gestione Organizzazione e Gestione destinatari | | Microsoft 365/Microsoft Exchange Server | Access delegato completo (Microsoft Graph API) | Invia come Access completo | | Google area di lavoro | - | Apporta modifiche e gestisci la condivisione | {% hint style="info" %} **Raccomandazione di Zoom** Zoom consiglia che le Integrazioni del calendario utilizzino il metodo di Autorizzazione dell'applicazione. Questa configurazione richiede meno sforzo da parte dell'amministratore e non richiede un account di servizio dedicato. È anche l'approccio consigliato da Microsoft per le applicazioni Enterprise in esecuzione come servizi in background. {% endhint %} ### Connettore API avanzato Le Integrazioni del calendario per sistemi di sala H.323 e SIP basati su standard tramite il Connettore API avanzato (rilasciato all'inizio del 2021) viene eseguita indipendentemente dalla configurazione del client utente e di Zoom Rooms. La metodologia dell'account di servizio e le Autorizzazione sono identiche alla sezione di Zoom Rooms trattata in precedenza. #### Cosa c'è di diverso nel flusso dei dati del Connettore API avanzato? I sistemi di sala connessi tramite il Connettore API avanzato non contatteranno direttamente i provider del calendario, il che differisce dai flussi di connessione del client Zoom e di Zoom Rooms. Il Servizio Web Zoom funge da client per questi sistemi e invierà i dati del calendario direttamente agli endpoint, con un'eccezione per Dispositivo Poly. Dispositivo Poly interrogherà prima il Servizio Web Zoom per gli aggiornamenti del calendario, che poi trasmette i dati del calendario al Dispositivo. #### Quanti giorni di eventi del calendario vengono recuperati? Il Connettore API avanzato recupera i dati della riunione imminente per i prossimi 30 giorni e rimuove ogni riunione completata dall'archiviazione dopo 30 giorni. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://library.zoom.com/technical-library/it/angolo-admin/third-party-integrations/zoom-calendaring-integration-explainer/zoom-calendaring-endpoints.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.