> 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/de/administrator-bereich/third-party-integrations/zoom-and-microsoft-integration-and-deployment-field-guide/getting-started-with-microsoft-and-zoom-workplace-deployments.md).
# Erste Schritte mit Microsoft- und Zoom Workplace-Bereitstellungen
Dieser Abschnitt behandelt die Entscheidungen, die jede Microsoft-Integration in Zoom Workplace beeinflussen. Beginnen Sie hier, bevor Sie Kalender, Outlook, Teams oder Raum-Workflows bereitstellen.
### Voraussetzungen
Zoom- und Microsoft-Integrationen fallen im Allgemeinen in zwei Muster:
1. **Microsoft-Oberflächenintegrationen**, bei denen Zoom-Funktionen in Microsoft-Produkten wie Teams oder Outlook bereitgestellt werden.
2. **Zoom-Oberflächenintegrationen**, bei denen Microsoft-Dienste als Datenquellen, Identitätsanbieter oder Systeme zum aufzeichnen in Zoom eingebunden werden.
Mehrere Integrationen in diesem Leitfaden haben gemeinsame Voraussetzungen, die Microsoft 365-Konten, Entra ID-Berechtigungen und API-Konfigurationsentscheidungen betreffen. Wenn Sie diese von Anfang an korrekt einrichten, vermeiden Sie Nacharbeiten später.
#### Zusammenstellung der erforderlichen Konten und Anmeldedaten für die Integration
Um die in diesem Leitfaden beschriebenen Schritte erfolgreich abzuschließen, benötigen Sie die folgenden Konten und Anmeldeinformationen:
* Ein Microsoft 365 Administrator-Konto mit Exchange Online-Administratorberechtigungen, **und**:
* Das Konto muss über Exchange Online-Administratorberechtigungen für beide verfügen **Unternehmen Management** und **Empfängerverwaltung**.
* Für Microsoft Graph API-Anwendungsberechtigungen ist ein Microsoft 365 Global Administrator oder ein Benutzer mit Microsoft 365 Cloud-Anwendungsadministratorberechtigungen erforderlich, um die Zoom Anwendung zur Microsoft Entra ID Enterprise Anwendung hinzuzufügen.
* Für Microsoft Graph API-Anwendungsberechtigungen ist mindestens ein [zugehörige Domäne](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0066259) erforderlich, die mit einer benutzerdefinierten Domäne übereinstimmt, die in Ihrem Microsoft 365-Mandanten verifiziert wurde.
* Eine Rolle mit Access zu Zoom Rooms.
* Die Fähigkeit, Kalenderressourcen für Meetingräume aufzulisten, zu erstellen und zu verwalten.
* Administrator Access für Windows PowerShell unter Windows 10 oder höher bzw. Windows Server 2016 oder höher
**Konfigurieren Sie die Zoom Workplace-Berechtigungen so, dass sie den Benutzerzustimmungseinstellungen von Microsoft Entra ID entsprechen**
Der erste Schritt bei der Integration einer beliebigen Art von Microsoft 365-Kalender in die Zoom Plattform besteht darin, Ihre Zoom Berechtigungen so zu konfigurieren, dass sie mit Ihren Microsoft Entra ID (früher Azure Active Directory) Benutzerzustimmungs-Einstellungen übereinstimmen.
Dieser Prozess soll Berechtigungsprobleme zwischen der Zoom Plattform und Entra ID durch eine Abgleichübung verhindern, während Sie die verbleibenden Schritte in dieser Anleitung befolgen.
**Ermitteln Sie die aktuellen Benutzerzustimmungseinstellungen von Microsoft Entra ID**
1. Melden Sie sich beim [Microsoft Azure-Administrationsportal](https://portal.azure.com/) mit einem Microsoft 365 Administrator-Konto an.
2. Unter der **Bereich Azure-Dienste** klicken Sie auf die **Microsoft Entra ID** Symbol.
3. Unter der **Verwalten** Dropdown-Liste und klicken Sie auf **Enterprise-Anwendungen**.
4. Unter der Dropdown-Liste Sicherheit klicken Sie auf **Zustimmung und Berechtigungen**.
5. Notieren Sie sich den Wert des *Abschnitts Benutzerzustimmung für Anwendungen*, der einer der folgenden sein wird:
1. Keine Benutzer-Einwilligung zulassen
2. Benutzer-Einwilligung für Apps von verifizierten Herausgebern mit ausgewählten Berechtigungen zulassen
3. Benutzer-Einwilligung für Apps zulassen
**Bestätigen Sie, dass die Benutzerzustimmung und die Einstellungen des Zoom-Webportals übereinstimmen**
Ihr Unternehmen kann Wählen, die Benutzer-Einstellungen für Zustimmungen einzuschränken oder zuzulassen. Zoom empfiehlt eine vereinfachte Berechtigungsmethode, bei der Benutzer selbst ihre Zustimmung zu Entra-ID-Apps erteilen können. Unabhängig davon, welche Wahl Sie treffen, muss Ihr Unternehmen die Entra-ID-Option mit einer passenden Option auf der Zoom-Administrationsseite abstimmen.
Wenn Sie die Benutzer-Einwilligungseinstellungen von Microsoft Entra ID so konfiguriert haben, dass **Keine Benutzer-Einwilligung zulassen**, oder **Benutzer-Einwilligung für Apps von verifizierten Herausgebern mit ausgewählten Berechtigungen zulassen**, dann muss die Zoom-Webeinstellung, die besagt *Zustimmung zu Office 365 Kalenderintegration-Berechtigungen im Namen des gesamten Kontos* auf **Ein**.
Alternativ, wenn Ihre Benutzer-Einwilligungseinstellungen so konfiguriert sind, dass **Benutzer-Einwilligung für Apps zulassen**, dann schalten Sie die Einstellung **Aus**.
**(Optional) Erstellen einer benutzerdefinierten Microsoft Entra Anwendung zur Integration mit Microsoft Office 365**
Für vollständige Anweisungen zum Konfigurieren einer benutzerdefinierten Anwendung siehe den Zoom-Support-Artikel [Einrichten von Zoom Rooms mit Office 365](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0063474).
{% hint style="info" %}
Diese Funktion muss [von Zoom aktiviert werden](https://support.zoom.com/hc/en/contact?id=contact_us).
{% endhint %}
### Entscheiden, welche API-Methode für Ihr Unternehmen geeignet ist
Eine der ersten Entscheidungen, die ein Administrator treffen muss, ist, wie Zoom sich bei Microsoft-Diensten authentifizieren soll. Diese Wahl wirkt sich auf mehrere nachgelagerte Integrationen aus, daher lohnt es sich, sie zu verstehen, bevor Sie mit der Konfiguration einzelner Funktionen beginnen.
{% hint style="info" %}
Zoom empfiehlt **Microsoft Graph API mit Anwendungsberechtigungen** standardmäßig für sowohl Zoom Rooms als auch persönliche Kalenderintegrationen. Für die meisten Implementierungen ist dies der einfachere, sicherere und skalierbarere Weg.
{% endhint %}
**Welche Microsoft 365-APIs verwenden Sie für die Kalenderverwaltung?**
Die Zoom calendaring Integration basiert auf der Microsoft Graph API (MGAPI). Microsoft hat begonnen [die Methoden von Exchange Web Services (EWS) auslaufen zu lassen](https://techcommunity.microsoft.com/blog/exchange/retirement-of-exchange-web-services-in-exchange-online/3924440) die zuvor Verfügbar waren, um Microsoft 365-Daten mit Zoom-Dienste zu verbinden. Zoom betrachtet diese EWS-Methoden als Legacy-Optionen.
Anwendung-Berechtigungen und delegierte Berechtigungen (OAuth) sind nicht austauschbar: Sie bringen unterschiedliche Kompromisse mit sich, je nachdem, wie Ihre Benutzer tatsächlich arbeiten. Die richtige Wahl hängt weniger von technischen Vorlieben ab und mehr davon, wo Ihre Benutzer ihren Tag verbringen.
**Wie kann ich die offizielle Zoom-Anwendung identifizieren, die für Konferenzräume verwendet wird?**
Die Kalenderanwendungen für den Konferenzraum von Zoom sind im Entra ID Enterprise-Anwendungsverzeichnis Verfügbar und mit den folgenden Anwendungs-IDs registriert, abhängig von Ihrer Graph API-Konfigurationsmethode:
* `a651cfda-cbdd-4a39-bd03-fa829c3c1b29` (Vollständiger delegierter Access)
* `f56e91e5-5a82-452f-b435-d4d78aeaf064` (Anwendungsberechtigungen)
{% hint style="warning" %}
**Zoom-Empfehlung**
Es besteht keine Notwendigkeit für manuelles Hinzufügen von Anwendungen aus dem Entra ID-Portal. Wenn Sie die Zoom-Weboberfläche verwenden, um Berechtigungsanfragen anzufordern und zu genehmigen, wird die Anwendung automatisch Ihrem Mandanten hinzugefügt.
{% endhint %}
**Was ist der Unterschied zwischen Full Delegate Access und Anwendung-Berechtigungen?**
Im Allgemeinen empfiehlt Zoom die Verwendung von Microsoft Graph API mit Anwendungsberechtigungen, da diese Art der Konfiguration deutlich weniger Aufwand bei der Einrichtung und Wartung seitens des Administrator erfordert und kein dediziertes Service-Konto benötigt. Sie wendet jedoch Berechtigungen im gesamten Konto an.
Anwendungsberechtigungen (auch als App-only access bekannt) sind der von Microsoft empfohlene Ansatz für Enterprise Anwendungen, die als Hintergrunddienste ausgeführt werden und bei denen die erforderlichen Daten nicht auf einen einzelnen Benutzer beschränkt werden können.
Microsoft Graph API mit vollständigem Delegate Access ist eine alternative Option, erfordert jedoch ein dediziertes Service-Konto und mehr Aufwand für die Ersteinrichtung und Wartung.
#### Für Zoom Rooms: Anwendung-Berechtigungen
Für Zoom Rooms und Konferenzräume von Drittanbietern empfiehlt Zoom uneingeschränkt Anwendung-Berechtigungen. Für Räume gibt es zwischen den beiden Methoden keine Funktionslücken, und Anwendung-Berechtigungen macht die Notwendigkeit eines dedizierten Dienstkontos überflüssig, das als Delegierter für Raumpostfächer fungiert.
Dadurch wird der anfängliche Einrichtungsaufwand reduziert und eine laufende Wartungsabhängigkeit beseitigt.
#### Für Benutzer: Beginnen Sie damit, wie sie Zoom Workplace nutzen
Für persönliche Kalenderintegrationen empfiehlt Zoom Anwendung-Berechtigungen, aber Ihre Wahl hängt davon ab, wie die Benutzer Ihres Unternehmens Zoom Workplace jeden Tag nutzen.
**Die meisten Organisationen: Anwendung Berechtigungen (Empfohlen)**
Wenn Ihre Benutzer Besprechungen hauptsächlich über das Outlook-Hinzufügen-In planen und daran teilnehmen und die Zoom Workplace App nicht regelmäßig für Kalender, Chat oder andere Workflows öffnen, sind Anwendungsberechtigungen die bessere Wahl.
Hier ist der Grund:
* **Vom Administrator verwaltete Cloud-zu-Cloud-Integration.** Die Kalenderintegration wird auf Kontoebene verwaltet. Einzelne Benutzer müssen ihre eigene Verbindung nicht autorisieren oder pflegen. Wenn die Integration unterbrochen wird, bemerken Admins dies sofort, anstatt sich darauf zu verlassen, dass einzelne Benutzer Probleme melden.
* **Stärkere Token-Sicherheit.** Anwendung-Berechtigungen verwenden ein kurzlebiges Access Token, das alle 60 Minuten durch einen Cloud-zu-Cloud-Austausch erneuert wird. Das Token wird nie dauerhaft gespeichert und nur im Speicher gehalten. Es gibt kein Refresh Token und keine Offline-Access-Genehmigung. Wenn ein Benutzer deprovisioniert wird, gibt es keine verbleibenden Token, die verwendet werden könnten, um auf seine Kalenderdaten zuzugreifen.
* **Keine Abhängigkeit vom Anmeldeverhalten des Benutzers.** Mit delegierten Berechtigungen ist die Integration darauf angewiesen, dass einzelne Benutzer in der Zoom Workplace App angemeldet sind. Wenn das Token eines Benutzers abläuft oder sie ihr Passwort ändern, wird ihre Kalenderintegration stillschweigend unterbrochen. Sie bemerken das möglicherweise wochenlang nicht, wenn sie hauptsächlich Outlook verwenden. Anwendungsberechtigungen entfernen diesen Fehlerfall vollständig.
**Wann delegierte Berechtigungen die bessere Wahl sein können**
Wenn Ihre Benutzer regelmäßige Benutzer der Zoom Workplace App sind, könnten delegierte Berechtigungen besser geeignet sein:
* **Geteilte Kalender.** Delegierte Berechtigungen zulassen es Benutzern, gemeinsame Kalender von Kollegen anzuzeigen, zu denen sie in Microsoft 365 Access haben. Mit Anwendungsberechtigungen können Benutzer in der Zoom Workplace App nur ihren Kalender sehen.
* **E-Mail in Zoom Workplace.** Die Zoom Mail-Anwendung in der Workplace App erfordert delegierte Berechtigungen, um auf die Microsoft 365 Postfach eines Benutzers zuzugreifen. Die Methode für Anwendungsberechtigungen unterstützt diese Integration heute nicht.
* **Self-Service-Sichtbarkeit.** Wenn die Delegated-Integration eines Benutzers ausfällt, etwa durch Ablauf des Token oder eine Passwort-Ändern, sehen sie direkt in der Workplace-App eine Aufforderung, sich erneut zu authentifizieren. Für Benutzer, die bereits in der App aktiv sind, bietet dies eine schnellere Self-Service-Wiederherstellung.
#### Alles zusammengebracht: Empfehlungen für Ihre Bereitstellung
Für die meisten Zoom/Microsoft-Bereitstellungen lautet die Empfehlung:
* **Zimmer:** Anwendung-Berechtigungen. Keine Kompromisse, einfachere Einrichtung, kein Service-Konto.
* **Benutzer:** Anwendung-Berechtigungen, es sei denn, Ihre Benutzer sind aktiv auf gemeinsame Kalender oder E-Mail innerhalb der Zoom Workplace App angewiesen.
Die Wahl ist nicht dauerhaft. Organisationen können über eine erneute Autorisierung zwischen den Methoden Ändern.
Wenn Sie unsicher sind, beginnen Sie mit Anwendung-Berechtigungen. Es bietet Ihnen eine zuverlässige Integration mit der Option, Delegierte Berechtigungen später für bestimmte Benutzergruppen hinzuzufügen, falls Anforderungen an gemeinsame Kalender oder E-Mail entstehen.
Die folgenden Diagramme Anzeigen die delegierten und anwendungsbasierten Methoden mit Anmeldeinformationen während der Übertragung.
Die delegierte Methode bietet zwar Autorisierung, sendet jedoch Anmeldeinformationen an die Zoom App.
Eine skalierbarere Methode, die anwendungsbasierte Autorisierung, verhindert, dass Benutzer-Anmeldeinformationen oder Token die Zoom Anwendung direkt erreichen.
### Sicherheit und Datenverarbeitung
Der Zoom Web-Kalenderdienst speichert die Objekte, die erforderlich sind, um den Kalenderanbieter jedes Benutzer zu authentifizieren. Das bedeutet, dass Zoom das Refresh-Token speichert, wenn Organisationen OAuth verwenden, um Outlook oder Google Kalender mit Zoom-Diensten zu verbinden. Es bedeutet auch, dass Zoom für Organisationen, die Basic Authentifizierung in Exchange On-Premises verwenden, den Konto Benutzername und das Passwort speichert.
| Synchronisierte Events |
| --------------------------- |
| `TeilnehmerAusgelassen` |
| `Beschreibung` |
| `Anzeigename` (Teilnehmer) |
| `E-Mail` (Teilnehmer) |
| `FesterArbeitsstandort` |
| `iCalUID` |
| `Standort` |
| `Anzeigename` (Organisator) |
| `E-Mail` (Organisator) |
| `Zusammenfassung` |
| `Zeitvorschlag` |
| `ArbeitsstandortAktiviert` |
Wenn die bidirektionale Kalender-Synchronisierung (Synchronisieren 2.0) aktiviert ist, speichert Zoom keine externen Kalender-Event-Daten (von Microsoft 365 oder Google Kalender) in seiner Datenbank.\
\
Stattdessen überwacht der Dienst ein rollierendes 24-Monats-Fenster der Kalenderaktivität (bis zu 6 Monate in der Vergangenheit und 18 Monate in der Zukunft). Wenn innerhalb dieses Fensters Änderungen auftreten, erhält Zoom Ändern-Benachrichtigungen vom Kalenderanbieter und ruft die aktualisierten Event-Daten bei Bedarf ab, um die entsprechenden Zoom-Meeting-Aktualisierungen zu verarbeiten. Der Meeting-Service wird dann benachrichtigt, um die erforderlichen Änderungen anzuwenden.
Administratoren können diese Funktion auf Konto- oder Benutzer Gruppenebene Konfigurieren. Weitere Informationen finden Sie in unserer [Support-Dokumentation](https://support.zoom.us/hc/en-us/articles/8522918261645-Enabling-bi-directional-calendar-sync) .
#### Wie werden gespeicherte Token und Anmeldedaten geschützt?
Die gespeicherten Tokens und Anmeldeinformationen sind im Ruhezustand mithilfe von 256-Bit-AES-GCM-Verschlüsselung verschlüsselt. Diese Daten gelten als Kundeninhalt und unterliegen den Zugriffssteuerung-Richtlinien und -Standards von Zoom. Diese Kontrollen werden von unabhängigen Wirtschaftsprüfungsgesellschaften bewertet, sofern dies in unseren Sicherheitszertifizierungen und -bestätigungen angegeben ist, wie etwa SOC 2. Der Zugriff mit Berechtigung auf Infrastrukturdaten und -systeme wird protokolliert, überwacht und mithilfe von Multi-Faktor-Authentifizierung und Zugriffssteuerungen mit der geringsten Berechtigung gesteuert.
#### Wie wird der Datenverkehr zwischen Apps und dem Kalenderanbieter geschützt?
Die Kommunikation zwischen Kalender-Anbietern und jeglicher Zoom-Software — Zoom Desktop-/Mobil-Apps, Zoom Web-Kalenderdienst, Planen-Tools und dem API Connector — wird während der Übertragung mit TLS 1.2 verschlüsselt.
#### Wie lange ist ein OAuth Token gültig?
Zoom wird Access-Tokens anfordern, die in 1 Stunde ablaufen, sowie Refresh-Tokens, die in 90 Tagen ablaufen. Bei Kalenderanbietern können jedoch Tokens mit abweichenden Limits bereitgestellt werden. Befolgen Sie die Anweisungen Ihres Anbieters, wenn Sie die standardmäßig Werte ändern müssen.
#### Kann ich ein OAuth Token oder Anmeldedaten widerrufen?
Zoom-Administratoren können jederzeit wählen, die Kalenderintegration aus einem einzelnen Zoom-Konto zu entfernen, wodurch verhindert wird, dass die Kalenderfunktion des Benutzers funktioniert. Löschen Sie sofort alle gespeicherten Tokens oder Anmeldedaten für diesen Benutzer.
Microsoft 365-Administratoren können den Kalenderzugriff von Zoom von allen Benutzerkonten entfernen, indem sie die Zoom-Anwendung im Entra ID Enterprise-Anwendungsportal löschen, und Google Arbeitsplatz-Administratoren können den Zugriff über die Google Cloud Plattform-Konsole widerrufen.
#### Kann ich die Fähigkeit von Zoom einschränken, Kalender- oder Kontaktdaten an einen Anbieter zu schreiben?
Nach der ersten Konfiguration können Zoom-Administratoren beim Verbinden über Microsoft 365-Methoden zwischen Lese- und Lese-/Schreibberechtigungen für sowohl Kalender als auch Kontakte Wählen. Administratoren können außerdem Google Arbeitsplatz-Integrationen für Benutzerkalender einschränken.
### Überprüfen der Entra-ID-Berechtigungen
#### Validieren Sie die MGAPI-Anwendungsberechtigungen-Methode, die Anwendungs-ID und die Bereiche für Konferenzräume
Wenn Sie die Methode für Anwendungsberechtigungen für Zoom Rooms oder Konferenzräume von Drittanbietern verwenden, validieren Sie die Berechtigungen anhand der folgenden Schritte:
1. Melden Sie sich beim Azure-Portal mit dem Konto des Microsoft 365 Administrators an.
2. Klicken Sie auf die **Microsoft** **Entra ID** Logo.
3. Navigieren Sie zu **Enterprise-Anwendungen**.
4. Standardmäßig, **Alle Anwendungen** werden in der interaktiven Datentabelle angezeigt.
5. Klicken Sie auf die **Zoom** App mit der Anwendungs-ID *f56e91e5-5a82-452f-b435-d4d78aeaf064*.
6. Klicken Sie auf die **Sicherheit** Dropdown und auswählen **Berechtigungen**.
7. Überprüfen Sie die *Administratorzustimmung* Registerkarte entspricht dem Bildschirm hier:
#### Validieren Sie die MGAPI-Vollzugriffsdelegat-Methode, die Anwendungs-ID und die Bereiche für Konferenzräume oder Zoom Rooms
Wenn Sie die Full Delegate-Methode für Zoom Rooms oder Konferenzräume von Drittanbietern verwenden, überprüfen Sie die Berechtigungen anhand der folgenden Schritte:
1. Melden Sie sich beim Azure-Portal mit dem Microsoft 365 Administrator-Konto an.
2. Klicken Sie auf das **Microsoft** **Entra ID** Logo.
3. Navigieren Sie zu **Enterprise Anwendungen**.
4. standardmäßig, **Alle Anwendungen** werden in der interaktiven Datentabelle angezeigt.
5. Klicken Sie auf das **Zoom** App mit der Anwendungs-ID *a651cfda-cbdd-4a39-bd03-fa829c3c1b29*.
6. Klicken Sie auf das **Sicherheit** Dropdownmenü und wählen Sie **Berechtigungen**.
7. Überprüfen Sie, ob die *Administratorzustimmung* Registerkarte mit dem Bildschirm hier übereinstimmt:\\
#### Validieren Sie die ID und die Bereiche der Anwendungsberechtigungen des persönlichen Kalenders
Wenn Sie die Methode für Anwendungsberechtigungen für persönliche Kalender verwenden, validieren Sie die Berechtigungen mit den folgenden Schritten:
1. Melden Sie sich beim Azure-Portal mit dem Microsoft 365 Administrator-Konto an.
2. Klicken Sie auf das **Microsoft Entra ID** Logo.
3. Navigieren Sie zu **Enterprise-Anwendungen**.
4. Standardmäßig, **Alle Anwendungen** werden in der interaktiven Datentabelle angezeigt.
5. Klicken Sie auf das **Zoom** App mit der Anwendungs-ID *f46ceaed-fb2d-4694-803b-6341837f0ed2*.
6. Klicken Sie auf das **Sicherheit** Dropdown-Menü öffnen und auswählen **Berechtigungen**.
7. Validieren Sie die *Administratorzustimmung* Registerkarte hier übereinstimmt:
#### Validieren Sie die OAuth-Anwendungs-ID und die Bereiche des persönlichen Kalenders
Wenn Sie für Ihre Benutzer die OAuth Integration verwendet haben, auch Delegierte Berechtigungen genannt, überprüfen Sie die Berechtigungen anhand der folgenden Schritte:
1. Melden Sie sich beim Azure-Portal mit dem Microsoft 365 Administrator-Konto an.
2. Klicken Sie auf das **Microsoft Entra ID** Logo.
3. Navigieren Sie zu **Enterprise Anwendungen**.
4. standardmäßig, **Alle Anwendungen** werden in der interaktiven Datentabelle angezeigt.
5. Klicken Sie auf das **Zoom** App mit der Anwendungs-ID *fc108d3f-543d-4374-bbff-c7c51f651fe5*.
6. Klicken Sie auf das **Sicherheit** Dropdownmenü und wählen Sie **Berechtigungen**.
7. Überprüfen Sie, ob die *Administratorzustimmung* Registerkarte stimmt mit dem Bildschirm hier überein:
---
# 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/de/administrator-bereich/third-party-integrations/zoom-and-microsoft-integration-and-deployment-field-guide/getting-started-with-microsoft-and-zoom-workplace-deployments.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.