> 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/configuring-microsoft-platform-integrations-for-zoom-workplace.md).

# Zoom Workplace için Microsoft platform Entegrasyonlarını Yapılandırma

Zoom ve Teams genelinde takvim davranışını, toplantı planlamasını ve varlığı etkileyen temel Microsoft entegrasyonlarını Yapılandır.

Bu Entegrasyonlar platform katmanında yer alır. Outlook, Teams, konferans odaları veya içerik düzeyindeki Entegrasyonlardan önce bunları Yapılandırın.

<details open>

<summary>Platform Düzeyinde Entegrasyon Senaryoları</summary>

{% hint style="success" icon="face-thinking" %}
**"Kullanıcılarımın Microsoft Outlook'u Zoom'a entegre etmenin karmaşıklığı nedeniyle yaşadığı takvim eşitleme sorunlarını ve toplantılara katılma hatalarını ortadan kaldırmak istiyorum."**

<a href="https://library.zoom.com/technical-library/tr/yonetici-kosesi/third-party-integrations/zoom-and-microsoft-integration-and-deployment-field-guide/configuring-microsoft-platform-integrations-for-zoom-workplace.md#calendar-integration-and-bi-directional-sync" class="button secondary" data-icon="hand-point-right">Şuraya gidin: Takvim Entegrasyonu ve Çift Yönlü Eşitleme</a>
{% endhint %}

{% hint style="success" icon="face-thinking" %}
**"Kullanıcılarımın Microsoft Teams toplantıları oluşturmasına izin vermeden, tüm toplantılarımın her durumda Zoom platformunu kullanmasını zorunlu kılmak istiyorum."**

<a href="https://library.zoom.com/technical-library/tr/yonetici-kosesi/third-party-integrations/zoom-and-microsoft-integration-and-deployment-field-guide/configuring-microsoft-platform-integrations-for-zoom-workplace.md#setting-up-calendaring-integration-enabling-bi-directional-sync-and-setting-the-default-meeting-type" class="button secondary" data-icon="hand-point-right">Şuraya gidin: Tüm Toplantıları Zoom Toplantısı Olmaya Zorlama</a>
{% endhint %}

{% hint style="success" icon="face-thinking" %}
**"Microsoft Teams ve Zoom kullanıcılarımın uygulamalar arasında doğru durum bilgilerini (Uygun, meşgul, Toplantıda vb.) paylaşmasını istiyorum."**

<a href="https://library.zoom.com/technical-library/tr/yonetici-kosesi/third-party-integrations/zoom-and-microsoft-integration-and-deployment-field-guide/configuring-microsoft-platform-integrations-for-zoom-workplace.md#bi-directional-presence-sync" class="button secondary" data-icon="hand-point-right">Şuraya gidin: Çift Yönlü Durum Eşitleme</a>
{% endhint %}

</details>

### Takvim Entegrasyonu ve Çift Yönlü Eşitleme

Takvim entegrasyonu, bu kılavuzdaki etkisi en yüksek tek yapılandırmadır. Düzgün çalıştığında kullanıcılar Zoom ve Outlook genelinde birleşik bir takvim deneyimi yaşar. Çalışmadığında ise destek taleplerinin başlıca nedenlerinden biri olur.

Bu bölümde Zoom’un takvim Entegrasyonunun nasıl çalıştığı ve nasıl Yapılandırılacağı ele alınmaktadır.

#### <mark style="color:mavi;">Nedir ve neden önemlidir?</mark>

* Kullanıcılar Zoom uygulamalarında tam bir takvim (Zoom dışındaki toplantılar da dahil) görür
* Kullanıcılar Zoom uygulamalarından toplantı planlayabilir ve düzenleyebilir
* Zoom Rooms ekranları ve planlama ekranları yaklaşan takvim etkinliklerini gösterir
* Standartlara dayalı H.323 ve SIP uç noktaları, Gelişmiş API Bağlayıcısı aracılığıyla Zoom toplantılarına otomatik olarak veya tek dokunuşla katılabilir

