> 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 del calendario Zoom ### Servizio di Calendario Web Il Servizio di Calendario Web è il cuore della capacità di Zoom di fornire informazioni di calendario a tutte le Zoom Apps. #### Quali informazioni memorizza Zoom? ### App desktop e mobili #### Le Zoom Apps memorizzano dati di calendario o di contatto? Le Zoom Apps conservano le informazioni di calendario nella memoria temporanea (RAM) e non persistono alcun elemento sul disco locale. Ciò include token di autenticazione, credenziali, informazioni sugli eventi del calendario e dati di contatto. Questi dati non sono più Disponibile una volta che il client Zoom si chiude. #### Cosa succede al momento dell'accesso? Le Zoom Apps avviano un aggiornamento completo a ogni accesso per raccogliere l'elenco dei prossimi eventi. Ciò comporta la ricezione del proprio token OAuth di Access o delle credenziali memorizzate dal Servizio Web Calendario di Zoom e quindi l'uso di tale oggetto per aggiornare i dati degli eventi direttamente dal provider di calendario. Se il token di Access non è valido, il Servizio Web Calendario di Zoom utilizzerà il token di aggiornamento per richiedere e passare un nuovo token di Access al client Zoom. #### Come fa il client a sapere quando aggiornare il proprio elenco di prossimi eventi? Il Servizio Web Calendario di Zoom si iscrive a un webhook del provider di calendario per ciascun utente dopo che il calendario è stato connesso nel portale web. Questi webhook notificano al Servizio di Calendario Web eventuali modifiche, così può poi notificare al client Zoom che è necessario un aggiornamento. Infine, il client Zoom richiederà un aggiornamento direttamente al provider di 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 per il client? Le app Zoom mostrano i dati della riunione dopo aver sanificato gli eventi che analizza, il che significa che ha scartato tutti gli attributi che non utilizza. Gli attributi dell'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 | | #### Sono memorizzati dati di calendario nei registri del client? Le Zoom Apps non stamperanno dati sensibili del calendario, come token, credenziali o eventi, in alcun log del client. ### Strumenti di pianificazione Zoom offre una varietà di strumenti per semplificare l'esperienza di pianificazione delle riunione con i prodotti Microsoft e Google. Questi prodotti includono integrazioni di pianificazione native per Google area di lavoro e Microsoft 365, oppure estensioni software da usare con browser Seleziona e Outlook. #### Come funzionano gli strumenti di pianificazione? Tutti gli strumenti di pianificazione, ad eccezione del Plug-in di Outlook, inviano direttamente richieste API sia al provider di calendari sia al servizio di calendaring web di Zoom. Il Plug-in di Outlook è diverso in quanto pianifica una riunione tramite il Client Zoom Desktop, che invia la richiesta API al servizio di calendaring web di Zoom per conto del plug-in. #### Quali informazioni vengono inviate a Zoom quando si pianifica con uno strumento? Gli unici 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é utilizza dettagli aggiuntivi come il corpo o l'elenco dei partecipanti. #### Ci sono requisiti di firewall o di 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 riunioni Zoom tramite il loro client Outlook. Il plugin comunica con il Client Zoom Desktop di Zoom Workplace tramite un canale di comunicazione interprocesso (IPC). Usando questo IPC, il plugin invia le pianificazioni al servizio di calendaring web 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 l'implementazione e l'utilizzo del componente aggiuntivo Zoom per Outlook. Il componente aggiuntivo offre una distribuzione più semplice e soluzioni di gestione amministrativa più solide, è attivamente supportato da Microsoft e soddisfa meglio i requisiti di sicurezza recentemente rafforzati da fornitori come Apple. {% hint style="danger" %} **Avviso** I miglioramenti della nuova Funzionalità non saranno implementati per il Plug-in di Zoom per Outlook. Si consiglia vivamente di eseguire la migrazione a Zoom per Outlook come componente aggiuntivo. {% endhint %} Il componente aggiungi di Outlook è una applicazione basata sul web che non richiede l'installazione locale sulle macchine dell'utente e invece appare come una app web integrata, Disponibile sia nel client locale sia in Outlook sul web. Il componente aggiungi 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 è affatto Disponibile per Exchange Server locale — sia Disponibile. Questo significa: * Il componente Aggiungi-in di Outlook non può essere usato per la pianificazione delegata con Exchange Server locale. * I delegati devono utilizzare il client Microsoft 365 Outlook, Outlook 2021 o versioni successive per Mac/PC, oppure Outlook sul Web per Pianificare riunioni per conto di un altro utente. #### Come posso identificare l'applicazione ufficiale del componente aggiuntivo Zoom? L'applicazione ufficiale Zoom per Outlook disponibile da [store 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” 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 nidificata (NAA). Gli amministratori Zoom, in collaborazione con gli amministratori Entra, devono Configura NAA all'interno del Zoom web portal seguendo le istruzioni nell'articolo di Assistenza [Configurazione dell'autenticazione dell'app annidata 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 annidata dell'app (NAA) è supportata solo con Exchange Online. Le organizzazioni che usano Exchange 2019 (o altre versioni on-premises di Exchange) dovranno continuare a utilizzare i token legacy di identità utente di Exchange e i token di callback, poiché questi non sono bloccati negli ambienti on-premises. {% endhint %} In caso contrario, Zoom per Outlook è un'applicazione basata sul web che non richiede l'installazione locale sui computer degli utenti e appare invece 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 per Windows e macOS, le app Outlook per Android e iOS e Outlook sul web. Il componente aggiuntivo può essere configurato e distribuito in massa dagli amministratori di Outlook oppure installato dai singoli utenti. Il Plug-in di Outlook funziona come un software installato, soggetto a occasionali aggiornamenti e miglioramenti. Di conseguenza, il Plugin richiede una gestione delle versioni e aggiornamenti nel tempo. {% hint style="info" %} **Nota** L'autenticazione dell'app annidata 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 facilmente Abilita tutti gli utenti per Pianificare Zoom Meetings tramite Google Calendar installando l'app Zoom for GSuite dal Google Workspace Marketplace. L'app è gestita in modo centralizzato e si aggiorna automaticamente man mano che Zoom invia miglioramenti a Google. In alternativa, le estensioni basate su browser sono anch’esse 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 utilizzi le versioni desktop, web o mobili 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 sincronizzazione bidirezionale del calendario garantisce aggiornamenti del calendario senza interruzioni ed è abilitata per impostazione predefinita 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 rilevate, soprattutto 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 gestisce l'automazione basata sugli eventi come OnAppointmentSend, non è supportata dai seguenti ambienti e applicazioni: * 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 la sincronizzazione bidirezionale o l'automazione basata su API, anche le riunioni ricorrenti potrebbero non riflettere le modifiche, con conseguenti link Zoom scaduti o non validi. Il Plug-in Zoom Outlook è supportato solo sui sistemi Windows. Offre una sincronizzazione delle riunioni migliorata tramite l'integrazione diretta con l'app Zoom Workplace, aggirando i limiti dell'API di Microsoft. Sebbene sia consigliato per i sistemi Windows senza sincronizzazione bidirezionale, presenta notevoli limitazioni: * Richiede aggiornamenti MSI gestiti dall'IT * Pianificazione delle riunioni più lenta * Nessun supporto per macOS o dispositivi mobili ### Zoom Rooms L’Integrazioni di pianificazione di Zoom Rooms viene eseguita indipendentemente dall’Integrazioni del client desktop o mobile dell’utente. Dopo la configurazione, gli eventi del calendario vengono visualizzati sui display di Zoom Rooms, inclusi schermi televisivi, interfacce di pianificazione e pannelli di controllo. Gli utenti possono avviare o partecipare alle riunioni con un solo tocco sul controller della stanza. I seguenti passaggi sono una panoramica generale del processo di configurazione: 1. Configura Microsoft Exchange Online e aggiorna gli script PowerShell per le impostazioni della casella di posta di Zoom Rooms 2. Configura le autorizzazioni di Microsoft Graph API per Abilita l’Access ai dati del calendario Zoom consiglia Microsoft Graph API con Autorizzazioni dell’applicazione come metodo Standard di Integrazioni. 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 i calendari di Microsoft 365. {% hint style="info" %} **Nota** Le organizzazioni che utilizzano sistemi di sala conferenze di terze parti (come Cisco, Poly e Lifesize) devono completare passaggi aggiuntivi tramite lo Zoom Enhanced API Connettore per garantire il corretto funzionamento del calendario e delle riunioni. Per ulteriori informazioni sulla configurazione dell’Access alla pianificazione per Zoom Rooms, consulta il nostro documento M365 Calendaring Field Guide. {% endhint %} #### Quali metodi posso usare per concedere Access alle caselle di posta della sala? L’Integrazioni di pianificazione di Zoom Rooms si basa su Microsoft Graph API (MGAPI). Microsoft ha iniziato [l’eliminazione graduale dei metodi di 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 opzioni legacy. Google area di lavoro dispone solo di un singolo metodo per applicare le Autorizzazioni. #### Quali Autorizzazioni sono necessarie per l’account del servizio? L’Autorizzazione specifica varierà a seconda del metodo selezionato. Ogni opzione e le Autorizzazioni richieste sono dettagliate nella tabella seguente: | Fornitore | Metodo | Autorizzazioni richieste | | --------------------------------------- | ------------------------------------------------------ | ------------------------------------------------------------------------------- | | Microsoft 365/Microsoft Exchange Server | Autorizzazioni dell’applicazione (API Microsoft Graph) | Account amministratore: gestione dell'Organizzazione e gestione dei destinatari | | Microsoft 365/Microsoft Exchange Server | Accesso completo delegato (API Microsoft Graph) | Invia come Accesso completo | | Google area di lavoro | - | Apporta modifiche e gestisci la condivisione | {% hint style="info" %} **Raccomandazione di Zoom** Zoom consiglia che le integrazioni calendario utilizzino il metodo delle autorizzazioni dell'applicazione. Questa configurazione richiede meno impegno 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 L'integrazione del calendario per i sistemi di sala H.323 e SIP basati su standard tramite il Connettore API avanzato (rilasciato all'inizio del 2021) viene eseguita indipendentemente dal client utente e dalla configurazione di Zoom Rooms. La metodologia dell'account di servizio e le autorizzazioni sono identiche alla sezione Zoom Rooms trattata in precedenza. #### Cosa cambia nel flusso dei dati del Connettore API avanzato? I sistemi di sala connessi tramite il Connettore API avanzato non contatteranno direttamente i provider di calendario, il che differisce dai flussi di connessione di client Zoom e Zoom Rooms. Il servizio Web di Zoom funge da client per questi sistemi e invierà i dati del calendario direttamente agli endpoint, con un'eccezione per i dispositivi Poly. I dispositivi Poly eseguiranno prima una query al servizio Web di Zoom per gli aggiornamenti del calendario, che quindi trasmette i dati del calendario al dispositivo. #### Quanti giorni di eventi del calendario vengono recuperati? Il Connettore API avanzato recupera i dati delle riunione imminente per i prossimi 30 giorni e rimuove le riunioni completate dall'archivio 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: ``` GET https://library.zoom.com/technical-library/it/angolo-admin/third-party-integrations/zoom-calendaring-integration-explainer/zoom-calendaring-endpoints.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.