> 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/es/servicios-empresarial-avanzados/zoom-node/zoom-phone-local-survivability.md).

# Supervivencia local de Zoom Phone

### Resumen

#### <mark style="color:azul;">ZPLS es un dispositivo virtual local que admite llamadas telefónicas internas entre usuarios en un sitio común cuando los centros de datos de Zoom no están accesibles</mark>

El módulo ZPLS es un dispositivo local que permite a los usuarios dentro del mismo **sitio** llamarse por teléfono entre sí cuando los centros de datos de Zoom no están accesibles. Esto crea una solución de resiliencia para la continuidad Comercial ante una interrupción de la red.

{% hint style="danger" %}
Dentro de esta guía, un **sitio** sitio es un término específico utilizado en Zoom Phone que agrupa a los usuarios bajo una identidad común, como una Ubicación de oficina. Para algunos Clientes, varios edificios están representados por un solo sitio; para otros, cada edificio de un campus puede constituir su propio sitio. Los Clientes deben tener en cuenta sus configuraciones de sitio existentes o potenciales al considerar el módulo ZPLS debido a las consideraciones de diseño mencionadas en este artículo.
{% endhint %}

**ZPLS también admite llamadas entre sitios cuando los dispositivos ZPLS y sus sitios asociados están conectados a través de una red común**

Por sí solo, un dispositivo ZPLS (también denominado un módulo, es decir, un *módulo Zoom Node*) proporciona resiliencia a los usuarios dentro de un Zoom Phone común **sitio**. Sin embargo, múltiples módulos ZPLS conectados a través de una red de área local, de campus o de área amplia pueden admitir la comunicación entre sitios, conectando a usuarios de distintos sitios durante un evento de supervivencia siempre que la red interna siga operativa.

#### <mark style="color:azul;">Clientes pueden integrar ZPLS con un SBC para realizar y recibir llamadas RTPC cuando los centros de datos de Zoom no están accesibles</mark>

Clientes pueden integrar el módulo ZPLS con un controlador de borde de sesión (SBC) para llamadas externas a la Red telefónica pública conmutada (RTPC) cuando los centros de datos de Zoom no están accesibles. Esto permite a los usuarios con números RTPC proporcionados por Zoom o por operadores BYOC de terceros recibir llamadas entrantes de terceros cuando el desvío de llamadas para la supervivencia está habilitado en la nube, y realizar llamadas telefónicas externas independientemente de las condiciones de la red local o de la disponibilidad de los centros de datos de Zoom; sin embargo, las llamadas internas pueden verse limitadas por el diseño del sitio.

#### <mark style="color:azul;">El módulo ZPLS es el punto de registro de tercera prioridad para los dispositivos compatibles, y prefiere las zonas SIP primaria y secundaria de Zoom dentro de la nube cuando están en estado Disponible</mark>

Durante un proceso rutinario de arranque, un cliente Zoom Phone descarga los registros SRV DNS de las zonas SIP primaria y secundaria (puntos de registro) ubicadas dentro de los centros de datos de Zoom. Sin embargo, para los sitios con habilitación de supervivencia con un módulo ZPLS, los dispositivos cliente compatibles también se configuran con un *tercer* registro SRV, que apunta a la Dirección IP del módulo del sitio.

#### <mark style="color:azul;">El módulo ZPLS supervisa la disponibilidad de la nube de Zoom mediante pings OPTIONS rutinarios a las zonas SIP específicas del sitio</mark>

Durante el funcionamiento normal, el módulo ZPLS generalmente permanece inactivo dentro de la red local y no interviene en la administración de llamadas. En su lugar, el módulo ZPLS envía pings OPTIONS rutinarios a las zonas SIP específicas del sitio para supervisar la conectividad activa entre ubicaciones.

#### <mark style="color:azul;">El modo de supervivencia solo se activa cuando tanto el módulo ZPLS como los dispositivos cliente no pueden conectarse a las zonas SIP específicas del sitio</mark>

Un módulo ZPLS solo entra en modo de supervivencia cuando fallan los pings OPTIONS rutinarios entre el módulo ZPLS y las zonas SIP primaria y secundaria. Los dispositivos cliente que pierden la conexión con las zonas SIP al mismo tiempo que el módulo ZPLS se registrarán en el módulo, siempre que exista conectividad IP entre los dispositivos. Si el módulo ZPLS mantiene la conectividad con la nube de Zoom Phone, no aceptará registros SIP.

