> 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/zoom-workplace/zoom-phone/zoom-phone-spam-field-guide.md).

# Guía de campo de spam de Zoom Phone

### Introducción

Este documento está diseñado para brindar a los lectores una comprensión completa de cómo funciona la protección contra llamadas spam en Zoom Phone. Las llamadas spam pueden interrumpir las operaciones comerciales y reducir la productividad, pero Zoom Phone ofrece varias capas de protección para identificar, bloquear y remediar las llamadas spam en toda la Organización.

Entender la protección contra spam es esencial para mantener la calidad de la comunicación y garantizar que las llamadas legítimas lleguen a sus usuarios mientras las llamadas no deseadas se filtran. Esta guía cubre cómo funciona la detección de spam, las opciones de configuración para administradores, los controles a nivel de usuario, las capacidades de monitoreo y las soluciones para cuando sus llamadas Salientes son etiquetadas incorrectamente como spam por otros operadores.

### Cómo usar este documento

Este documento está organizado para proporcionar información en un flujo lógico que facilita la comprensión de la protección contra spam. A lo largo de este documento, hemos estructurado el contenido de varias maneras:

**Organización Basado en roles:** Secciones separadas para administradores que configuran la configuración de toda la cuenta y usuarios que gestionan sus propias preferencias de bloqueo de spam.

**Secciones basadas en tareas:** El contenido está organizado según lo que necesita lograr: Comprensión de la protección contra spam, Configuración de la protección, administración de la Configuración del usuario, monitoreo de la actividad y solución de problemas.

**Formato de declaración y respuesta:** Las preguntas e incidencias comunes se presentan como declaraciones que describen su situación, seguidas de respuestas y soluciones completas.

Por ejemplo, cuando vea "*Mis llamadas Salientes están siendo etiquetadas como spam por los destinatarios*", sabrá de inmediato que esta sección aborda su situación, y la respuesta proporciona los pasos exactos para resolver el problema. Hemos incluido opciones de Configuración detalladas, procedimientos paso a paso y orientación completa para la solución de problemas para brindarle la información más completa disponible.

Se proporcionan enlaces a artículos de Soporte relevantes a lo largo del documento para darle acceso a las instrucciones más actuales para cada proceso.

### Lo que necesita saber antes de habilitar la protección contra spam

#### <mark style="color:azul;">Requisitos previos</mark>

**Para administradores:**

* Privilegios de propietario de cuenta o administrador
* Cuenta Pro, Comercial o Empresarial
* Plan de llamadas de Zoom Phone
* Licencias de Zoom Phone

**Para usuarios:**

* Cuenta Comercial o Empresarial
* Licencia de Zoom Phone
* Aplicación de escritorio de Zoom Workplace para Windows, macOS o Linux (versión mínima global o superior)
* Aplicación móvil de Zoom Workplace para Android o iOS (versión mínima global o superior)
* Protección contra spam habilitada por el administrador

#### <mark style="color:azul;">Conceptos clave de la protección contra spam</mark>

**Marcar spam automáticamente**

Zoom Phone puede analizar automáticamente las llamadas Entrantes y etiquetar posibles llamadas spam según estándares globales de la industria. Esta función está habilitada de forma predeterminada para cuentas de tipo Empresarial y utiliza análisis de llamadas para identificar patrones de spam sin requerir intervención manual.

**Marcar spam manualmente**

Los administradores pueden definir umbrales en los que el sistema marca automáticamente los Números de teléfono como spam según cuántos usuarios los hayan reportado. Esto crea un sistema colaborativo de detección de spam en el que los reportes de los usuarios contribuyen a la protección de toda la Organización.

**Niveles de sensibilidad del spam**

Zoom ofrece tres niveles de sensibilidad para la detección automática de spam:\
**Sensibilidad baja**: Marca las llamadas como spam con certeza absoluta\
**Sensibilidad media**: Marca las llamadas como spam con certeza moderada\
**Sensibilidad alta**: Marca las llamadas como spam con gran certeza

**Spam frente a posible spam**

