# Eindpunten voor Zoom-agendering ### Web-agendaservice De Web-agendaservice vormt het hart van Zoom’s vermogen om agenderingsinformatie te leveren aan alle Zoom-apps. #### Welke informatie slaat Zoom op? ### Desktop- en mobiele apps #### Slaan de Zoom-apps agenda- of contactpersoongegevens op? Zoom-apps bewaren agenderingsinformatie in tijdelijk geheugen (RAM) en slaan geen items blijvend op de lokale schijf op. Dit omvat authenticatie tokens, inloggegevens, agenda Evenement-informatie en contactpersoongegevens. Deze gegevens zijn niet langer beschikbaar zodra de client wordt afgesloten. #### Wat gebeurt er bij het aanmelden? Zoom-apps starten bij elke aanmelding een volledige vernieuwing om de lijst met komende evenementen te verzamelen. Dit houdt in dat de OAuth-access token of opgeslagen inloggegevens worden ontvangen van de Zoom Web-agendaservice en dat dat object vervolgens wordt gebruikt om Evenement-gegevens rechtstreeks te vernieuwen vanaf de agenda-aanbieder. Als de access token ongeldig is, gebruikt de Zoom Web-agendaservice de refresh token om een nieuwe access token aan te vragen en door te geven aan de client. #### Hoe weet de client dat de lijst met komende evenementen moet worden vernieuwd? De Zoom Web-agendaservice abonneert zich op een agenda-aanbieder webhook voor elke gebruiker nadat de agenda is verbonden in het webportaal. Deze webhooks stellen de Web-agendaservice op de hoogte van eventuele wijzigingen, zodat deze vervolgens de Zoom-client kan informeren dat een update nodig is. Ten slotte zal de Zoom-client rechtstreeks vanaf de agenda-aanbieder een update aanvragen. Apps die geen updatemelding ontvangen, vernieuwen hun Evenement-lijst elke 30 minuten. #### Welke vergaderingsdetails zijn beschikbaar voor de klant? Zoom Apps weergeven vergaderingsgegevens nadat de Evenementen die het parseert zijn opgeschoond, wat betekent dat het alle attributen heeft verworpen die het niet gebruikt. De evenementattributen die worden opgeslagen voor gebruik en verworpen, worden in de onderstaande tabel uiteengezet. | Opgeslagen voor weergave in client | Verworpen en niet bewaard | | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------- | | | | | \*Alleen wanneer Evenement-opname mogelijk gemaakt door AI Companion 2.0 is ingeschakeld | | #### Worden er agenda-gegevens opgeslagen in clientlogboeken? Zoom apps zullen geen gevoelige agenda-gegevens zoals tokens, inloggegevens of Evenementen in clientlogboeken afdrukken. ### Planningstools Zoom biedt verschillende tools om de Planning-ervaring voor Zoom vergaderingen met Microsoft- en Google-producten te vereenvoudigen. Deze producten omvatten native Planning-integraties voor Google werkruimte en Microsoft 365, of software-extensies voor gebruik met Selecteer browsers en Outlook. #### Hoe werken de planningstools? Alle planningstools, met uitzondering van de Outlook-invoegtoepassing, dienen rechtstreeks API-verzoeken in bij zowel de agenda-provider als de Web Agenda-service van Zoom. De Outlook-invoegtoepassing is anders omdat deze een vergadering plant via de Zoom-desktopclient, die namens de invoegtoepassing het API-verzoek indient bij de Web Agenda-service van Zoom. #### Welke informatie wordt naar Zoom verzonden bij het plannen met een tool? De enige gegevens die worden bewaard bij gebruik van een planningstool, zijn informatie die nodig is om een vergadering te plannen. Wanneer een gebruiker bijvoorbeeld een Zoom-vergadering plant met de Microsoft 365-invoegtoepassing, gebruikt de invoegtoepassing het onderwerp van het evenement, de datum, de tijd, de tijdzone en de herhalingsvlag om de Zoom-vergadering te plannen. De Zoom-invoegtoepassing vraagt geen aanvullende details op en gebruikt deze ook niet, zoals de body of de deelnemerslijst. #### Zijn er firewall- of beveiligingsvereisten? De planningstools vereisen geen aanvullende firewall- of beveiligingswijzigingen bovenop wat al nodig is voor agenda-integraties. De volledige lijst met vereisten is gedocumenteerd in [netwerk- en firewallregels voor Zoom](https://support.zoom.us/hc/en-us/articles/201362683-Network-firewall-or-proxy-server-settings-for-Zoom). #### Wat is het verschil tussen de Outlook-invoegtoepassing en de Outlook-invoegtoepassing? De Outlook-invoegtoepassing wordt geïnstalleerd op de computer van een eindgebruiker en helpt gebruikers bij het plannen van Zoom Meetings via hun Outlook-client. De invoegtoepassing communiceert met de Zoom Workplace-desktopclient via een interprocescommunicatiekanaal (IPC). Met deze IPC stuurt de invoegtoepassing planningen naar de Web Agenda-service van Zoom via de resources van de client. Om de beste ervaring voor onze gebruikers te bieden en tegelijkertijd te voldoen aan het beleid en de richtlijnen van Apple en Microsoft, beveelt Zoom ten zeerste de implementatie en het gebruik van de Zoom voor Outlook-invoegtoepassing aan. De invoegtoepassing biedt u eenvoudigere implementatie en robuustere oplossingen voor administratief beheer, wordt actief ondersteund door Microsoft en voldoet beter aan de recent aangescherpte beveiligingsvereisten van leveranciers zoals Apple. {% hint style="danger" %} **Waarschuwing** Nieuwe functieverbeteringen zullen niet worden geïmplementeerd voor de Zoom voor Outlook-invoegtoepassing. Het wordt sterk aangeraden om over te stappen op de Zoom voor Outlook-invoegtoepassing. {% endhint %} De Outlook-invoegtoepassing is een webgebaseerde applicatie die geen lokale installatie op gebruikersmachines vereist en in plaats daarvan verschijnt als een ingebouwde webapp, beschikbaar in zowel de lokale client als Outlook op het web. De invoegtoepassing werkt via web-API’s die rechtstreeks communiceren met de Calendaring Web Service van Zoom. De Invoegtoepassing en de Toevoegen-in bieden vergelijkbare functionaliteit, maar de Toevoegen-in vereist dat de vereiste set v1.8 van de Outlook JavaScript API beschikbaar is — een versie die alleen bestaat in moderne versies van Outlook en helemaal niet beschikbaar is voor Exchange Server on-premises —. Dit betekent: * De Outlook Toevoegen-in kan niet worden gebruikt voor Planning door gemachtigden met on-premises Exchange Server. * Gedelegeerden moeten de Microsoft 365 Outlook-client, Outlook 2021 of nieuwer voor Mac/PC, of Outlook op het web gebruiken om vergaderingen namens een andere gebruiker te Planning. #### Hoe kan ik de officiële Zoom Toevoegen-in-applicatie identificeren? De officiële Zoom voor Outlook-applicatie beschikbaar via de [Microsoft AppSource-winkel](https://appsource.microsoft.com/en-us/product/office/WA104381712?tab=Overview) wordt geïnstalleerd in uw Entra ID Onderneming Apps-map onder de naam “Zoom-Office-Toevoegen-in-SSO” met de applicatie-ID ce63c970-e2d7-45e6-bee1-80c330b0800b. #### Moet ik de Outlook-invoegtoepassing of invoegtoepassing bijwerken? Met ingang van januari 2025 is Microsoft begonnen met het vervangen van verouderde Exchange Online-tokens door Nested app authenticatie (NAA). Zoom-beheerders moeten, in samenwerking met Entra-beheerders, NAA Configureer binnen het Zoom-webportal volgens de instructies in het ondersteuningsartikel [Geneste app-authenticatie configureren voor Office-invoegtoepassingen](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0078410). {% hint style="info" %} **Opmerking** Geneste app-authenticatie (NAA) wordt alleen ondersteund met Exchange Online. Organisaties die Exchange 2019 (of andere on-premises versies van Exchange) gebruiken, moeten doorgaan met het gebruik van verouderde Exchange-gebruikeridentiteitstokens en callbacktokens, omdat deze niet worden geblokkeerd in on-premises omgevingen. {% endhint %} Anders is de Zoom voor Outlook-invoegtoepassing een webgebaseerde applicatie die geen lokale installatie op gebruikersmachines vereist en in plaats daarvan verschijnt als een ingebouwde webapplicatie die via web-API's werkt om te communiceren met de Web Calendaring Service van Zoom. De invoegtoepassing is Beschikbaar voor Windows- en macOS-Outlook-apps, Android- en iOS-Outlook-apps en Outlook op het web. De invoegtoepassing kan worden geconfigureerd en op grote schaal worden uitgerold door Outlook-beheerders of worden geïnstalleerd door individuele gebruikers. De Outlook-invoegtoepassing werkt als een geïnstalleerd softwareonderdeel, dat onderhevig is aan incidentele updates en verbeteringen. Daarom vereist de Invoegtoepassing versiebeheer en upgrades in de loop van de tijd. {% hint style="info" %} **Opmerking** Nested app authenticatie is niet vereist voor de Outlook-invoegtoepassing. {% endhint %} #### Welke Planning-tool is het meest geschikt voor mijn omgeving? **Google werkruimte** Organisaties die Google werkruimte gebruiken, kunnen eenvoudig alle gebruikers Inschakelen om Zoom Meetings te plannen via Google Agenda door de Zoom for GSuite-app te installeren vanuit de Google werkruimte Marketplace. De app wordt centraal beheerd en automatisch bijgewerkt wanneer Zoom verbeteringen indient bij Google. Als alternatief zijn de op Browser gebaseerde extensies ook Beschikbaar voor gebruik, maar deze zijn over het algemeen meer geschikt voor gebruikers met een persoonlijk account omdat ze een lokale installatie, periodieke updates vereisen en niet centraal worden beheerd. **Microsoft** Voor organisaties die Microsoft 365 of Exchange Server on-premises gebruiken, hangt de beste optie af van zowel de omgeving als van hoe agenda-integratie is geconfigureerd. De Zoom voor Outlook-invoegtoepassing is de voorkeursoplossing voor Microsoft 365-omgevingen — of u nu de desktop-, web- of mobiele versies van Outlook gebruikt. De invoegtoepassing vereist Outlook voor Microsoft 365, Outlook 2013 of later voor Windows, of Outlook 2016 of later voor Mac. Bi-Directionele Agenda Synchroniseren zorgt voor naadloze agenda-updates en is Standaard ingeschakeld bij het integreren van agenda's. Hierdoor kan Zoom wijzigingen in Outlook-agenda-evenementen automatisch weergeven — zoals verplaatste tijden of annuleringen — zonder dat gebruikers vergaderingen handmatig hoeven bij te werken of te verwijderen via de invoegtoepassing. Dit is vooral belangrijk omdat Zoom-vergaderlinks kunnen verlopen als wijzigingen niet worden vastgelegd, vooral wanneer een vergadering meer dan 30 dagen na de oorspronkelijke datum wordt verplaatst. Vergaderings-ID's verlopen doorgaans na 30 dagen, tenzij ze deel uitmaken van een terugkerende reeks. De moderne JavaScript API (v1.8), die gebeurtenisgebaseerde automatisering zoals OnAppointmentSend aanstuurt, wordt niet ondersteund door de volgende omgevingen en toepassingen: * Exchange-omgevingen on-premises * Klassieke Outlook verbonden met M365 * Mobiele Outlook op iOS en Android Als gevolg hiervan kan Zoom in deze configuraties vergaderingen niet automatisch detecteren of bijwerken via de invoegtoepassing. Zonder Bi-Directionele Synchroniseren of op API gebaseerde automatisering kunnen zelfs terugkerende vergaderingen wijzigingen mogelijk niet weergeven — wat leidt tot verlopen of ongeldige Zoom-links. De Zoom Outlook-invoegtoepassing wordt alleen ondersteund op Windows-systemen. Deze biedt verbeterde vergadersynchronisatie via directe Integratie(s) met de Zoom Workplace app, waarbij beperkingen van Microsoft API worden omzeild. Hoewel deze wordt aanbevolen voor Windows-systemen zonder Bi-Directionele Synchroniseren, kent deze enkele duidelijke beperkingen: * Vereist door IT beheerde MSI-updates * Langzamere vergaderplanning * Geen ondersteuning voor macOS of mobiel ### Zoom Rooms Zoom Rooms-agendaintegratie wordt onafhankelijk van de desktop- of mobiele clientintegratie van de gebruiker uitgevoerd. Na de configuratie verschijnen agenda-evenementen op Zoom Rooms-schermen, waaronder televisieschermen, planningsinterfaces en bedieningspanelen. Gebruikers kunnen vergaderingen starten of deelnemen met Met één druk op de room-controller. De volgende stappen vormen een globaal overzicht van het configuratieproces: 1. Configureer Microsoft Exchange Online en werk PowerShell-scripts bij voor Zoom Rooms-postbusinstellingen 2. Stel Microsoft Graph API-machtigingen in om toegang tot agenda-gegevens Inschakelen Zoom raadt Microsoft Graph API met toepassingsmachtigingen aan als de standaard Integratie(s)-methode. Deze aanbeveling sluit aan bij Microsoft's plan om Exchange Web Services (EWS)-protocollen te verwijderen. De Graph API-methode biedt de meest stabiele verbinding tussen Zoom Rooms en Microsoft 365-agenda's. {% hint style="info" %} **Opmerking** Organisaties die systemen voor derden voor vergaderzaal gebruiken (zoals Cisco, Poly en Lifesize) moeten aanvullende stappen voltooien via de Zoom Enhanced API Connector om correcte agenda- en vergaderfuncties te garanderen. Raadpleeg ons document M365 Calendaring Field Guide voor meer informatie over het configureren van agenda-toegang voor Zoom Rooms. {% endhint %} #### Welke methoden kan ik gebruiken om toegang tot postvakken van vergaderzalen te verlenen? Zoom Rooms-agendaintegratie is afhankelijk van de Microsoft Graph API (MGAPI). Microsoft is begonnen [met het uitfaseren van de Exchange Web Services (EWS)-methoden](https://techcommunity.microsoft.com/blog/exchange/retirement-of-exchange-web-services-in-exchange-online/3924440) die voorheen beschikbaar waren om Microsoft 365-gegevens te verbinden met Zoom-diensten. Zoom beschouwt deze EWS-methoden als verouderde opties. Google werkruimte heeft slechts één methode voor het toepassen van Toestemmingen. #### Welke Toestemmingen zijn vereist voor het serviceaccount? De specifieke Toestemming zal variëren afhankelijk van de geselecteerde methode. Elke optie en de vereiste Toestemmingen worden hieronder in de tabel beschreven: | Provider | Methode | Vereiste Toestemmingen | | --------------------------------------- | --------------------------------------------------- | -------------------------------------------------------- | | Microsoft 365/Microsoft Exchange Server | Applicatiemachtigingen (Microsoft Graph API) | beheerder account: Organisatiebeheer en ontvangersbeheer | | Microsoft 365/Microsoft Exchange Server | Volledige gedelegeerde Access (Microsoft Graph API) | Verzenden als volledige Access | | Google werkruimte | - | Wijzigingen aanbrengen en delen beheren | {% hint style="info" %} **Zoom-aanbeveling** Zoom raadt aan om voor agenda-integraties de methode voor toepassingsmachtigingen te gebruiken. Deze configuratie vereist minder inspanning van de beheerder en vereist geen speciaal service-account. Het is ook Microsofts aanbevolen aanpak voor Onderneming-toepassingen die als achtergrondservices worden uitgevoerd. {% endhint %} ### Verbeterde API Connector Kalender Integratie(s) voor op standaarden gebaseerde H.323- en SIP-ruimtesystemen via de Enhanced API Connector (uitgebracht begin 2021) wordt onafhankelijk uitgevoerd van de configuratie van de gebruikerclient en Zoom Rooms. De methodologie en machtigingen van het service account zijn identiek aan het Zoom Rooms-gedeelte dat eerder is behandeld. #### Wat is anders Over de verbeterde API Connector-gegevensstroom? Ruimtesystemen die via de Verbeterde API Connector zijn verbonden, zullen niet rechtstreeks contactpersoon opnemen met agenda-aanbieders, wat verschilt van de verbindingsstromen van de Zoom-client en Zoom Room. De Zoom Web Service fungeert als een client voor deze systemen en zal agendagegevens rechtstreeks naar de eindpunten pushen, met een uitzondering voor Poly-apparaten. Poly-apparaten zullen eerst de Zoom Web Service raadplegen voor agenda-updates, die vervolgens agendagegevens naar het Apparaat verzendt. #### Hoeveel dagen aan agenda-evenementen worden opgehaald? De Enhanced API Connector haalt gegevens over aanstaande vergaderingen op voor de komende 30 dagen en verwijdert voltooide vergaderingen na 30 dagen uit de opslag. --- # Agent Instructions: 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/nl/beheerdershoek/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.