> 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/fr/services-avances-pour-lentreprise/zoom-node/zoom-phone-local-survivability.md).

# Survivabilité locale de Zoom Phone

### Vue d’ensemble

#### <mark style="color:bleu;">ZPLS est un appareil virtuel sur site qui prend en charge les appels téléphoniques internes entre les utilisateurs d'un site commun lorsque les centres de données Zoom sont inaccessibles</mark>

Le module ZPLS est un appareil sur site qui permet aux utilisateurs du même **site** de s'appeler mutuellement lorsque les centres de données Zoom sont inaccessibles. Cela crée une solution de résilience pour assurer la continuité des Affaires en cas d'un événement tel qu'une panne réseau.

{% hint style="danger" %}
Dans ce guide, un **site** est un terme spécifique utilisé dans Zoom Phone qui regroupe les utilisateurs sous une identité commune, comme l'Emplacement d'un bureau. Pour certains Clients, plusieurs bâtiments sont représentés par un seul site ; pour d'autres, chaque bâtiment d'un campus peut constituer son propre site. Les Clients doivent être conscients de leurs configurations de site existantes ou potentielles lorsqu'ils envisagent le module ZPLS en raison des considérations de conception mentionnées dans cet article.
{% endhint %}

**ZPLS prend également en charge les appels inter-sites lorsque les appareils ZPLS et leurs sites associés sont connectés via un réseau commun**

À lui seul, un appareil ZPLS (également appelé module, c.-à-d. un *module Zoom Node*) offre une résilience aux utilisateurs au sein d'un même Zoom Phone **site**. Cependant, plusieurs modules ZPLS connectés via un réseau local, de campus ou étendu peuvent prendre en charge une communication inter-sites, avec une connexion des utilisateurs de différents sites pendant un événement de survie, tant que le réseau interne reste opérationnel.

#### <mark style="color:bleu;">Les Clients peuvent intégrer ZPLS avec un SBC pour passer et recevoir des appels RTC lorsque les centres de données Zoom sont inaccessibles</mark>

Les Clients peuvent intégrer le module ZPLS avec un Contrôleur de bordure de session (SBC) pour les appels externes vers le réseau téléphonique commuté (RTC) lorsque les data centers Zoom sont injoignables. Cela permet aux utilisateurs disposant de numéros RTC fournis par Zoom ou par des opérateurs BYOC tiers de recevoir des appels entrants de parties externes lorsque le transfert d'appel pour la survivabilité est activé dans le cloud, et de passer des appels téléphoniques externes quelles que soient les conditions du réseau local ou la disponibilité du data center Zoom ; toutefois, les appels internes peuvent être limités par la conception du site.

#### <mark style="color:bleu;">Le module ZPLS est le point d’inscription de troisième priorité pour les appareils pris en charge, en privilégiant les zones SIP principale et secondaire de Zoom Phone dans le cloud lorsqu’elles sont Disponible</mark>

Au cours d’un processus de démarrage de routine, un client Zoom Phone télécharge les enregistrements DNS SRV des zones SIP principale et secondaire (points d’inscription) situées dans les centres de données Zoom. Cependant, pour les sites dotés d’une fonctionnalité de survie avec un module ZPLS, les appareils client pris en charge sont également configurés avec un *troisième* SRV enregistrer, pointant vers l'adresse IP du module du site.

#### <mark style="color:bleu;">Le module ZPLS surveille la disponibilité de cloud Zoom via des pings OPTIONS de routine vers des zones SIP spécifiques au site</mark>

Au cours des opérations normales, le module ZPLS est généralement inactif au sein du réseau local et ne participe pas au traitement des appels. À la place, le module ZPLS envoie des pings OPTIONS de routine vers des zones SIP spécifiques au site afin de surveiller la connectivité Actif entre les sites.

#### <mark style="color:bleu;">Le mode de survie ne s’active que lorsque le module ZPLS et les appareils clients ne peuvent pas se connecter aux zones SIP spécifiques au site</mark>

