> 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/tr/yonetici-kosesi/third-party-integrations/zoom-and-microsoft-integration-and-deployment-field-guide/getting-started-with-microsoft-and-zoom-workplace-deployments.md).
# Microsoft ve Zoom Workplace Dağıtımlarına Başlarken
Bu bölüm, Zoom Workplace içindeki her Microsoft Entegrasyonlar üzerinde etkisi olan kararları kapsar. Takvimleri, Outlook’u, Teams’i veya oda iş akışlarını dağıtmadan önce buradan başlayın.
### Ön Koşullar
Zoom ve Microsoft entegrasyonları genel olarak iki desene ayrılır:
1. **Microsoft-yüzeyli entegrasyonlar**, burada Zoom özellikleri Teams veya Outlook gibi Microsoft ürünlerinin içinde sunulur.
2. **Zoom-yüzeyli entegrasyonlar**, burada Microsoft hizmetleri veri kaynakları, kimlik sağlayıcıları veya kaydetmek sistemleri olarak Zoom’a getirilir.
Bu kılavuzdaki birkaç Entegrasyonlar, Microsoft 365 hesapları, Entra ID izinleri ve API yapılandırma seçeneklerini içeren ortak ön koşulları paylaşır. Bunları en başta doğru şekilde kurmak, ileride yeniden iş yapmayı önler.
#### Entegrasyon için Gerekli Hesapların ve Kimlik Bilgilerinin Toplanması
Bu kılavuzda belirtilen adımları başarıyla tamamlamak için aşağıdaki hesaplara ve kimlik bilgilerine ihtiyacınız olacak:
* Exchange Online yönetici izinlerine sahip bir Microsoft 365 Yönetici Hesabı, **ve**:
* Hesabın her ikisi için de Exchange Online yönetici izinlerine sahip olması gerekir **Organizasyon Yönetimi** ve **Alıcı Yönetimi**.
* Microsoft Graph API Uygulama İzinleri, Zoom uygulamasını Microsoft Entra ID Kurumsal Uygulama'ya Eklemek için bir Microsoft 365 Global yönetici veya Microsoft 365 Bulut Uygulama Yöneticisi izinlerine sahip bir kullanıcı gerektirir.
* Microsoft Graph API Uygulama İzinleri en az bir [ilişkili etki alanı](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0066259) gerektirir; bu etki alanı Microsoft 365 kiracınızda doğrulanmış özel bir etki alanıyla eşleşmelidir.
* Zoom Rooms'a erişimi olan bir Rol.
* Toplantı odaları için takvim kaynaklarını listeleme, oluşturma ve yönetme yeteneği.
* Windows 10 veya üzeri ya da Windows Server 2016 veya üzeri için Windows PowerShell'de Yönetici Erişimi
**Zoom Workplace izinlerini Microsoft Entra ID kullanıcı onayı Ayarları ile eşleşecek şekilde Yapılandır**
Her türlü Microsoft 365 takvimini Zoom platformuyla entegre etmedeki ilk adım, Microsoft Entra ID (eski adıyla Azure Active Directory) kullanıcı onay ayarlarınızla eşleşecek şekilde Zoom izinlerinizi Yapılandırmaktır.
Bu süreç, bu kılavuzdaki kalan adımları izlerken bir eşleştirme çalışması yoluyla Zoom platformu ile Entra ID arasındaki İzin sorunlarını engellemek için tasarlanmıştır.
**Geçerli Microsoft Entra ID kullanıcı onayı Ayarlarını belirleyin**
1. Şuraya giriş yapın: [Microsoft Azure yönetim portalı](https://portal.azure.com/) bir Microsoft 365 yönetici hesabı kullanarak.
2. Altında **Azure services** bölümünde, şuna tıklayın: **Microsoft Entra ID** simgesi.
3. Altında **Yönet** açılır menüsünde, şuna tıklayın: **Kurumsal uygulamalar**.
4. Security açılır menüsünün altında, şuna tıklayın: **Onaylar ve izinler**.
5. Şunun değerini not edin: *Kullanıcı onayı for applications bölümü*; bu, aşağıdakilerden biri olacaktır:
1. Kullanıcı onayına izin vermeyin
2. Doğrulanmış yayıncılardan gelen uygulamalar için, seçili izinler için kullanıcı onayına izin verin
3. Uygulamalar için kullanıcı onayına izin verin
**Kullanıcı onayı ve Zoom web portalı Ayarlarının eşleştiğini onaylayın**
Organizasyonunuz, kullanıcı onayı Ayarlar'ını kısıtlamayı veya kullanıcı onayına İzin Ver seçebilir. Zoom, kullanıcıların Entra ID uygulamalarına kendilerinin onay vermesine İzin Ver şeklinde basitleştirilmiş bir İzinler yöntemi önerir. Ancak hangi seçimi yaparsanız yapın, Organizasyonunuz Entra ID seçeneğini Zoom yönetim tarafındaki eşleştirilmiş bir seçenekle eşleştirmelidir.
Microsoft Entra ID kullanıcı onay Ayarlar'ını şu şekilde kullanacak şekilde yapılandırdıysanız **kullanıcı onayına izin verme**, ya da **Onaylanmış yayıncılardan gelen uygulamalar için, seçili izinler için kullanıcı onayına izin ver**, o zaman şu ifadeyi belirten Zoom web ayarı *Tüm hesap adına Office 365 takvim entegrasyonu izinlerine onay ver* şuna ayarlanmalıdır: **Açık**.
Alternatif olarak, kullanıcı onay Ayarlar'ınız şu şekilde yapılandırıldıysa **Uygulamalar için kullanıcı onayına izin ver**, o zaman şu ayarı **Kapalı**.
**(İsteğe Bağlı) Microsoft Office 365 ile entegre etmek için özel bir Microsoft Entra uygulama oluşturma**
Özel bir uygulamayı yapılandırmaya ilişkin tam talimatlar için Zoom Destek makalesine bakın [Office 365 ile Zoom Rooms kurulumu](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0063474).
{% hint style="info" %}
Bu Özellikler olmalıdır [Zoom tarafından etkinleştirilmelidir](https://support.zoom.com/hc/en/contact?id=contact_us).
{% endhint %}
### Hangi API Yönteminin Organizasyonunuz için Doğru Olduğuna Karar Vermek
Bir yönetici için vermesi gereken ilk kararlardan biri, Zoom’un Microsoft hizmetleriyle nasıl kimlik doğrula yapacağıdır. Bu seçim, aşağı akışta birden fazla Entegrasyonlar’ı etkiler; bu nedenle tek tek özellikleri Yapılandırmaya başlamadan önce bunu anlamak önemlidir.
{% hint style="info" %}
Zoom öneriyor **Microsoft Graph API ile Uygulama İzinleri** hem Zoom Rooms hem de kişisel takvim entegrasyonları için varsayılan olarak. Çoğu dağıtım için bu daha basit, daha güvenli ve daha ölçeklenebilir bir yoldur.
{% endhint %}
**Takvim için hangi Microsoft 365 API'lerini kullanıyorsunuz?**
Zoom takvim Entegrasyonlar, Microsoft Graph API (MGAPI)'ye dayanır. Microsoft, başlamıştır [Exchange Web Services (EWS) yöntemlerini aşamalı olarak kaldırmaya](https://techcommunity.microsoft.com/blog/exchange/retirement-of-exchange-web-services-in-exchange-online/3924440) daha önce Microsoft 365 verilerini Zoom Hizmetleri ile bağlamak için Uygun olan yöntemlerdi. Zoom, bu EWS yöntemlerini eski seçenekler olarak değerlendirir.
Uygulama İzinleri ve Devredilmiş İzinler (OAuth) birbirinin yerine geçmez: kullanıcılarınızın gerçekte nasıl çalıştığına bağlı olarak farklı ödünlerle gelirler. Doğru seçim, teknik tercihten daha az, kullanıcılarınızın günlerini nerede geçirdiğine daha çok bağlıdır.
**Konferans odaları için kullanılan resmi Zoom uygulamasını nasıl belirleyebilirim?**
Zoom için konferans odası takvimleme uygulamaları, Entra ID Kurumsal Uygulama dizininde Uygun olarak bulunur ve Graph API yapılandırma yönteminize bağlı olarak aşağıdaki Uygulama Kimlikleriyle kaydedilmiştir:
* `a651cfda-cbdd-4a39-bd03-fa829c3c1b29` (Tam Temsilci Access)
* `f56e91e5-5a82-452f-b435-d4d78aeaf064` (Uygulama İzinleri)
{% hint style="warning" %}
**Zoom Önerisi**
Entra ID portalından uygulamaları manuel olarak Eklemenize gerek yoktur. İzin isteklerini istemek ve onaylamak için Zoom web arayüzünü kullanmak, uygulamayı kiracınıza otomatik olarak Ekleyecektir.
{% endhint %}
**Tam Devretme Access ile Uygulama İzinleri arasındaki fark nedir?**
Genel olarak Zoom, Microsoft Graph API'nin Uygulama İzinleri ile kullanılmasını önerir; çünkü bu yapılandırma biçimi, yönetici açısından kurulum ve bakım için önemli ölçüde daha az çaba gerektirir ve özel bir hizmet hesabı gerektirmez. Ancak, izinleri hesap genelinde bir kapsamda uygular.
Uygulama İzinleri (Yalnızca uygulama erişimi olarak da bilinir), arka plan hizmetleri olarak çalışan ve gereken verilerin tek bir kullanıcı ile sınırlandırılamadığı Kurumsal uygulamalar için Microsoft'un önerdiği yaklaşımdır.
Tam Temsilci Access ile Microsoft Graph API alternatif bir seçenektir, ancak özel bir hizmet hesabı ve ilk kurulum ile bakım için daha fazla çaba gerektirir.
#### Zoom Rooms için: Uygulama İzinleri
Zoom Rooms ve üçüncü taraf konferans odaları için Uygulama İzinleri, hiçbir istisna olmaksızın Zoom'un önerisidir. Odalar için iki yöntem arasında hiçbir Özellikler açığı yoktur ve Uygulama İzinleri, oda posta kutuları için bir temsilci olarak hareket edecek özel bir hizmet hesabına duyulan ihtiyacı ortadan kaldırır.
Bu, ilk kurulum çabasını azaltır ve devam eden bir bakım bağımlılığını ortadan kaldırır.
#### Kullanıcılar için: Zoom Workplace'i Nasıl Kullandıklarıyla Başlayın
Kişisel takvim Entegrasyonlar için, Zoom Uygulama İzinleri'ni önerir; ancak seçiminiz, Organizasyonunuzdaki kullanıcıların her gün Zoom Workplace ile nasıl etkileşim kurduğuna bağlıdır.
**Çoğu Organizasyon: Uygulama İzinleri (Önerilir)**
Kullanıcılarınız öncelikle toplantıları Outlook Eklentisi üzerinden Planlıyor ve Katılıyor ve takvim, sohbet ya da diğer iş akışları için Zoom Workplace uygulamasını düzenli olarak açmıyorsa, Uygulama İzinleri daha uygun bir seçenektir.
İşte nedeni:
* **Yönetici tarafından yönetilen, buluttan buluta Entegrasyonlar.** takvim entegrasyonu hesap düzeyinde yönetilir. Bireysel kullanıcıların kendi bağlantılarını yetkilendirmesi veya sürdürmesi gerekmez. Entegrasyon bozulursa, yöneticiler sorunları bireysel kullanıcıların bildirmesine güvenmek yerine bunu hemen fark eder.
* **Daha güçlü belirteç güvenliği.** Uygulama İzinleri, buluttan buluta bir değişim yoluyla her 60 dakikada bir yenilenen kısa ömürlü bir erişim belirteci kullanır. Belirteç hiçbir zaman kalıcı olarak saklanmaz ve yalnızca bellekte tutulur. Yenileme belirteci yoktur ve çevrimdışı erişim izni de verilmez. Bir kullanıcı devre dışı bırakılırsa, takvim verilerine erişmek için kullanılabilecek kalan belirteçler kalmaz.
* **Kullanıcının oturum açma davranışına bağlı değildir.** Devredilen İzinlerle, Entegrasyonlar bireysel kullanıcıların Zoom Workplace uygulamasında oturum açmış olmasına dayanır. Bir kullanıcının belirteci süresi dolarsa veya parolasını değiştirirse, takvim entegrasyonu sessizce bozulur. Esas olarak Outlook kullanıyorlarsa bunu haftalarca fark etmeyebilirler. Uygulama İzinleri bu hata modunu tamamen ortadan kaldırır.
**Yetkilendirilmiş İzinlerin daha iyi bir seçenek olabileceği durumlar**
Kullanıcılarınız düzenli Zoom Workplace uygulama kullanıcılarıysa, Devredilen İzinler daha iyi bir seçenek olabilir:
* **Paylaşılan takvimler.** Delegated Permissions, kullanıcıların Microsoft 365’te erişim sahibi oldukları çalışma arkadaşlarının paylaşılan takvimlerini görüntülemesine İzin Verir. Uygulama Permissions ile kullanıcılar yalnızca Zoom Workplace uygulamasında kendi takvimlerini görebilir.
* **Zoom Workplace'te e-posta.** Workplace uygulaması içindeki Zoom Mail İstemcisi, bir kullanıcının Microsoft 365 posta kutusuna erişmek için Yetkilendirilmiş İzinler gerektirir. Uygulama İzinleri yöntemi bugün bu Entegrasyonlar'ı desteklemiyor.
* **Kendi kendine hizmet görünürlüğü.** Bir kullanıcının Delegated Entegrasyonlar'ı bozulduğunda, örneğin belirteç süresinin dolması veya parola Değiştirildiğinde, Workplace uygulamasında doğrudan yeniden kimlik doğrula istemi görürler. Zaten uygulama içinde yaşayan kullanıcılar için bu, daha hızlı self-servis kurtarma sağlar.
#### Hepsini bir araya getirmek: Dağıtımınız için öneriler
Çoğu Zoom/Microsoft dağıtımı için öneri şöyledir:
* **Odalar:** Uygulama İzinleri. Ödün gerekmez, kurulum daha basittir, hizmet hesabı gerekmez.
* **Kullanıcılar:** Uygulama İzinleri, kullanıcılarınız Zoom Workplace uygulaması içinde paylaşılan takvimlere veya e-postaya aktif olarak güvenmiyorsa.
Seçim kalıcı değildir. Kuruluşlar, yeniden yetkilendirme yoluyla yöntemler arasında Değiştir yapabilir.
Emin değilseniz, Uygulama İzinleri ile başlayın. Bu size güvenilir bir Entegrasyonlar sunar ve daha sonra paylaşılan takvim veya e-posta gereksinimleri ortaya çıkarsa belirli kullanıcı grupları için Devralınan İzinler ekleme seçeneği sağlar.
Aşağıdaki diyagramlar, kimlik bilgileri aktarım halindeyken Delegated ve uygulama tabanlı yöntemleri Göster.
Delegated yöntemi, yetkilendirme sağlasa da kimlik bilgilerini Zoom uygulamasına gönderir.
Daha ölçeklenebilir bir yöntem olan uygulama tabanlı yetkilendirme, kullanıcı kimlik bilgilerinin veya belirteçlerin Zoom uygulamasına doğrudan ulaşmasını önler.
### Güvenlik ve Veri İşleme
Zoom Web Takvim Hizmeti, her kullanıcının takvim sağlayıcısının kimliğini doğrulamak için gereken nesneleri saklar. Bu, kuruluşlar Outlook veya Google Takvim'i Zoom hizmetlerine bağlamak için OAuth kullandığında Zoom'un yenileme belirtecini sakladığı anlamına gelir. Ayrıca bu, Exchange On-Premises'e Temel kimlik doğrulama kullanan kuruluşlar için, Zoom'un hesap Kullanıcı Adı ve parolayı sakladığı anlamına da gelir.
| Eşitlenen Etkinlikler |
| ------------------------------ |
| `katılımcılarAtlandı` |
| `açıklama` |
| `görünenAd` (rolsüz katılımcı) |
| `e-posta` (rolsüz katılımcı) |
| `sabitÇalışmaKonumu` |
| `iCalUID` |
| `Konum` |
| `görünenAd` (düzenleyici) |
| `e-posta` (düzenleyici) |
| `özet` |
| `zamanÖnerisi` |
| `çalışmaKonumuEtkin` |
Çift yönlü Takvim Eşitleme (Eşitle 2.0) etkinleştirildiğinde, Zoom harici takvim Etkinlik verilerini (Microsoft 365 veya Google Takvim'den) kendi veritabanında tutmaz.\
\
Bunun yerine hizmet, 24 aylık hareketli bir takvim etkinliği penceresini izler (geçmişte 6 aya kadar ve gelecekte 18 aya kadar). Bu pencere içinde değişiklikler olursa, Zoom takvim sağlayıcısından değişiklik bildirimleri alır ve ilgili Zoom toplantı güncellemelerini işlemek için güncellenmiş Etkinlik verilerini gerektiğinde alır. Ardından gerekli değişiklikleri uygulaması için toplantı hizmetine bildirim gönderilir.
Yöneticiler, hesap veya kullanıcı grup düzeyinde bu Özellikler için Yapılandır işlemini yapabilir. Bkz. [destek belgeleri](https://support.zoom.us/hc/en-us/articles/8522918261645-Enabling-bi-directional-calendar-sync) daha fazla bilgi için bakın.
#### Depolanan token'lar ve kimlik bilgileri nasıl korunur?
Depolanan belirteçler ve kimlik bilgileri, 256 bit AES-GCM şifreleme kullanılarak bekleme durumunda şifrelenir. Bu veri, müşteri içeriği olarak kabul edilir ve Zoom’un erişim kontrolü politikalarına ve standartlarına tabidir. Bu kontroller, güvenlik sertifikalarımızda ve SOC 2 gibi beyanlarımızda belirtildiği üzere bağımsız denetim firmaları tarafından değerlendirilir. Altyapı verilerine ve sistemlere yönelik Ayrıcalıklı erişim, çok faktörlü kimlik doğrulama ve en az Ayrıcalık erişim kontrolleri kullanılarak kaydedilir, izlenir ve denetlenir.
#### Uygulamalar ile takvim sağlayıcısı arasındaki trafik nasıl korunur?
takvim sağlayıcıları ile herhangi bir Zoom yazılımı — Zoom masaüstü/mobil uygulamaları, Zoom Web takvim Hizmeti, planlama araçları ve API Bağlayıcı — arasındaki iletişimler, TLS 1.2 kullanılarak aktarım sırasında şifrelenir.
#### Bir OAuth belirteci ne kadar süre geçerlidir?
Zoom, 1 saat içinde süresi dolan erişim belirteçleri ve 90 gün içinde süresi dolan yenileme belirteçleri isteyecektir; ancak takvim sağlayıcıları alternatif sınırlara sahip belirteçler sağlayabilir. varsayılan değerleri değiştirmek istiyorsanız sağlayıcınızın talimatlarını izleyin.
#### Bir OAuth belirteci veya kimlik bilgisi iptal edebilir miyim?
Zoom yöneticileri, herhangi bir zamanda tek bir Zoom hesabından takvim entegrasyonunu kaldırmayı Seçebilir; bu, kullanıcının takvim kullanımının çalışmasını engelleyecektir. Bu kullanıcıya ait depolanan tüm belirteçleri veya kimlik bilgilerini hemen silin.
Microsoft 365 yöneticileri, tüm kullanıcı hesaplarından Zoom’un takvim erişimini, Entra ID Kurumsal Uygulama portalında Zoom uygulamasını silerek kaldırabilir ve Google çalışma alanı yöneticileri Google Cloud Platform Konsolu’nu kullanarak erişimi iptal edebilir.
#### Zoom’un bir sağlayıcıya takvim veya kişi verisi yazma yeteneğini sınırlayabilir miyim?
İlk yapılandırmadan sonra, Zoom yöneticileri Microsoft 365 yöntemleri üzerinden Bağlanıyor sırasında hem takvim hem de kişiler için Salt Okuma ve Okuma/Yazma izinleri arasında Seçebilir. Yöneticiler ayrıca kullanıcı takvimleri için Google çalışma alanı entegrasyonlarını da sınırlayabilir.
### Entra ID İzinlerini Doğrulama
#### Konferans odaları için MGAPI Uygulama İzinleri yönteminin Uygulama Kimliğini ve kapsamlarını doğrulayın
Zoom Rooms veya üçüncü taraf konferans odaları için Uygulama İzinleri yöntemini kullanıyorsanız, izinleri aşağıdaki adımları kullanarak doğrulayın:
1. Microsoft 365 yönetici hesabını kullanarak Azure portalına Giriş yapın.
2. Şuna tıklayın **Microsoft** **Entra ID** logosu.
3. Şuraya gidin **Kurumsal Uygulamalar**.
4. Varsayılan olarak, **Tüm uygulamalar** etkileşimli veri tablosunda Gösterilir.
5. Şuna tıklayın **Zoom** uygulaması, Uygulama Kimliği ile *f56e91e5-5a82-452f-b435-d4d78aeaf064*.
6. Şuna tıklayın **Güvenlik** açılır menüsünden Seç **İzinler**.
7. Yönetici onayını doğrulayın *Yönetici onayı* sekmesi buradaki ekranla eşleşir:
#### Konferans odaları veya Zoom Rooms için MGAPI Tam Temsilci yönteminin Uygulama Kimliğini ve kapsamlarını doğrulayın
Zoom Rooms veya üçüncü taraf konferans odaları için Full Delegate yöntemini kullanıyorsanız, aşağıdaki adımları kullanarak izinleri doğrulayın:
1. Microsoft 365 yönetici hesabını kullanarak Azure portalına Giriş yapın.
2. Tıkla **Microsoft** **Entra ID** logosu.
3. Şuraya gidin **Kurumsal Uygulamalar**.
4. Varsayılan olarak, **Tüm uygulamalar** etkileşimli veri tablosunda Gösterilir.
5. Tıkla **Zoom** uygulaması, Uygulama Kimliği ile *a651cfda-cbdd-4a39-bd03-fa829c3c1b29*.
6. Tıkla **Güvenlik** açılır menüsünden Seç **İzinler**.
7. Yönetici onayını doğrulayın *Yönetici onayı* sekme buradaki ekranla eşleşir:\\
#### Kişisel takvim Uygulama İzinleri Kimliğini ve kapsamlarını doğrulayın
Kişisel takvimler için Uygulama İzinleri yöntemini kullanıyorsanız, aşağıdaki adımları kullanarak izinleri doğrulayın:
1. Microsoft 365 yönetici hesabını kullanarak Azure portalında oturum açın.
2. Tıklayın **Microsoft Entra ID** logosu.
3. Bölümüne gidin **Kurumsal Uygulamalar**.
4. Varsayılan olarak, **Tüm uygulamalar** etkileşimli veri tablosunda gösterilir.
5. Tıklayın **Zoom** uygulama, Uygulama Kimliği ile *f46ceaed-fb2d-4694-803b-6341837f0ed2*.
6. Tıklayın **Güvenlik** açılır menüsünü açın ve **İzinler**.
7. Doğrulayın *Yönetici onayı* sekmesi buradaki ekranla eşleşir:
#### Kişisel takvim OAuth Uygulama Kimliğini ve kapsamlarını doğrulayın
Kullanıcılarınız için OAuth Entegrasyonlar yöntemini, diğer adıyla Yetki Devri İzinleri'ni kullandıysanız, izinleri aşağıdaki adımları kullanarak doğrulayın:
1. Microsoft 365 yönetici hesabını kullanarak Azure portalına Giriş yapın.
2. Tıkla **Microsoft Entra ID** logosu.
3. Şuraya gidin **Kurumsal Uygulamalar**.
4. Varsayılan olarak, **Tüm uygulamalar** etkileşimli veri tablosunda Gösterilir.
5. Tıkla **Zoom** uygulaması, Uygulama Kimliği ile *fc108d3f-543d-4374-bbff-c7c51f651fe5*.
6. Tıkla **Güvenlik** açılır menüsünden Seç **İzinler**.
7. Yönetici onayını doğrulayın *Yönetici onayı* sekmesi buradaki ekranla eşleşir:
---
# 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/tr/yonetici-kosesi/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.