El sistema distingue entre spam definitivo (marcado como "**SPAM**") y spam potencial (marcado como "**Posible** **SPAM**") según los niveles de confianza y los reportes de los usuarios.

**Opciones de gestión**

Cuando una llamada o SMS se identifica como spam, los administradores pueden elegir cómo gestionarlo. Para llamadas y SMS, los administradores pueden bloquear el número por completo o marcarlo sin bloquearlo, lo que permite que la llamada o SMS pase y lo etiqueta como spam. A continuación se enumeran acciones específicas para llamadas y SMS:

* Llamadas:
  * Reenviar al correo de voz/videocorreo
* SMS:
  * Deshabilitar el envío o la recepción de archivos adjuntos
  * Deshabilitar hipervínculos
  * Filtrar enlaces de phishing

#### <mark style="color:azul;">Diferentes tipos de protección contra spam</mark>

**Protección contra spam Entrantes**

Protege a sus usuarios de recibir llamadas no deseadas mediante la identificación y el bloqueo de llamantes de spam. Esto incluye tanto la detección automática como el spam reportado por los usuarios.

**Remediación de spam Salientes**

Protege la reputación de su Organización mediante la supervisión de sus Números de teléfono para detectar etiquetas de spam aplicadas por otros operadores y trabajando automáticamente para eliminar esas etiquetas.

**Registro Empresarial de spam**

Permite a las organizaciones registrar su información comercial y sus Números de teléfono con los principales operadores de EE. UU. para mejorar la reputación del ID de llamada y reducir la probabilidad de que las llamadas legítimas se etiqueten como spam.

#### <mark style="color:azul;">Recursos adicionales y cómo configurar</mark>

* [Guía del administrador para Zoom Phone Spam](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0057965)
* [Guía del usuario para Zoom Phone Spam](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0057964)
* [Ver el Panel de control de spam de Zoom Phone](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0081913)
* [Llamadas Salientes bloqueadas o etiquetadas como spam](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0062095)
* [Habilitar la remediación de etiquetas de spam](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0080575)
* [Gestionar el registro de etiquetado de spam Empresarial](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0082998)

