> 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/it/angolo-admin/third-party-integrations/zoom-and-microsoft-integration-and-deployment-field-guide/configuring-microsoft-platform-integrations-for-zoom-workplace.md).

# Configurazione delle Integrazioni della piattaforma Microsoft per Zoom Workplace

Queste Integrazioni si collocano a livello di piattaforma. Configurale prima di Outlook, Teams, delle sale conferenze o delle Integrazioni a livello di contenuto.

<details open>

<summary>Scenari di Integrazioni a livello di piattaforma</summary>

{% hint style="success" icon="face-thinking" %}
**"Voglio eliminare i problemi di sincronizzazione del calendario e gli errori di partecipazione alla riunione che i miei utenti stanno riscontrando a causa della complessità di integrare Microsoft Outlook con Zoom."**

<a href="/pages/cc6afc425a07a67f329c9726486d967a7b794fe6#calendar-integration-and-bi-directional-sync" class="button secondary" data-icon="hand-point-right">Vai qui: integrazione del calendario e Sincronizzazione bidirezionale</a>
{% endhint %}

{% hint style="success" icon="face-thinking" %}
**"Voglio forzare tutte le mie riunioni a usare la piattaforma Zoom in ogni caso, senza consentire ai miei utenti di creare riunioni di Microsoft Teams."**

<a href="/pages/cc6afc425a07a67f329c9726486d967a7b794fe6#setting-up-calendaring-integration-enabling-bi-directional-sync-and-setting-the-default-meeting-type" class="button secondary" data-icon="hand-point-right">Vai qui: Forzare tutte le riunioni a essere Zoom Meetings</a>
{% endhint %}

{% hint style="success" icon="face-thinking" %}
**"Voglio che i miei utenti di Microsoft Teams e Zoom condividano uno stato di presenza accurato (Disponibile, Occupato, riunione, ecc.) tra le applicazioni."**

<a href="/pages/cc6afc425a07a67f329c9726486d967a7b794fe6#bi-directional-presence-sync" class="button secondary" data-icon="hand-point-right">Vai qui: Sincronizzazione bidirezionale della presenza</a>
{% endhint %}

</details>

### Integrazione del calendario e Sincronizzazione bidirezionale

L'integrazione del calendario è la configurazione con il maggiore impatto in questa guida. Quando funziona bene, gli utenti vedono un'esperienza di calendario unificata tra Zoom e Outlook. Quando non funziona, spesso è uno dei principali fattori che generano ticket di assistenza.

Questa sezione descrive come funziona l'integrazione del calendario di Zoom, la differenza tra Sincronizzazione bidirezionale 1.0 e 2.0 e come configurarla.

#### <mark style="color:blu;">Che cos'è e perché è importante</mark>

* Gli utenti vedono un calendario completo (incluse le riunioni non Zoom) nelle loro Zoom Apps
* Gli utenti possono Pianificare e modificare le riunioni dalle loro Zoom Apps
* Gli schermi di Zoom Rooms e i display di pianificazione mostrano i prossimi eventi del calendario
* Gli endpoint H.323 e SIP basati su standard possono partecipare alle riunioni Zoom automaticamente o con a un solo tocco tramite il Connettore API avanzato

{% hint style="info" %}
La sincronizzazione bidirezionale è **consigliata e abilitata per impostazione predefinita** quando l'integrazione del calendario è attiva. Con la sincronizzazione bidirezionale 2.0, le Integrazioni sono ampliate per coprire sia gli eventi del calendario Zoom sia quelli non Zoom, offrendo un'esperienza unificata agli utenti che si affidano a Zoom come hub centrale per la pianificazione.

L'abilitazione della sincronizzazione bidirezionale del calendario garantisce che tutti gli eventi del calendario di terze parti eliminati, modificati o abbandonati durante la pianificazione vengano sincronizzati automaticamente con il servizio di calendario web di Zoom
{% endhint %}

