Instalación en Windows

El Agent de Zoan se instala junto con el resto de la plataforma (Designer, Runner, Session Capture) usando un único instalador: Zoan Platform Setup. Esta página cubre la instalación detallada en Windows, las decisiones del wizard y cómo gestionar el servicio Windows que ejecuta el Agent en modo desatendido.

Requisitos

Requisito	Detalle
Sistema operativo	Windows 10 (build 1809+) o Windows 11. Windows Server 2016, 2019 o 2022.
Arquitectura	x64 únicamente. ARM64 no soportado por ahora.
Memoria	4 GB mínimo. Recomendado 8 GB+ si vas a ejecutar varios bots concurrentes.
Disco	500 MB libres para la instalación. El espacio adicional depende de los paquetes que descargues.
Permisos	Administrador local si quieres instalar el Agent como servicio (recomendado para servidores). Usuario normal si solo lo necesitas para tu sesión.
Red	Acceso saliente al puerto 443 (HTTPS) hacia tu instancia de Nexus.
Runtime .NET	El instalador descarga e instala automáticamente .NET 8 Desktop Runtime si falta.
WebView2	El instalador descarga e instala automáticamente Microsoft Edge WebView2 Runtime si falta.

Servidores corporativos con proxy

Si tu red corporativa requiere proxy para salir a internet, el Agent respeta la configuración de proxy del sistema. Asegúrate de que el usuario bajo el cual se ejecuta el servicio (LocalSystem por defecto) tenga acceso al proxy o configura un proxy explícito en las opciones avanzadas (próximamente documentado).

Descargar el instalador

El archivo es ZoanPlatformSetup.exe (~80-120 MB). Hay tres formas de obtenerlo:

1. Desde el portal del tenant: hay un enlace de descarga en el header y en la página de cada agente.
2. Desde el correo de activación que recibiste al activar tu tenant.
3. Pedírselo a soporte: soporte@zoansoftware.com.

El wizard de instalación

Al ejecutar ZoanPlatformSetup.exe, Windows pregunta si quieres permitir cambios (UAC). Acepta.

Antes de mostrar el wizard, el instalador hace dos verificaciones automáticas:

1. .NET 8 Desktop Runtime — si no está, te ofrece descargarlo y lo instala en background.
2. Microsoft Edge WebView2 Runtime — idem.

Si aceptas ambas instalaciones, el wizard se abre cuando terminan. Si declinas, el instalador se cierra (no puede continuar sin esos componentes).

A partir de aquí tienes 5 pasos:

1. Welcome

   Pantalla de bienvenida con un resumen de qué hace el instalador y enlaces a los términos legales.

   

   Nota

   Al instalar aceptas los Términos de Servicio y la Política de Privacidad.

   Clic en Get started.

2. Select components

   Lista de componentes a instalar, todos seleccionados por defecto:

   Componente	Qué hace	Cuándo desmarcarlo
   Zoan Designer	IDE visual para diseñar playbooks.	En servidores que solo ejecutan bots desatendidos.
   Zoan Agent	Runtime que ejecuta los bots y se conecta a Nexus.	En máquinas que solo se usan para diseñar (no para ejecutar bots de Nexus).
   Zoan Runner	Motor de ejecución. Necesario para que Designer y Agent funcionen.	Nunca — Designer y Agent dependen de él.
   Session Capture	Utilidad que graba la pantalla durante ejecuciones desatendidas (para auditoría).	Si no quieres grabaciones.

   

   Clic en Next.

3. Install location

   Dos decisiones acopladas:

   Scope (alcance de la instalación):

   Opción	Detalle	Cuándo elegirla
   All users	Instala para todos los usuarios de Windows. Requiere admin. Registra el Agent como servicio Windows (ZoanAgentService) con arranque automático al boot.	Servidores y máquinas dedicadas a ejecutar bots desatendidos 24/7.
   Current user only	Instala solo para tu cuenta. No requiere admin. El Agent arranca al iniciar sesión (entrada en HKCU\...\Run), no como servicio.	Equipos de desarrollo, máquinas compartidas, o cuando no tienes permisos de admin.

   Destination folder: dónde se copian los archivos. Por defecto:

   • All users: C:\Program Files\Zoan\
   • Current user only: C:\Users\<TuUsuario>\AppData\Local\Programs\Zoan\

   Puedes cambiarla con Browse… si necesitas instalar en otra unidad o ruta corporativa.

   

   Clic en Next.

4. Installing

   Barra de progreso con el detalle de qué está copiando. El log de la parte inferior muestra cada paso:

   Extrayendo Designer...
   Extrayendo Agent...
   Extrayendo Runner...
   Extrayendo Session Capture...
   Creando accesos directos del Designer...
   Creando accesos directos del Agent...
   Configurando inicio automático del Agent...
   Registrando servicio ZoanAgentService...  (solo con All users)
   Iniciando servicio ZoanAgentService...     (solo con All users)

   

   La instalación toma 30-90 segundos según la velocidad del disco.

5. Done

   Confirmación con un check verde. La instalación creó:

   • Accesos directos en el menú Inicio: Zoan Designer y Zoan Agent.
   • Accesos directos en el Escritorio.
   • Una entrada en Configuración → Aplicaciones llamada “Zoan Platform” para desinstalación futura.
   • (Si elegiste All users) el servicio ZoanAgentService registrado y ejecutándose.
   • (Si elegiste Current user only) una entrada en HKCU\Software\Microsoft\Windows\CurrentVersion\Run que abre el Agent al iniciar sesión.

   

   Clic en Finish. El instalador se cierra.

Conectar el Agent a Nexus

