> 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/nl/geavanceerde-ondernemingsservices/conference-room-connector-explainer/zoom-enhanced-api-connector-cisco-h.323-sip-device-settings.md).

# Zoom Verbeterde API Connector (Cisco H.323/SIP Apparaat Instellingen)

Wanneer een Cisco H.323/SIP-apparaat wordt beheerd door de Zoom Enhanced API Connector, worden specifieke Instellingen op het Cisco-apparaat aangepast. De apparaatinstellingen die worden gewijzigd, zijn afhankelijk van de Instellingen die zijn geconfigureerd in de Zoom beheerportal. In deze sectie worden 3 scenario's voor bellenbesturing/SIP-proxy-Registratie beschreven om dit proces te illustreren.

1. [Gebruik van door Zoom geleverde bellenbesturing (Zoom-cloud SIP-proxy)](#using-zoom-provided-call-control-zoom-cloud-sip-proxy)
2. [Gebruik van door Zoom geleverde bellenbesturing (Zoom-cloud SIP-proxy + Zoom Phone)](#using-zoom-provided-call-control-zoom-cloud-sip-proxy)
3. [Gebruik van bellenbesturing van derden](#using-third-party-call-control-not-provisioned-by-zoom)

{% hint style="info" %}
**Opmerking**

De [Gebruik van bellenbesturing van derden](#using-third-party-call-control-not-provisioned-by-zoom) Dit scenario maakt specifiek gebruik van Cisco Cloud-registratie.
{% endhint %}

De [Zoom beheerportal](#cisco-device-configurations-are-modified-by-settings-in-the-cisco-polycom-rooms-section-of-the-zoom) Deze sectie beschrijft configuraties van Cisco H.323/SIP-videoconferentieapparaten die worden gewijzigd door algemene wijzigingen in de Instellingen in de **Cisco/Polycom Rooms** sectie van de Zoom beheerportal.

### Gebruik van door Zoom geleverde bellenbesturing (Zoom-cloud SIP-proxy)

In dit scenario gebruikt een Cisco-apparaat door Zoom geleverde bellenbesturing, in de vorm van Zoom’s Cloud SIP-proxy. Dit scenario gaat uit van het gebruik van Standaard **Cisco & Polycom Ruimte** Instellingen op accountniveau.

Op het niveau van de afzonderlijke ruimte zijn in dit scenario de volgende configuraties toegepast.

#### Ruimteprofiel

* Ruimtenaam (vereist)
* Alle overige Instellingen zijn ingesteld op Standaard

#### Vergadering

* Geen agenda-integratie geconfigureerd
* Alle Instellingen zijn ingesteld op Standaard

#### H.323/SIP Integratie(s)

* **Configuratie voor SIP-bellenbesturing:** ingesteld op “Registreren bij Zoom”
* **H.323-modus:** ingesteld op uitgeschakeld
* **H.323-gatekeeper:** ingesteld op “Niet door Zoom geprovisioneerd”
* Alle overige Instellingen zijn ingesteld op Standaard

#### Geavanceerd

* Alle Instellingen ingesteld op Standaard

Met deze configuratie worden de volgende configuraties van Cisco-apparaten gewijzigd (namen in de **Cisco-instellingselement** kolom zijn afkomstig uit een back-upbestand van een Cisco-apparaat):

| Cisco-instellingselement         | Oude waarde | Nieuwe waarde                    | Gewijzigd door                                                                                                | Opmerkingen                                                                                                                                                                                                                                                           |
| -------------------------------- | ----------- | -------------------------------- | ------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| SIP-authenticatiewachtwoord      | \<leeg>     | \[verschilt]                     | SIP/H.323 Integratie(s) > SIP-bellenbesturingsconfiguratie                                                    | Zoom voorziet deze instelling om SIP-Registratie naar Zoom’s SIP Cloud-proxy te ondersteunen.                                                                                                                                                                         |
| SIP-authenticatie Gebruikersnaam | \<leeg>     | \[serienummer]@cisco-Apparaat    | SIP/H.323 Integratie(s) > SIP-bellenbesturingsconfiguratie                                                    | Zoom voorziet deze instelling om SIP-Registratie naar Zoom’s SIP Cloud-proxy te ondersteunen.                                                                                                                                                                         |
| SIP Standaardtransport           | Auto        | TLS                              | SIP/H.323 Integratie(s) > SIP-bellenbesturingsconfiguratie                                                    | Zoom stelt deze instelling in op “TLS” om TLS te gebruiken voor SIP-connectiviteit met Zoom’s SIP Cloud-proxy.                                                                                                                                                        |
| SIP-weergavenaam                 | \<leeg>     | \[de geconfigureerde Ruimtenaam] | <p>SIP/H.323 Integratie(s) > SIP-bellenbesturingsconfiguratie</p><p><br></p><p>Ruimteprofiel > Ruimtenaam</p> | Zoom stelt deze instelling in op de geconfigureerde Ruimtenaam, zodat wanneer het apparaat deelneemt aan een Zoom-vergadering, het correct een naam krijgt in de deelnemerslijst en op zijn videoteegel in de videolay-out voor andere deelnemers aan de vergadering. |
| SIP-proxyadres                   | \<leeg>     | us01sipproxy.zoom.us             | SIP/H.323 Integratie(s) > SIP-bellenbesturingsconfiguratie                                                    | Zoom voorziet deze instelling om SIP-Registratie naar Zoom’s SIP Cloud-proxy te ondersteunen.                                                                                                                                                                         |
| SIP TlsVerify                    | Aan         | Uit                              | SIP/H.323 Integratie(s) > SIP-bellenbesturingsconfiguratie                                                    | Zoom stelt deze instelling in op “Uit” omdat Eindpunten op oudere firmware mogelijk niet over actuele beveiligingscertificaten beschikken. Als TlsVerify “Aan” zou zijn, kan het Eindpunt worden geblokkeerd bij het registreren.                                     |
| SIP URI                          | \<leeg>     | \[serienummer]@cisco-Apparaat    | SIP/H.323 Integratie(s) > SIP-bellenbesturingsconfiguratie                                                    | Zoom voorziet deze instelling om SIP-Registratie naar Zoom’s SIP Cloud-proxy te ondersteunen.                                                                                                                                                                         |
| Naam van SystemUnit              | \<leeg>     | \[de geconfigureerde Ruimtenaam] | Ruimteprofiel > Ruimtenaam                                                                                    | Zoom stelt deze instelling in op de geconfigureerde ruimtenaam, zodat de UI van het Cisco Apparaat de ruimtenaam toont.                                                                                                                                               |

Andere veelvoorkomende systeemconfiguraties omvatten het volgende (zie [Zoom beheerportal](#cisco-device-configurations-are-modified-by-settings-in-the-cisco-polycom-rooms-section-of-the-zoom) sectie voor details):

#### Ruimteprofiel

* Tijdzone
* Tijdnotatie

#### Vergadering

* Agendaresources
* Deelnemen aan vergadering met DTMF
* Belsnelheid

### Gebruik van door Zoom geleverde bellenbesturing (Zoom-cloud SIP-proxy + Zoom Phone)

In dit scenario gebruikt een Cisco H.323/SIP-videoconferentieapparaat door Zoom geleverde gespreksbesturing in de vorm van Zooms Cloud SIP-proxy. Het Cisco Apparaat is ook geconfigureerd met Zoom Phone.

Dit scenario gaat uit van het gebruik van Standaard **Cisco & Polycom Ruimte** Instellingen op accountniveau.

Op het niveau van de afzonderlijke ruimte zijn in dit scenario de volgende configuraties toegepast.

#### Ruimteprofiel

* Ruimtenaam (vereist)
* Alle overige Instellingen zijn ingesteld op Standaard

#### Vergadering

* Geen agenda-integratie geconfigureerd
* Alle Instellingen ingesteld op Standaard

#### H.323/SIP Integratie(s)

* **Configuratie voor SIP-bellenbesturing:** ingesteld op “Registreren bij Zoom”
* **H.323-modus:** ingesteld op uitgeschakeld
* **H.323-gatekeeper:** ingesteld op “Niet door Zoom geprovisioneerd”
* Alle overige Instellingen zijn ingesteld op Standaard

#### Geavanceerd

* Alle Instellingen zijn ingesteld op Standaard

Met deze configuratie worden de volgende configuraties van het Cisco Apparaat gewijzigd (de namen in de **Cisco-instellingselement** kolom zijn afkomstig uit een back-upbestand van een Cisco-apparaat):

| Cisco-instellingselement         | Oude waarde | Nieuwe waarde                    | Gewijzigd door                                                                                                | Opmerkingen                                                                                                                                                                                                                                                           |
| -------------------------------- | ----------- | -------------------------------- | ------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| SIP-authenticatiewachtwoord      | \<leeg>     | \[verschilt]                     | SIP/H.323 Integratie(s) > SIP-bellenbesturingsconfiguratie                                                    | Zoom stelt deze instelling in ter ondersteuning van SIP-Registratie bij Zooms SIP-Cloud-proxy                                                                                                                                                                         |
| SIP-authenticatie Gebruikersnaam | \<leeg>     | \[number]                        | SIP/H.323 Integratie(s) > SIP-bellenbesturingsconfiguratie                                                    | Zoom stelt deze instelling in ter ondersteuning van SIP-Registratie bij Zooms SIP-Cloud-proxy met Zoom Phone-functies                                                                                                                                                 |
| SIP Standaardtransport           | Auto        | TLS                              | SIP/H.323 Integratie(s) > SIP-bellenbesturingsconfiguratie                                                    | Zoom stelt deze instelling in op “TLS” om TLS te gebruiken voor SIP-connectiviteit met Zooms Cloud SIP-proxy                                                                                                                                                          |
| SIP-weergavenaam                 | \<leeg>     | \[de geconfigureerde Ruimtenaam] | <p>SIP/H.323 Integratie(s) > SIP-bellenbesturingsconfiguratie</p><p><br></p><p>Ruimteprofiel > Ruimtenaam</p> | Zoom stelt deze instelling in op de geconfigureerde Ruimtenaam, zodat wanneer het apparaat deelneemt aan een Zoom-vergadering, het correct een naam krijgt in de deelnemerslijst en op zijn videoteegel in de videolay-out voor andere deelnemers aan de vergadering. |
| SIP-proxyadres                   | \<leeg>     | \[verschilt]                     | SIP/H.323 Integratie(s) > SIP-bellenbesturingsconfiguratie                                                    | Zoom stelt deze instelling in ter ondersteuning van SIP-Registratie bij Zooms SIP-Cloud-proxy met Zoom Phone-functies.                                                                                                                                                |
| SIP TlsVerify                    | Aan         | Uit                              | SIP/H.323 Integratie(s) > SIP-bellenbesturingsconfiguratie                                                    | Zoom stelt deze instelling in op “Uit” omdat Eindpunten op oudere firmware mogelijk niet over actuele beveiligingscertificaten beschikken. Als TlsVerify “Aan” zou zijn, kan het Eindpunt worden geblokkeerd bij het registreren.                                     |
| SIP URI                          | \<leeg>     | \[verschilt]                     | SIP/H.323 Integratie(s) > SIP-bellenbesturingsconfiguratie                                                    | Zoom stelt deze instelling in ter ondersteuning van SIP-Registratie bij Zooms SIP-Cloud-proxy met Zoom Phone-functies.                                                                                                                                                |
| Naam van SystemUnit              | \<leeg>     | \[de geconfigureerde Ruimtenaam] | Ruimteprofiel > Ruimtenaam                                                                                    | Zoom stelt deze instelling in op de geconfigureerde ruimtenaam, zodat de UI van het Cisco Apparaat de ruimtenaam toont.                                                                                                                                               |

Andere veelvoorkomende systeemconfiguraties omvatten het volgende (zie [Zoom beheerportal](#cisco-device-configurations-are-modified-by-settings-in-the-cisco-polycom-rooms-section-of-the-zoom) sectie voor details):

#### Ruimteprofiel

* Tijdzone
* Tijdnotatie

#### Vergadering

* Agendaresources
* Deelnemen aan vergadering met DTMF
* Belsnelheid

### Gebruik van besturing door derden (“niet geconfigureerd door Zoom”)

In dit scenario gebruikt een Cisco H.323/SIP-videoconferentieapparaat besturing door derden in de vorm van Registratie bij Cisco cloudservices (Cisco Webex Control Hub). Dit scenario gaat uit van het gebruik van Standaard **Cisco & Polycom Ruimte** Instellingen op accountniveau.

Op het niveau van de afzonderlijke ruimte zijn in dit scenario de volgende configuraties toegepast.

#### Ruimteprofiel

* Ruimtenaam (vereist)
* Alle overige Instellingen zijn ingesteld op Standaard

#### Vergadering

* Geen agenda-integratie geconfigureerd
* Alle Instellingen ingesteld op Standaard

#### H.323/SIP Integratie(s)

* **SIP-modus:** ingesteld op uitgeschakeld
* **Configuratie voor SIP-bellenbesturing:** ingesteld op “Niet door Zoom geprovisioneerd”
* **H.323-modus:** ingesteld op uitgeschakeld
* **H.323-gatekeeper:** ingesteld op “Niet door Zoom geprovisioneerd”
* Alle overige Instellingen zijn ingesteld op Standaard

#### Geavanceerd

* Alle Instellingen ingesteld op Standaard

Met deze configuratie worden de volgende configuraties van het Cisco Apparaat gewijzigd (de namen in de **Cisco-instellingselement** kolom zijn afkomstig uit een back-upbestand van een Cisco-apparaat):

| Cisco-instellingselement | Oude waarde | Nieuwe waarde                    | Gewijzigd door             | Opmerkingen                                                                                                             |
| ------------------------ | ----------- | -------------------------------- | -------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| Naam van SystemUnit      | \<leeg>     | \[de geconfigureerde Ruimtenaam] | Ruimteprofiel > Ruimtenaam | Zoom stelt deze instelling in op de geconfigureerde ruimtenaam, zodat de UI van het Cisco Apparaat de ruimtenaam toont. |

Andere veelvoorkomende systeemconfiguraties omvatten het volgende (zie [Zoom beheerportal](#cisco-device-configurations-are-modified-by-settings-in-the-cisco-polycom-rooms-section-of-the-zoom) sectie voor details):

#### Ruimteprofiel

* Tijdzone
* Tijdnotatie

#### Vergadering

* Agendaresources
* Deelnemen aan vergadering met DTMF
* Belsnelheid

### Cisco Apparaatconfiguraties worden gewijzigd door Instellingen in de Cisco/Polycom Rooms-sectie van de Zoom-beheerportal

Deze sectie beschrijft veelvoorkomende configuratiewijzigingen in de **Cisco & Polycom Rooms** sectie van de Zoom-beheerportal en hoe deze de configuratie van Cisco H.323/SIP-videoconferentieapparaten beïnvloeden.

De namen in de **Cisco-instellingselement** kolom in de onderstaande tabel zijn overgenomen uit een back-upbestand van een Cisco Apparaat. De **Cisco Standaardwaarde** kolom is gebaseerd op de configuratie van een Cisco Apparaat dat naar de fabrieksinstellingen is teruggezet en, waar mogelijk, door de wizard voor gebruiksklare configuratie is geleid met Standaardselecties.

#### <mark style="color:blauw;">Rooms-profielinstellingen in het Zoom-webportal</mark>

| Zoom-instelling         | Cisco-instellingselement                                                             | Cisco Standaardwaarde                                | Nieuwe waarde                                                   | Opmerkingen                                                                                           |
| ----------------------- | ------------------------------------------------------------------------------------ | ---------------------------------------------------- | --------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| Ruimtenaam              | Naam van SystemUnit                                                                  | \<leeg>                                              | \[de geconfigureerde Ruimtenaam]                                | <p><br></p>                                                                                           |
| Tijdzone                | Tijdzone                                                                             | Etc/UTC                                              | \<varieert>                                                     | <p><br></p>                                                                                           |
| Tijdnotatie             | Tijd Tijdnotatie                                                                     | 24U                                                  | 12U \| 24U                                                      | <p><br></p>                                                                                           |
| Alternatieve tijdserver | <p>Netwerkservices NTP-modus</p><p><br></p><p>Netwerkservices NTP-server 1-adres</p> | <p>Auto</p><p><br></p><p>0.tandberg.pool.ntp.org</p> | <p>Handmatig</p><p><br></p><p>\[door klant opgegeven adres]</p> | Deze instelling heeft geen direct effect op Apparaten die zijn geregistreerd bij Cisco cloudservices. |

#### <mark style="color:blauw;">Vergaderingsinstellingen in het Zoom-webportal</mark>

| Zoom-instellingen                                                                                                         | Cisco-instellingselement | Cisco Standaardwaarde | Nieuwe waarde                           | Opmerkingen                                                                                                                                                                                                                                                                                                                                                                                                                 |
| ------------------------------------------------------------------------------------------------------------------------- | ------------------------ | --------------------- | --------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Agendaresources                                                                                                           | n/b                      | n/b                   | \[door klant opgegeven adres]           | Deze instelling heeft geen directe invloed op de configuratie van het Cisco Apparaat.                                                                                                                                                                                                                                                                                                                                       |
| Persoonlijke vergadering-ID voor ruimte                                                                                   | n/b                      | n/b                   | \[door klant verstrekte vergadering-ID] | <p><br></p>                                                                                                                                                                                                                                                                                                                                                                                                                 |
| Deelnemen aan vergadering met DTMF                                                                                        | n/b                      | n/b                   | n/b                                     | Deze instelling kan ervoor zorgen dat een nieuw item verschijnt in de **Favorieten** (en dus telefoonboek). Zie de [Locatie voor Ad-hoc Deelnemen/Nu vergaderen](#the-a-d-hoc-favorite-join-button-will-connect-your-h.323-sip-video-conferencing-device-to-the-zoom-c) voor meer details.                                                                                                                                  |
| Altijd Deelnemen-knop Weergeven                                                                                           | n/b                      | n/b                   | n/b                                     | Deze instelling zorgt ervoor dat agenda-evenementen zonder herkende informatie om deel te nemen aan de vergadering een Deelnemen-knop aanbieden die, wanneer erop wordt gedrukt, het equivalent van de [Favoriet voor ad-hoc deelnemen](#the-a-d-hoc-favorite-join-button-will-connect-your-h.323-sip-video-conferencing-device-to-the-zoom-c) bestemming belt.                                                             |
| Locatie voor Ad-hoc Deelnemen/Nu vergaderen                                                                               | <p><br></p>              | <p><br></p>           | <p><br></p>                             | Als ingesteld op **Favorieten**, verschijnt er een nieuw item in de **Favorieten** (en dus telefoonboek) van het Cisco Apparaat. De titel wordt geconfigureerd door de instelling **Label voor knop voor ad-hoc**. De XML voor de telefoonboekvermelding is te vinden in de [Favoriet voor ad-hoc deelnemen](#the-a-d-hoc-favorite-join-button-will-connect-your-h.323-sip-video-conferencing-device-to-the-zoom-c) sectie. |
| Label voor knop voor ad-hoc                                                                                               | n/b                      | n/b                   | n/b                                     | Deze instelling wijzigt het label van de [Favoriet voor ad-hoc deelnemen](#the-a-d-hoc-favorite-join-button-will-connect-your-h.323-sip-video-conferencing-device-to-the-zoom-c).                                                                                                                                                                                                                                           |
| Dempen opheffen bij binnenkomst                                                                                           | n/b                      | n/b                   | n/b                                     | Deze instelling voegt SIP-kiescode “12” toe aan de [Favoriet voor ad-hoc deelnemen](#the-a-d-hoc-favorite-join-button-will-connect-your-h.323-sip-video-conferencing-device-to-the-zoom-c) en aanroepen van de agenda-Deelnemen-knop voor Zoom Meetings.                                                                                                                                                                    |
| Delen van inhoud van hoge kwaliteit                                                                                       | n/b                      | n/b                   | n/b                                     | Deze instelling voegt SIP-kiescode “100001” toe aan de [Favoriet voor ad-hoc deelnemen](#the-a-d-hoc-favorite-join-button-will-connect-your-h.323-sip-video-conferencing-device-to-the-zoom-c) en aanroepen van de agenda-Deelnemen-knop voor Zoom Meetings.                                                                                                                                                                |
| Herinnering voor aanstaande vergadering                                                                                   | n/b                      | n/b                   | n/b                                     | Deze instelling heeft geen directe invloed op de instellingen van het Cisco Apparaat.                                                                                                                                                                                                                                                                                                                                       |
| Automatisch Deelnemen                                                                                                     | n/b                      | n/b                   | n/b                                     | Als agenda-integratie is ingeschakeld, zorgt deze instelling ervoor dat het Cisco Apparaat agenda-evenementen automatisch start op het starttijdstip van het evenement.                                                                                                                                                                                                                                                     |
| OBTP Inschakelen                                                                                                          | n/b                      | n/b                   | n/b                                     | Deze instelling heeft geen directe invloed op de instellingen van het Cisco Apparaat, maar als agenda-integratie is ingeschakeld, zorgt deze instelling ervoor dat de Verbeterde API-Connector boekingen invoegt die overeenkomen met agenda-evenementen in de agenda van de bijbehorende agenda-resource.                                                                                                                  |
| Automatisch Verlaten                                                                                                      | n/b                      | n/b                   | n/b                                     | Als agenda-integratie is ingeschakeld, zorgt deze instelling ervoor dat het Cisco Apparaat agenda-evenementen automatisch verlaat op het eindtijdstip van het evenement.                                                                                                                                                                                                                                                    |
| Geef de hoogste resolutie prioriteit (max. 720p)                                                                          | n/b                      | n/b                   | n/b                                     | Deze instelling voegt SIP-kiescode “100003” toe aan de “[Favoriet voor ad-hoc deelnemen](#the-a-d-hoc-favorite-join-button-will-connect-your-h.323-sip-video-conferencing-device-to-the-zoom-c)” en aanroepen van de agenda-Deelnemen-knop voor Zoom Meetings.                                                                                                                                                              |
| <p>Voorkeur voor bandbreedteverdeling: inhoud versus video ></p><p>Geef video prioriteit boven inhoud</p><p><br><br></p>  | n/b                      | n/b                   | n/b                                     | Deze instelling voegt SIP-kiescode “100004” toe aan de “[Favoriet voor ad-hoc deelnemen](#the-a-d-hoc-favorite-join-button-will-connect-your-h.323-sip-video-conferencing-device-to-the-zoom-c)” en aanroepen van de agenda-Deelnemen-knop voor Zoom Meetings.                                                                                                                                                              |
| <p>Voorkeur voor bandbreedteverdeling: inhoud versus video ></p><p>Verdeel video en inhoud gelijkelijk</p><p><br><br></p> | n/b                      | n/b                   | n/b                                     | Deze instelling voegt SIP-kiescode “100005” toe aan de “[Favoriet voor ad-hoc deelnemen](#the-a-d-hoc-favorite-join-button-will-connect-your-h.323-sip-video-conferencing-device-to-the-zoom-c)” en aanroepen van de agenda-Deelnemen-knop voor Zoom Meetings.                                                                                                                                                              |
| <p>Voorkeur voor bandbreedteverdeling: inhoud versus video ></p><p>Geef inhoud prioriteit boven video</p><p><br><br></p>  | n/b                      | n/b                   | n/b                                     | Deze instelling voegt SIP-kiescode “100006” toe aan de “[Favoriet voor ad-hoc deelnemen](#the-a-d-hoc-favorite-join-button-will-connect-your-h.323-sip-video-conferencing-device-to-the-zoom-c)” en aanroepen van de agenda-Deelnemen-knop voor Zoom Meetings.                                                                                                                                                              |
| <p>DTMF buiten de band</p><p><br><br></p>                                                                                 | n/b                      | n/b                   | n/b                                     | Deze instelling voegt SIP-kiescode “200001” toe aan de “[Favoriet voor ad-hoc deelnemen](#the-a-d-hoc-favorite-join-button-will-connect-your-h.323-sip-video-conferencing-device-to-the-zoom-c)” en aanroepen van de agenda-Deelnemen-knop voor Zoom Meetings.                                                                                                                                                              |
| Verwijder audio-prompts bij deelnemen                                                                                     | n/b                      | n/b                   | n/b                                     | Deze instelling voegt SIP-kiescode “200006” toe aan de “[Favoriet voor ad-hoc deelnemen](#the-a-d-hoc-favorite-join-button-will-connect-your-h.323-sip-video-conferencing-device-to-the-zoom-c)” en aanroepen van de agenda-Deelnemen-knop voor Zoom Meetings.                                                                                                                                                              |
| Muziekmodus                                                                                                               | n/b                      | n/b                   | n/b                                     | Deze instelling voegt SIP-kiescode “306” toe aan de “[Favoriet voor ad-hoc deelnemen](#the-a-d-hoc-favorite-join-button-will-connect-your-h.323-sip-video-conferencing-device-to-the-zoom-c)” en aanroepen van de agenda-Deelnemen-knop voor Zoom Meetings.                                                                                                                                                                 |
| Videodelingsmodus                                                                                                         | n/b                      | n/b                   | n/b                                     | Deze instelling voegt SIP-kiescode “200009” toe aan de “[Favoriet voor ad-hoc deelnemen](#the-a-d-hoc-favorite-join-button-will-connect-your-h.323-sip-video-conferencing-device-to-the-zoom-c)” en aanroepen van de agenda-Deelnemen-knop voor Zoom Meetings.                                                                                                                                                              |
| Hele-dag-evenementen uitsluiten                                                                                           | n/b                      | n/b                   | n/b                                     | Als agenda-integratie is ingeschakeld, zorgt deze instelling ervoor dat de Enhanced API-Connector “hele dag”-evenementen negeert bij het lezen van de agendaresource-agenda die is gekoppeld aan het Cisco-Apparaat.                                                                                                                                                                                                        |
| audio-niveau > audio-niveau 1 gebruiken                                                                                   | n/b                      | n/b                   | n/b                                     | Deze instelling voegt SIP-kiescode “300001” toe aan de “[Favoriet voor ad-hoc deelnemen](#the-a-d-hoc-favorite-join-button-will-connect-your-h.323-sip-video-conferencing-device-to-the-zoom-c)” en aanroepen van de agenda-Deelnemen-knop voor Zoom Meetings.                                                                                                                                                              |
| audio-niveau > audio-niveau 2 gebruiken                                                                                   | n/b                      | n/b                   | n/b                                     | Deze instelling voegt SIP-kiescode “300002” toe aan de “[Favoriet voor ad-hoc deelnemen](#the-a-d-hoc-favorite-join-button-will-connect-your-h.323-sip-video-conferencing-device-to-the-zoom-c)” en aanroepen van de agenda-Deelnemen-knop voor Zoom Meetings.                                                                                                                                                              |
| audio-niveau > audio-niveau 3 gebruiken                                                                                   | n/b                      | n/b                   | n/b                                     | Deze instelling voegt SIP-kiescode “300003” toe aan de “[Favoriet voor ad-hoc deelnemen](#the-a-d-hoc-favorite-join-button-will-connect-your-h.323-sip-video-conferencing-device-to-the-zoom-c)” en aanroepen van de agenda-Deelnemen-knop voor Zoom Meetings.                                                                                                                                                              |
| Aanvullende DTMF-opdracht                                                                                                 | n/b                      | n/b                   | n/b                                     | Deze instelling heeft geen direct effect op de Instellingen van het Cisco-Apparaat, maar als deze wordt gebruikt, worden de opgegeven SIP-kiescode(s) toegevoegd aan de “[Favoriet voor ad-hoc deelnemen](#the-a-d-hoc-favorite-join-button-will-connect-your-h.323-sip-video-conferencing-device-to-the-zoom-c)” en aanroepen van de agenda-Deelnemen-knop voor Zoom Meetings.                                             |
| Belsnelheid                                                                                                               | n/b                      | n/b                   | n/b                                     | Deze instelling heeft geen direct effect op de Instellingen van het Cisco-Apparaat, maar als deze wordt gebruikt, zorgt deze ervoor dat de opgegeven bellen-snelheid wordt gebruikt voor de “[Favoriet voor ad-hoc deelnemen](#the-a-d-hoc-favorite-join-button-will-connect-your-h.323-sip-video-conferencing-device-to-the-zoom-c)”.                                                                                      |
| Deelnemen aan Webex                                                                                                       | n/b                      | n/b                   | n/b                                     | Deze instelling zorgt ervoor dat er een nieuw item verschijnt in de “Favorieten” (en dus in het telefoonboek). Zie “[Favoriet voor Webex](#the-webex-favorite-join-button-will-connect-your-h.323-sip-video-conferencing-device-to-the-webex-me)” voor details.                                                                                                                                                             |
| Webex-vergadering-ID                                                                                                      | n/b                      | n/b                   | n/b                                     | Deze instelling vormt het “gebruiker”-gedeelte van de URI die wordt gebruikt door de “[Favoriet voor Webex](#the-webex-favorite-join-button-will-connect-your-h.323-sip-video-conferencing-device-to-the-webex-me).”                                                                                                                                                                                                        |
| Webex-locatie-URL                                                                                                         | n/b                      | n/b                   | n/b                                     | Deze instelling vormt het “domein”-gedeelte van de URI die wordt gebruikt door de “[Favoriet voor Webex](#the-webex-favorite-join-button-will-connect-your-h.323-sip-video-conferencing-device-to-the-webex-me).”                                                                                                                                                                                                           |
| Onderwerp Verbergen                                                                                                       | n/b                      | n/b                   | n/b                                     | Als agenda-integratie is ingeschakeld, zorgt deze instelling ervoor dat de Enhanced API-Connector het onderwerp/de titel van de vergadering verbergt bij het lezen van de agendaresource-agenda die is gekoppeld aan het Cisco-Apparaat.                                                                                                                                                                                    |
| Agenda Verbergen                                                                                                          | n/b                      | n/b                   | n/b                                     | Als agenda-integratie is ingeschakeld, zorgt deze instelling ervoor dat de Enhanced API-Connector de inhoud/opmerking van de vergadering verbergt bij het lezen van de agendaresource-agenda die is gekoppeld aan het Cisco-Apparaat.                                                                                                                                                                                       |
| Standaardonderwerp                                                                                                        | n/b                      | n/b                   | n/b                                     | Als agenda-integratie en “Onderwerp Verbergen” zijn ingeschakeld, zorgt deze instelling ervoor dat de Enhanced API-Connector het onderwerp/de titel van de vergadering vervangt door de opgegeven waarde voor agenda-gebeurtenissen waarvan niet wordt gedetecteerd dat ze enige vergaderinformatie bevatten.                                                                                                               |
| Standaardonderwerp (Zoom)                                                                                                 | n/b                      | n/b                   | n/b                                     | Als agenda-integratie en “Onderwerp Verbergen” zijn ingeschakeld, zorgt deze instelling ervoor dat de Enhanced API-Connector het onderwerp/de titel van de vergadering vervangt door de opgegeven waarde voor agenda-gebeurtenissen die worden gedetecteerd als bevattende Zoom-vergaderinformatie.                                                                                                                         |

#### <mark style="color:blauw;">H.323/SIP Integratie-Instellingen in het Zoom-webportal</mark>

| Zoom-instellingen                                                                | Cisco-instellingselement                                                                                                                                                                                                                                                 | Cisco Standaardwaarde                                                                                                                                         | Nieuwe waarde                                                                                                                                                                                                          | Opmerkingen                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| -------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| SIP-modus                                                                        | NetworkServices SIP-modus                                                                                                                                                                                                                                                | Aan                                                                                                                                                           | Aan \| Uit                                                                                                                                                                                                             | <p><br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| SIP bellenbesturing Registratie > Ingeschakeld, niet geregistreerd               | <p>SIP-authenticatie Gebruikersnaam</p><p><br></p><p>SIP Standaardtransport</p><p><br></p><p>SIP-weergavenaam</p><p><br></p><p>SIP-proxy 1-adres</p><p><br></p><p>SIP TlsVerify</p><p><br></p><p>SIP URI</p>                                                             | <p>\<leeg></p><p><br></p><p>Auto</p><p><br></p><p>\<leeg></p><p><br></p><p>\<leeg></p><p><br></p><p>Aan</p><p><br></p><p>\<leeg></p>                          | <p>\<leeg></p><p><br></p><p>TLS</p><p><br></p><p>\[Ruimtenaam]</p><p><br></p><p>\<leeg></p><p><br></p><p>Uit</p><p><br></p><p>\[serienummer]@cisco-Apparaat</p>                                                        | Deze instelling zal bestaande SIP-Instellingen overschrijven als ze afwijken van de Standaardinstellingen.                                                                                                                                                                                                                                                                                                                                                     |
| SIP bellenbesturing Registratie > Ingeschakeld, registreren bij Zoom             | <p>SIP-authenticatiewachtwoord</p><p><br></p><p>SIP-authenticatie Gebruikersnaam</p><p><br></p><p>SIP Standaardtransport</p><p><br></p><p>SIP-weergavenaam</p><p><br></p><p>SIP-proxy 1-adres</p><p><br></p><p>SIP TlsVerify</p><p><br></p><p>SIP URI</p><p><br><br></p> | <p>\<leeg></p><p><br></p><p>\<leeg></p><p><br></p><p>Auto</p><p><br></p><p>\<leeg></p><p><br></p><p>\<leeg></p><p><br></p><p>Aan</p><p><br></p><p>\<leeg></p> | <p>\[varieert, geredigeerd]</p><p><br></p><p>\<leeg></p><p><br></p><p>TLS</p><p><br></p><p>\[Ruimtenaam]</p><p><br></p><p>us01sipproxy.zoom.us</p><p><br></p><p>Uit</p><p><br></p><p>\[serienummer]@cisco-Apparaat</p> | Zoom levert deze Instellingen ter ondersteuning van SIP-Registratie bij Zoom’s Cloud-SIP-proxy.                                                                                                                                                                                                                                                                                                                                                                |
| SIP bellenbesturing Registratie > Niet geleverd door Zoom                        | n/b                                                                                                                                                                                                                                                                      | n/b                                                                                                                                                           | n/b                                                                                                                                                                                                                    | Deze instelling heeft geen directe invloed op de instellingen van het Cisco Apparaat.                                                                                                                                                                                                                                                                                                                                                                          |
| SIP bellenbesturing Registratie > Ingeschakeld, registreren bij een derde partij | \<varieert>                                                                                                                                                                                                                                                              | \<varieert>                                                                                                                                                   | \<varieert>                                                                                                                                                                                                            | Deze instelling maakt handmatige levering van verschillende SIP-configuraties voor het Cisco-Apparaat mogelijk.                                                                                                                                                                                                                                                                                                                                                |
| H.323-modus                                                                      | NetworkServices H323-modus                                                                                                                                                                                                                                               | Aan                                                                                                                                                           | Aan \| Uit                                                                                                                                                                                                             | Deze instelling heeft geen direct effect op Apparaten die zijn geregistreerd bij Cisco Cloud-services                                                                                                                                                                                                                                                                                                                                                          |
| H.323 Gatekeeper > Ingeschakeld, niet geregistreerd                              | n/b                                                                                                                                                                                                                                                                      | n/b                                                                                                                                                           | n/b                                                                                                                                                                                                                    | Deze instelling heeft geen direct effect op Apparaten die zijn geregistreerd bij Cisco Cloud-services                                                                                                                                                                                                                                                                                                                                                          |
| H.323 Gatekeeper > Niet ondersteund door Apparaatmodel                           | n/b                                                                                                                                                                                                                                                                      | n/b                                                                                                                                                           | n/b                                                                                                                                                                                                                    | Deze instelling heeft geen direct effect op Apparaten die zijn geregistreerd bij Cisco Cloud-services                                                                                                                                                                                                                                                                                                                                                          |
| H.323 Gatekeeper > Niet ingericht door Zoom                                      | n/b                                                                                                                                                                                                                                                                      | n/b                                                                                                                                                           | n/b                                                                                                                                                                                                                    | Deze instelling heeft geen direct effect op Apparaten die zijn geregistreerd bij Cisco Cloud-services                                                                                                                                                                                                                                                                                                                                                          |
| H.323 Gatekeeper > Aangepaste Registratie                                        | \<varieert>                                                                                                                                                                                                                                                              | \<varieert>                                                                                                                                                   | \<varieert>                                                                                                                                                                                                            | Deze instelling maakt handmatige levering van verschillende SIP-configuraties voor het Cisco-Apparaat mogelijk.                                                                                                                                                                                                                                                                                                                                                |
| Bellenbeheerprotocol voor Zoom Meetings                                          | n/b                                                                                                                                                                                                                                                                      | n/b                                                                                                                                                           | n/b                                                                                                                                                                                                                    | Als agenda-integratie of de “[Favoriet voor ad-hoc deelnemen](#the-a-d-hoc-favorite-join-button-will-connect-your-h.323-sip-video-conferencing-device-to-the-zoom-c)” is ingeschakeld, bepaalt deze Instellingen welk bellenbeheerprotocol door het Cisco Eindpunt wordt gebruikt om respectievelijk het agenda-Evenement of de Favoriet te kiezen.                                                                                                            |
| Kiezen met numeriek kiesplan                                                     | n/b                                                                                                                                                                                                                                                                      | n/b                                                                                                                                                           | n/b                                                                                                                                                                                                                    | Deze Instellingen hebben geen rechtstreeks effect op de Instellingen van Cisco Apparaten, maar indien ingesteld op numeriek, zorgt dit ervoor dat de “[Favoriet voor ad-hoc deelnemen](#the-a-d-hoc-favorite-join-button-will-connect-your-h.323-sip-video-conferencing-device-to-the-zoom-c)” en oproepen via de agendaknop om deel te nemen voor Zoom-vergaderingen en andere typen agendavergaderingen alleen met cijfers worden gekozen (geen URI-domein). |

#### <mark style="color:blauw;">Geavanceerde Instellingen in het Zoom-webportal</mark>

| Zoom-instellingen            | Cisco-instellingselement | Cisco Standaardwaarde | Nieuwe waarde                | Opmerkingen                                                                                                                                                                                                                                                                                           |
| ---------------------------- | ------------------------ | --------------------- | ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Alternatieve Ruimteconnector | n/b                      | n/b                   | n/b                          | Deze instelling wijzigt het SIP-domein van de Cloudruimteconnector dat wordt gebruikt door de “[Favoriet voor ad-hoc deelnemen](#the-a-d-hoc-favorite-join-button-will-connect-your-h.323-sip-video-conferencing-device-to-the-zoom-c)” en aanroepen van de agenda-Deelnemen-knop voor Zoom Meetings. |
| Connector                    | n/b                      | n/b                   | n/b                          | Deze instelling heeft geen directe invloed op Cisco Apparaat Instellingen, maar wijzigt welke Enhanced API Connector het Apparaat zal beheren.                                                                                                                                                        |
| Achtergrondafbeelding        | n/b                      | n/b                   | n/b                          | Deze instelling heeft geen directe invloed op Cisco Apparaat Instellingen, maar heeft wel invloed op de Apparaat Branding, door de Standaard Cisco-achtergrondafbeelding te vervangen door het meegeleverde afbeeldingsbestand.                                                                       |
| Capset Filter                | Vergadering CapsetFilter | <p><br></p>           | \[de geconfigureerde waarde] | Deze instelling wijzigt de CapsetFilter die wordt gebruikt bij het onderhandelen over SIP- of H323-oproepen. Deze instelling heeft geen directe invloed op apparaten die zijn geregistreerd bij Cisco Cloud-services.                                                                                 |
| Geavanceerde provisioning    | \[verschilt]             | \[verschilt]          | \[verschilt]                 | Geavanceerde provisioningopdrachten kunnen de Instellingen van het Cisco Apparaat wijzigen.                                                                                                                                                                                                           |

#### <mark style="color:blauw;">De ad-hoc Favoriet-deelnemenknop verbindt uw H.323/SIP-videoconferentie-Apparaat met de Zoom CRC-gateway om Deelnemen aan Zoom Meetings</mark>

Door deze **Favoriet** knop zal een bellen naar het Zoom CRC-vergaderingsstartscherm initiëren waar een gebruiker de Zoom vergadering-ID en numerieke toegangscode kan Invoeren.

Als de Functie(s) **Deelnemen aan vergadering met DTMF** is ingeschakeld en de **Locatie voor Ad-hoc Deelnemen/Nu vergaderen** is ingesteld in het webportaal, zal de Zoom Verbeterde API Connector automatisch een telefoonboekvermelding in het Apparaat invoegen. De Standaard “Label voor ad-hocknop” is **Deelnemen aan Zoom-vergadering**.

* De SIP URI bestaat uit meerdere delen. Het onderstaande voorbeeld toont de Standaard.
* Het deel “\[security code]” verandert willekeurig, met een levensduur van 2 uur—Zoom Verbeterde API Connector zal het item bijwerken voordat het verloopt.
* Het “\[domain]” hangt af van de instelling **Alternatieve Ruimteconnector**.
* Het Protocol varieert op basis van de instelling **Bellenbeheerprotocol voor Zoom Meetings**.
* De CallRate varieert op basis van de instelling **Belsnelheid**—de Standaard is 1920.

{% hint style="success" %}
**Voorbeeld: XML voor Ad-hoc favorietenknop**

\<?xml version="1.0" encoding="UTF-8"?>

\<LocalPhoneBook>

\<contactpersoon localId="localcontactpersoonId-1" type="Persoon">

\<Weergavenaam>Deelnemen aan Zoom-vergadering\</Weergavenaam>

\<Label>Favoriet\</Label>

\<contactpersoonMethodeGroep type="only\_one\_Groep">

\<contactpersoonMethode type="Video" localId="1">

\<Uri>0.....\[beveiligingscode]@\[domein]\</Uri>

\<Protocol>\[verschilt]\</Protocol>

\<Gesprekstarief>\[verschilt]\</Gesprekstarief>

\<Oproeptype>Video\</Oproeptype>

\</contactpersoonMethode>

\</ContactMethodGroup>

\</contactpersoon>

\</LocalPhoneBook>
{% endhint %}

#### <mark style="color:blauw;">De Webex Favoriete Deelnemen-knop verbindt uw H.323/SIP-videoconferentie-Apparaat met de Webex-vergaderinginterface</mark>

Als de Functie(s) **Deelnemen aan Webex** is ingeschakeld en de bijbehorende Instellingen **Webex-vergadering-ID** en **Webex-locatie-URL** zijn geconfigureerd, zal Zoom Enhanced API Connector automatisch een telefoonboekvermelding met de naam “Webex” invoegen.

* De SIP-URI bestaat uit meerdere delen - de “Webex vergadering-ID” levert het “\[gebruiker]”-gedeelte, terwijl de “Webex locatie-URL” het “\[domein]”-gedeelte levert.
* Het Protocol varieert op basis van de instelling **Bellenbeheerprotocol voor Zoom Meetings**.
* De CallRate varieert op basis van de instelling **Belsnelheid**—de Standaard is 1920.
* Met deze Favoriet wordt bellen naar Webex gestart.

{% hint style="success" %}
**Voorbeeld: XML Webex-favorietenknop**

\<?xml version="1.0" encoding="UTF-8"?>

\<LocalPhoneBook>

\<contactpersoon localId="localcontactpersoonId-1" type="Persoon">

\<DisplayName>Webex\</DisplayName>

\<Label>Favoriet\</Label>

\<contactpersoonMethodeGroep type="only\_one\_Groep">

\<contactpersoonMethode type="Video" localId="1">

\<Uri>\[gebruiker]@\[domain]\</Uri>

\<Protocol>\[verschilt]\</Protocol>

\<Gesprekstarief>\[verschilt]\</Gesprekstarief>

\<Oproeptype>Video\</Oproeptype>

\</contactpersoonMethode>

\</ContactMethodGroup>

\</contactpersoon>

\</LocalPhoneBook>
{% endhint %}

#### <mark style="color:blauw;">Agenda-uitnodigingen</mark>

Als de agenda-integratie Functie(s) is ingeschakeld, leest de Zoom Enhanced API Connector automatisch de bijbehorende agendaresource en voegt een **BookingsList** vermelding.

* De “Titel” kan worden overschreven door de instelling van het Zoom-webportal **Onderwerp Verbergen**.
* De “Agenda” kan worden overschreven door de instelling van het Zoom-webportal **Agenda Verbergen**.
* De SIP URI bestaat uit meerdere delen. Het onderstaande voorbeeld toont de Standaard.
* De “\[vergadering-ID]” en “\[toegangscode]”-delen zijn gebaseerd op de informatie van de Zoom-vergadering. Het “\[beveiligingscode]”-deel verandert willekeurig, met een geldigheidsduur van twee (2) uur - Zoom Enhanced API Connector werkt de vermelding bij voordat deze verloopt.
* Het “\[domain]” hangt af van de instelling **Alternatieve Ruimteconnector**.
* Het Protocol varieert op basis van de instelling **Bellenbeheerprotocol voor Zoom Meetings**.
* De “MeetingPlatform” wordt ingesteld op “Zoom” voor Zoom-vergaderingen.
* De CallRate varieert op basis van de instelling **Belsnelheid**—de Standaard is 1920

{% hint style="success" %}
**Voorbeeld: XML voor agenda-uitnodigingen**

\<?xml version="1.0" encoding="UTF-8"?>

\<Command>

\<BookingsListResult status="OK">

\<ResultInfo>

\<TotalRows>1\</TotalRows>

\</ResultInfo>

\<LastUpdated>\[varies]\</LastUpdated>

\<Booking item="1" maxOccurrence="n">

\<Id>\[varies]\</Id>

\<MeetingId>\</MeetingId>

\<Titel>\[varies]\</Titel>

\<Agenda>\[varies]\</Agenda>

\<privacy>Openbaar\</privacy>

\<Organisator>

\<Voornaam>\[varies]\</Voornaam>

\<Achternaam>\[varies]\</Achternaam>

\<E-mail>\[varies]\</E-mail>

\<Id>\</Id>

\</Organisator>

\<Tijd>

\<StartTime>\[varieert]\</StartTime>

\<StartTimeBuffer>1800\</StartTimeBuffer>

\<EndTime>\[varieert]\</EndTime>

\<EndTimeBuffer>1800\</EndTimeBuffer>

\</Time>

\<MaximumMeetingExtension>5\</MaximumMeetingExtension>

\<MeetingExtensionAvailability>\</MeetingExtensionAvailability>

\<BookingStatus>OK\</BookingStatus>

\<BookingStatusMessage>\</BookingStatusMessage>

\<MeetingPlatform>Zoom\</MeetingPlatform>

\<Annuleerbaar>False\</Annuleerbaar>

\<Webex>

\<Ingeschakeld>False\</Ingeschakeld>

\<URL>\</URL>

\<vergaderingNummer>\</vergaderingNummer>

\<wachtwoord>\</wachtwoord>

\<Hostsleutel>\</Hostsleutel>

\<Inbelnummers/>

\</Webex>

\<encryptie>BestEffort\</encryptie>

\<Opname>Uitgeschakeld\</Opname>

\<Inbelinformatie>

\<bellen>

\<bellen item="1" maxOccurrence="n">

\<Nummer>\[vergadering-ID].\[vergadering toegangscode]....\[beveiligingscode]@\[domein]\</Nummer>

\<Oproeptype>Video\</Oproeptype>

\</bellen>

\</bellen>

\<Verbindingsmodus>OBTP\</Verbindingsmodus>

\</Inbelinformatie>

\</Boeking>

\</BoekingsLijstResultaat>

\</Opdracht>
{% endhint %}


---

# 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/nl/geavanceerde-ondernemingsservices/conference-room-connector-explainer/zoom-enhanced-api-connector-cisco-h.323-sip-device-settings.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.
