> 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 llamadas spam en toda su Organización.

Comprender 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 explica cómo funciona la detección de spam, las opciones de configuración para los administradores, los controles a nivel de usuario, las capacidades de monitoreo y las soluciones cuando sus llamadas Salientes se etiquetan incorrectamente como spam por otras operadoras.

### 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 los administradores que configure Configuración de toda la cuenta y para los usuarios que administran sus propias preferencias de bloqueo de spam.

**Secciones basadas en tareas:** El contenido está organizado según lo que necesita lograr: Comprender la protección contra spam, Configurar la protección, Administrar la Configuración de usuario, Monitorear la actividad y Solucionar problemas.

**Formato de declaración-respuesta:** Las preguntas y problemas 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 de 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 automáticamente como spam**

Zoom Phone puede analizar automáticamente las llamadas Entrantes y etiquetar posibles llamadas spam según los estándares globales de la industria. Esta característica está habilitada de forma predeterminada para las cuentas Empresariales y usa análisis de llamadas para identificar patrones de spam sin requerir intervención manual.

**Marcar manualmente como spam**

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 donde los informes de los usuarios contribuyen a la protección de toda la Organización.

**Niveles de sensibilidad de spam**

Zoom ofrece tres niveles de sensibilidad para la detección automática de spam:\
**Baja sensibilidad**: Marca las llamadas como spam con certeza definitiva\
**Sensibilidad media**: Marca las llamadas como spam con certeza moderada\
**Alta sensibilidad**: Marca las llamadas como spam con certeza sólida

**Spam frente a quizá spam**

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

**Opciones de manejo**

Cuando una llamada o SMS se identifica como spam, los administradores pueden elegir cómo manejarlo. Tanto para llamadas como para 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 adjuntos
  * Deshabilitar hipervínculos
  * Filtrar enlaces de phishing en pantalla

#### <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 identificando y bloqueando a quienes llaman como 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 al supervisar sus Números de teléfono para detectar etiquetas de spam aplicadas por otras operadoras y trabajar automáticamente para eliminar esas etiquetas.

**Registro Empresarial de spam**