#### <mark style="color:azul;">El tiempo aproximado para la conmutación por error a un módulo ZPLS es de aproximadamente tres minutos, pero puede variar según el número de dispositivos</mark>

En el Evento de que las zonas SIP específicas del sitio no sean accesibles, el tiempo aproximado de conmutación por error del Dispositivo a un módulo ZPLS es de tres minutos. Sin embargo, este tiempo puede variar según el número de Dispositivos concurrentes que intenten registrarse en cada módulo ZPLS.

#### <mark style="color:azul;">Los clientes de escritorio notifican a los usuarios al entrar y salir del modo de supervivencia</mark>

Cuando los clientes de escritorio de Zoom cambian al modo de supervivencia, los usuarios reciben una alerta que les informa que no tienen conexión a Internet, pero el servicio telefónico sigue estando Disponible.

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

Una vez que se restablecen los servicios, los usuarios reciben una alerta de restauración de la conexión.

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

{% hint style="info" %}
Esta alerta es exclusiva de los clientes de escritorio de Zoom; los teléfonos IP no mostrarán una alerta de conmutación por error o de respaldo.
{% endhint %}

#### <mark style="color:azul;">La llamada en estado activo se interrumpirá cuando se active el modo de supervivencia y los usuarios deberán volver a establecer manualmente la llamada</mark>

Los usuarios involucrados en una llamada activo cuando se desconectan de las zonas SIP de su sitio escucharán una señal de Ocupado rápida antes de que su llamada se desconecte. Después de la desconexión y la conmutación por error al modo de supervivencia, los usuarios deben restablecer manualmente su llamada.

#### <mark style="color:azul;">El desvío de llamada puede enrutar llamadas Entrantes a un número BYOC cuando el modo de supervivencia está activo</mark>

Durante un Evento de supervivencia, los dispositivos con Números de teléfono registrados en la nube de Zoom Phone no son alcanzables debido a la pérdida de conectividad a Internet. Sin embargo, los clientes de ZPLS con un SBC y un operador independiente pueden establecer reglas de reenvío de llamadas en el portal web para la marcación directa entrante. Cuando se habilitan, las reglas de reenvío de llamadas redirigen las llamadas Entrantes a un número registrado en Zoom Phone, a un *separado* número vinculado al troncal RTPC local de un cliente. Esto permite a los clientes la flexibilidad de comprar números directamente de Zoom, al tiempo que siguen pudiendo contestar llamadas directamente en un sitio que ha perdido conectividad con la nube.

Por ejemplo, si un usuario tiene el número de teléfono X55-555-5555 registrado en Zoom Phone y el sitio del usuario entra en modo de supervivencia, el número de teléfono del usuario no está disponible desde la perspectiva de la nube de Zoom. Si el reenvío de llamadas está habilitado y se llama a su número, Zoom Phone puede reenviar la llamada a su número de teléfono de reenvío designado (p. ej., X11-111-1111) a través de la RTPC al SBC del cliente. En consecuencia, los llamantes externos pueden comunicarse con los usuarios dentro de un sitio afectado que esté atravesando un Evento de supervivencia.

#### <mark style="color:azul;">ZPLS admite Grupos de distribución de supervivencia, proporcionando capacidades matizadas de enrutamiento de llamadas durante un Evento de supervivencia</mark>

Los módulos de ZPLS admiten Grupos de distribución de supervivencia (SDG) para configuraciones matizadas de Enrutamiento de llamadas durante un Evento de supervivencia. Con los SDG, una empresa puede enrutar llamadas internas y llamadas Entrantes de RTPC a un usuario individual, a un grupo de usuarios (similar a una cola de llamadas o un grupo compartido), a un menú IVR, a otro número de teléfono o, si es necesario, a otro SDG.

Aunque los SDG no ofrecen la misma funcionalidad completa que las colas de llamadas, los grupos de línea compartida o los recepcionistas automáticos de operación estándar, los SDG pueden seguir respaldando las necesidades críticas de enrutamiento de llamadas de una empresa hasta que se restablezcan las operaciones normales.

Se puede añadir un SDG usando la **Añadir grupo de rutas** configuración dentro del portal del administrador.

