> 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 angezeigt werden.
2. **Zoom-Oberflächenintegrationen**, bei denen Microsoft-Dienste in Zoom als Datenquellen, Identitätsanbieter oder Systeme zum aufzeichnen eingebunden werden.
Mehrere Integrationen in diesem Leitfaden teilen gemeinsame Voraussetzungen, die Microsoft 365-Konten, Entra ID-Berechtigungen und API-Konfigurationsentscheidungen umfassen. Wenn Sie diese zu Beginn korrekt einrichten, vermeiden Sie spätere Nacharbeiten.
#### Erforderliche Konten und Anmeldeinformationen für die Integration sammeln
Um die in diesem Leitfaden beschriebenen Schritte erfolgreich abzuschließen, benötigen Sie die folgenden Konten und Anmeldeinformationen:
* Ein Microsoft 365-Administratorkonto mit Administratorberechtigungen für Exchange Online, **und**:
* Das Konto muss für beide über Administratorberechtigungen für Exchange Online verfügen **Unternehmensverwaltung** 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.
* Microsoft Graph API-Anwendungsberechtigungen erfordern mindestens ein [zugehörige Domain](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0066259) das mit einer benutzerdefinierten Domäne übereinstimmt, die in Ihrem Microsoft 365-Mandanten verifiziert ist.
* Eine Rolle mit Zugriff auf Zoom Rooms.
* Die Möglichkeit, Kalenderressourcen für Meetingräume aufzulisten, zu erstellen und zu verwalten.
* Administrator-Access für Windows PowerShell auf Windows 10 oder höher oder Windows Server 2016 oder höher
**Konfigurieren Sie die Zoom Workplace-Berechtigungen so, dass sie den Microsoft Entra ID-Benutzerzustimmungseinstellungen entsprechen**
Der erste Schritt bei der Integration eines beliebigen Typs eines Microsoft 365-Kalenders in die Zoom Plattform besteht darin, Ihre Zoom-Berechtigungen so zu konfigurieren, dass sie Ihre Microsoft Entra ID (früher als Azure Active Directory bezeichnet) Zustimmungs-Einstellungen für Benutzer erfüllen.
Dieser Prozess soll Berechtigungsprobleme zwischen der Zoom-Plattform und Entra ID durch eine Abgleichübung verhindern, während Sie die verbleibenden Schritte in diesem Leitfaden befolgen.
**Identifizieren Sie die aktuellen Microsoft Entra ID-Benutzerzustimmungseinstellungen**
1. Melden Sie sich bei dem [Microsoft Azure-Verwaltungsportal](https://portal.azure.com/) unter Verwendung eines Microsoft 365 Administrator-Kontos.
2. Unter dem **Azure-Dienste** Abschnitt, klicken Sie auf das **Microsoft Entra ID** Symbol.
3. Unter dem **Verwalten** Dropdown-Menü, klicken Sie auf **Enterprise-Anwendungen**.
4. Unter dem Dropdown-Menü Sicherheit klicken Sie auf **Zustimmung und Berechtigungen**.
5. Notieren Sie den Wert des *Abschnitt Benutzerzustimmung für Anwendungen*, der einer der folgenden sein wird:
1. Benutzerzustimmung nicht zulassen
2. Benutzerzustimmung für Apps von verifizierten Herausgebern für ausgewählte Berechtigungen zulassen
3. Benutzerzustimmung für Apps zulassen
**Bestätigen Sie, dass die Einstellungen für Benutzerzustimmung und die Einstellungen im Zoom-Webportal übereinstimmen**
Ihr Unternehmen kann wählen, ob Benutzereinwilligungseinstellungen eingeschränkt oder zugelassen werden sollen. Zoom empfiehlt eine vereinfachte Berechtigungsmethode, bei der Benutzer Entra ID-Apps selbst zustimmen. Unabhängig von der gewählten Option muss Ihr Unternehmen die Entra ID-Option mit einer passenden Option auf der Zoom-Administratorseite abstimmen.
Wenn Sie die Microsoft Entra ID-Einstellungen für die Benutzerzustimmung so konfiguriert haben, dass **Benutzerzustimmung nicht zulassen**, oder **Benutzerzustimmung für Apps von verifizierten Herausgebern für ausgewählte Berechtigungen zulassen**, dann muss die Zoom-Webeinstellung, die besagt *Zustimmung zu Berechtigungen der Office 365 Kalenderintegration im Namen des gesamten Kontos* muss auf **Ein**.
Alternativ, wenn Ihre Einstellungen für die Benutzerzustimmung so konfiguriert sind, dass **Benutzerzustimmung 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 sein [von Zoom aktiviert](https://support.zoom.com/hc/en/contact?id=contact_us).
{% endhint %}
### Entscheiden, welche API-Methode für Ihr Unternehmen die richtige ist
Eine der ersten Entscheidungen, die ein Administrator treffen muss, ist, wie Zoom sich bei Microsoft-Diensten authentifizieren wird. Diese Wahl wirkt sich auf mehrere Integrationen downstream 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** als standardmäßig für sowohl Zoom Rooms als auch persönliche Kalender-Integrationen. Für die meisten Bereitstellungen ist dies der einfachere, sicherere und besser skalierbare Weg.
{% endhint %}
**Welche Microsoft 365-APIs verwenden Sie für die Kalenderverwaltung?**
Die Zoom-Kalender-Integration basiert auf der Microsoft Graph API (MGAPI). Microsoft hat begonnen [die Exchange Web Services (EWS)-Methoden schrittweise einzustellen](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-Diensten zu verbinden. Zoom betrachtet diese EWS-Methoden als veraltete Optionen.
Anwendungsberechtigungen und delegierte Berechtigungen (OAuth) sind nicht austauschbar: Sie bringen je nach tatsächlicher Arbeitsweise Ihrer Nutzer unterschiedliche Kompromisse mit sich. Die richtige Wahl hängt weniger von der technischen Präferenz ab als vielmehr davon, wo Ihre Nutzer ihren Tag verbringen.
**Wie kann ich die offizielle Zoom-Anwendung identifizieren, die für Konferenzräume verwendet wird?**
Die Konferenzraum-Kalenderanwendungen für Zoom sind im Entra ID Enterprise-Anwendungsverzeichnis Verfügbar und mit den folgenden Anwendungs-IDs registriert, je nach Ihrer Graph-API-Konfigurationsmethode:
* `a651cfda-cbdd-4a39-bd03-fa829c3c1b29` (Voller Delegierten-Access)
* `f56e91e5-5a82-452f-b435-d4d78aeaf064` (Anwendungsberechtigungen)
{% hint style="warning" %}
**Zoom-Empfehlung**
Es ist nicht erforderlich, das manuelle Hinzufügen von Anwendungen aus dem Entra ID-Portal vorzunehmen. Die Verwendung der Zoom-Weboberfläche zum Anfordern und Genehmigen von Berechtigungsanfragen führt automatisch zum Hinzufügen der Anwendung zu Ihrem Mandanten.
{% endhint %}
**Was ist der Unterschied zwischen Full Delegate Access und Anwendungsberechtigungen?**
Im Allgemeinen empfiehlt Zoom die Verwendung der Microsoft Graph API mit Anwendungsberechtigungen, da diese Konfiguration seitens des Administrators erheblich weniger Aufwand bei Einrichtung und Wartung erfordert und kein dediziertes Dienst-Konto benötigt. Sie gilt jedoch kontoweit.
Anwendungsberechtigungen (auch bekannt als App-only Access) sind Microsofts empfohlener Ansatz für Enterprise-Anwendungen, die als Hintergrunddienste ausgeführt werden und bei denen die benötigten Daten nicht auf einen einzelnen Benutzer beschränkt werden können.
Microsoft Graph API mit Full Delegate Access ist eine alternative Option, erfordert jedoch ein dediziertes Dienst-Konto sowie mehr Aufwand für die Ersteinrichtung und Wartung.
#### Für Zoom Rooms: Anwendungsberechtigungen
Für Zoom Rooms und Konferenzräume von Drittanbietern sind Anwendungsberechtigungen Zooms Empfehlung, ohne Vorbehalte. Zwischen den beiden Methoden für Räume gibt es keine Funktionslücken, und Anwendungsberechtigungen machen ein dediziertes Dienstkonto als Stellvertreter für Raumpostfächer überflüssig.
Dies reduziert den anfänglichen Einrichtungsaufwand und beseitigt eine fortlaufende Wartungsabhängigkeit.
#### Für Nutzer: Beginnen Sie damit, wie sie Zoom Workplace verwenden
Für persönliche Kalender-Integrationen empfiehlt Zoom Anwendungsberechtigungen, aber Ihre Wahl hängt davon ab, wie die Nutzer in Ihrem Unternehmen täglich mit Zoom Workplace interagieren.
**Die meisten Organisationen: Anwendung-Berechtigungen (empfohlen)**
Wenn Ihre Benutzer Besprechungen hauptsächlich über das Outlook-Hinzufügen-In planen und ihnen beitreten und die Zoom Workplace App nicht regelmäßig für Kalender, Chat oder andere Arbeitsabläufe öffnen, sind Anwendungsberechtigungen besser geeignet.
Hier ist der Grund:
* **Administrator-verwaltet, Cloud-zu-Cloud-Integration.** Die Kalenderintegration wird auf Kontoebene verwaltet. Einzelne Nutzer müssen ihre eigene Verbindung nicht autorisieren oder pflegen. Wenn die Integration ausfällt, bemerken Administratoren das sofort, anstatt sich darauf zu verlassen, dass einzelne Nutzer Probleme melden.
* **Stärkere Token-Sicherheit.** Anwendung-Berechtigungen verwenden ein kurzlebiges Access-Token, das alle 60 Minuten über einen Cloud-zu-Cloud-Austausch aktualisiert 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, bleiben keine verbleibenden Token übrig, die zum Access seiner Kalenderdaten verwendet werden könnten.
* **Keine Abhängigkeit vom Anmeldeverhalten des Benutzers.** Bei delegierten Berechtigungen verlässt sich die Integration darauf, dass einzelne Benutzer in der Zoom Workplace App angemeldet sind. Wenn das Token eines Benutzers abläuft oder er sein Passwort ändert, bricht seine Kalenderintegration unbemerkt ab. Möglicherweise fällt ihnen das wochenlang nicht auf, wenn sie hauptsächlich Outlook verwenden. Anwendungsberechtigungen beseitigen diesen Fehlerfall vollständig.
**Wann delegierte Berechtigungen die bessere Wahl sein können**
Wenn Ihre Nutzer regelmäßige Zoom Workplace App-Nutzer sind, könnten Delegated Permissions die bessere Wahl sein:
* **Geteilte Kalender.** Delegierte Berechtigungen zulassen Benutzern, freigegebene Kalender von Kollegen anzuzeigen, auf die sie in Microsoft 365 Zugriff haben. Mit Anwendungsberechtigungen können Benutzer nur ihren Kalender in der Zoom Workplace App sehen.
* **E-Mail in Zoom Workplace.** Die Zoom Mail-Anwendung innerhalb der Workplace App erfordert Delegierte Berechtigungen, um auf das Microsoft 365 Postfach eines Benutzers zuzugreifen. Die Methode für Anwendung Berechtigungen unterstützt diese Integration heute nicht.
* **Self-Service-Sichtbarkeit.** Wenn die Delegated Integration eines Benutzers ausfällt, etwa durch ablaufendes Token oder eine Passwort-Änderung, sehen sie direkt in der Workplace App eine Aufforderung, sich erneut zu authentifizieren. Für Benutzer, die bereits in der App zu Hause sind, bietet dies eine schnellere Self-Service-Wiederherstellung.
#### Alles zusammengefasst: Empfehlungen für Ihre Bereitstellung
Für die meisten Zoom/Microsoft-Bereitstellungen lautet die Empfehlung:
* **Zimmer:** Berechtigungen für die Anwendung. Keine Kompromisse, einfacheres Setup, kein Dienst-Konto.
* **Benutzer:** Berechtigungen für die Anwendung, sofern Ihre Benutzer nicht aktiv auf geteilte Kalender oder E-Mail innerhalb der Zoom Workplace App angewiesen sind.
Die Wahl ist nicht dauerhaft. Organisationen können zwischen Methoden wechseln; Ändern ist durch erneute Autorisierung möglich.
Wenn Sie unsicher sind, beginnen Sie mit Berechtigungen für die Anwendung. Es bietet Ihnen eine zuverlässige Integration mit der Option zum Hinzufügen von delegierten Berechtigungen für bestimmte Benutzergruppen später, falls Bedarf an geteiltem Kalender oder E-Mail entsteht.
Die folgenden Diagramme: Anzeigen der Delegated- und auf Anwendung basierenden Methoden mit Anmeldeinformationen während der Übertragung.
Die Delegated-Methode gewährt zwar Autorisierung, sendet jedoch Anmeldeinformationen an die Zoom App.
Eine besser skalierbare Methode, die auf Anwendung basierende Autorisierung, verhindert, dass Benutzer-Anmeldeinformationen oder Tokens die Zoom Anwendung direkt erreichen.
### Sicherheit und Datenverarbeitung
Der Zoom-Web-Kalenderdienst speichert die Objekte, die erforderlich sind, um den Kalenderanbieter jedes Benutzers 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 für Exchange On-Premises verwenden, den Benutzernamen des Kontos und das Passwort speichert.
| Synchronisierte Events |
| --------------------------- |
| `Teilnehmer ausgelassen` |
| `Beschreibung` |
| `Anzeigename` (Teilnehmer) |
| `E-Mail` (Teilnehmer) |
| `fester Arbeitsstandort` |
| `iCalUID` |
| `Standort` |
| `Anzeigename` (Organisator) |
| `E-Mail` (Organisator) |
| `Zusammenfassung` |
| `Zeitvorschlag` |
| `Arbeitsort aktiviert` |
Wenn die bidirektionale Kalender-Synchronisieren-Funktion aktiviert ist, behält Zoom keine Daten externer Kalender-Events (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 Eventdaten bei Bedarf ab, um die entsprechenden Zoom-Meeting-Updates zu verarbeiten. Der Meeting-Dienst wird dann benachrichtigt, um die erforderlichen Änderungen anzuwenden.
Administratoren können diese Funktion auf Konto- oder Benutzergruppenebene Konfigurieren. Siehe unsere [Support-Dokumentation](https://support.zoom.us/hc/en-us/articles/8522918261645-Enabling-bi-directional-calendar-sync) für weitere Informationen.
#### Wie werden gespeicherte Token und Anmeldedaten geschützt?
Die gespeicherten Token und Anmeldedaten werden im Ruhezustand mithilfe von 256-Bit-AES-GCM-Verschlüsselung verschlüsselt. Diese Daten gelten als Kundeninhalte und unterliegen den Zugriffssteuerungsrichtlinien und -standards von Zoom. Diese Kontrollen werden von unabhängigen Prüffirmen bewertet, sofern dies in unseren Sicherheitszertifizierungen und -bescheinigungen angegeben ist, wie z. B. SOC 2. Der privilegierte Zugriff auf Infrastrukturdaten und -systeme wird protokolliert, überwacht und mithilfe von Multi-Faktor-Authentifizierung und Zugriffssteuerungen mit geringsten Berechtigungen kontrolliert.
#### Wie wird der Datenverkehr zwischen Apps und dem Kalenderanbieter geschützt?
Kommunikationen zwischen Kalenderanbietern und jeglicher Zoom-Software — Zoom-Desktop-/Mobile-Apps, Zoom Web-Kalenderdienst, Tools zum Planen und dem API-Connector — sind bei der Übertragung mithilfe von TLS 1.2 verschlüsselt.
#### Wie lange ist ein OAuth-Token gültig?
Zoom fordert Zugriffs-Token an, die in 1 Stunde ablaufen, und Refresh-Token, die in 90 Tagen ablaufen, aber Kalenderanbieter können Token mit anderen Grenzwerten bereitstellen. Folgen Sie den Anweisungen Ihres Anbieters, wenn Sie die standardmäßig festgelegten Werte ändern müssen.
#### Kann ich ein OAuth-Token oder eine Anmeldedaten widerrufen?
Zoom-Administratoren können jederzeit Wählen, die Kalenderintegration aus einem einzelnen Zoom-Konto zu entfernen, wodurch die Kalenderfunktion des Benutzers verhindert wird. Löschen Sie sofort alle gespeicherten Token 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 mithilfe der Google Cloud Plattform-Konsole widerrufen.
#### Kann ich Zooms Fähigkeit 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 auch Google-Arbeitsplatz-Integrationen für Benutzerkalender einschränken.
### Überprüfen der Entra-ID-Berechtigungen
#### Validieren Sie die ID der Anwendung und die Scopes der MGAPI-Anwendungsberechtigungen für Konferenzräume
Wenn Sie die Methode für Anwendung-Berechtigungen 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 die **Microsoft** **Entra ID** Logo.
3. Navigieren zu **Enterprise-Anwendungen**.
4. Standardmäßig, **Alle Anwendungen** werden in der interaktiven Datentabelle angezeigt.
5. Klicken Sie auf die **Zoom** App mit der ID der Anwendung *f56e91e5-5a82-452f-b435-d4d78aeaf064*.
6. Klicken Sie auf die **Sicherheit** Dropdown-Menü öffnen und auswählen **Berechtigungen**.
7. Überprüfen Sie die *Administratorzustimmung* Registerkarte entspricht dem Bildschirm hier:
#### Validieren Sie die ID der MGAPI-Full-Delegate-Methode der Anwendung und die Scopes 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 die **Microsoft** **Entra ID** Logo.
3. Navigieren zu **Enterprise-Anwendungen**.
4. Standardmäßig, **Alle Anwendungen** werden in der interaktiven Datentabelle angezeigt.
5. Klicken Sie auf die **Zoom** App mit der ID der Anwendung *a651cfda-cbdd-4a39-bd03-fa829c3c1b29*.
6. Klicken Sie auf die **Sicherheit** Dropdown-Menü öffnen und auswählen **Berechtigungen**.
7. Überprüfen Sie die *Administratorzustimmung* Die Registerkarte entspricht hier dem Bildschirm:\\
#### Validieren Sie die ID der persönlichen Kalender-Anwendungsberechtigungen und die Scopes
Wenn Sie die Methode für Anwendungsberechtigungen für persönliche Kalender 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 die **Microsoft Entra ID** Logo.
3. Navigieren zu **Enterprise-Anwendungen**.
4. Standardmäßig, **Alle Anwendungen** werden in der interaktiven Datentabelle angezeigt.
5. Klicken Sie auf die **Zoom** App mit der ID der Anwendung *f46ceaed-fb2d-4694-803b-6341837f0ed2*.
6. Klicken Sie auf die **Sicherheit** Dropdown-Menü öffnen und auswählen **Berechtigungen**.
7. Überprüfen Sie die *Administratorzustimmung* Registerkarte entspricht dem Bildschirm hier:
#### Validieren Sie die ID der persönlichen Kalender-OAuth-Anwendung und die Scopes
Wenn Sie für Ihre Benutzer die OAuth-Integrationsmethode verwendet haben, auch Delegated Permissions 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 die **Microsoft Entra ID** Logo.
3. Navigieren zu **Enterprise-Anwendungen**.
4. Standardmäßig, **Alle Anwendungen** werden in der interaktiven Datentabelle angezeigt.
5. Klicken Sie auf die **Zoom** App mit der ID der Anwendung *fc108d3f-543d-4374-bbff-c7c51f651fe5*.
6. Klicken Sie auf die **Sicherheit** Dropdown-Menü öffnen und auswählen **Berechtigungen**.
7. Überprüfen Sie die *Administratorzustimmung* Registerkarte entspricht dem Bildschirm hier:
---
# 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.