Un module ZPLS n’entre en mode de survivabilité que lorsque les pings OPTIONS habituels entre le module ZPLS et les zones SIP primaire et secondaire échouent. Les Appareils clients qui perdent la connexion avec les zones SIP en même temps que le module ZPLS s’enregistreront auprès du module, à condition qu’il existe une connectivité IP entre les appareils. Si le module ZPLS maintient la connectivité au cloud Zoom Phone, il n’acceptera pas les enregistrements SIP.

#### <mark style="color:bleu;">Le temps approximatif de basculement vers un module ZPLS est d’environ trois minutes, mais peut varier selon le nombre d’Appareils</mark>

Dans l’événement où les zones SIP propres au site sont injoignables, le temps approximatif de basculement de l’Appareil vers un module ZPLS est inférieur à trois minutes. Cependant, ce délai peut varier en fonction du nombre d’Appareils simultanés tentant de s’enregistrer auprès de chaque module ZPLS.

#### <mark style="color:bleu;">Les clients de bureau avertissent les utilisateurs lorsqu’ils entrent en mode de survivabilité et lorsqu’ils en sortent</mark>

Lorsque les clients de bureau Zoom basculent en mode de survivabilité, les utilisateurs reçoivent une alerte les informant qu’ils n’ont pas de connexion Internet, mais le service téléphonique est toujours Disponible.

<div data-with-frame="true"><img src="https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/iBKBV5KVuU1xKsH2Br2r/Unknown%20image" alt=""></div>

Une fois les services rétablis, les utilisateurs reçoivent une alerte de rétablissement de la connexion.

<div data-with-frame="true"><img src="https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/j5OMSJ3osllv4Daik6bQ/Unknown%20image" alt=""></div>

{% hint style="info" %}
Cette alerte est propre aux clients de bureau Zoom ; les téléphones IP n’afficheront pas d’alerte de basculement ou de repli.
{% endhint %}

#### <mark style="color:bleu;">Les appels, lorsqu’ils sont Actif, seront coupés lorsque le mode de survivabilité est activé et les utilisateurs devront rétablir manuellement l’appel</mark>

Les utilisateurs impliqués dans un appel Actif lorsqu’ils sont déconnectés des zones SIP de leur site entendront un signal Occupé rapide avant que leur appel ne soit déconnecté. Après la déconnexion et le basculement en mode de survivabilité, les utilisateurs devront rétablir manuellement leur appel.

#### <mark style="color:bleu;">Le renvoi d’appel peut acheminer les appels entrants vers un numéro BYOC lorsque le mode de survivabilité est Actif</mark>

Lors d’un événement de survivabilité, les appareils dont les numéros de téléphone sont enregistrés dans le cloud Zoom Phone ne sont pas joignables en raison de la perte de connectivité Internet. Cependant, les clients ZPLS disposant d’un SBC et d’un opérateur indépendant peuvent définir des règles de renvoi d’appel dans le portail web pour la numérotation directe entrante. Lorsqu’elles sont activées, les règles de renvoi d’appel redirigent les appels entrants vers un numéro enregistré dans Zoom Phone, vers un *distinct* numéro lié à un trunk RTC sur site d’un client. Cela permet aux clients la flexibilité d’acheter des numéros directement auprès de Zoom tout en pouvant toujours répondre aux appels directement sur un site ayant perdu la connectivité au cloud.

Par exemple, si un utilisateur a le numéro de téléphone X55-555-5555 enregistré dans Zoom Phone et que son site passe en mode de survivabilité, son numéro de téléphone est indisponible du point de vue du cloud Zoom. Si le renvoi d’appel est activé et que son numéro est appelé, Zoom Phone peut transférer l’appel vers son numéro de téléphone de renvoi désigné (p. ex. X11-111-1111) via le RTC vers le SBC du client. Par conséquent, les appelants externes peuvent joindre les utilisateurs d’un site affecté en cours d’un événement de survivabilité.