<div data-with-frame="true"><figure><img src="https://1630984505-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:azul;">Las llamadas internas entre usuarios en modo de supervivencia siguen protegidas por SRTP</mark>

Durante el modo de supervivencia, las llamadas telefónicas internas entre usuarios están protegidas por el Protocolo de Transporte Seguro en Tiempo Real (SRTP) mediante cifrado AES-128 o AES-256, según las capacidades del Dispositivo [Las capacidades del Dispositivo](https://support.zoom.us/hc/en-us/articles/360001299063-Zoom-Voice-Supported-Devices).

#### <mark style="color:azul;">Los servicios de nube/Enrutamiento se restaurarán después de que el módulo ZPLS haya mantenido una conectividad SIP confiable durante aproximadamente cinco minutos</mark>

Una vez que los dispositivos cliente y el módulo ZPLS hayan restablecido una conexión con las zonas SIP específicas del sitio, el tiempo aproximado de recuperación para volver a las operaciones normales es de cinco minutos. Esto incluye un período de tiempo para asegurar que las conexiones de red sean estables en caso de una recuperación de red intermitente o parcial (flapping). Si la conectividad de red es intermitente, los dispositivos cliente y el módulo ZPLS permanecerán en modo de supervivencia hasta que se determine que las conexiones son estables.

#### <mark style="color:azul;">El módulo ZPLS cargará los registros de detalles de llamadas para todas las llamadas realizadas después de salir del modo de supervivencia</mark>

Después de que el módulo ZPLS haya salido correctamente del modo de supervivencia y la conectividad de la zona SIP sea estable, el módulo cargará los registros de detalles de llamadas (CDR) de todas las llamadas realizadas en modo de supervivencia. Estos registros se marcan en los informes como llamadas que se completaron mientras estaban en modo de supervivencia.

#### <mark style="color:azul;">Los cambios del sitio, incluida la adición o modificación de usuarios o dispositivos, se sincronizan con el módulo ZPLS una vez cada 10 horas</mark>

Las actualizaciones de una configuración del sitio a través del portal web de Zoom, incluida la adición o modificación de usuarios o dispositivos, se sincronizan con el módulo ZPLS una vez cada 10 horas. Si ocurre un Evento de inactividad antes de que las nuevas configuraciones se sincronicen con el módulo ZPLS, el módulo utilizará la última configuración conocida.

#### <mark style="color:azul;">Los Clientes pueden probar o simular eventos de conmutación por error con el Modo de pruebas</mark>

Los Clientes pueden simular eventos de failover para un sitio habilitando el Modo de prueba desde el portal web. Una vez que el modo de prueba está habilitado para un sitio específico, el módulo ZPLS debe reiniciarse para aceptar registros de clientes. Después, los usuarios que seleccionen Cerrar sesión y vuelvan a iniciar sesión en su cliente de escritorio se registrarán automáticamente en el módulo ZPLS mientras el modo de prueba esté habilitado.

Mientras el Modo de prueba está activo, el módulo ZPLS funcionará como si se estuviera produciendo un evento de failover. Los usuarios internos pueden realizar llamadas a otros usuarios dentro de su sitio. Además, las llamadas Salientes y Entrantes se enrutarán a través del SBC conectado si está configurado, y las llamadas entrantes seguirán las reglas de desvío de llamadas si está configurado y habilitado.

Después de deshabilitar el Modo de prueba, el módulo ZPLS debe reiniciarse para reanudar las operaciones normales de red.

{% hint style="info" %}
El Modo de prueba no se aplica a los dispositivos de teléfono IP. El Modo de prueba solo puede probarse con aplicaciones de escritorio de Zoom.
{% endhint %}

### Funciones compatibles y clientes admitidos

#### <mark style="color:azul;">Funciones Disponible en el modo de supervivencia</mark>

La siguiente lista contiene las funciones admitidas del módulo ZPLS cuando el modo de supervivencia está activo:

**Funciones de llamada**

* Marcación de extensiones internas
* Marcación completa de extensiones con código de sitio
* Marcar desde el historial de llamadas
* DTMF (RFC 2833)
* Conferencia ad hoc de 3 participantes
* Desvío de llamadas\*
* RTPC Entrantes/Salientes\*
* Búsqueda/marcación de contactos (primeros 25 000 contactos)
* Marcar por nombre
* Silenciar/Reactivar audio
* Retener/Reanudar llamada
* estacionamiento de llamadas

**Transferencia y Enrutamiento**

* Transferencia asistida
* transferencia directa
* Número de identificación de ubicación de emergencia
* Llamadas entre módulos ZPLS

**Distribución de supervivencia**

* Enrutar a usuario
* Enrutar a miembros del grupo
* Enrutar a número de teléfono\*
* Enrutar a IVR
* horario comercial
* Timbreo Secuencial
* Llamada Simultánea
* Indicaciones de audio

<sub>*\*Requiere Integraciones con SBC y BYOC*</sub>

#### <mark style="color:azul;">Funciones no disponibles en el modo de supervivencia</mark>

La siguiente lista contiene las funciones que no son compatibles cuando el modo de supervivencia está activo:

* Añadir/Eliminar contacto
* correo de voz
* Escalar a conferencia multiparte (4+ usuarios)
* Escalar a reunión
* Captura de llamada
* Cambiar a operador
* Llamadas e911 nómadas
* Marcación rápida
* Monitoreo (Intrusión/Monitoreo/Susurro)
* Delegación de llamadas
* Intercomunicación
* Llamadas cifradas de extremo a extremo (E2EE)
* Contestador automático
* cola de llamadas

#### <mark style="color:azul;">Dispositivos de cliente compatibles</mark>

Consulte nuestro Centro de soporte para obtener una lista de [dispositivos de cliente compatibles](https://support.zoom.us/hc/en-us/articles/360029698771-Supported-desk-phone-features#h_01GGF32MEZ6DDT3VBE8Y2D6JH3) y [versiones de firmware compatibles](https://support.zoom.us/hc/en-us/articles/360001299063-Zoom-Phone-Certified-Hardware).

### Puertos de red y flujo de datos

#### <mark style="color:azul;">Diagrama general</mark>

El siguiente diagrama muestra los puertos de red y los flujos de datos utilizados con un módulo ZPLS y una configuración de SBC.

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

#### <mark style="color:azul;">Requisitos del firewall de supervivencia de ZPLS</mark>

La siguiente tabla enumera los puertos de red utilizados por Zoom Phone durante las operaciones normales cuando no hay interrupción en la conectividad con la nube. Consulte nuestro Centro de soporte para una [lista completa de direcciones IP](https://support.zoom.us/hc/en-us/articles/201362683-Zoom-network-firewall-or-proxy-server-settings#h_01EEBSGCKBYVB20MCVPR78T0NN) utilizadas para la nube de Zoom Phone.

| Transporte | Dirección IP de origen | Dirección IP de destino | Puerto de destino | Propósito                                            |
| ---------- | ---------------------- | ----------------------- | ----------------- | ---------------------------------------------------- |
| TCP        | Cliente de Zoom Phone  | Nube de Zoom Phone      | 5091              | Tráfico de señalización SIP                          |
| TCP        | Cliente de Zoom Phone  | Nube de Zoom Phone      | 443               | Tráfico web - Configuración del cliente              |
| TCP        | Cliente de Zoom Phone  | Nube de Zoom Phone      | 390               | Búsqueda de directorio desde teléfonos de escritorio |
| UDP        | Cliente de Zoom Phone  | Nube de Zoom Phone      | 20000-64000       | Tráfico de medios SRTP                               |
| TCP        | ZPLS                   | Nube de Zoom Phone      | 5091              | Ping de opciones SIP (Keepalive)                     |
| TCP        | ZPLS                   | Nube de Zoom Phone      | 443               | Tráfico de administración de nodo / SO               |
| TCP        | ZPLS                   | Nube de Zoom Phone      | 9669              | Historial de llamadas / Sincronizar de recuperación  |
| TCP        | SBC                    | Nube de Zoom Phone      | 5061              | Tráfico de señalización SIP (BYOC)                   |
| UDP        | SBC                    | Nube de Zoom Phone      | 10000-64000       | Tráfico de medios SRTP (BYOC)                        |

La siguiente tabla describe los puertos TCP y UDP utilizados por Zoom Phone cuando el proceso de conmutación por error a ZPLS está activo debido a una interrupción en la conectividad con la nube.

| Transporte | Dirección IP de origen | Dirección IP de destino | Puerto de destino | Propósito                                            |
| ---------- | ---------------------- | ----------------------- | ----------------- | ---------------------------------------------------- |
| TCP        | Cliente de Zoom Phone  | ZPLS                    | 5091              | Tráfico de señalización SIP                          |
| UDP        | Cliente de Zoom Phone  | ZPLS                    | 20000-64000       | Tráfico de medios SRTP                               |
| TCP        | ZPLS                   | SBC                     | 5061              | Búsqueda de directorio desde teléfonos de escritorio |
| UDP        | ZPLS                   | SBC                     | 20000-64000       | Tráfico de medios SRTP                               |

#### <mark style="color:azul;">Requisitos del firewall de peering local BYOC</mark>

Los Clientes que integren el módulo ZPLS con un SBC para la marcación externa durante un Evento de supervivencia deben Habilitar los puertos requeridos para el peering local. Después de configurar un grupo de rutas, las direcciones IP necesarias para el grupo de rutas están disponibles en la web. Para acceder a las direcciones IP, realice los siguientes pasos:

1. Inicie sesión en el portal web de Zoom.
2. En la [**Centro del administrador**](https://zoom.com/account) menú de navegación, haga clic en **Configuración del producto**, luego **sistema de telefonía**, luego [**Información de la empresa**](https://zoom.com/pbx/page/telephone/settings#/settings).
3. Haga clic en **Configuración de la cuenta**
4. Localice la opción para **grupo de rutas**. Haga clic en **Administrar** para cargar una nueva página.

   <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. En la página siguiente, localice el grupo de rutas deseado y pase el cursor sobre el **"i"** icono.

   <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. Habilite la dirección IP y los puertos especificados en la ventana según sea necesario dentro de su red.

   <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:azul;">Zoom Phone Local Survivability: Mantenimiento de la telefonía durante un Evento que afecta al servicio</mark> <a href="#mw9st83qsojm" id="mw9st83qsojm"></a>

Zoom Phone Local Survivability (ZPLS) es un módulo de servicio basado en la capacidad de supervivencia que proporciona a los usuarios de Zoom Phone funcionalidad de conmutación por error, conectividad y capacidad de supervivencia en caso de un Evento de interrupción de Internet o del servicio.

Durante un Evento de supervivencia, cuando los puntos finales de Zoom no pueden llegar a la nube de Zoom Phone, los dispositivos de usuario compatibles se registran automáticamente con el módulo ZPLS como su registrador de tercera prioridad, después de las zonas SIP primaria y secundaria. Este registro habilita servicios básicos de telefonía, como llamadas internas y grupos de distribución de supervivencia, hasta que se restaure el servicio completo.

Cuando está configurado correctamente, los módulos ZPLS en diferentes sitios pueden admitir llamadas entre sitios durante un Evento de supervivencia, siempre que los dispositivos sean detectables en la red local y el desvío de llamadas esté habilitado.

Las organizaciones pueden ampliar aún más esta capacidad Conectando el módulo ZPLS a un Controlador de borde de sesión (SBC) y enrutar llamadas a través de la Red telefónica pública conmutada (RTPC) mediante Conserve su operador (BYOC). Este enfoque híbrido combina la simplicidad de la telefonía administrada en la nube con la resiliencia de la infraestructura local, ayudando a garantizar la continuidad del negocio incluso cuando ocurre lo inesperado.

Sin embargo, la capacidad de supervivencia aún puede verse afectada si falla la propia red local, especialmente en implementaciones de un solo sitio donde los edificios dependen de una red de campus compartida.

Las siguientes imágenes muestran configuraciones de implementación de ejemplo para Zoom Phone Local Survivability en una variedad de topologías de sitio y red.

<figure><img src="https://1630984505-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>Diagrama que muestra el módulo ZPLS en un diseño de un solo sitio</p></figcaption></figure>

<figure><img src="https://1630984505-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>Diagrama que muestra el módulo ZPLS en un diseño de varios sitios con una red común</p></figcaption></figure>

<figure><img src="https://1630984505-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>Diagrama que muestra el módulo ZPLS en un diseño de varios sitios con conectividad RTPC</p></figcaption></figure>

Consulte a su equipo de cuenta de Zoom o al Centro de soporte de Zoom para obtener más información sobre [Supervivencia local 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/es/servicios-empresarial-avanzados/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.
