> 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/zoom-workplace/zoom-phone/third-party-integrations/zoom-and-mitel-phone-system-integration-field-guide.md).
# Handleiding voor integratie van Zoom en het Mitel Telefoonsysteem
### Overzicht
Zoom en Mitel bundelen hun krachten om je VoIP-systeem te verbeteren. Met deze Telefoonsysteem Integratie(s) — of PSI — haal je het beste van twee werelden in huis: de samenwerkingskracht van Zoom Workplace en de belmogelijkheden van je bestaande Mitel-systeem, allemaal vanuit de desktop- en mobiele Zoom Workplace-apps.
Als u Zoom Workplace al gebruikt, overweegt om met Zoom Workplace te beginnen, of meer Zoom Workplace-functies toevoegt en een compatibele Mitel-opstelling hebt, is deze Integratie(s) een uitstekende keuze.
Dit is het idee: je Zoom Phone Tabblad wordt een SIP-softphone (sessie initiation protocol) die rechtstreeks verbinding maakt met het Mitel-belPlatform. Als je via internet Verbinden maakt, gebruikt deze de OpenScape sessie Border Controller van Mitel, of SBC. Je gebruikt ook Mitel CloudLink om inloggen eenvoudiger te maken en gebruikers soepeler te beheren tussen Zoom en Mitel.
Even ter info: je moet alle juiste Zoom- en Mitel-componenten op hun plaats hebben om deze Integratie(s) goed te laten werken.
#### Zoom- en Mitel PSI-functies
Deze Integratie(s) brengt een hele reeks functies naar uw huidige Mitel-implementatie. Hier zijn slechts enkele waarvan u kunt profiteren:
* Bellen plaatsen en ontvangen
* Verwerk meerdere oproepen tegelijk
* Zet oproepen in de wacht of start een vergadering
* Oproepen doorverbinden (koud of warm)
* Toegang tot voicemail
* Bekijk bellenhistorie en logboeken
* Stel bellen doorschakelen in
* Gebruik de modus Niet storen
* Synchroniseren van bedrijfscontacten
* Zet een telefoongesprek (bellen) om in een Zoom-vergadering
* Bekijk aanwezigheidsstatus tussen Zoom Apps (beperkt met Mitel-telefoons)
* Ga van chatbericht naar bellen via PSI
#### High-level vereisten
De volgende secties schetsen high-level vereisten voor deze Integratie(s).
**Zoom-specifieke details**
Om alles aan de Zoom-kant aan het draaien te krijgen, heb je nodig:
* Een accounteigenaar- of beheerdersrol om gebruikers, de PSI en Zoom Phone te beheren
* Een ondersteunde licentie per gebruiker, zoals:
* Zoom Workplace Zakelijk/Zakelijk+
* Zoom Workplace Essentials/Onderneming/Onderneming+/Onderneming Premier
* Verouderde vergadering-licenties (ENH/EAH)
* Elk abonnement met Zoom Phone Pro
* Zoom Phone geconfigureerd en Actief voor uw Organisatie
* [**Automatische telefoontoewijzing**](#disable-the-automatic-phone-license-assignment-for-zoom-workplace) uitgeschakeld voor Zoom Workplace-licenties
* Zoom Workplace app-versie 6.3.6 of hoger
**Mitel-specifieke details**
Aan de Mitel-kant heb je het volgende nodig:
**PBX Hardware-compatibiliteit:**
* OpenScape Voice (OSV)
* OpenScape 4k (OS4k)
* Mitel CloudLink
* MiVoice Zakelijk (MiVB)
**Ondersteunde app en Platformen:**
* Mitel Beheer app
* OpenScape 4000 Platform (voor OS4k)
* OpenScape Common Management Platform (voor OSV)
* OpenScape SBC Management Portal (voor OSV en OS4k)
* OpenScape SBC (voor externe Registratie met OSV/OS4k)
**Licenties:**
* Mitel ZoomPSI of Hybrid
* Teleworker-licentie
Voordat u het Integratie(s)proces start, zijn er een paar belangrijke dingen om te weten:
* De Zoom Workplace app gebruikt de [Standaard firewallpoorten en IP-bereiken](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060548).
* De IP's en poorten voor telefoonsignalering/media worden bepaald door de Mitel-configuratie en kunnen afwijken van de standaarden. Neem contactpersoon op met Mitel of uw Mitel-partner als u aanvullende informatie nodig hebt.
* U moet een Teleworker-licentie hebben voor zowel de desktop- als mobiele apps van Zoom Workplace — twee licenties per gebruiker. Deze zijn essentieel om terug te Verbinden met de Mitel PBX.
### Architectuur
#### Standaard Integratie(s)-architectuur
Belangrijke verbindingen:
* **Zoom-cloud naar Mitel CloudLink**: REST API via TLS
* **Zoom Workplace-verbinding**: TLS naar de datacenters van Zoom
* **Apparaat van de gebruiker naar Mitel**: telefoon-signalering/media via TLS
* **Mitel CloudLink naar PBX**: Propriëtaire protocollen
#### Hybride configuratie
Organisaties draaien zowel Zoom Phone als de Mitel Integratie(s) gelijktijdig. Gebruikers met Zoom Phone-licenties maken verbinding met Zoom Phone SBC, terwijl gebruikers met de Mitel Integratie(s) verbinding maken met Mitel SBC. Met een BYOP-trunk die hen Verbinden, kunnen gebruikers extensies tussen verschillende systemen bellen.
#### Technisch architectuuroverzicht
**Mitel CloudLink-verbinding**
CloudLink is een Cloud-gebaseerd Platform dat uw on-premises PBX overbrugt met Cloud-oplossingen. Zoom gebruikt CloudLink voor Cloud API Access tot Mitel PBX-componenten, waardoor één interface ontstaat in plaats van dat elk PBX zijn unieke taal moet "spreken".
{% hint style="success" %}
**Voorbeeld**
Wanneer u Niet storen inschakelt, stuurt Zoom één API-opdracht naar CloudLink, die deze interpreteert voor de specifieke Mitel PBX (OS4K en MiVoice Zakelijk behandelen dit verschillend).
{% endhint %}
**Zoom-cloud naar CloudLink-synchronisatie**
U brengt veilige communicatie tot stand via **Zoom Apps** van beide **Zoom** en **CloudLink**. Wanneer je deze apps installeert, moet een beheerder bij beide systemen inloggen om een veilige OAuth-verbinding op te zetten.
Zodra er verbinding is gemaakt, haalt Zoom de inloggegevens van de gebruiker via TLS op:
* SIP "Gebruikersnaam" (vaak het telefoonnummer)
* SIP-inloggegevens (alleen veilige hash)
* Registratie-IP-adressen (SBC en back-up-SBC, of interne PBX)
**App-Registratieproces**
1. De Cloud van Zoom geeft de inloggegevens door aan de Zoom Workplace-app van de gebruiker via TLS
2. Zoom Workplace activeert het tabblad Telefoon
3. De Zoom Workplace app maakt rechtstreeks verbinding met de Mitel SBC of PBX via TLS (niet via Zoom-cloud geproxied)
**Aanvullend** **Flows**
* Functies: De Zoom Workplace app communiceert rechtstreeks met Mitel CloudLink via REST API over TLS voor bellen-logboeken, voicemailberichten en Niet storen-status
* Mobiele push: Mitel SBC stuurt pushmeldingen naar Zoom-cloud, die ze doorstuurt naar mobiele apparaten
* Netwerkadaptatie: externe gebruikers verbinden via CloudLink en Mitel SBC. Desktops op locatie verbinden rechtstreeks met Mitel PBX. Mobiele apparaten gebruiken de veilige externe route.
### Configureer de Integratie(s)
De Integratie(s) is eenvoudig tussen Zoom en Mitel, waarbij het werk aan de Zoom-kant gemiddeld ongeveer 45 minuten duurt, met een groter deel aan de Mitel-kant. Neem contact op met Mitel of uw Mitel-partner voor aanvullende vragen of informatie over de tijdsplanning.
Elke beheerder die deze stappen uitvoert, heeft de **Telefoonsysteem Integratie(s)** Toestemming om alle stappen te voltooien.
#### Voltooi de eerste installatie van Zoom Phone
Als u een nieuwe klant bent en Zoom Phone nog niet hebt geconfigureerd, volg dan ons ondersteuningsdocument over [Aan de slag met Zoom Phone](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060257#h_5ae26a3a-290c-4a8d-b3b0-6384ed267b13). Anders, Doorgaan met de volgende stap.
#### Uitschakelen van de automatische toewijzing van telefoonlicenties voor Zoom Workplace
Uitschakelen van de automatische licentietoewijzing voor Zoom Phone voor alle gebruikers in het account:
1. Aanmelden bij het [Zoom-webportal](https://zoom.us/profile) als beheerder.
2. Klik in het linkernavigatiemenu op **accountbeheer**, en vervolgens op **Accountinstellingen**.
3. Klik op de **Zoom Phone** Tabblad.
4. Onder **Algemeen**, klik op de **Zoom Phone-gebruikers automatisch activeren** In-/uitschakelen om het uit te schakelen.
5. Als er een Verificatie-dialoogvenster wordt weergegeven, klik op **Uitschakelen** om de wijziging te bevestigen.
#### Gebruikers toevoegen aan Zoom
U kunt gebruikers afzonderlijk toevoegen, met een CSV-bestand, of door SSO (Single Sign-On) te gebruiken via de stappen in ons ondersteuningsdocument over [gebruikers beheren](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0061789#h_8b193526-997c-4385-955b-ffddda0b0404). Als u een bestaande gebruiker uitnodigt om deel te nemen aan uw Zoom-account, lees dan meer over het proces van [bestaande gebruikers toevoegen aan een betaald account](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0063202), zoals het afhandelen van eventuele resterende saldi en gegevens die naar uw account worden overgedragen.
#### Licenties toewijzen aan gebruikers
U kunt Zoom-productlicenties afzonderlijk of in bulk toewijzen. Meer informatie is beschikbaar over hoe u [Zoom-licenties toewijzen](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064911) in het gelinkte artikel.
#### Installeer de Mitel-app vanuit Zoom App Marketplace
Volg de onderstaande stappen om Zoom met Mitel CloudLink te verbinden:
1. Aanmelden bij het [Zoom-webportal](https://zoom.us/profile) als beheerder.
2. In het linkernavigatiemenu, onder **Geavanceerd** klik op **app Marketplace**.
3. Gebruik het zoekvak om de **Mitel PSI-app** te vinden en selecteer deze. Klik op **Toevoegen**.
4. Klik op **Connector maken**.
5. Klik op **Verbinden** om te bevestigen dat u de externe Mitel Connector met uw Zoom-account wilt verbinden. Er wordt een Browservenster geopend en u wordt doorgestuurd naar Mitel CloudLink.
6. Meld u aan bij Mitel CloudLink. De communicatie tussen Zoom en Mitel's CloudLink is nu voltooid.
{% hint style="info" %}
**Opmerking**
Mitel heeft ook een App Store voor CloudLink waar Zoom kan worden toegevoegd om naar Zoom te worden doorgestuurd voor voltooiing.
{% endhint %}
#### Configureer Telefoonsysteem-Integratie(s)-Instellingen
Volg de onderstaande stappen om gebruikers van de mobiele Zoom Workplace-app te laten bellen via een Mitel on-premises-systeem:
1. Aanmelden bij het [Zoom-webportal](https://zoom.us/profile) als beheerder.
2. Klik in het linkernavigatiemenu op **accountbeheer**, en vervolgens op **Telefoonsysteem Integratie(s)**.
3. Klik op de **Instellingen** Tabblad.
4. Om bellen in de mobiele Zoom Workplace-app te integreren, selecteer het **Toestaan om het geïntegreerde Telefoonsysteem te gebruiken om te bellen op de mobiele Zoom-client** In-/uitschakelen.
5. Als er een Verificatie-dialoogvenster verschijnt, klik op **Inschakelen** of **Uitschakelen** om de wijziging te bevestigen.
{% hint style="info" %}
**Opmerkingen**
* Zorg ervoor dat deze instelling altijd is ingeschakeld.
* Als deze optie is ingeschakeld en de gebruikers op de lijst voor Telefoonsysteem-Integratie(s) staan, kunnen deze gebruikers een Mitel on-premises-systeem gebruiken om te bellen via de mobiele Zoom Workplace-app.
{% endhint %}
#### Zoom-gebruikers toevoegen aan de Mitel PSI
U kunt ervoor kiezen gebruikers handmatig of in bulk via CSV toe te voegen. Zie de stappen voor [het toevoegen van Zoom-gebruikers aan de Mitel-Integratie(s)](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0079172#mcetoc_1iiurdfim2r8) in ons gelinkte ondersteuningsartikel.
#### Verifieer de Zoom-Mitel-Integratie(s) in de Zoom Workplace-app
Om te verifiëren dat de Integratie(s) correct is geconfigureerd, meldt u zich aan bij de Zoom Workplace-app (desktop of mobiel) en klikt u op het **Telefoon** Tabblad. Zorg ervoor dat u de beller-ID (extensie van Mitel) kunt zien en dat er geen foutmeldingen zijn. Als er fouten zijn, geeft de statuskolom relevante informatie:
| Status | Beschrijving |
| ----------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| **SIP-inloggegevens in afwachting** | Wachten tot CloudLink de gebruiker autoriseert. |
| **Inactief** | De SIP-referentie is al gesynchroniseerd met Zoom, maar de gebruiker heeft zich nog niet geregistreerd bij de Zoom Workplace app. |
| **Geregistreerd** | De Zoom Workplace app heeft zich succesvol geregistreerd bij de SIP-server. |
| **SIP-foutcodes (diverse)** | Dit biedt veelvoorkomende SIP-foutcodes en een algemene beschrijving om te helpen bij het oplossen van het Registratieprobleem. |
#### Configureer Mitel Gebruikersbeheer
Gebruik de verwijzingen in onze [Zoom-Mitel PSI-configuratie](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0079172#mcetoc_1iiurmd8a34k) handleiding voor informatie om u op weg te helpen. Neem contactpersoon op met Mitel of uw Mitel-partner voor vragen of aanvullende informatie.
#### Beveiligingsoverwegingen
Onze [Zoom-Mitel PSI-configuratie](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0079172#mcetoc_1iiurmd8a34k) Deze handleiding bevat enkele beveiligingsoverwegingen voor uw Organisatie. Neem contactpersoon op met Mitel of uw Mitel-partner voor vragen of aanvullende informatie.
#### Externe contacten beheren (niet-Zoom-contacten)
Eigenaren van een account en beheerders kunnen een gedeelde map met externe contacten aanmaken. Er is meer informatie in onze[ Zoom-Mitel PSI-configuratie](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0079172#mcetoc_1iiurmd8a34k) Handleiding. Contactpersoon Mitel of uw Mitel-partner voor vragen of aanvullende informatie.
#### Breng je eigen PBX (BYOP)
BYOP stelt je in staat een SIP-trunk op te zetten tussen Zoom Phone en Mitel voor bellen op basis van toestelnummers. Mix en match — sommige kantoren gebruiken Zoom Phone, terwijl andere de Mitel Integratie(s) gebruiken. Met een BYOP-trunk bellen gebruikers toestelnummers tussen systemen.
Deze configuratie vereist extra firewallregels en gebruikt Mutual TLS. Zie onze ondersteuning-locatie voor vereisten. We hebben samen met Mitel ondersteuningsdocumenten geschreven voor OpenScape SBC en MiVoice Border Gateway, Beschikbaar op onze Zoom Phone-ondersteunde Hardware-pagina.
#### Mitel Desk Phone-ondersteuning op Zoom Phone
Gebruikers op Zoom Phone kunnen Mitel-bureautelefoons gebruiken die rechtstreeks worden geregistreerd bij Zoom Phone. Raadpleeg voor een lijst met ondersteunde modellen Zoom’s [lijst met gecertificeerde Hardware](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060242).
### Veelgestelde vragen
#### Een licentie- of software-update kan vereist zijn, afhankelijk van je Mitel-systeemconfiguratie
Elke Mitel-opstelling is anders, dus wat je nodig hebt, hangt af van je specifieke configuratie. Je Mitel-partner kan je systeem snel beoordelen en je vertellen of je licentie-upgrades nodig hebt (zoals Teleworker-licenties) of software-updates om alles compatibel te maken. Het is de moeite waard om het even te controleren, omdat de vereisten sterk verschillen per implementatie.
#### Mitel CloudLink is vereist om deze Integratie(s) te laten werken
Ja, CloudLink is essentieel. Het helpt alles te Synchroniseren tussen Zoom en je Mitel-systeem, zoals je gebruiker-info en inloggegevens. Het vereenvoudigt ook het beheer van gebruikers.
#### Ja, deze Integratie(s) werkt naast Zoom Phone-implementaties
Je kunt mixen en matchen — sommige kantoren kunnen niet-geïntegreerde Zoom Phone gebruiken terwijl andere de Mitel Integratie(s) gebruiken. Met een BYOC/BYOP-trunk die hen Verbinden, kunnen gebruikers zelfs extensies tussen verschillende systemen kiezen. Gebruik wat het beste werkt voor elke Locatie.
#### Je kunt zowel een Mitel-bureautelefoon als de Zoom Workplace app gebruiken
De Zoom Workplace app werkt naast je bestaande bureautelefoon, niet in plaats daarvan. Beide kunnen overgaan wanneer iemand je toestelnummer belt, zodat je kunt opnemen met welk toestel het het handigst is om mee te bellen. Je Mitel-systeem behandelt Zoom Phone als nog een telefoon op je bureau.
#### Zoom verbindt met Mitel via CloudLink
CloudLink is de brug die Zoom en Mitel met elkaar laat communiceren. Het behandelt drie hoofdzaken: controleren of de gebruiker is wie die zegt te zijn, de informatie van de gebruiker synchroniseren tussen beide systemen, en de inloggegevens die Zoom nodig heeft om verbinding te maken met je Mitel-systeem veilig doorgeven. Zonder CloudLink dat als vertaler optreedt, zouden deze twee systemen niet samen kunnen werken — het is wat de Integratie(s) mogelijk maakt.
#### Je kunt geen sms-berichten verzenden via deze Integratie(s)
SMS wordt op dit moment niet ondersteund omdat de Zoom Workplace app in feite fungeert als een softphone die verbinding maakt met je Mitel-systeem voor alleen spraakbellen. sms werkt op totaal andere technologie die je Mitel-systeem apart afhandelt. Zie het zo: Zoom leent de belmogelijkheden van je Mitel-systeem om te bellen, maar sms bevindt zich in een ander deel van dat systeem dat niet toegankelijk is via deze Integratie(s). Je zult voorlopig je huidige Mitel-sms-tools moeten blijven gebruiken, al kan dit in toekomstige updates veranderen.
#### De Netwerkconnectiviteitstool werkt niet met Mitel-telefoons
Zoom's Netwerkconnectiviteitstool kan je Mitel-telefoonverbindingen niet testen, omdat die is ontworpen om de eigen servers van Zoom te controleren, niet je Mitel-systeem. Wanneer je deze Integratie(s) gebruikt, gaan je oproepen via het netwerk van Mitel (rechtstreeks naar je PBX of via de servers van Mitel), dus de testtool van Zoom kan die routes simpelweg niet zien of testen. Het is alsof je een diagnosehulpmiddel van een auto op een ander merk probeert te gebruiken — ze spreken gewoon verschillende talen. Met andere woorden: bellen verloopt daar via Mitel, niet via Zoom. De tool werkt nog steeds prima om je gewone Zoom-vergaderingverbindingen te testen.
#### Zoom-gebruikers kunnen de aanwezigheid niet zien van gebruikers die alleen Mitel-bureautelefoons hebben
Je traditionele Mitel-bureautelefoons geven niet aan of iemand Beschikbaar is of aan het bellen is met Zoom. De Integratie(s) werkt geweldig om aanwezigheid weer te geven tussen gebruikers van de Zoom Workplace app, maar die ouderwetse bureautelefoons functioneren in hun eigen wereld en kunnen hun status niet delen met het systeem van Zoom. Het staat op de roadmap om dit te verbeteren, maar voorlopig zie je alleen aanwezigheid van mensen die de Zoom Workplace app echt gebruiken.
#### Momenteel zijn er geen AI-functies Beschikbaar met de Mitel PSI Integratie(s)
Uw oproepen verlopen via het systeem van Mitel, niet via de Cloud van Zoom waar de AI zich bevindt, dus Zoom AI heeft geen toegang tot uw gesprekken. Dat betekent geen automatische voicemailtranscriptie, oproepsamenvattingen of andere AI-functies die u met niet-geïntegreerde Zoom Phone zou krijgen. De oproepen omzeilen de AI-verwerking van Zoom volledig. Toekomstige updates kunnen dit veranderen, maar voorlopig moet u de AI-hulpmiddelen gebruiken die uw Mitel-systeem biedt.
#### Als iets na de installatie niet werkt, controleer dan uw Instellingen voor Telefoon-Integratie(s) in Zoom
Wanneer oproepen niet werken, controleer dan de Synchroniseren-status op het Tabblad Geïntegreerde gebruikers in de Instellingen voor Telefoonsysteem-Integratie(s) in het beheerportal. Synchroniseren-mislukkingen betekenen meestal dat CloudLink de referenties niet correct doorgeeft — dan moet u uw CloudLink-logboeken controleren om te zien wat er mis is.
#### U bent verantwoordelijk voor de certificaten van uw Apparaat
Omdat u Verbinden met uw eigen Mitel-systeem (niet met de servers van Zoom), moet u de beveiligingscertificaten van uw bedrijf installeren op elk Apparaat dat deze Integratie(s) zal gebruiken. Zie certificaten als digitale sleutels — Zoom beheert zijn eigen sleutels voor niet-geïntegreerde Zoom Phone, maar met deze Integratie(s) gebruikt u uw eigen "sleutels" om Verbinden met uw eigen systeem. Uw IT-team moet ervoor zorgen dat elke laptop, telefoon en Tablet de juiste certificaten heeft geïnstalleerd, anders kunnen ze geen beveiligde verbindingen met uw Mitel-systeem maken.
#### Verbinden is eenvoudig, zowel op locatie als op het bedrijfsnetwerk
Het systeem past de manier waarop het Verbinden aan op basis van waar u zich bevindt. Als u aan het thuiswerken bent of in een koffiebar bent, maken uw mobiele en desktop-apps via CloudLink en de sessiegrens-Controller van Mitel verbinding voor beveiliging. Maar als u op kantoor bent en verbonden met uw bedrijfsnetwerk, kan uw desktop rechtstreeks Verbinden met de Mitel PBX voor sneller en efficiënter bellen. Mobiele Apparaten gebruiken altijd de beveiligde externe route voor consistentie en beveiliging, ongeacht de Locatie.
#### Alleen Accounteigenaren of beheerders kunnen de Mitel PSI-app aan Zoom Toevoegen
Hoewel de Mitel PSI-app na de installatie geen bevoegdheden van een Eigenaar of beheerder gebruikt, zijn deze wel vereist voor de eerste installatie. **Let op:** Als de Eigenaar of beheerder die de app oorspronkelijk heeft toegevoegd het account verlaat, stopt de Integratie(s) met werken. Om de functionaliteit te herstellen, moet een andere beheerder of de nieuwe Eigenaar de app opnieuw autoriseren.
---
# 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/nl/zoom-workplace/zoom-phone/third-party-integrations/zoom-and-mitel-phone-system-integration-field-guide.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.