#### <mark style="color:bleu;">ZPLS prend en charge les groupes de distribution de survivabilité, offrant des capacités nuancées de routage des appels lors d’un événement de survivabilité</mark>

Les modules ZPLS prennent en charge les groupes de distribution de survivabilité (SDG) pour des configurations nuancées de routage des appels lors d’un événement de survivabilité. Avec les SDG, une entreprise peut acheminer les appels RTC internes et entrants vers un utilisateur individuel, un groupe d’utilisateurs (similaire à une file d’attente des appels ou à un groupe partagé), un menu SVI, un autre numéro de téléphone ou, si nécessaire, un autre SDG.

Bien que les SDG n’offrent pas les mêmes fonctionnalités complètes que les files d’attente des appels, les groupes de ligne partagée ou les réceptionnistes automatiques en mode de fonctionnement standard, les SDG peuvent continuer à prendre en charge les besoins critiques de routage des appels d’une entreprise jusqu’à ce que les opérations normales soient rétablies.

Un SDG peut être ajouté à l’aide du **Ajouter un groupe de routage** configuration dans le portail administrateur.

<div data-with-frame="true"><figure><img src="https://4108585137-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-b686a448099c61746dcb50fee9f35eb9d2f42178%2Fimage.png?alt=media" alt="" width="508"><figcaption></figcaption></figure></div>

#### <mark style="color:bleu;">Les appels internes entre utilisateurs en mode de survivabilité restent protégés par SRTP</mark>