#### <mark style="color:blu;">Quali miglioramenti dell'affidabilità sono stati apportati tra Sincronizzazione bidirezionale 1.0 e Sincronizzazione bidirezionale 2.0?</mark> <a href="#what-reliability-improvements-were-made-between-bi-directional-sync-1.0-and-bi-directional-sync-2.0" id="what-reliability-improvements-were-made-between-bi-directional-sync-1.0-and-bi-directional-sync-2.0"></a>

Bi-Directional Sync 2.0 introduce anche significativi miglioramenti dell’affidabilità. Nella versione precedente, gli aggiornamenti del calendario richiedevano un evento di attivazione in Outlook e Google Calendar, come la creazione o la modifica di una riunione, prima che le modifiche potessero propagarsi a Zoom. Con 2.0, la sincronizzazione avviene automaticamente, senza la necessità di azioni di attivazione di Outlook.

#### <mark style="color:blu;">Quali provider di calendari sono supportati?</mark> <a href="#which-calendaring-providers-are-supported" id="which-calendaring-providers-are-supported"></a>

I Clienti di Zoom possono integrare i dati di contatto e del calendario con tre provider:

* Microsoft 365 (in precedenza Office 365)
* Server Microsoft Exchange
* Google area di lavoro

#### Come funziona l'integrazione del calendario? <a href="#how-does-the-calendaring-integration-work" id="how-does-the-calendaring-integration-work"></a>

Le Integrazioni di calendario di Zoom seguono quattro fasi: autorizzazione, monitoraggio degli eventi, recupero dei dati dell'endpoint e Sincronizza bidirezionale. Le prime due fasi sono universali per tutti gli endpoint e i metodi. La terza fase varia a seconda del tipo di endpoint e del metodo di autenticazione selezionato.

{% stepper %}
{% step %}

#### **Autorizzazione e archiviazione sicura delle credenziali**

Gli amministratori di Zoom — o gli utenti, se consentito dall'Organizzazione — devono prima autorizzare l'accesso al proprio fornitore di servizi di calendario tramite lo Zoom web portal.

Zoom archivia gli oggetti necessari per accedere al calendario connesso in una posizione persistente, crittografata e sicura. Quando si usa OAuth 2.0, Zoom archivia in modo sicuro i token di accesso e i token di aggiornamento dell'accesso delegato nel cloud Zoom. Tuttavia, per Exchange on-premises (non ibrido), che non supporta OAuth 2.0, Zoom deve archiviare in modo sicuro Nome utente e password nel cloud Zoom, poiché questo è l'unico metodo Disponibile per mantenere l'accesso.

{% hint style="info" %}
Le Integrazioni dirette con Exchange On-Premises richiedono autenticazione Basic.
{% endhint %}

{% hint style="info" %}
Puoi configurare facoltativamente le Integrazioni di calendario per usare Chiave gestita dal cliente Zoom (CMK) per crittografare e archiviare le credenziali, consentendoti di proteggere alcuni dati archiviati a riposo all'interno dell'infrastruttura cloud Zoom usando le tue chiavi di crittografia. CMK è un'offerta a pagamento e la soluzione Bring Your Own Key (BYOK) di Zoom. Puoi [leggi di più su Zoom CMK](https://www.zoom.com/en/blog/zoom-customer-managed-key/) sul sito web di Zoom.
{% endhint %}
{% endstep %}

{% step %}

#### **Monitoraggio degli eventi e Notifica di Modifica**

Il servizio Web Calendaring di Zoom si iscrive a un webhook del fornitore di servizi di calendario per ogni utente dopo che il calendario è stato connesso nel Zoom web portal. Questi webhook notificano al servizio Web Calendaring qualsiasi Modifica del calendario, così da poter poi notificare gli endpoint Zoom appropriati che è necessario un aggiornamento.
{% endstep %}

{% step %}

#### **Recupero dei dati dell'endpoint**

Il modo in cui i dati del calendario raggiungono un endpoint Zoom dipende dal tipo di endpoint e dal metodo di autenticazione selezionato. Le sezioni seguenti descrivono ogni modello.

**App desktop e mobili: accesso delegato**