{% hint style="info" %}
Çift Yönlü Eşitleme **takvim entegrasyonu Aktif olduğunda önerilir ve varsayılan olarak etkindir** Çift Yönlü Eşitleme ile Entegrasyonlar hem Zoom hem de Zoom dışındaki takvim etkinliklerini kapsar ve Zoom'u merkezi planlama merkezi olarak kullanan kişilere birleşik bir deneyim sunar.

Çift Yönlü Takvim Eşitlemesini etkinleştirmek, planlama sırasında silinen, düzenlenen veya yarıda bırakılan tüm üçüncü taraf takvim etkinliklerinin Zoom Web Takvim Hizmeti ile otomatik olarak eşitlenmesini sağlar.
{% endhint %}

#### <mark style="color:mavi;">Hangi takvim sağlayıcıları destekleniyor?</mark> <a href="#which-calendaring-providers-are-supported" id="which-calendaring-providers-are-supported"></a>

Zoom Müşterileri, kişi ve takvim verilerini üç sağlayıcıyla entegre edebilir:

* Microsoft 365 (eski adıyla Office 365)
* Microsoft Exchange Server
* Google çalışma alanı

#### Takvim Entegrasyonu nasıl çalışır? <a href="#how-does-the-calendaring-integration-work" id="how-does-the-calendaring-integration-work"></a>

Zoom’un takvim Entegrasyonları dört aşamadan oluşur: yetkilendirme, etkinlik izleme, uç nokta verilerini alma ve çift yönlü Eşitleme. İlk iki aşama tüm uç noktalar ve yöntemler için aynıdır. Üçüncü aşama, uç nokta türüne ve seçilen kimlik doğrulama yöntemine göre farklılık gösterir.

{% stepper %}
{% step %}

#### **Yetkilendirme ve kimlik bilgilerinin güvenli şekilde depolanması**

Zoom yöneticileri veya Organizasyon izin veriyorsa kullanıcılar, öncelikle Zoom web portalı üzerinden takvim hizmeti sağlayıcılarına erişim yetkisi vermelidir.

Zoom, bağlı takvime erişmek için gereken nesneleri kalıcı, şifrelenmiş ve güvenli bir Konumda depolar. OAuth 2.0 kullanıldığında Zoom, erişim belirteçlerini ve devredilmiş erişim yenileme belirteçlerini Zoom bulutta güvenli şekilde depolar. Ancak OAuth 2.0’ı desteklemeyen şirket içi Exchange için Zoom, erişimi sürdürmenin kullanılabilir tek yöntemi bu olduğundan, Kullanıcı Adı ve parolayı Zoom bulutta güvenli şekilde depolamalıdır.

{% hint style="info" %}
Exchange şirket içi ile doğrudan Entegrasyon, Temel kimlik doğrulama gerektirir.
{% endhint %}