Para obtener soporte adicional o preguntas no cubiertas en esta guía, póngase en contacto con el soporte de Zoom Phone a través del portal web o [visite nuestra documentación de soporte](https://support.zoom.com/).

### Monitoreo de la actividad de spam

#### <mark style="color:azul;">Acceso al Panel de control de spam</mark>

1. Iniciar sesión en el [portal web de Zoom](https://zoom.us/signin#/login) como administrador.
2. En el menú de navegación, haga clic en **Panel de control**.
3. En la parte superior de la página, haga clic en el **Teléfono** pestaña.
   1. **Nota**: Si la pestaña Phone no está visible, haga clic en el **elipsis (...)**, luego haga clic en **Teléfono** para acceder a la pestaña.
4. Haga clic en el **Spam** pestaña.
   1. (Opcional) En la parte superior de la página, filtre el Panel de control.
5. Seleccione el rango de fechas que desea ver.
6. Haga clic en el menú desplegable y seleccione la **Sensibilidad de marcado automático de spam** nivel.

**Importante**: El filtro de sensibilidad en la página del panel de control no cambia la configuración de su cuenta. Solo filtra los datos mostrados en el panel de control.

#### <mark style="color:azul;">Comprender las métricas del Panel de control</mark>

**Clave** **Métricas** (mostradas en la parte superior de la página):

* **Spam**: Número de llamadas directas a usuarios marcadas como **Spam** por la función de marcado automático o manual, incluido el porcentaje de llamadas Entrantes (excluye **Spam marcado incorrectamente**)
* **Posible** **Spam**: Número de llamadas directas marcadas como **Posible spam**, incluido el porcentaje de llamadas Entrantes (excluye Spam marcado incorrectamente)
* **Entrantes** **RTPC** **Llamadas**: Total de llamadas directas RTPC a usuarios, con indicador de cambio del rango de fechas
* **Únicos** **Llamantes**: Recuento único de Números de teléfono Entrantes que realizan llamadas directas RTPC a usuarios, con indicador de cambio del rango de fechas

#### <mark style="color:azul;">Revisión del gráfico de llamadas Entrantes</mark>

La sección de llamadas Entrantes muestra un gráfico que muestra el volumen de llamadas directas RTPC categorizadas a lo largo del tiempo:

* **Spam**
* **Posible spam**
* **No es spam**
* **Spam marcado incorrectamente** (llamadas marcadas como spam por el marcado automático pero marcadas como No spam por los usuarios)

Pase el cursor sobre el gráfico para ver fechas y porcentajes específicos de cada categoría.

#### <mark style="color:azul;">Analizando los Números de teléfono de impacto más destacados 100</mark>

Esta sección muestra los 100 Números de teléfono principales en su Organización que han recibido la mayor cantidad de llamadas spam y posiblemente spam.

**Información** **mostrado**:

* Número de teléfono
* Total de llamadas recibidas
* Llamadas spam recibidas
* Llamadas posiblemente spam recibidas
* Usuario o extensión asignado al número

Utilice estos datos para identificar qué usuarios se ven más afectados por las llamadas de spam y pueden necesitar medidas de protección adicionales.

#### <mark style="color:azul;">Analizando los 100 principales emisores de llamadas de spam</mark>

Esta sección muestra los 100 principales emisores de llamadas que fueron etiquetados como spam o posiblemente spam.

**Información** **mostrado**:

* Número de teléfono del emisor
* Total de llamadas realizadas
* Estado de marcado automático como spam para las llamadas
* Estado de marcado manual
* Número de llamadas realizadas

Utilice estos datos para identificar a los emisores de spam persistentes y verificar que su detección de spam esté funcionando correctamente.

### Protección contra Spam Salientes

#### <mark style="color:azul;">Por qué sus llamadas Salientes pueden marcarse como spam</mark>

Cuando realiza llamadas Salientes desde Zoom Phone, sus llamadas pueden ser bloqueadas o marcadas como spam por el servicio telefónico o el operador de la parte receptora. Esto sucede porque los operadores están implementando cada vez más programas de bloqueo de llamadas para proteger a los consumidores contra las llamadas automáticas abusivas. Si su cuenta tiene una etiqueta de spam errónea, consulte nuestra sección sobre la remediación de etiquetas de spam.

**Razones comunes por las que sus llamadas se marcan como spam**:

* **Llamadas de gran volumen y corta duración**: Operadores de EE. UU. como AT\&T, Verizon y T-Mobile bloquean o marcan llamadas que siguen patrones de llamadas automáticas
* **Servicios de bases de datos de terceros**: La parte receptora puede usar servicios como Nomorobo que tienen su número marcado
* **Filtros de servicios telefónicos de terceros**: El receptor puede tener filtros que bloquean ciertos prefijos de número
* **Falta de registro de ID de llamada**: Su información comercial no está registrada con las operadoras y los proveedores de análisis

#### <mark style="color:azul;">Permitir de forma proactiva sus números con las operadoras de EE. UU.</mark>

Si realiza llamadas Salientes frecuentes y legítimas (como recordatorios de citas), puede registrar de forma proactiva sus números para evitar que se clasifiquen como spam.

**Operadoras de EE. UU. de contacto**:

* Hiya
* TNS
* Sprint
* T-Mobile

**Servicios de bases de datos de robollamadas para contacto**:

* Nomorobo
* YouMail

**Proveedores de análisis**:

* Transparencia de llamada
* Registro gratuito de llamadas (ayuda a llegar a proveedores de análisis que ofrecen soporte para los principales operadores de EE. UU.)

contacto a estas organizaciones directamente para solicitar que se permita su número de teléfono y proporcione información sobre su uso Comercial legítimo.

#### <mark style="color:azul;">Corrección de la etiqueta de spam</mark> <a href="#spam-tag-remediation" id="spam-tag-remediation"></a>

Características de remediación de etiquetas de spam supervisa automáticamente sus Números de teléfono para detectar etiquetas de spam aplicadas por otros operadores y trabaja para eliminarlas.

**Requisitos**:

* Zoom centro de contacto Premium o Elite licencia o licencia de Zoom Phone con add-on de Zoom Auto Dialer
* SKU de supervisión y remediación de spam de Zoom (a menos que use el marcador Salientes del centro de contacto)
* Finalización y aprobación del formulario de inscripción de remediación de la etiqueta de spam
* Admite tanto números nativos como BYOC

**Limitaciones**: Actualmente disponible solo en Estados Unidos (Números de teléfono con código de país +1)

#### <mark style="color:azul;">Comprender el proceso de remediación</mark>

Una vez que los números estén inscritos, mostrarán un indicador de estado de spam actualizado en el portal del administrador. Cuando se detecta un número como spam:

1. Verá alertas en línea en varias ubicaciones del portal del administrador
2. El proceso de remediación automática comienza de inmediato
3. El proceso suele tardar 1-2 días (puede tardar más en caso de disputas regulatorias)
4. No se requiere ninguna acción manual de su parte
5. Si tiene éxito, la etiqueta de spam se elimina automáticamente

Para **Zoom centro de contacto**: Con la coincidencia automática de ID de llamada, los números marcados como spam se omiten durante el proceso de coincidencia de ID de llamada. Una vez que se elimina la etiqueta de spam, el número vuelve a ser elegible. Sin embargo, si un número con etiqueta de spam está configurado como el ID de llamada predeterminado, no se omitirá por la regla de coincidencia del ID de llamada predeterminado.

### Solución de problemas y Preguntas frecuentes

#### <mark style="color:azul;">Mis llamadas salientes están siendo bloqueadas o marcadas como spam por los destinatarios</mark>

Empiece por identificar qué operador o servicio está bloqueando sus llamadas y luego contáctelo directamente para solicitar la inclusión en la lista de permitidos. Proporcione documentación de su uso comercial legítimo para respaldar su solicitud. Para soluciones a largo plazo, complete **Registro Empresarial de etiquetado de spam** para registrar su empresa con los principales operadores y habilitar **Corrección de la etiqueta de spam** para supervisar y eliminar automáticamente las etiquetas de spam. Siga las mejores prácticas para llamadas salientes evitando patrones de llamadas de gran volumen y corta duración.

#### <mark style="color:azul;">Demasiadas llamadas de spam están llegando a mis usuarios</mark>

Verifique que la Protección contra spam esté habilitada a nivel de la cuenta y ajuste el **Nivel del filtro de spam** a una sensibilidad más alta. Anime a los usuarios a marcar las llamadas de spam, lo que ayuda a mejorar la precisión del sistema con el tiempo. Revise los **Los 100 principales llamadores de spam** en el Panel de control para identificar a los infractores persistentes y considere cambiar la administración de llamadas a **Bloquear este número** o **Reenviar al correo de voz**. Para los usuarios más afectados, habilite **Filtrado de llamadas**, que requiere que los llamantes externos presionen un botón para conectarse.

#### <mark style="color:azul;">Las llamadas legítimas se están marcando incorrectamente como spam</mark>

Pida a los usuarios que marquen los números como **No es spam** desde su historial de llamadas o correo de voz y ajuste el **Umbral de marcado manual de NO ES SPAM** a un número más bajo. Disminuya la **Nivel del filtro de spam** sensibilidad para reducir los falsos positivos. Añada los números a los contactos del usuario o de la empresa y luego habilite **Excluir los contactos del usuario y de la empresa de la Protección contra spam**. Revise la **Spam marcado incorrectamente** métrica en el Panel de control con regularidad para evaluar con qué frecuencia ocurre esto.

#### <mark style="color:azul;">Necesito ver la actividad de spam durante un período de tiempo específico</mark>

Acceda al Panel de control de spam navegando a **Panel de control > Teléfono > Spam** en su portal del administrador. En la parte superior de la página, seleccione el intervalo de fechas deseado para filtrar los datos. Revise el **Llamadas Entrantes** gráfico para ver tendencias a lo largo del tiempo e identificar patrones. Exporte los datos si es necesario para fines de informes.

#### <mark style="color:azul;">Un número de teléfono específico sigue llamando a pesar de estar bloqueado</mark>

Verifique que el número esté en la lista de números de spam comprobando **Configuración de la cuenta > Protección contra spam > Administrar la lista de números**. Confirme que la administración de llamadas esté configurada para **Bloquear este número** en lugar de solo **Marcar sin bloquear**. Compruebe si la persona que llama está usando suplantación de números o rotando entre varios números. Considere bloquear todo el código de área o prefijo si corresponde, e informe a las autoridades locales sobre las personas que realizan llamadas de spam persistentes si lo acosan o amenazan.

#### <mark style="color:azul;">Las etiquetas de spam no aparecen en mis llamadas</mark>

Verifique que la protección contra spam esté habilitada en **Configuración de la cuenta** y confirme que tiene una cuenta Comercial o Empresarial. Compruebe que sus Números de teléfono sean números de EE. UU. o Canadá, ya que el marcado automático solo funciona para números +1. Asegúrese de que los usuarios tengan la versión mínima requerida de la aplicación Zoom Workplace y Permitir tiempo para que el sistema aprenda los patrones de spam.

#### <mark style="color:azul;">Es posible que se hayan aplicado etiquetas de spam a mis números Salientes</mark>

Vaya a **Administración de números > Números de teléfono > Funciones relacionadas > Corrección de etiquetas de spam** para comprobar el estado de sus números. Revise el indicador de estado de spam de cada número inscrito y busque alertas en línea que indiquen la detección de spam. Supervise el estado del proceso de corrección automática para ver si Zoom está trabajando activamente para eliminar las etiquetas. Sin la corrección de etiquetas de spam, es posible que no sepa que sus números están etiquetados, a menos que los destinatarios se lo informen.

#### <mark style="color:azul;">No entiendo la diferencia entre el marcado automático y el marcado manual de spam</mark>

El marcado automático de spam utiliza análisis de llamadas y estándares globales del sector para identificar automáticamente el spam sin intervención del usuario. Está disponible solo para números de EE. UU. y Canadá, ofrece tres niveles de sensibilidad y funciona inmediatamente después de su habilitación. El marcado manual de spam se basa en informes de usuarios y umbrales definidos, y requiere que los usuarios marquen activamente los números como spam. Crea listas de spam específicas de la Organización y anula la Configuración de marcado automático cuando se alcanzan los umbrales.

#### <mark style="color:azul;">Quiero usar conjuntamente el marcado automático y manual de spam</mark>

Sí, y se recomienda para obtener los mejores resultados. Los umbrales de marcado manual anularán las decisiones del marcado automático, lo que permitirá que la experiencia colectiva de su Organización ajuste con precisión el sistema de detección automática. Esta combinación proporciona protección básica mediante la detección de spam conforme a los estándares del sector, al tiempo que permite que los informes de sus usuarios adapten el sistema a sus patrones de llamadas específicos.

#### <mark style="color:azul;">La corrección de mis etiquetas de spam está tardando más de lo esperado</mark>

El proceso de corrección automática suele tardar entre 1 y 2 días en completarse. Puede tardar más si hay disputas regulatorias con los operadores o si varios operadores aplicaron la etiqueta de spam. No se requiere ninguna acción manual de su parte durante este proceso. Si la corrección no tiene éxito después de varios días, abra una entrada de soporte para obtener asistencia adicional.

#### <mark style="color:azul;">No entiendo qué sucede durante la corrección de etiquetas de spam</mark>

Para Zoom centro de contacto con coincidencia automática de ID de llamada, los números marcados como spam se omiten durante el proceso de coincidencia de ID de llamada. Una vez que se elimina la etiqueta, el número vuelve a ser apto para la coincidencia. Para Zoom Phone normal, el sistema trabaja automáticamente con los operadores para eliminar la etiqueta y verá actualizaciones de estado en el portal del administrador. Si no tiene éxito después del intento inicial, es posible que deba abrir una entrada de soporte.

#### <mark style="color:azul;">Necesito Configure la protección contra spam para mensajes SMS</mark>

Puede Configure la administración de spam para SMS con dos opciones. **Bloquear este número** bloquea los SMS por completo para que los usuarios no puedan ver los mensajes de spam. Marcar sin bloquear etiqueta los SMS como spam, pero permite su entrega. Configure esto en **Configuración de la cuenta > Zoom Phone > Protección contra spam > administración de llamadas y opciones de SMS > SMS de SPAM entrantes**.

#### <mark style="color:azul;">La protección contra spam está bloqueando llamadas de mis Clientes legítimos</mark>

Habilitar la exclusión de contactos de usuarios y empresas de la protección contra spam para Permitir automáticamente el paso de todos los contactos guardados. Haga que los usuarios guarden los números de los clientes en sus contactos para que se reconozcan como personas que llaman legítimas. Ajuste los niveles de sensibilidad según corresponda, ya que una menor sensibilidad reduce los falsos positivos, y capacite a los usuarios para marcar como No spam los números identificados incorrectamente. Revise regularmente la métrica de spam marcado erróneamente en su Panel de control para detectar patrones.

#### <mark style="color:azul;">Recibí una llamada de spam y necesito saber qué hacer</mark>

No responda si la llamada ya está marcada como spam, a menos que reconozca el número. Marque la llamada como spam desde su historial de llamadas o correo de voz si no se detectó automáticamente. Seleccione **Llamadas de spam** en lugar de **Otros motivos** para ayudar a proteger a toda su Organización. Informe el acoso persistente a su administrador y use el modo No molestar si está sufriendo un ataque de llamadas de spam.

#### <mark style="color:azul;">Quiero bloquear códigos de área o prefijos completos</mark>

Aunque Zoom Phone le permite bloquear números y prefijos específicos, el bloqueo de códigos de área completos debe abordarse con cautela, ya que puede bloquear a personas que llaman legítimas. Si está recibiendo spam de prefijos específicos, puede Añadirlos a su lista de números bloqueados. Sin embargo, considere el impacto Comercial antes de implementar reglas de bloqueo amplias. Un enfoque mejor suele ser usar niveles más altos de sensibilidad al spam y fomentar los informes de los usuarios.

#### <mark style="color:azul;">Me preocupa la precisión de la detección automática de spam</mark>

La precisión depende del nivel de sensibilidad que Seleccione, de la calidad de las bases de datos globales de spam, de los Comentarios de los usuarios mediante el marcado manual y de cuánto coincidan los patrones de spam habituales con sus llamadas Entrantes. Supervise la métrica de spam marcado erróneamente en el Panel de control para evaluar la precisión en su Organización. Si observa un número elevado de casos de spam marcados erróneamente, considere reducir el nivel de sensibilidad. También puede implementar la opción de excluir contactos de usuarios y empresas para evitar que se bloqueen contactos conocidos.

#### <mark style="color:azul;">No entiendo por qué necesito el registro de spam Empresarial cuando ya tengo protección contra spam</mark>

Estas funciones tienen propósitos diferentes y trabajan juntas para ofrecer una protección integral. La protección contra spam protege a sus usuarios de recibir llamadas Entrantes no deseadas mediante el filtrado y bloqueo de personas que realizan llamadas de spam. El registro de spam Empresarial protege las llamadas Salientes de su Organización para que otros operadores no las etiqueten como spam. Además, el registro de spam funciona con números internacionales, mientras que la corrección de spam solo está disponible para números de EE. UU. Ambos se recomiendan para una administración integral del spam, especialmente si su Organización realiza llamadas Salientes con frecuencia.

#### <mark style="color:azul;">Quiero saber qué información se comparte durante el registro de spam Empresarial</mark>

Zoom comparte la razón social y el nombre público de su empresa, el sector y el tamaño de la empresa, la información de contacto y la dirección Comercial con los principales operadores de EE. UU. y sus Socios de análisis. El sistema también comparte los números DUNS y EIN, así como todos los Números de teléfono de su cuenta, independientemente del país, producto o estado nativo. Esta información ayuda a los operadores a verificar su legitimidad y mejorar la reputación de su ID de llamada. Reduce la probabilidad de que los destinatarios bloqueen o etiqueten como spam sus llamadas Salientes.


---

# 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/es/zoom-workplace/zoom-phone/zoom-phone-spam-field-guide.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