Quando si usa l'accesso delegato, il servizio Web Calendaring di Zoom passa il token di accesso OAuth al client Zoom desktop o mobile all'accesso. Il client Zoom conserva temporaneamente questo token in memoria e lo usa per connettersi direttamente al fornitore di servizi di calendario per recuperare i dati dell'evento. Se il token di accesso non è valido, il servizio Web Calendaring di Zoom usa il token di aggiornamento memorizzato per richiedere un nuovo token di accesso e lo passa al client Zoom.

**App desktop e mobili: Autorizzazioni dell'applicazione (Microsoft Graph API)**

Quando si usa il metodo Autorizzazioni dell'applicazione, i token di accesso rimangono nel cloud Zoom e non vengono passati ai dispositivi client. Invece, tutte le richieste di dati del calendario vengono instradate tramite il servizio Web Calendaring di Zoom per conto del client Zoom. Il client Zoom non si connette direttamente al fornitore di servizi di calendario.

**Zoom Rooms: Entrambi i metodi**

Indipendentemente dal fatto che vengano usate le Autorizzazioni dell'applicazione o l'accesso delegato completo, Zoom Rooms archiviano i token sia nel cloud Zoom sia localmente sull'endpoint Zoom Room. Zoom Rooms si connettono direttamente al fornitore di servizi di calendario per recuperare i dati del calendario.

{% hint style="info" %}
I diagrammi nella [Dettagli specifici del provider](/technical-library/it/angolo-admin/third-party-integrations/zoom-calendaring-integration-explainer/provider-specific-details.md) pagina illustrano i metodi Microsoft Graph API basati su accesso delegato e su applicazione per le Integrazioni desktop e mobili degli utenti. Zoom Rooms seguono un diverso modello di archiviazione e recupero dei token, come descritto sopra.
{% endhint %}
{% endstep %}

{% step %}

#### Sincronizza bidirezionale del calendario

Con Sincronizza bidirezionale del calendario abilitata, se un utente pianifica o aggiorna una riunione da un client Zoom o dal web, il servizio Web Calendaring crea o aggiorna l'Evento sul calendario dell'utente tramite l'API del fornitore di servizi di calendario.