{% hint style="info" %}
Takvim Entegrasyonlarını kimlik bilgilerini şifreleyip depolamak üzere Zoom Müşteri Tarafından Yönetilen Anahtar’ı (CMK) kullanacak şekilde isteğe bağlı olarak Yapılandırabilirsiniz. Böylece Zoom bulut altyapısında bekleyen belirli verileri kendi şifreleme anahtarlarınızla koruyabilirsiniz. CMK ücretli bir hizmettir ve Zoom’un Kendi Anahtarınızı Getirin (BYOK) çözümüdür. Daha fazla bilgi için [Zoom CMK hakkında daha fazla bilgi edinin](https://www.zoom.com/en/blog/zoom-customer-managed-key/) Zoom web sitesini ziyaret edin.
{% endhint %}
{% endstep %}

{% step %}

#### **Etkinlik izleme ve Değişiklik bildirimleri**

Takvim web portalında bağlandıktan sonra Zoom Web Takvim Hizmeti, her kullanıcı için takvim hizmeti sağlayıcısının bir web kancasına abone olur. Bu web kancaları, takvimdeki tüm değişiklikleri Web Takvim Hizmetine bildirir; böylece hizmet, uygun Zoom uç noktalarına güncelleme gerektiğini bildirebilir.
{% endstep %}

{% step %}

#### **Uç nokta verilerini alma**

Takvim verilerinin Zoom uç noktasına nasıl ulaştığı, uç nokta türüne ve seçilen kimlik doğrulama yöntemine bağlıdır. Aşağıdaki bölümlerde her model açıklanmaktadır.

**Masaüstü ve mobil uygulamalar: Devredilmiş erişim**

Devredilmiş erişim kullanıldığında Zoom Web Takvim Hizmeti, oturum açma sırasında OAuth erişim belirtecini masaüstü veya mobil istemciye iletir. İstemci bu belirteci geçici olarak bellekte tutar ve etkinlik verilerini almak için doğrudan takvim hizmeti sağlayıcısına bağlanırken kullanır. Erişim belirteci geçersizse Zoom Web Takvim Hizmeti, yeni bir erişim belirteci istemek için depolanan yenileme belirtecini kullanır ve bu belirteci istemciye iletir.

**Masaüstü ve mobil uygulamalar: Uygulama izinleri (Microsoft Graph API)**

Uygulama izinleri yöntemi kullanıldığında erişim belirteçleri Zoom bulutta kalır ve istemci cihazlara iletilmez. Bunun yerine tüm takvim verisi istekleri, istemci adına Zoom Web Takvim Hizmeti üzerinden iletilir. İstemci doğrudan takvim hizmeti sağlayıcısına bağlanmaz.

**Zoom Rooms: Her iki yöntem**

Uygulama izinleri veya tam devredilmiş erişim kullanılmasına bakılmaksızın Zoom Rooms, belirteçleri hem Zoom bulutta hem de Zoom Room uç noktasında yerel olarak depolar. Zoom Rooms, takvim verilerini almak için doğrudan takvim hizmeti sağlayıcısına bağlanır.

{% hint style="info" %}
sayfadaki diyagramlar [Sağlayıcıya Özgü Ayrıntılar](https://library.zoom.com/technical-library/tr/yonetici-kosesi/third-party-integrations/zoom-calendaring-integration-explainer/provider-specific-details.md) kullanıcıların masaüstü ve mobil Entegrasyonları için devredilmiş ve uygulama tabanlı Microsoft Graph API yöntemlerini gösterir. Zoom Rooms, yukarıda açıklandığı gibi farklı bir belirteç depolama ve alma modeli kullanır.
{% endhint %}
{% endstep %}

{% step %}

#### Çift Yönlü Takvim Eşitleme

Çift Yönlü Takvim Eşitleme etkinleştirildiğinde, kullanıcı Zoom istemcisinden veya web üzerinden bir toplantı planlar ya da güncellerse Web Takvim Hizmeti, takvim hizmeti sağlayıcısının API’si aracılığıyla kullanıcının takviminde etkinliği oluşturur veya günceller.

{% hint style="info" %}
Yöneticiler, [Çift Yönlü Eşitlemeyi Yapılandırabilir](https://support.zoom.us/hc/en-us/articles/8522918261645-Enabling-bi-directional-calendar-sync) hesap veya kullanıcı grubu düzeyinde.

Çift Yönlü Eşitleme, aşağıdaki toplantı türlerinde yapılan güncellemeleri destekler:

* Tek bir toplantı
* Bir toplantı dizisi (yinelenen)
* Bir toplantı dizisinin tek bir gerçekleşmesi
  {% endhint %}
  {% endstep %}
  {% endstepper %}

#### <mark style="color:mavi;">Takvim Entegrasyonunu kurma, Çift Yönlü Eşitlemeyi Etkinleştirme ve varsayılan toplantı türünü ayarlama</mark>

Aşağıdaki talimatlar kişisel takvimleri bağlamanıza, Çift Yönlü Eşitlemeyi Etkinleştirmenize ve varsayılan toplantı türü olarak Zoom Meetings’i ayarlamanıza yardımcı olur.

**Kişisel Takvimleri Bağlanıyor**

Kullanıcıların Microsoft 365 takvimlerini Zoom Workplace uygulamasıyla entegre etmelerine İzin Vermek için hesabınızı Yapılandırmak üzere aşağıdaki adımları izleyin:

1. Zoom yöneticisi olarak şu adreste oturum açın:  [zoom.us](http://zoom.us/).
2. şuradaki [**Yönetici merkezi**](https://zoom.com/account) gezinme menüsünde, tıklayın [**Ayarlar**](https://zoom.com/account/setting).
3. Şuraya gidin:  *Posta ve Takvim*  sekmesi.
4. Şuna tıklayın:  **Entegrasyonlar**  sekmesi; ilgili Ayarlar'a gitmek için.
5. Şuna tıklayın:  **Aç/Kapat** yanındaki düğme *Üçüncü taraf posta ve takvim hizmetlerini entegre edin* ardından tıklayın **Etkinleştir** açılır pencerede.
6. için *Kullanıcılar için varsayılan takvim ve kişi hizmetlerini seçin* ayarında, Seç **Office 365** ve şu ayar için *Şununla yetkilendir:*: ayarı için şunu seçin: **Graph API**.

{% hint style="info" %}
“Exchange Web Services(EWS)” seçeneği önerilmez. Microsoft, daha önce Microsoft 365 verilerini Zoom Hizmetleri ile bağlamak için Uygun olan EWS yöntemlerini aşamalı olarak kullanımdan kaldırmaya başlamıştır. Zoom, bu EWS yöntemlerini desteklenmeyen eski seçenekler olarak değerlendirir.
{% endhint %}

7. Şunun altında: *Entegrasyonlar’ı kim kurabilir?*: ayarı için aşağıdaki seçeneklerden birini seçin:
   1. **Kullanıcılar, OAuth kullanarak Entegrasyonlar'ı kurabilir**
   2. **Office 365 yöneticisi, Uygulama İzinleri’ni kullanarak Entegrasyonlar’ı kurabilir** bu işlem, ek yapılandırma için Microsoft 365 ortamınızı açar.

{% hint style="info" %}
OAuth'un mu yoksa Uygulama İzinleri'nin mi daha iyi olduğuna karar vermek, şirketinizin hedeflerine ve tercihlerinize bağlı olarak değişir.

Şu **OAuth** Yöntem, Temsilci İzinleri olarak da adlandırılır ve Zoom web portalındaki ayarın üzerinde seçilen izin kapsamlarını yansıtarak verdiği izinlerde esneklik sunar. Ancak bu ayar, takvim etkinliklerinin eşitlenmemesine yol açabilir; çünkü belirteç iptal edilirse veya kullanıcının parolası değiştirilirse Entegrasyonlar sona erer ve yeniden kimlik doğrulama gerekir.

Alternatif olarak,  **Uygulama İzinleri** yöntem, kullanıcıların belirli aralıklarla kimliklerini yeniden doğrulamasını gerektirmez; ancak aynı düzeyde işlevselliği desteklemeyebilir. Ayrıca Zoom Workplace’e Microsoft 365 ortamınıza başlangıçta daha geniş bir erişim düzeyi sağlar. Varsayılan olarak, uygulamayı onaylarken bu kapsam izinleri kısıtlanamaz; ancak yöneticiler, şu adımları izleyerek Entra ID içinde bu uygulamanın izin kapsamını sonradan ayarlayabilir: [Entra ID İzinlerini İptal Etme](#id-51ygv2kwmxbi) bu kılavuzun bölümü. Zoom Workplace'in takvim etkinliklerine erişimini korumasını ancak posta kutularına erişmemesini istiyorsanız tüm izinleri iptal edebilirsiniz *hariç* **Takvim.OkuYaz**. Gerekli izinlerin tam listesi için şu kaynağa başvurun [MGAPI Uygulama İzinleri yönteminin Uygulama Kimliklerini ve Kapsamlarını doğrulayın](#yn2twi7v7su4) bölümü.
{% endhint %}

**Çift Yönlü Eşitlemeyi Etkinleştirme**

Çift Yönlü Takvim Eşitlemeyi Etkinleştirmeye ilişkin adım adım talimatlar için Zoom Destek makalesine bakın: [Çift yönlü takvim eşitlemesini Etkinleştirme veya Devre dışı bırakma](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0058782).

**Tüm Toplantıları Zoom Meetings Olarak Ayarlama**

Microsoft Outlook’u tüm çevrimiçi toplantılarda varsayılan olarak Zoom Meetings’i kullanacak şekilde Yapılandırmak için Outlook’un kendi Ayarlar’ını düzenlemeniz gerekir. Microsoft, bu yapılandırmaya ilişkin ayrıntılı talimatları destek belgelerinde sunar.

Her toplantıyı çevrimiçi toplantı hâline getirme ve varsayılan sağlayıcı olarak Zoom’u ayarlama konusunda adım adım rehberlik için Microsoft’un destek makalesine bakın: [Her toplantıyı çevrimiçi hâle getirme](https://support.microsoft.com/en-us/office/make-every-meeting-online-70f9bda0-fd29-498b-9757-6709cc1c73f0).

Kullanıcıların Teams toplantıları oluşturma olanağını Devre dışı bırakmak için Microsoft’un şu destek makalesine de bakabilirsiniz: [Anlık toplantıları kimlerin başlatabileceğini ve toplantı Planlayabileceğini yönetme](https://learn.microsoft.com/en-us/microsoftteams/manage-who-can-schedule-meetings).

**Ek Kaynaklar**

<table data-header-hidden="false" data-header-sticky><thead><tr><th></th><th>Hizmet</th><th>Kimlik Doğrulama Yöntemi</th><th>Zoom Takvim Hizmetinin Sakladıkları</th><th>Uç Noktanın Oturum Açarken Aldıkları</th><th>Uç Noktanın Takvimi Aldığı Kaynak</th></tr></thead><tbody><tr><td><strong>Kullanıcı Takvimleri</strong></td><td>Microsoft 365</td><td>OAuth</td><td>Her kullanıcı hesabı için Access ve yenileme belirteci.</td><td>Zoom Takvim Hizmetinden alınan Access belirteci.</td><td>Microsoft 365</td></tr><tr><td><strong>Exchange Server</strong></td><td>Temel</td><td>Her kullanıcı hesabı için Kullanıcı Adı ve parola.</td><td>Zoom Takvim Hizmetinden alınan Kullanıcı Adı ve parola.</td><td>Exchange Server</td><td></td></tr><tr><td><strong>Google çalışma alanı</strong></td><td>OAuth</td><td>Her kullanıcı hesabı için Access ve yenileme belirteci.</td><td>Zoom Takvim Hizmetinden alınan Access belirteci.</td><td>Google çalışma alanı</td><td></td></tr><tr><td><p><strong>Zoom Rooms</strong></p><p><br></p></td><td>Microsoft 365</td><td>OAuth</td><td>Zoom Rooms hizmet hesabı için Access ve yenileme belirteci.</td><td>Zoom Takvim Hizmetinden alınan, Zoom Rooms hizmet hesabına ait Access belirteci.</td><td>Microsoft 365</td></tr><tr><td><strong>Exchange Server</strong></td><td>Temel</td><td>Zoom Rooms hizmet hesabı için Kullanıcı Adı ve parola.</td><td>Zoom Takvim Hizmetinden alınan, Zoom Rooms hizmet hesabına ait Kullanıcı Adı ve parola.</td><td>Exchange Server</td><td></td></tr><tr><td><strong>Google çalışma alanı</strong></td><td>OAuth</td><td>Zoom Rooms hizmet hesabı için Access ve yenileme belirteci.</td><td>Zoom Takvim Hizmetinden alınan, Zoom Rooms hizmet hesabına ait Access belirteci.</td><td>Google çalışma alanı</td><td></td></tr><tr><td><strong>Gelişmiş API Bağlayıcısı (EAC)</strong></td><td>Microsoft 365</td><td>OAuth</td><td>EAC hizmet hesabı için Access ve yenileme belirteci.</td><td>Takvim verileri</td><td>Gelişmiş API Bağlayıcısı*</td></tr><tr><td><strong>Exchange Server</strong></td><td>Temel</td><td>EAC hizmet hesabı için Kullanıcı Adı ve parola.</td><td>Takvim verileri</td><td>Gelişmiş API Bağlayıcısı*</td><td></td></tr><tr><td><strong>Google çalışma alanı</strong></td><td>OAuth</td><td>EAC hizmet hesabı için Access ve yenileme belirteci.</td><td>Takvim verileri</td><td>Gelişmiş API Bağlayıcısı*</td><td></td></tr></tbody></table>

{% hint style="info" %}
\*EAC uç noktaları takvim verilerini EAC'den alır; EAC de takvim verilerini Zoom Takvim Hizmetinden alır. Başka bir deyişle, EAC hizmeti ve ilişkili uç noktaları Microsoft 365, Exchange veya Google çalışma alanına bağlanmaz.
{% endhint %}

### Çift Yönlü Uygunluk Durumu Eşitlemesi

Çift yönlü uygunluk durumu eşitlemesi, kullanıcıların Zoom Workplace ve Teams genelindeki uygunluk durumlarını görmesini sağlar. Bir kullanıcı Zoom toplantısındayken Microsoft Teams durumu da bunu yansıtır. Her iki platformu birlikte kullanan Organizasyonlar için bu, iş arkadaşlarının çevrimiçi durumlarına bakarken uygunluklarını tahmin etme gereksinimini azaltır.

#### <mark style="color:mavi;">Nedir ve neden önemlidir?</mark>

Zoom Uygunluk Durumu Birlikte Çalışabilirliği, Zoom ve Microsoft Teams uygunluk durumlarını gerçek zamanlı olarak güncel tutar. Her iki uygulamada da durumun gerçek zamanlı eşitlenmesi için Microsoft Yetkilendirilmiş İzinlerini kullanır. Bağımsız olarak veya Organizasyonunuzun sahip olduğu diğer uygulama izinleriyle birlikte çalışabilir. Zoom’un verilerinizi nasıl işlediği hakkında bilgi için lütfen şu belgeye bakın: [Zoom Gizlilik Bildirimi](https://www.zoom.com/en/trust/privacy/privacy-statement/).

* **Kimlik Doğrulama ve Yetkilendirme**: Kullanıcıların bu Özelliği Etkinleştirmek için Zoom Web Portalı üzerinden Microsoft hesaplarıyla bu Entegrasyona izin vermeleri gerekir. Böylece uygunluk durumu, doğrudan kullanıcının kimliği doğrulanmış kimliğine bağlanır. Kullanıcıların sahip olduğu [erişim](https://learn.microsoft.com/en-us/entra/identity-platform/permissions-consent-overview) Organizasyonun Microsoft’ta Yapılandırdığı ayarlara bağlıdır. Kullanıcılar, kullanıcı düzeyinde uygunluk durumu birlikte çalışabilirliğini Devre dışı bırakarak bu kimlik doğrulamayı istedikleri zaman iptal edebilir; böylece Zoom ile Microsoft arasındaki uygunluk durumu eşitlemesi durdurulur.
* **Sorunsuz Entegrasyon**: Kimlik doğrulaması yapıldıktan sonra kullanıcılar Zoom’da uygunluk durumlarını belirleyebilir ve bu durum Microsoft Teams ile eşitlenir. Kullanıcılar Yetkilendirilmiş İzinleri (önerilen) kullanırsa eşitleme çift yönlü gerçekleşir (Zoom’dan Microsoft Teams’e ve tersi yönde). Kullanıcılar Birlikte Sunulan İzinleri (Eski; takvim ve kişilerle birlikte) kullanırsa yalnızca kullanıcının Zoom’daki uygunluk durumu Microsoft Teams’e gönderilir; Microsoft’tan herhangi bir uygunluk durumu veya veri alınmaz.
* **Hibrit**: Bu Özellik, hem Zoom hem de Microsoft Teams kullanan kullanıcılar için özellikle yararlıdır.

#### <mark style="color:mavi;">Çift Yönlü Uygunluk Durumu Eşitlemesini Kurma</mark>

Yapılandırma adımları için Zoom Destek makalelerine bakın:

* [Zoom ile Microsoft arasında uygunluk durumu birlikte çalışabilirliğini Etkinleştirme veya Devre dışı bırakma](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0076649) yöneticiler için.
* [Zoom ve Microsoft uygunluk durumu eşitlemesini Yapılandırma](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0076650) kullanıcılar için.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://library.zoom.com/technical-library/tr/yonetici-kosesi/third-party-integrations/zoom-and-microsoft-integration-and-deployment-field-guide/configuring-microsoft-platform-integrations-for-zoom-workplace.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