Permite a las organizaciones registrar su información Comercial y Números de teléfono con las principales operadoras 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 Configure</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)
* [Administrar 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 si tiene preguntas no cubiertas en esta guía, comuníquese con el Soporte de Zoom Phone a través del portal web o [visite nuestra documentación de soporte](https://support.zoom.com/).

### Supervisión de la actividad de spam

#### <mark style="color:azul;">Accediendo 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 Teléfono 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 intervalo de fechas que desea ver.
6. Haga clic en el menú desplegable y seleccione el **Nivel de sensibilidad de marcado automático de spam** .

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

#### <mark style="color:azul;">Comprensión de 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 por error**)
* **Quizá** **Spam**: Número de llamadas directas marcadas como **Posible spam**, incluido el porcentaje de llamadas Entrantes (excluye Spam marcado por error)
* **Entrantes** **RTPC** **Llamadas**: Total de llamadas directas RTPC a usuarios, con indicador de cambio de rango de fechas
* **Único** **Llamantes**: Recuento único de Números de teléfono Entrantes que realizan llamadas directas RTPC a usuarios, con indicador de cambio de rango de fechas

#### <mark style="color:azul;">Revisar el gráfico de llamadas Entrantes</mark>

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

* **Spam**
* **Posible spam**
* **No spam**
* **Spam marcado por error** (llamadas marcadas como spam por auto-mark, pero marcadas como No spam por los usuarios)

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

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

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

**Información** **mostrada**:

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

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

#### <mark style="color:azul;">Analizar los 100 llamantes spam principales</mark>

Esta sección muestra los 100 llamantes principales que fueron etiquetados como spam o quizá spam.

**Información** **mostrada**:

* Número de teléfono del llamante
* Total de llamadas realizadas
* Estado de auto-mark spam para llamadas
* Estado de marcado manual
* Número de llamadas realizadas

Use estos datos para identificar llamantes spam persistentes y verificar que su detección de spam funcione correctamente.

### Protección contra spam saliente

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

Cuando realiza llamadas Salientes desde Zoom Phone, sus llamadas pueden ser bloqueadas o etiquetadas como spam por el servicio telefónico o la operadora del destinatario. Esto sucede porque las operadoras 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 están etiquetadas como spam**:

* **Llamadas de alto volumen y corta duración**: Operadoras de EE. UU. como AT\&T, Verizon y T-Mobile bloquean o etiquetan 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 proactivamente sus Números de teléfono con operadoras de EE. UU.</mark>

Si realiza llamadas Salientes frecuentes y legítimas (como recordatorios de citas), puede registrar proactivamente sus Números de teléfono para evitar que se clasifiquen como spam.

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

* Hiya
* TNS
* Sprint
* T-Mobile

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

* Nomorobo
* YouMail

**Proveedores de análisis**:

* Transparencia de llamadas
* Registro de llamantes gratuito (ayuda a llegar a proveedores de análisis que admiten a los principales operadores de EE. UU.)

Póngase en contacto con 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;">Remediación de la etiqueta de spam</mark> <a href="#spam-tag-remediation" id="spam-tag-remediation"></a>

La 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 monitoreo y remediación de spam de Zoom (a menos que se 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
* Compatible con números nativos y 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 se inscriben, se les mostrará un indicador actualizado del estado de spam en el portal del administrador. Cuando un número se detecta como spam:

1. Verás alertas en línea en varias ubicaciones en el portal del administrador
2. El proceso de remediación automática comienza de inmediato
3. El proceso suele tardar de 1 a 2 días (puede tardar más en disputas regulatorias)
4. No se requiere ninguna acción manual de tu 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 etiquetado como 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 etiquetadas como spam por los destinatarios</mark>

Comience por identificar qué operador o servicio está bloqueando sus llamadas, luego contacte con ellos directamente para solicitar que lo agreguen a la lista permitida. 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 negocio con los principales operadores y Habilitar **Remediación de la etiqueta de spam** para supervisar y eliminar automáticamente las etiquetas de spam. Siga las mejores prácticas para las 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 mayor sensibilidad. Anime a los usuarios a marcar las llamadas de spam, lo que ayuda a mejorar la precisión del sistema con el tiempo. Revise el **Los 100 principales emisores de llamadas 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 gravemente afectados, Habilitar **Filtrado de llamadas**, que requiere que las personas que llaman desde fuera pulsen un botón para conectarse.

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

Haga que los usuarios marquen los números como **No spam** de 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. Reduzca 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, luego Habilitar **Excluir los contactos del usuario y de la empresa de Spam Protection**. Revise la **Spam marcado por error** métrica en el Panel de control regularmente 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>

Acceso al Panel de control de Spam navegando a **Panel de control > Teléfono > Spam** en tu 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 lista de números**. Confirme que la administración de llamadas esté configurada en **Bloquear este número** en lugar de solo **Marcar sin bloquear**. Compruebe si quien llama está usando suplantación de número 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 los llamantes spam persistentes si lo están acosando o amenazando.

#### <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 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 dé tiempo al sistema para aprender los patrones de spam.

#### <mark style="color:azul;">Puede que mis números salientes tengan etiquetas de spam aplicadas</mark>

Ir a **Gestión de números > Números de teléfono > Funciones relacionadas > Remediació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 detección de spam. Supervise el estado del proceso de remediación automática para ver si Zoom está trabajando activamente para eliminar las etiquetas. Sin la Remediació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 spam de marcado automático usa análisis de llamadas y estándares globales del sector para identificar automáticamente el spam sin intervención del usuario. Solo está Disponible para números de EE. UU. y Canadá, ofrece tres niveles de sensibilidad y funciona inmediatamente al habilitarse. El spam de marcado manual se basa en los informes de los usuarios y en 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 tanto el marcado automático como el marcado manual de spam juntos</mark>

Sí, y esto se recomienda para obtener los mejores resultados. Los umbrales marcados manualmente anularán las decisiones de marcado automático, lo que permitirá que la experiencia colectiva de su Organización perfeccione el sistema de detección automática. Esta combinación proporciona protección de base mediante detección de spam Estándar de la industria, 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 remediación de mi etiqueta de spam está tardando más de lo esperado</mark>

El proceso de remediación automática suele tardar entre 1 y 2 días en completarse. Puede tardar más si hay disputas regulatorias con las operadoras o si la etiqueta de spam fue aplicada por varias operadoras. No se requiere ninguna acción manual de tu parte durante este proceso. Si la remediación no tiene éxito después de varios días, abre una entrada de soporte para obtener asistencia adicional.

#### <mark style="color:azul;">No entiendo qué sucede durante la remediació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 elegible para la coincidencia. Para Zoom Phone estándar, el sistema trabaja automáticamente con los operadores para eliminar la etiqueta y verás actualizaciones de estado en el portal del administrador. Si no tiene éxito después del intento inicial, es posible que debas abrir una entrada de soporte.

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

Puede Configure la gestión de spam para SMS con dos opciones. **Bloquear este número** bloquea SMS por completo, de modo que los usuarios no pueden ver mensajes de spam. Marcar sin etiquetas de Bloqueo marca SMS como spam, pero permite la entrega. Configure esto en **Cuenta > Configuración > 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 Excluir los contactos del usuario y de la empresa de la Protección contra spam para Permitir automáticamente todas las llamadas de los contactos guardados. Haga que los usuarios guarden los números de los Clientes en sus contactos para que se reconozcan como llamantes legítimos. Ajuste los niveles de sensibilidad adecuadamente, ya que una sensibilidad más baja reduce los falsos positivos, y enseñe a los usuarios a marcar los números incorrectamente señalados como No spam. Revise periódicamente la métrica de Spam marcado incorrectamente en su Panel de control para detectar patrones.

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

No conteste 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 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>

Si bien Zoom Phone le permite bloquear números y prefijos específicos, bloquear códigos de área completos debe abordarse con cautela, ya que podría bloquear llamantes legítimos. Si está experimentando 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. A menudo, un mejor enfoque es usar niveles de sensibilidad al spam más altos y fomentar que los usuarios lo informen.

#### <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, la calidad de las bases de datos globales de spam, los Comentarios de los usuarios mediante el marcado manual y de cómo los patrones típicos de spam coinciden con sus llamadas Entrantes. Supervise la métrica de Spam marcado incorrectamente en el Panel de control para evaluar la precisión de su Organización. Si ve un gran número de spam marcados incorrectamente, considere reducir su nivel de sensibilidad. También puede implementar la opción Excluir contactos del usuario y la empresa para evitar que se bloqueen contactos conocidos.

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

Estas funciones cumplen distintos propósitos y funcionan juntas para una protección integral. La Protección contra spam protege a sus usuarios de recibir llamadas Entrantes no deseadas filtrando y bloqueando a los llamantes de spam. Empresarial Spam registro protege las llamadas Salientes de su Organización para que no sean etiquetadas como spam por otros operadores. Además, el registro de spam funciona para números internacionales, mientras que la remediación de spam solo está Disponible para números de EE. UU. Se recomiendan ambas para una gestió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 Empresarial Spam registro</mark>

Zoom comparte su nombre legal Comercial y nombre público, industria y tamaño de la empresa, información de contacto y 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 y 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 sus llamadas Salientes sean bloqueadas o etiquetadas como spam por los destinatarios.


---

# 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.