{% hint style="info" %}
Gli amministratori possono [Configura la Sincronizza bidirezionale](https://support.zoom.us/hc/en-us/articles/8522918261645-Enabling-bi-directional-calendar-sync) a livello di account o di gruppo di utenti.

La Sincronizza bidirezionale supporta gli aggiornamenti apportati ai seguenti tipi di riunione:

* Una riunione individuale
* Una serie di riunioni (ricorrenti)
* Una singola occorrenza di una serie di riunioni
  {% endhint %}
  {% endstep %}
  {% endstepper %}

#### <mark style="color:blu;">Configurazione dell'integrazione del calendario, abilitazione della Sincronizzazione bidirezionale e impostazione del tipo di riunione predefinito</mark>

Le seguenti istruzioni ti aiuteranno a connettere i calendari personali, abilitare la Sincronizzazione bidirezionale e forzare Zoom Meetings a essere il tipo di riunione predefinito.

**Connessione dei calendari personali**

Per Configura il tuo account per consentire agli utenti di integrare il loro calendario Microsoft 365 con l'app Zoom Workplace, esegui i seguenti passaggi:

1. Come Zoom admin, accedi a [zoom.us](http://zoom.us/).
2. Fai clic su **Gestione dell'account** menu a discesa e Seleziona **Impostazioni account.**
3. Vai alla *posta & calendario* scheda.
4. Fai clic su **Integrazioni** scheda per andare alle Impostazioni appropriate.
5. Fai clic su **Attiva/disattiva** pulsante accanto a *Integra servizi di posta e calendario di terze parti* quindi fai clic **Abilita** nella finestra pop-up.
6. Per il *Scegli i servizi predefinito di calendario e contatto per gli utenti* impostazione, seleziona **Office 365** e per il *Autorizza con*: impostazione, Seleziona **API Graph**.

{% hint style="info" %}
L’opzione “Exchange Web Services (EWS)” non è consigliata. Microsoft ha iniziato a ritirare gradualmente i metodi EWS, che in precedenza erano disponibili per connettere i dati di Microsoft 365 con i Servizi Zoom. Zoom considera questi metodi EWS opzioni legacy non supportate.
{% endhint %}

7. Sotto la *Chi può configurare le Integrazioni*: impostazione, Scegli tra le seguenti opzioni:
   1. **Gli utenti possono configurare le Integrazioni usando OAuth**
   2. **L’admin di Office 365 può configurare le Integrazioni usando i permessi dell’applicazione** che ti porterà al tuo ambiente Microsoft 365 per ulteriori configurazioni.

{% hint style="info" %}
Decidere se OAuth o i permessi dell’applicazione siano la scelta migliore varierà in base agli obiettivi e alle preferenze della tua azienda.

Il **OAuth** il metodo, chiamato anche Delegated Permissions, offre flessibilità nelle Autorizzazione che concede, riflettendo gli scope di Autorizzazione selezionati sopra l’impostazione all’interno di Zoom web portal. Tuttavia, questa impostazione può portare a eventi del calendario non sincronizzati, poiché le Integrazioni scadranno e richiederanno una nuova autenticazione se il token viene revocato o se la password dell’utente cambia.

In alternativa, il **Autorizzazioni dell'applicazione** Il metodo non richiede una riautenticazione periodica da parte degli utenti, ma potrebbe non supportare gli stessi livelli di funzionalità. Inoltre concede a Zoom Workplace inizialmente un livello di accesso maggiore al tuo ambiente Microsoft 365. Per impostazione predefinita, queste autorizzazioni di ambito non possono essere limitate al momento dell'approvazione dell'app; tuttavia, gli amministratori possono modificare retroattivamente l'ambito delle autorizzazioni di questa app all'interno di Entra ID seguendo i passaggi in [Revoca delle autorizzazioni di Entra ID](#id-51ygv2kwmxbi) sezione di questa guida. Se vuoi che Zoom Workplace mantenga l'accesso agli eventi del calendario ma non alle caselle di posta, puoi revocare tutte le autorizzazioni *eccetto* **calendario.ReadWrite**. Per un elenco completo dei permessi richiesti, fare riferimento all’ [Convalida il metodo Permessi dell’applicazione MGAPI ID e ambiti dell’applicazione](#yn2twi7v7su4) .
{% endhint %}

**Abilitazione della Sincronizzazione bidirezionale**

Per istruzioni passo passo sull'abilitazione della Sincronizzazione bidirezionale del calendario, consulta l'articolo di Assistenza Zoom [Abilitazione o disabilitazione della sincronizzazione bidirezionale del calendario](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0058782).

**Richiesta di iscrizione a Sincronizzazione bidirezionale 2.0**

Per richiedere l'abilitazione di Sincronizzazione bidirezionale 2.0 per la tua Organizzazione, [invia un ticket di assistenza ad Assistenza Zoom](https://support.zoom.com/hc/en/contact?id=contact_us). Includi il nome del cliente e l'ID dell'account nella richiesta. Sincronizzazione bidirezionale 2.0 è attualmente Disponibile solo per alcuni Clienti.

**Forzare tutte le riunioni a essere Zoom Meetings**

Per configurare Microsoft Outlook in modo che per tutte le riunioni online l'impostazione predefinita sia Zoom Meetings, dovrai modificare le Impostazioni direttamente in Outlook. Microsoft fornisce istruzioni dettagliate per questa configurazione nella propria documentazione di assistenza.

Per una guida passo passo su come rendere ogni riunione una riunione online e impostare Zoom come provider predefinito, consulta l'articolo di assistenza di Microsoft [Rendi ogni riunione online](https://support.microsoft.com/en-us/office/make-every-meeting-online-70f9bda0-fd29-498b-9757-6709cc1c73f0).

Per disabilitare la possibilità per gli utenti di creare riunioni Teams, puoi anche consultare l'articolo di assistenza di Microsoft [Gestire chi può avviare riunioni istantanee e pianificare riunioni](https://learn.microsoft.com/en-us/microsoftteams/manage-who-can-schedule-meetings).

**Riferimenti aggiuntivi**

<table data-header-hidden="false" data-header-sticky><thead><tr><th></th><th>Servizio</th><th>Metodo di autenticazione</th><th>Il Servizio di calendario di Zoom archivia</th><th>L'endpoint riceve al momento dell'accesso</th><th>L'endpoint recupera il calendario da</th></tr></thead><tbody><tr><td><strong>Calendari utente</strong></td><td>Microsoft 365</td><td>OAuth</td><td>Access e token di aggiornamento per ogni account utente.</td><td>Token di Access dal Servizio di calendario di Zoom.</td><td>Microsoft 365</td></tr><tr><td><strong>Exchange Server</strong></td><td>Basic</td><td>Nome utente e password per ogni account utente.</td><td>Nome utente e password dal Servizio di calendario di Zoom.</td><td>Exchange Server</td><td></td></tr><tr><td><strong>Google area di lavoro</strong></td><td>OAuth</td><td>Access e token di aggiornamento per ogni account utente.</td><td>Token di Access dal Servizio di calendario di Zoom.</td><td>Google area di lavoro</td><td></td></tr><tr><td><p><strong>Zoom Rooms</strong></p><p><br></p></td><td>Microsoft 365</td><td>OAuth</td><td>Access e token di aggiornamento per l'account di servizio di Zoom Rooms.</td><td>Token di Access per l'account di servizio di Zoom Rooms dal Servizio di calendario di Zoom.</td><td>Microsoft 365</td></tr><tr><td><strong>Exchange Server</strong></td><td>Basic</td><td>Nome utente e password per l'account di servizio di Zoom Rooms.</td><td>Nome utente e password per l'account di servizio di Zoom Rooms dal Servizio di calendario di Zoom.</td><td>Exchange Server</td><td></td></tr><tr><td><strong>Google area di lavoro</strong></td><td>OAuth</td><td>Access e token di aggiornamento per l'account di servizio di Zoom Rooms.</td><td>Token di Access per l'account di servizio di Zoom Rooms dal Servizio di calendario di Zoom.</td><td>Google area di lavoro</td><td></td></tr><tr><td><strong>Connettore API avanzato (EAC)</strong></td><td>Microsoft 365</td><td>OAuth</td><td>Access e token di aggiornamento per l'account di servizio EAC.</td><td>Dati di calendario</td><td>Connettore API avanzato*</td></tr><tr><td><strong>Exchange Server</strong></td><td>Basic</td><td>Nome utente e password per l'account di servizio EAC.</td><td>Dati di calendario</td><td>Connettore API avanzato*</td><td></td></tr><tr><td><strong>Google area di lavoro</strong></td><td>OAuth</td><td>Access e token di aggiornamento per l'account di servizio EAC.</td><td>Dati di calendario</td><td>Connettore API avanzato*</td><td></td></tr></tbody></table>

{% hint style="info" %}
\*Gli endpoint EAC recuperano i propri dati di calendario dall'EAC, che a sua volta recupera i propri dati di calendario dal Servizio di calendario di Zoom. In altre parole, il servizio EAC e i relativi endpoint non si connettono a Microsoft 365, Exchange o Google area di lavoro.
{% endhint %}

### Sincronizzazione bidirezionale dello stato di presenza

La sincronizzazione bidirezionale dello stato di presenza consente agli utenti di vedere lo stato di Disponibile tra Zoom Workplace e Teams. Quando un utente è in una riunione Zoom, il suo stato Microsoft Teams lo riflette. Per le Organizzazioni che utilizzano entrambe le piattaforme fianco a fianco, questo riduce il gioco delle ipotesi sulla Disponibile quando si visualizzano gli stati online dei colleghi.

#### <mark style="color:blu;">Che cos'è e perché è importante</mark>

L’integrazione in-app di Zoom per Microsoft Teams offre un punto di accesso unificato per Zoom Meetings, Zoom Phone e Zoom Whiteboard all’interno dell’app Teams. L’integrazione consente agli utenti di gestire processi Zoom comuni—come pianificazione delle riunioni, visualizzazione delle prossime riunioni, accesso alla cronologia delle chiamate e condivisione di Whiteboards—direttamente da Teams, mentre consente di passare facilmente all’app Zoom Workplace o a un browser web quando necessario per completare azioni specifiche. Questo approccio riduce al minimo il cambio di contesto per le attività quotidiane, preservando al contempo l’esperienza applicazione nativa di Zoom quando si applicano limitazioni tecniche o requisiti di Funzionalità.

Da una prospettiva architetturale, Microsoft Entra ID fornisce il livello di identità e autorizzazione per le Integrazioni. Quando gli utenti interagiscono con Zoom all'interno di Microsoft Teams, Entra ID verifica l'identità dell'utente e consente all'app Zoom di accedere a specifici contesti di Microsoft 365 — come i dati del calendario, Partecipanti della chat e i contatti — per conto dell'utente. Queste autorizzazioni consentono a Zoom di mostrare informazioni e azioni pertinenti all'interno di Teams senza duplicare i servizi di identità o di directory.

Microsoft Teams funge da interfaccia principale in cui gli utenti avviano flussi di lavoro correlati a Zoom, mentre i servizi Zoom sono accessibili tramite chiamate API sicure. Zoom continua a operare come sistema di registrare per riunioni, telefonia, Whiteboard e tutte le politiche associate, i controlli di sicurezza e la reportistica. Questa separazione consente di avviare e gestire le attività di Zoom da Teams, mentre la titolarità, l’applicazione e la gestione dei dati rimangono all’interno della piattaforma Zoom.

Fare riferimento a [Biblioteca tecnica](https://library.zoom.com/admin-corner/third-party-integrations/integrating-zoom-with-microsoft-teams/zooms-in-app-integration-for-microsoft-teams), [Centro assistenza di Zoom](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0067825), e il [Microsoft Marketplace Store](https://marketplace.microsoft.com/en-us/product/office/wa104381441?tab=overview) per ulteriori Info sull’Integrazioni nell'app di Zoom per Microsoft Teams.

Le Integrazioni nell'app di Zoom per Microsoft Teams includono, ma non si limitano, alle seguenti funzionalità:

| <p><strong>Riunioni</strong></p><ul><li>Visualizzare le prossime riunioni Zoom</li><li>Pianificare riunioni Zoom</li><li>Avviare riunioni Zoom ad hoc</li><li>Avviare riunioni Zoom da Teams</li><li>Condividere riunioni Zoom nelle chat di Teams</li><li>mostrare riunioni Zoom nei calendari di Teams e Outlook</li><li>Utilizzare il riepilogo della riunione di Zoom AI sia per le riunioni Zoom sia per le riunioni di Teams<br></li></ul><p><strong>Zoom Whiteboard</strong></p><ul><li>Avviare, creare e condividere le lavagne Zoom in Teams</li></ul> | <p><strong>Zoom Phone</strong></p><ul><li>Effettuare e ricevere chiamate Zoom Phone</li><li>Access alla cronologia delle chiamate di Zoom Phone</li><li>Inviare e ricevere SMS di Zoom Phone</li><li>Access alla segreteria telefonica e alle trascrizioni della segreteria telefonica</li><li>Access alle chiamate registrate e alle trascrizioni delle chiamate</li><li>Riepiloghi delle chiamate, attività e segreteria telefonica di Zoom AI<br></li></ul><p><strong>Chat e notifiche</strong></p><ul><li>Pianificare riunioni tramite il chatbot di Teams</li><li>Ricevere notifiche del chatbot di Zoom in Teams</li><li>Usare la chat continua delle riunioni tra Teams e Zoom</li><li>Condividere lo stato di presenza tra le piattaforme</li></ul> |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

#### <mark style="color:blu;">Configurazione della sincronizzazione bidirezionale dello stato di presenza</mark>

Per i passaggi di configurazione, consulta l'articolo di Assistenza Zoom [Usare Zoom per Microsoft Teams](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0067825).


---

# 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/it/angolo-admin/third-party-integrations/zoom-and-microsoft-integration-and-deployment-field-guide/configuring-microsoft-platform-integrations-for-zoom-workplace.md?ask=<question>&goal=<endgoal>
```

`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.