La configuración de la conexión a tu instancia de Nexus se hace desde la interfaz del Agent, no editando archivos.

1. Abre Zoan Agent desde el menú Inicio.

2. Pantalla “Conectar este equipo”

   La primera vez te recibe esta pantalla. Tiene dos campos:

   • URL de Nexus — la URL de tu portal (ej. https://acme.nexus.zoansoftware.com). Debe empezar con https:// y sin slash final.
   • Machine Key — la clave generada al crear el agente en el portal (formato UUID, 36 caracteres con guiones).

   

3. Pega los valores y clic en “Conectar con Nexus”

   El Agent contacta a Nexus, valida la Machine Key, y guarda la configuración cifrada en disco. Si todo va bien, en 2-3 segundos cambia a la pantalla principal con el status pill connected en verde.

   

4. Verifica desde el portal

   Ve al entorno → Agentes. El agente debe figurar como online (badge verde) y el contador “Online” arriba debe haberse incrementado.

   

Pantalla de configuración solo con admin

La pantalla de “Conectar este equipo” requiere que el Agent se haya abierto como administrador para guardar la configuración en una ubicación protegida. Si se abre como usuario normal, la pantalla se muestra pero el botón aparece deshabilitado y se ve una advertencia para reabrir como admin. Esto evita que un usuario sin privilegios cambie la conexión de Nexus de una máquina compartida.

Gestionar el servicio Windows

Cuando eliges All users durante la instalación, el Agent se registra como servicio. Comandos útiles desde PowerShell con admin:

# Estado del servicio
Get-Service ZoanAgentService

# Detener
Stop-Service ZoanAgentService

# Iniciar
Start-Service ZoanAgentService

# Reiniciar
Restart-Service ZoanAgentService

# Cambiar a inicio manual (no arranca con Windows)
Set-Service ZoanAgentService -StartupType Manual

# Volver a automático
Set-Service ZoanAgentService -StartupType Automatic

Logs del servicio: C:\ProgramData\Zoan\Agent\logs\service.log — útil para diagnosticar problemas cuando el Agent no aparece como online sin razón aparente.

Modos de ejecución

El Agent puede operar en dos modos según cómo se haya instalado y abierto:

Modo	Cómo se activa	Características
Atendido	Abres Zoan Agent desde el escritorio o el menú. La UI se muestra.	Necesita una sesión de Windows abierta. Ideal para automatizaciones que requieren ver la pantalla (ej. capturas, supervisión).
Desatendido (servicio)	El servicio ZoanAgentService se ejecuta en background bajo la cuenta LocalSystem.	No necesita sesión abierta. Arranca con el sistema. Limitaciones para automatizaciones de UI que requieran sesión interactiva.

El portal de Nexus puede dirigir ejecuciones tanto al modo atendido como al desatendido, según cómo configures los procesos.

Actualizar el Agent

Cuando hay una nueva versión, el Agent puede:

• Notificarte desde la bandeja del sistema (modo atendido) — clic derecho en el ícono → Actualizar ahora.
• Actualizarse automáticamente durante una ventana de mantenimiento configurada (próximamente).

Las actualizaciones son in-place: descarga el nuevo .exe, lo verifica, reemplaza el binario y reinicia el servicio. No requiere reconfigurar la conexión a Nexus.

Desinstalación

Tres formas:

1. Configuración → Aplicaciones → Zoan Platform → Desinstalar (recomendado).
2. Panel de Control → Programas → Zoan Platform → Desinstalar.
3. Ejecutar ZoanPlatformSetup.exe --uninstall desde una consola con admin.

El uninstaller usa un wizard de 3 pasos:

1. Confirm — confirma qué componentes están instalados y se van a borrar.
2. Removing — barra de progreso. Detiene y desregistra ZoanAgentService, borra accesos directos, elimina archivos.
3. Done — confirmación.

Nota

La desinstalación no borra los logs de operación en C:\ProgramData\Zoan\ ni los paquetes instalados en el directorio de paquetes. Borralos manualmente si quieres una limpieza total.

Solución de problemas

Síntoma	Causa probable	Cómo resolver
El instalador no abre	Falta .NET 8 o WebView2 y la descarga falló	Instala manualmente desde dotnet.microsoft.com y developer.microsoft.com/microsoft-edge/webview2
”Acceso denegado” durante la instalación	Elegiste “All users” sin admin	Cierra y reabrí el instalador como administrador, o elige “Current user only”
El Agent no aparece después de instalar	No estás mirando el menú correcto. En “Current user” solo aparece en el menú Inicio de tu usuario; en “All users” aparece para todos.	Busca “Zoan Agent” desde el menú Inicio
El botón “Conectar con Nexus” está deshabilitado	El Agent se abrió como usuario normal	Cerralo y reabrilo como administrador (clic derecho → Ejecutar como administrador)
“No se pudo contactar a Nexus”	Firewall, proxy, URL incorrecta	Verifica la URL, prueba abrirla desde Edge en la misma máquina. Si hay proxy corporativo, configura el proxy del sistema
El Agent dice “connected” pero el portal lo muestra offline	Heartbeat bloqueado en la red	Verifica que el puerto 443 está abierto outbound desde la máquina del Agent hacia Nexus. WebSockets tampoco bloqueados
El servicio ZoanAgentService no arranca	Permisos o cuenta de servicio cambiada	Get-EventLog -LogName System -Newest 20 para ver el error específico

Si nada de lo anterior resuelve, revisa C:\ProgramData\Zoan\Agent\logs\service.log (modo servicio) o C:\Users\<TuUsuario>\AppData\Local\Zoan\Agent\logs\ (modo atendido) y contactanos en soporte@zoansoftware.com con las últimas 50 líneas del log.