> For the complete documentation index, see [llms.txt](https://help.join.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.join.com/help-center/es/review-candidates/pipeline-management.md).

# Gestión del pipeline

Crea y edita plantillas de pipeline, elige una predeterminada y archiva las antiguas; después mueve, ordena y filtra solicitudes en la vista de tarjetas o de tabla de una oferta.

Un pipeline representa el recorrido que hace una solicitud desde el momento en que un candidato se postula hasta que lo contratas o lo rechazas. Piensa en él como un flujo de trabajo visual que refleja tu proceso interno de contratación. Cada etapa del pipeline representa un paso de tu embudo de selección; por ejemplo: `Entrevista telefónica`, `Caso práctico`, `Oferta` o `Contratado`.

Con pipelines, puedes:

* Estructurar tus pasos de contratación de forma coherente entre equipos
* Hacer seguimiento de en qué parte del proceso está cada solicitud
* Activar acciones automatizadas cuando un candidato llega a una etapa, como enviar un correo o rechazar solicitudes estancadas
* Ordenar y reordenar candidatos para decidir a quién revisar primero

Todos los candidatos entran automáticamente en la primera etapa del pipeline cuando se postulan.

Puedes acceder a los pipelines en JOIN de dos formas:

* Desde `Configuración` > `Pipelines`, para crear, editar o gestionar plantillas de pipeline
* Desde la subpestaña `Candidaturas` de cualquier oferta, para ver y gestionar las solicitudes del pipeline de ese puesto

## Pasos rápidos

1. Ve a `Configuración` > `Pipelines` y haz clic en `+ Añadir plantilla`.
2. Pasa el cursor entre dos etapas, haz clic en `+` y añade cada etapa personalizada con un `Nombre de la etapa` y un `Tipo de etapa`.
3. Introduce un `Nombre del pipeline` y haz clic en `Crear pipeline`.
4. Abre la subpestaña `Candidaturas` de una oferta y arrastra la tarjeta de un candidato para moverlo a otra etapa.

***

## Crear una plantilla de pipeline

Toda plantilla de pipeline que crees parte de la misma base: cuatro etapas fijas, más las etapas personalizadas que añadas para tu propio proceso de contratación.

### Etapas fijas

Toda plantilla de pipeline, incluidas las nuevas que crees, incluye estas cuatro etapas:

* `Candidatura recibida`
* `Revisión de candidaturas`
* `Oferta`
* `Contratado`

Se llaman etapas fijas porque no puedes renombrarlas, reordenarlas ni eliminarlas en ningún pipeline. Existen para que JOIN pueda saber siempre en qué punto está una solicitud, use el pipeline que use la oferta; así, los filtros, los informes y las automatizaciones de etapa funcionan igual en todas partes.

`Candidatura recibida` es el punto de entrada en el que empieza toda solicitud. Esta etapa incluye una automatización predeterminada que envía el correo de confirmación de la solicitud a cada candidato que se postula a tus puestos abiertos.

`Revisión de candidaturas` es la etapa a la que llegan casi todas a continuación, porque ahí empieza tu propio proceso de contratación.

Tus etapas personalizadas se añaden entre `Revisión de candidaturas` y `Oferta` (ahí está la mayor parte de tu proceso: llamadas de criba, entrevistas, pruebas).

### Tipos de etapa

Cada etapa personalizada que añadas necesita un `Tipo de etapa`: `Revisión de candidaturas` o `Entrevista`. Elige el que corresponda a lo que de verdad ocurre en ese paso de tu proceso.

{% hint style="warning" %}
El `Tipo de etapa` no se puede cambiar después de crear la etapa. Si necesitas otro tipo, elimina la etapa y añade una nueva. De momento, los dos tipos sirven sobre todo para clasificar tu proceso.
{% endhint %}

### Crear la plantilla

1. Ve a `Configuración` > `Pipelines`
2. Haz clic en `+ Añadir plantilla`

Se abre el editor de plantillas de pipeline: un lienzo con tus etapas fijas ya colocadas bajo los encabezados de sus grupos (`Postulado`, `Proceso activo`, `Oferta`, `Contratado`), listo para que añadas tus propias etapas.

3. Pasa el cursor entre dos etapas y haz clic en el icono `+` que aparece para `Añadir etapa`
4. En el panel de la etapa que se abre a la derecha, introduce un `Nombre de la etapa` y elige un `Tipo de etapa`
5. Opcional: haz clic en `Añadir automatización` en el mismo panel para configurar una para esa etapa directamente. Consulta [Añadir una automatización a una etapa del pipeline](https://help.join.com/help-center/es/review-candidates/automations.md#anadir-una-automatizacion-a-una-etapa-del-pipeline)
6. Repite el proceso para cada etapa que necesites y haz clic en `Crear pipeline`

Introduce el nombre del pipeline en el campo `Nombre del pipeline`, en la parte superior del editor. Una plantilla nueva nunca es la predeterminada: una vez guardada, usa el menú `...` de la parte superior derecha del editor para renombrarla o marcarla como predeterminada.

{% hint style="info" %}
Solo los usuarios con el rol `Administrador del sistema` o `Standard` pueden crear, editar o archivar plantillas de pipeline.
{% endhint %}

***

## Elegir una plantilla de pipeline predeterminada

El pipeline predeterminado es la plantilla de pipeline que JOIN aplica automáticamente cuando alguien crea una oferta sin elegir ninguna. Siempre puedes cambiar después el pipeline de una oferta, pero conviene tener un valor predeterminado sensato para que las ofertas nuevas no empiecen con el proceso equivocado.

Para establecer un pipeline como predeterminado:

1. Ve a `Configuración` > `Pipelines`
2. Abre la plantilla de pipeline que quieres convertir en predeterminada
3. Haz clic en el menú `...` de la parte superior derecha del editor
4. Activa la opción `Por defecto`

La tabla de resumen de `Pipelines` muestra el pipeline predeterminado actual en la columna `Predeterminado` y cuántas ofertas tiene asignadas cada pipeline.

***

## Editar un pipeline

Para editar una plantilla de pipeline existente:

1. Ve a `Configuración` > `Pipelines`
2. Abre la plantilla que quieres actualizar
3. Haz los cambios y haz clic en `Guardar cambios`

La mayoría de los cambios se hacen directamente en el lienzo del editor:

* Haz clic en una etapa para abrir su panel y cambiar su nombre, o añadir, editar o eliminar sus automatizaciones. Consulta [Automatizaciones](https://help.join.com/help-center/es/review-candidates/automations.md)
* Usa el menú `...` de una etapa personalizada para `Duplicar etapa` o `Eliminar etapa`

Las etapas fijas (`Candidatura recibida`, `Revisión de candidaturas`, `Oferta`, `Contratado`) no tienen las opciones `Duplicar etapa` ni `Eliminar etapa`, porque no se pueden renombrar, reordenar ni eliminar.

Para los cambios a nivel de pipeline, usa el menú `...` de la parte superior derecha del editor:

* `Renombrar pipeline`
* `Duplicar pipeline`
* Activar o desactivar `Por defecto`
* `Archivar pipeline` (consulta [Archivar un pipeline](#archivar-un-pipeline))

{% hint style="warning" %}
Cualquier cambio que hagas aquí se aplica a **todas las ofertas que usan este pipeline**, no solo a las nuevas. Si eliminas una etapa, consulta [Editar o archivar un pipeline en uso](#editar-o-archivar-un-pipeline-en-uso) antes de guardar.
{% endhint %}

***

## Archivar un pipeline

No puedes eliminar una plantilla de pipeline. Solo puedes archivarla.

Archivar no oculta el pipeline ni lo quita de las ofertas que ya lo usan; significa que esta plantilla ya no se puede asignar a una oferta a partir de ahora, ni a una oferta nueva que crees ni a una oferta existente que cambies a otra plantilla.

Para archivar un pipeline:

1. Ve a `Configuración` > `Pipelines`
2. Selecciona la plantilla de pipeline que quieres archivar
3. Abre el menú `...` de la parte superior derecha del editor
4. Haz clic en `Archivar pipeline`

No puedes archivar el pipeline predeterminado.

Los pipelines archivados pasan a la pestaña `Archivado` del resumen de `Pipelines`. Puedes abrir uno para `Duplicar` o `Restaurar`, pero no puedes editar sus etapas mientras está archivado. Restaura el pipeline primero.

Las ofertas que ya usaban un pipeline cuando se archivó siguen funcionando exactamente igual, sea cual sea su estado. Al abrir una de esas ofertas, su pipeline se muestra como siempre; verás el pipeline marcado como archivado si abres el desplegable de plantilla de pipeline de esa oferta. No puedes seleccionar un pipeline archivado para una oferta nueva ni asignarlo a otra oferta existente.

***

## Editar o archivar un pipeline en uso

Como un pipeline puede estar asignado a muchas ofertas a la vez, JOIN comprueba antes de aplicar un cambio si dejaría a algún candidato activo sin etapa.

**Eliminar una etapa con candidatos:** si eliminas una etapa personalizada y una o más ofertas tienen candidatos activos en ella, JOIN te pide que elijas a dónde van esos candidatos antes de guardar: a la siguiente etapa del pipeline o a otra etapa que elijas.

> Por ejemplo, al eliminar una etapa llamada `Entrevista con el responsable de selección`, se te pedirá que muevas a los candidatos afectados a `Entrevista de encaje con el equipo` o a la etapa que elijas.

**Cambiar el pipeline que usa una oferta:** cambiar una oferta a otra plantilla de pipeline funciona igual. Se te pedirá que asignes a los candidatos desde su etapa actual a una etapa del nuevo pipeline antes de aplicar el cambio.

***

## Ver el pipeline de una oferta

Una vez publicada una oferta, abre su pestaña `Candidaturas` para ver su pipeline. Cada columna es una etapa de la plantilla de pipeline, en orden, y muestra cuántas solicitudes hay en ella.

Si una etapa tiene automatizaciones, verás el icono de automatización junto a su nombre, y al mover a un candidato a ella esas automatizaciones se ponen en cola y se muestran en el propio tablero con una breve cuenta atrás. Consulta [Ver las automatizaciones en el pipeline de una oferta](https://help.join.com/help-center/es/review-candidates/automations.md#ver-las-automatizaciones-en-el-pipeline-de-una-oferta) para ver cómo se muestra y cómo cancelar una antes de que se ejecute.

Puedes mover candidatos entre columnas, o usar los `Filtros` y la configuración de la vista para cambiar cómo se ordena y se muestra el tablero. Para todo lo demás que puedes hacer con las solicitudes del pipeline (filtros, acciones masivas, vista de tabla, rechazos), consulta [Resumen de candidatos y filtros](https://help.join.com/help-center/es/review-candidates/candidates-overview-and-filters.md) y [Rechazar, eliminar o bloquear](https://help.join.com/help-center/es/review-candidates/reject-delete-or-block.md).

Al asignar una plantilla de pipeline a una oferta, si pasas el cursor por una plantilla en el desplegable `Plantilla de pipeline` verás una vista previa de sus etapas, con el icono de automatización junto a las que tienen alguna, para comprobar qué activará una plantilla antes de elegirla.

### Gestionar el pipeline de una oferta

Una vez publicada una oferta, puedes gestionar las solicitudes que recibes con el pipeline de la oferta.

1. Ve a la pestaña `Ofertas`
2. Abre la subpestaña `Activas`
3. Selecciona la oferta que quieres gestionar
4. Haz clic en la subpestaña `Candidaturas`

Llegarás a la vista de solicitudes `Activo`. Por defecto, el pipeline se abre en la vista `Tarjetas`.

Usa el conmutador de la parte superior para alternar entre solicitudes `Activo` y `Rechazado`. Cada pestaña muestra el número total de solicitudes en ese estado.

Puedes:

* Cambiar entre las vistas `Tarjetas` y `Tabla` desde el menú `Configuración de la vista` (icono <i class="fa-gear">:gear:</i> arriba a la derecha)
* Mover candidatos entre etapas
* Aplicar acciones masivas como `Mover a...`, `Rechazar`, `Exportar` o `Etiqueta`

### Ordenar las solicitudes

Abre el menú `Configuración de la vista` para personalizar cómo se muestran las solicitudes. Puedes ajustar la ordenación y los datos que aparecen en cada tarjeta o en las columnas de la tabla.

En el menú `Configuración de la vista`, puedes controlar cómo se ordenan las solicitudes:

* `Ordenar por`: `Tiempo en etapa`, `Fecha de candidatura`, `Nombre`
* `Ordenar por` (sentido):
  * `Nuevo a antiguo` / `Antiguo a nuevo` (para ordenación por fecha)
  * `de A a Z` / `de Z a A` (para ordenación por nombre)

Para volver a la configuración predeterminada, haz clic en `Restablecer` junto a `Datos visibles`.

La configuración de la vista, incluidos el orden y los datos visibles, se guarda en tu dispositivo. No se comparte con otros miembros del equipo.

***

## Ajustar las vistas del pipeline

{% tabs %}
{% tab title="Tarjetas" %}
En la vista `Tarjetas` (diseño kanban), cada columna representa una etapa del pipeline. Las solicitudes aparecen como tarjetas que puedes personalizar, ordenar y gestionar directamente en el tablero.

Cada columna muestra el número de solicitudes de esa etapa junto al nombre de la etapa. Cuando aplicas filtros, estos recuentos se actualizan. Si el nombre de una etapa es demasiado largo, se recorta, pero el número de solicitudes siempre se ve completo.

**Personalizar las tarjetas**

Ve al menú `Configuración de la vista` y desplázate hasta la sección `Datos visibles`.

Aquí puedes:

* Activar o desactivar campos para controlar qué aparece en cada tarjeta
* Arrastrar y reordenar campos para cambiar cómo se muestra la información

Los campos que puedes mostrar incluyen `País de residencia`, `Tiempo en la etapa del pipeline`, `Documentos`, `Etiquetas`, `Correo electrónico`, `Número de teléfono`, `Enlaces`, `Fecha de candidatura`, `Estado del RGPD`, `Fuente`, `Autorización de trabajo`, `Disponibilidad` y `Expectativas salariales`.

Los cambios se aplican al instante a todas las tarjetas de la vista.

**Mover candidatos entre etapas**

Los responsables de selección y los administradores de la oferta pueden mover candidatos arrastrando una tarjeta a otra etapa del pipeline.

Mientras arrastras una tarjeta:

* La columna de destino se resalta
* Se muestra la regla de ordenación activa (p. ej., "Tablero ordenado por Tiempo en etapa, Antiguo a nuevo")

Al soltar la tarjeta, se coloca automáticamente en la posición correcta según tu ordenación actual.

{% hint style="info" %}

* Los usuarios con el [rol de oferta](https://help.join.com/help-center/es/manage-your-team/member-management.md#roles-de-oferta) `Revisor` no pueden mover candidatos entre etapas. Si lo intentan, aparece un mensaje emergente.
* Cuando una oferta está archivada, no puedes mover la tarjeta de un candidato. Sí puedes rechazar candidatos en una oferta archivada.
* Las solicitudes rechazadas no se pueden mover a otra etapa.
  {% endhint %}

**Rechazar y deshacer acciones**

Al pasar el cursor por una tarjeta aparecen acciones rápidas:

* En las etapas activas (excepto `Contratado`): `Rechazar candidato`
* En la vista `Rechazado`: `Deshacer rechazo`
* En la etapa `Contratado`: `Deshacer contratación`

Los usuarios con el [rol de oferta](https://help.join.com/help-center/es/manage-your-team/member-management.md#roles-de-oferta) `Revisor` no ven las opciones de rechazar ni de deshacer el rechazo. Solo pueden usar `Añadir etiquetas` y `Añadir nota`.

También puedes hacer clic derecho en una tarjeta para abrir un menú con las acciones disponibles: `Rechazar` o `Deshacer rechazo`, `Añadir etiquetas`, `Añadir nota`

{% hint style="warning" %}
Las solicitudes rechazadas se pueden restaurar, pero los correos de rechazo (si se enviaron) no se pueden deshacer.\
Los candidatos **no** reciben ninguna notificación cuando los mueves entre etapas, salvo que esa etapa tenga una automatización `Enviar correo`.
{% endhint %}

**Navegar por el pipeline en la vista de tarjetas**

Cada columna de etapa ocupa toda la altura de tu pantalla.

* Puedes desplazarte por cada columna de forma independiente
* Haz clic en cualquier parte de una tarjeta para abrir el perfil del candidato
* Los botones de documentos abren una vista previa del archivo
* Los botones de enlaces profesionales abren enlaces externos
* Puedes actuar sobre varios candidatos a la vez seleccionando varias tarjetas
* Selecciona candidatos individuales pasando el cursor por una tarjeta y haciendo clic en la casilla que aparece arriba a la izquierda de la tarjeta

Ya no puedes eliminar una solicitud individual desde esta vista. Eliminar un candidato, junto con todas sus solicitudes, ahora solo está disponible desde la pestaña `Candidatos`. Consulta [Eliminar un candidato](https://help.join.com/help-center/es/review-candidates/reject-delete-or-block.md#eliminar-un-candidato).
{% endtab %}

{% tab title="Tabla" %}
En la vista `Tabla`, las solicitudes se muestran en un formato estructurado, tipo hoja de cálculo. Cada fila es una solicitud y las columnas muestran datos clave como `Nombre`, `Etapa`, `Correo electrónico`, `Fecha de candidatura`, `País del candidato`, `Estado del RGPD`, `Fuente`, `Documentos`, `Enlaces` y más.

Para cambiar a la vista de tabla:

1. Abre el menú `Configuración de la vista` (icono <i class="fa-gear">:gear:</i>)
2. Selecciona `Tabla`

**Personalizar la tabla**

En el menú `Configuración de la vista`, ve a la sección `Datos visibles` para controlar qué columnas aparecen.

Puedes:

* Activar o desactivar campos para mostrar solo las columnas relevantes
* Ajustar tu vista según la información que más necesites

Las columnas que puedes mostrar incluyen `País de residencia`, `Tiempo en la etapa del pipeline`, `Documentos`, `Etiquetas`, `Correo electrónico`, `Número de teléfono`, `Enlaces`, `Fecha de candidatura`, `Estado del RGPD`, `Fuente`, `Autorización de trabajo`, `Disponibilidad` y `Expectativas salariales`.

**Seleccionar candidatos**

Puedes seleccionar una o varias solicitudes con las casillas:

* Usa la casilla junto a cada fila para seleccionar candidatos individuales
* Usa la casilla del encabezado de la tabla para seleccionar todos los candidatos visibles

Una vez seleccionados, las acciones masivas están disponibles en la barra de herramientas de la parte inferior de la pantalla: `Mover a...`, `Rechazar` y un menú `...` con `Agregar etiqueta`, `Añadir nota` y `Exportar`. Si la etapa de destino tiene automatizaciones, puedes mover a los candidatos sin activarlas. Consulta [Mover candidatos sin activar automatizaciones](https://help.join.com/help-center/es/review-candidates/automations.md#mover-candidatos-sin-activar-automatizaciones).

No hay una columna `Acciones` con un icono de rechazo o de más opciones por fila. Selecciona la casilla del candidato y usa la barra de herramientas inferior.

**Mover candidatos entre etapas**

Para mover a un candidato a otra etapa:

* Haz clic en el desplegable `Etapa` de la fila del candidato
* Selecciona la etapa del pipeline que quieras

La solicitud pasa inmediatamente a la etapa seleccionada.

**Ver documentos y enlaces**

* Haz clic en el `CV` (u otro documento) de la columna `Documentos` para previsualizarlo directamente
* Haz clic en un enlace de la columna `Enlaces` para abrir el perfil de LinkedIn, el portfolio u otro perfil profesional del candidato

**Navegar por la tabla**

La tabla permite navegar en vertical y en horizontal:

* Desplázate arriba y abajo para ver las solicitudes
* Desplázate a izquierda y derecha para ver las columnas adicionales que hayas activado

Usa la opción `Restablecer` del menú `Configuración de la vista` para restaurar la configuración predeterminada.
{% endtab %}
{% endtabs %}

***

## Filtrar solicitudes

**Para filtrar solicitudes:**

1. Ve a la subpestaña `Candidaturas`
2. Haz clic en el botón `Filtros`
3. Usa los filtros disponibles: `Etapa del pipeline`, `Fecha de candidatura`, `Etiquetas`, `País del candidato`, `Fuente`

**Filtrar por nombre de etapa del pipeline:**

1. Haz clic en `Filtros`
2. Selecciona `Etapa del pipeline`
3. Elige una o varias etapas

Esto te ayuda a centrarte en un paso concreto del proceso, sobre todo en pipelines con mucho volumen.

***

## Ver solicitudes activas y rechazadas

Usa el conmutador `Activo / Rechazado` de la parte superior de la vista para alternar entre:

* Solicitudes `Activo`
* Solicitudes `Rechazado`

Ambas pestañas muestran el número total de solicitudes de ese filtro.

Usa la opción `Deshacer rechazo` <i class="fa-arrow-turn-left">:arrow-turn-left:</i> para devolver candidatos desde `Rechazado` a la etapa en la que se rechazaron. Los candidatos rechazados por una pregunta eliminatoria en `Candidatura recibida` pasan a `Revisión de candidaturas`.

***

## Preguntas frecuentes

<details>

<summary>¿Puedo deshacer el rechazo de un candidato?</summary>

Usa la opción `Deshacer rechazo` <i class="fa-arrow-turn-left">:arrow-turn-left:</i> para devolver candidatos desde `Rechazado` a la etapa en la que se rechazaron. Los candidatos rechazados por una pregunta eliminatoria en `Candidatura recibida` pasan a `Revisión de candidaturas`.

</details>

<details>

<summary>¿Qué pasa cuando elimino una solicitud?</summary>

Ya no puedes eliminar una solicitud individual desde la vista `Candidaturas` de una oferta. Para eliminar de forma permanente a un candidato y todas sus solicitudes, ve a la pestaña `Candidatos` y usa `Eliminar candidatos`. Esta acción es irreversible.

</details>

<details>

<summary>¿Puedo usar acciones masivas en las solicitudes?</summary>

Sí. Selecciona varios candidatos para `Mover a...`, `Rechazar`, `Etiqueta` o `Exportar`.

</details>

<details>

<summary>¿Cómo filtro solicitudes por etapa o estado?</summary>

Haz clic en `Filtros` en la subpestaña `Candidaturas` y usa campos como `Etapa del pipeline`, `Etiquetas`, `País del candidato` o `Fuente`.

</details>

<details>

<summary>¿Los candidatos reciben una notificación cuando se les mueve entre etapas?</summary>

No. JOIN no envía notificaciones automáticas, a menos que hayas configurado determinadas automatizaciones disponibles.

</details>

<details>

<summary>¿Puedo eliminar una plantilla de pipeline?</summary>

No. Los pipelines solo se pueden archivar, no eliminar. Las ofertas que ya usan un pipeline cuando se archiva lo conservan.

</details>

<details>

<summary>¿Por qué no veo la etapa "Candidatura recibida" en ningún sitio?</summary>

`Candidatura recibida` solo aparece cuando un candidato ha sido rechazado automáticamente por una pregunta de filtrado antes de llegar a `Revisión de candidaturas`. Si no hay nadie en ese estado, la etapa permanece oculta. Para ver las solicitudes rechazadas en la etapa `Candidatura recibida`:

* Selecciona la oferta
* Ve a la pestaña `Rechazado`
* Consulta las solicitudes de la etapa `Candidatura recibida`

</details>

<details>

<summary>¿Puedo cambiar el tipo de una etapa después de crearla?</summary>

No. El `Tipo de etapa` se define una vez y no se puede editar. Elimina la etapa y crea una nueva con el tipo que quieras.

</details>

<details>

<summary>¿Puedo editar el pipeline de una oferta después de publicarla?</summary>

Sí. Puedes editar una plantilla de pipeline en `Configuración` > `Pipelines` en cualquier momento, incluso para ofertas que ya están publicadas. Los cambios se aplican de inmediato a todas las ofertas que usan esa plantilla.

Si ya tienes solicitudes en esa etapa, se te pedirá que elijas otra etapa de ese pipeline a la que moverlas.

</details>

<details>

<summary>¿Puedo seguir usando un pipeline después de archivarlo?</summary>

Las ofertas que ya lo usan siguen funcionando con normalidad, y verás el pipeline marcado como archivado en el desplegable de pipeline de esa oferta. No podrás seleccionarlo para ofertas nuevas ni convertirlo en predeterminado, y tendrás que restaurarlo antes de editar sus etapas.

</details>


---

# 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://help.join.com/help-center/es/review-candidates/pipeline-management.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.