Pendant le mode de survivabilité, les appels téléphoniques internes entre utilisateurs sont protégés par le protocole de transport sécurisé en temps réel (SRTP) à l'aide d'un chiffrement AES-128 ou 256, selon [capacités de l'Appareil](https://support.zoom.us/hc/en-us/articles/360001299063-Zoom-Voice-Supported-Devices).

#### <mark style="color:bleu;">Les services cloud/le routage seront restaurés après que le module ZPLS a maintenu une connectivité SIP de zone fiable pendant environ cinq minutes</mark>

Une fois que les appareils clients et le module ZPLS ont rétabli une connexion avec les zones SIP spécifiques au site, le délai approximatif de reprise vers les opérations normales est de cinq minutes. Cela inclut une période visant à s'assurer que les connexions réseau sont stables en cas d'événement de récupération intermittente ou partielle du réseau (flapping). Si la connectivité réseau est intermittente, les appareils clients et le module ZPLS resteront en mode de survivabilité jusqu'à ce que les connexions soient jugées stables.

#### <mark style="color:bleu;">Le module ZPLS téléversera les enregistrements de détails d'appel pour tous les appels passés après la sortie du mode de survivabilité</mark>

Après que le module ZPLS a quitté avec succès le mode de survivabilité et que la connectivité SIP de zone est stable, le module téléversera les enregistrements de détails d'appel (CDR) pour tous les appels passés en mode de survivabilité. Ces enregistrements sont marqués dans les rapports comme des appels qui ont été effectués pendant le mode de survivabilité.

#### <mark style="color:bleu;">Les modifications du site, y compris l'ajout ou la modification d'utilisateurs ou d'Appareils, sont synchronisées avec le module ZPLS toutes les 10 heures</mark>

Les mises à jour d'une configuration de site via le portail Web Zoom, y compris l'ajout ou la modification d'utilisateurs ou d'Appareils, sont synchronisées avec le module ZPLS toutes les 10 heures. Si un événement d'indisponibilité se produit avant que de nouvelles modifications de configuration soient synchronisées avec le module ZPLS, le module utilisera la dernière configuration connue.

#### <mark style="color:bleu;">Les Clients peuvent tester ou simuler des événements de basculement avec le mode de test</mark>

Les Clients peuvent simuler des événements de basculement pour un site en activant le mode de test depuis le portail web. Une fois le mode de test activé pour un site spécifique, le module ZPLS doit être redémarré pour accepter les enregistrements des clients. Ensuite, les utilisateurs qui se déconnectent puis se reconnectent à leur client de bureau s'enregistreront automatiquement auprès du module ZPLS tant que le mode de test est activé.

Tant que le mode de test est actif, le module ZPLS fonctionnera comme si un événement de basculement se produisait. Les utilisateurs internes peuvent passer des appels à d'autres utilisateurs au sein de leur site. De plus, les appels sortants et entrants seront acheminés via le SBC connecté s'il est configuré, et les appels entrants suivront les règles de renvoi d'appel s'il est configuré et activé.

Après la désactivation du mode de test, le module ZPLS doit être redémarré pour reprendre les opérations réseau normales.

{% hint style="info" %}
Le mode de test ne s'applique pas aux appareils téléphoniques IP. Le mode de test ne peut être testé qu'avec les applications de bureau Zoom.
{% endhint %}

### Fonctionnalités et Clients pris en charge

#### <mark style="color:bleu;">Fonctionnalités Disponible en mode de survivabilité</mark>

La liste suivante contient les fonctionnalités prises en charge par le module ZPLS lorsque le mode de survivabilité est activé :

**Fonctionnalités d'appel**

* Composition des postes internes
* Composition complète des postes avec code de site
* Composer depuis l'historique d'appels
* DTMF (RFC 2833)
* Conférence ad hoc à 3 participants
* Renvoi d'appel\*
* RTC entrant/sortant\*
* Recherche/composition de contact (premiers 25 000 contacts)
* Composer par nom
* Couper le micro/rétablir le micro
* Mettre l'appel en attente/Reprendre l'appel
* Parcage d'appel

**Transfert et routage**

* Transfert consultatif
* transfert à froid
* Numéro d'identification de localisation d'urgence
* Appels inter-modules ZPLS

**Distribution de survivabilité**

* Acheminer vers l'utilisateur
* Acheminer vers les membres du groupe
* Acheminer vers le numéro de téléphone\*
* Acheminer vers SVI
* heures d'ouverture
* Sonnerie Séquentielle
* Sonnerie Simultanée
* Invites audio

<sub>*\*Nécessite les Intégrations SBC et BYOC*</sub>

#### <mark style="color:bleu;">Fonctionnalités indisponibles en mode de survivabilité</mark>

La liste suivante contient les fonctionnalités qui ne sont pas prises en charge lorsque le mode de survivabilité est activé :

* Ajouter/Supprimer un contact
* messagerie vocale
* Passer à une conférence multipartite (4 utilisateurs et plus)
* Passer à une réunion
* Prise d'appel
* Basculer vers l'opérateur
* Appels e911 nomades
* Numérotation rapide
* Surveillance (Intervenir/Surveiller/Chuchoter)
* Délégation d'appel
* Interphone
* Appels chiffrés de bout en bout (E2EE)
* réceptionniste automatique
* file d'attente des appels

#### <mark style="color:bleu;">Appareils clients pris en charge</mark>

Consultez notre Centre d'assistance pour une liste de [appareils clients pris en charge](https://support.zoom.us/hc/en-us/articles/360029698771-Supported-desk-phone-features#h_01GGF32MEZ6DDT3VBE8Y2D6JH3) et [versions de microprogramme prises en charge](https://support.zoom.us/hc/en-us/articles/360001299063-Zoom-Phone-Certified-Hardware).

### Ports réseau et flux de données

#### <mark style="color:bleu;">Diagramme d'ensemble</mark>

Le diagramme suivant démontre les ports réseau et les flux de données utilisés avec un module ZPLS et une configuration SBC.

<div data-with-frame="true"><img src="https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/jwJPyOKbR2KlSvR4WyaJ/Unknown%20image" alt=""></div>

#### <mark style="color:bleu;">Exigences du pare-feu de survivabilité ZPLS</mark>

Le tableau suivant répertorie les ports réseau utilisés par Zoom Phone pendant les opérations normales lorsqu'il n'y a aucune interruption de la connectivité au cloud. Consultez notre Centre d'assistance pour une [liste complète des IP](https://support.zoom.us/hc/en-us/articles/201362683-Zoom-network-firewall-or-proxy-server-settings#h_01EEBSGCKBYVB20MCVPR78T0NN) utilisé pour le cloud Zoom Phone.

| Transport | IP source         | IP de destination | porter de destination | Objectif                                             |
| --------- | ----------------- | ----------------- | --------------------- | ---------------------------------------------------- |
| TCP       | Client Zoom Phone | Zoom Phone cloud  | 5091                  | Trafic de signalisation SIP                          |
| TCP       | Client Zoom Phone | Zoom Phone cloud  | 443                   | Trafic Web - Paramètres client                       |
| TCP       | Client Zoom Phone | Zoom Phone cloud  | 390                   | Recherche d'annuaire depuis les téléphones de bureau |
| UDP       | Client Zoom Phone | Zoom Phone cloud  | 20000-64000           | Trafic média SRTP                                    |
| TCP       | ZPLS              | Zoom Phone cloud  | 5091                  | Ping des options SIP (Keepalive)                     |
| TCP       | ZPLS              | Zoom Phone cloud  | 443                   | Trafic de gestion du nœud / SYSTÈME D'EXPLOITATION   |
| TCP       | ZPLS              | Zoom Phone cloud  | 9669                  | Historique de l'appel / Synchroniser la récupération |
| TCP       | SBC               | Zoom Phone cloud  | 5061                  | Trafic de signalisation SIP (BYOC)                   |
| UDP       | SBC               | Zoom Phone cloud  | 10000-64000           | Trafic média SRTP (BYOC)                             |

Le tableau suivant décrit les ports TCP et UDP utilisés par Zoom Phone lorsque le basculement vers ZPLS est actif en raison d'une perturbation de la connectivité avec le cloud.

| Transport | IP source         | IP de destination | porter de destination | Objectif                                             |
| --------- | ----------------- | ----------------- | --------------------- | ---------------------------------------------------- |
| TCP       | Client Zoom Phone | ZPLS              | 5091                  | Trafic de signalisation SIP                          |
| UDP       | Client Zoom Phone | ZPLS              | 20000-64000           | Trafic média SRTP                                    |
| TCP       | ZPLS              | SBC               | 5061                  | Recherche d'annuaire depuis les téléphones de bureau |
| UDP       | ZPLS              | SBC               | 20000-64000           | Trafic média SRTP                                    |

#### <mark style="color:bleu;">Exigences du pare-feu de peering sur site BYOC</mark>

Les Clients qui intègrent le module ZPLS à un SBC pour la numérotation externe lors d'un événement de survivabilité doivent activer les ports requis pour le peering sur site. Après avoir configuré un groupe de routage, les adresses IP nécessaires pour le groupe de routage sont disponibles sur le Web. Pour accéder aux adresses IP, effectuez les étapes suivantes :

1. Connectez-vous au portail Web Zoom.
2. Dans le [**Centre admin**](https://zoom.com/account) menu de navigation, cliquez sur **configuration du produit**, puis **système de téléphonie**, puis [**Infos de la société**](https://zoom.com/pbx/page/telephone/settings#/settings).
3. Cliquez sur **Paramètres du compte**
4. Repérez l’option pour **Groupes de routage**. Cliquez sur **Gérer** pour charger une nouvelle page.

   <div data-with-frame="true"><figure><img src="https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/Vo7n7pkdGHHqoBDVLd4l/Unknown%20image" alt="" width="563"><figcaption></figcaption></figure></div>
5. Sur la page suivante, repérez le groupe de routage souhaité et survolez l’ **« i »** icône.

   <div data-with-frame="true"><figure><img src="https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/pCUJ8WVkYAnR5nDgfvLU/Unknown%20image" alt="" width="563"><figcaption></figcaption></figure></div>
6. Activez l'adresse IP et les ports spécifiés dans la fenêtre, selon les besoins de votre réseau.

   <div data-with-frame="true"><figure><img src="https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/BnIojqs0sYIsQSisquSv/Unknown%20image" alt="" width="563"><figcaption></figcaption></figure></div>

#### <mark style="color:bleu;">Survivabilité locale de Zoom Phone : maintenir la téléphonie pendant un événement ayant un impact sur le service</mark> <a href="#mw9st83qsojm" id="mw9st83qsojm"></a>

Zoom Phone Local Survivability (ZPLS) est un module de service basé sur la survivabilité qui fournit aux utilisateurs de Zoom Phone des fonctionnalités de basculement, de connexion et de survivabilité en cas d’interruption d’Internet ou du service.

Lors d’un événement de survivabilité, lorsque les terminaux Zoom ne peuvent pas atteindre le cloud Zoom Phone, les appareils utilisateur pris en charge s’inscrivent automatiquement auprès du module ZPLS comme leur enregistreur de troisième priorité — après les zones SIP principale et secondaire. Cette inscription permet des services de téléphonie de base, tels que les appels internes et les groupes de distribution de survivabilité, jusqu’à ce que le service complet soit rétabli.

Lorsqu’ils sont correctement configurés, les modules ZPLS sur différents sites peuvent prendre en charge les appels intersites pendant un événement de survivabilité, tant que les appareils sont détectables sur le réseau local et que le renvoi d’appel est activé.

Les organisations peuvent aller plus loin en assurant la connexion du module ZPLS à un Contrôleur de frontière de session (SBC) et acheminer les appels via le réseau téléphonique commuté (RTC) au moyen de Apportez votre propre opérateur (BYOC). Cette approche hybride combine la simplicité de la téléphonie gérée dans le cloud avec la résilience de l’infrastructure sur site, contribuant ainsi à assurer la continuité des activités même lorsque l’inattendu se produit.

Cependant, la survivabilité peut encore être affectée si le réseau local lui-même tombe en panne — en particulier dans les déploiements sur un seul site où les bâtiments dépendent d’un réseau de campus partagé.

Les images suivantes montrent des exemples de configurations de déploiement pour Zoom Phone Local Survivability sur une gamme de topologies de site et de réseau.

<figure><img src="https://4108585137-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-a4418b60e5b95fcb471d37d919770bcd88752dc8%2F0C46BEA3-2078-4647-80C2-379DFA9F509D.png?alt=media" alt="Diagram depicting the ZPLS module in a single-site design"><figcaption><p>Diagramme représentant le module ZPLS dans une conception sur un seul site</p></figcaption></figure>

<figure><img src="https://4108585137-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-920b6247b4f4a073404f570cd45280fe91b69f4e%2Fimage.png?alt=media" alt="Diagram depicting the ZPLS module in a multi-site design with a common network"><figcaption><p>Diagramme représentant le module ZPLS dans une conception multi-site avec un réseau commun</p></figcaption></figure>

<figure><img src="https://4108585137-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-2261162c080cb67f7409196a1b7f983a13b0cd9b%2FE96C5F1B-E5E9-4F8E-9DF5-55B6DBFC20B7.png?alt=media" alt="Diagram depicting the ZPLS module in a multi-site design with PSTN Connectivity"><figcaption><p>Diagramme représentant le module ZPLS dans une conception multi-site avec connectivité RTC</p></figcaption></figure>

Veuillez vous adresser à votre équipe de compte Zoom ou au Centre d'assistance de Zoom pour plus d'informations sur [Survivabilité locale de Zoom Phone](https://support.zoom.com/hc/en/category?id=kb_category\&kb_category=fce9b6da8720391089a37408dabb35d9).


---

# 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/fr/services-avances-pour-lentreprise/zoom-node/zoom-phone-local-survivability.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.