> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getnexor.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Pipeline y operación del Agente

> Monitorea leads por etapa, entiende las pausas del Agente y de cada lead, administra la propiedad y archiva o restaura un Agente de forma segura.

Abre un Agente desde la navegación principal para entrar a su **Pipeline**. El tablero muestra en qué parte del proceso está cada lead y las señales que explican qué ocurrirá después.

<Info>
  Usa **Pipeline** para monitorear y abrir leads. Usa **Ajustes** para definir, reordenar o eliminar etapas. Consulta [Configuración del agente](/docs/es/guides/agents/settings#pipeline) para conocer el constructor de etapas.
</Info>

## Usa el header del Agente

El header se mantiene disponible dentro del espacio de trabajo del Agente:

| Control              | Qué hace                                                                                              |
| -------------------- | ----------------------------------------------------------------------------------------------------- |
| **Pipeline**         | Abre el tablero de este Agente.                                                                       |
| **Ajustes**          | Abre la configuración del Agente.                                                                     |
| **Activo / Pausado** | Activa o pausa el Agente para todos sus leads reales.                                                 |
| Opciones del Agente  | Abre acciones como Renombrar, Mover a grupo, propietarios, Copiar ID del agente, Duplicar y Eliminar. |
| **Playground**       | Abre una conversación de prueba sin contactar a un lead real.                                         |

Las opciones visibles dependen del rol de la persona, del tipo de Agente y de si la propiedad del Agente está bloqueada.

## Activo y pausado

El header muestra **Activo** solo cuando el Agente está activo y no está pausado. Al apagar el switch, Nexor pide confirmación antes de pausarlo para todos los leads.

| Estado      | Contacto programado                                                   | Respuestas a leads reales                                           | Asignación de leads nuevos                                                                          | Playground                     |
| ----------- | --------------------------------------------------------------------- | ------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | ------------------------------ |
| **Activo**  | Se ejecuta según la cadencia y los horarios de contacto configurados. | El Agente puede responder cuando el lead y la etapa sean elegibles. | Puede comenzar una ejecución.                                                                       | Disponible.                    |
| **Pausado** | Se detiene el contacto programado pendiente.                          | El Agente no genera una respuesta de IA.                            | El lead y su ejecución del Agente todavía se pueden crear, pero el contacto espera la reactivación. | Sigue disponible para pruebas. |

Cuando reactivas el Agente, Nexor reanuda las ejecuciones que pausó este switch general. No anula una pausa manual del lead, un opt-out, una secuencia de seguimiento agotada ni otra detención específica del lead.

<Warning>
  El ícono de pausa en una tarjeta indica que la automatización está pausada para ese lead. No significa que todo el Agente esté pausado. Revisa el switch **Activo / Pausado** del header para conocer el estado general.
</Warning>

La activación puede quedar bloqueada hasta que se cumplan las revisiones requeridas de calidad o de configuración de reuniones. El dashboard indica qué revisiones fallaron para que puedas corregirlas antes de volver a intentar.

## Encuentra leads en el tablero

La búsqueda encuentra coincidencias por nombre, email o teléfono. En teléfonos, ignora los caracteres de formato, por lo que una secuencia parcial de dígitos también puede coincidir.

El menú **Filtros** puede incluir:

* Canales
* Recontacto programado, con o sin un contacto futuro
* Variables, cuando las variables de leads están habilitadas y hay valores disponibles
* Tags, cuando los leads de este Agente tienen tags
* Rango de fechas
* **Mostrar test**, para incluir los [leads de prueba](/docs/es/guides/agents/leads/test-leads)

Los filtros activos aparecen como chips que puedes quitar. Selecciona **Limpiar todo** para restablecer los filtros de leads. Ocultar una columna es distinto a filtrar leads, y la selección de columnas ocultas se guarda solo en el navegador actual para ese Agente.

## Lee las columnas y tarjetas

El tablero organiza las columnas en tres fases:

| Fase            | Qué contiene                                                                             |
| --------------- | ---------------------------------------------------------------------------------------- |
| **En progreso** | Las etapas de trabajo no terminales del Agente.                                          |
| **En espera**   | La etapa opcional **Escalado a ejecutivo** cuando está presente y corresponde mostrarla. |
| **Terminal**    | Los resultados terminales y la columna derivada **Descartado**.                          |

Cada columna muestra la cantidad de leads y puede cargar más tarjetas. Abre el menú de la columna para ocultarla; usa **Etapas ocultas** para restaurar una o todas las columnas ocultas. Esto solo cambia el tablero en el navegador actual, no la configuración de etapas del Agente.

Selecciona una tarjeta para abrir el lead. Las tarjetas no se pueden arrastrar entre columnas. Para cambiar la etapa de un lead, ábrelo y elige ahí la etapa nueva.

### Señales de una tarjeta

Una tarjeta comienza con el nombre del lead, la actividad más reciente, el dato de contacto y los íconos de canales. Según el lead, también puede mostrar tags, hasta cuatro variables recopiladas, la persona asignada y el próximo contacto o recordatorio programado.

Presta especial atención a estas señales:

| Señal                              | Significado                                                                                                                                             |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Prueba**                         | La tarjeta pertenece a un lead de prueba o sandbox.                                                                                                     |
| Ícono de transferencia             | El lead tiene ejecuciones en más de un Agente.                                                                                                          |
| Ícono de pausa                     | La automatización está pausada para este lead.                                                                                                          |
| Advertencia de contacto o entrega  | El teléfono o email no es válido, o falló el último envío. Un fallo de entrega de WhatsApp usa el ícono de WhatsApp; pasa el cursor para ver el motivo. |
| **Recontacto detenido**            | Nexor no programará otro seguimiento para la ejecución actual.                                                                                          |
| Contacto o recordatorio programado | Muestra el próximo contacto conocido de la cadencia, tarea o recordatorio.                                                                              |

## Administra las acciones del Agente

Abre el menú de opciones del Agente en el header:

| Acción                       | Qué ocurre                                                                                                                     |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| **Renombrar**                | Cambia el nombre visible del Agente.                                                                                           |
| **Mover a grupo**            | Mueve el Agente a un Grupo existente, lo quita de su Grupo actual con **Sin grupo** o crea un Grupo nuevo.                     |
| **Bloqueado / Desbloqueado** | Abre **Propietarios y acceso** para administrar propietarios, asociar Equipos y cambiar el bloqueo de edición en el dashboard. |
| **Copiar ID del agente**     | Copia el identificador del Agente para llamadas a la API, integraciones o soporte.                                             |
| **Duplicar**                 | Crea una copia pausada después de indicar el nombre del Agente nuevo. Revisa la copia antes de activarla.                      |
| **Eliminar**                 | Archiva el Agente después de la confirmación. No borra su historial de forma permanente.                                       |

### Define la propiedad y bloquea la edición

En **Propietarios y acceso**, agrega al menos un propietario antes de seleccionar **Bloquear**. También puedes asociar Equipos al Agente. Mientras el Agente está bloqueado, el dashboard limita algunas acciones de edición a sus propietarios registrados; los demás controles siguen sus propias reglas de rol y tipo de Agente. Selecciona **Bloqueado** desde el menú de opciones para abrir el mismo diálogo y desbloquearlo.

<Note>
  El bloqueo restringe algunas acciones de edición en el dashboard. No es un límite de permisos de la API ni un bloqueo completo del ciclo de vida, y no cambia qué persona está asignada a un lead ni quién puede recibir reuniones.
</Note>

## Archiva y restaura un Agente

El menú llama a la acción **Eliminar**, pero la operación archiva el Agente.

Si el Agente todavía tiene leads reales activos, la confirmación los muestra en una lista. Puedes abrir un lead y moverlo a otro Agente, o elegir un motivo opcional de descarte y usar la acción que descarta los leads de la lista antes de archivar.

Archivar tiene más efectos que ocultar el Agente:

* El Agente queda inactivo y pausado.
* Sus ejecuciones activas se desactivan y se cancelan las tareas de seguimiento pendientes.
* Se liberan sus asignaciones de canales.
* El historial del Agente permanece guardado.

Para restaurarlo:

<Steps>
  <Step title="Muestra los Agentes archivados">
    En la navegación principal, abre las opciones junto a la lista de Agentes y selecciona **Mostrar archivados**.
  </Step>

  <Step title="Abre el Agente archivado">
    Selecciona el Agente archivado. Su espacio de trabajo muestra un aviso de archivo en vez del tablero activo.
  </Step>

  <Step title="Selecciona Desarchivar">
    El Agente vuelve en estado pausado e inactivo.
  </Step>

  <Step title="Revisa antes de activar">
    Reconecta o reasigna los canales necesarios, revisa la configuración y luego activa el Agente. Desarchivar no restaura los canales liberados, las ejecuciones anteriores ni las tareas canceladas.
  </Step>
</Steps>

## Descarta un lead

**Descartado** es una columna derivada del sistema, no una etapa que se pueda editar o reordenar. Puede contener leads descartados por una persona y leads cuya cadencia de seguimiento se agotó. Descartar un lead manualmente conserva el lead y su historial, pero termina la ejecución actual del Agente y cancela sus tareas de seguimiento pendientes.

Para descartar un lead, ábrelo, cambia su etapa a **Descartado** y elige uno de estos motivos obligatorios:

* Sin respuesta del lead
* El lead declaró explícitamente no tener interés
* Datos de contacto inválidos o equivocados
* Inasistencias o cancelaciones reiteradas
* Otro motivo

También puedes agregar una nota opcional. El motivo permanece en el historial del lead y en los reportes. Si el lead debe trabajarse de nuevo más adelante, moverlo a una etapa de trabajo no terminal puede reactivar la ejecución; descartar no equivale a eliminar ni archivar el lead.
