Instalación en Windows

El Agent de Zoan Automation se instala junto con el resto de la plataforma (Designer y el motor que comparten, el Runner) 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 Zoan Cloud.
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 quien administra Zoan Cloud en tu organización, que lo descarga del portal.
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. Install location

   Alcance de la instalación:

   Opción	Detalle	Cuándo elegirla
   All users	Instala para todos los usuarios de Windows. Requiere admin. Es la única que permite el servicio de Windows para ejecución desatendida.	Servidores y máquinas dedicadas a ejecutar bots desatendidos.
   Current user only	Instala solo para tu cuenta. No requiere admin. El Agent arranca en la bandeja al iniciar sesión (entrada en HKCU\...\Run).	Equipos de desarrollo, ejecución atendida, 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: %LOCALAPPDATA%\Zoan (por ejemplo C:\Users\<TuUsuario>\AppData\Local\Zoan)

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

   

   Clic en Next.

3. Select components

   Componente	Qué hace	Por defecto
   Zoan Designer	Editor visual de playbooks, con su motor para probarlos en local.	Marcado. Desmárcalo en servidores que solo ejecutan bots.
   Zoan Agent	Conecta la máquina a Zoan Cloud y ejecuta los bots. Tiene icono en la bandeja para ejecuciones manuales y remotas.	Marcado. Desmárcalo en equipos que solo diseñan.
   Zoan Agent Service	Registra el Agent como servicio de Windows (ZoanAgentService) con arranque automático, para ejecución desatendida. Requiere el Agent.	Desmarcado. Solo disponible con All users.
   Zoan UI Discover (extensión del navegador)	Chrome o Edge la instalan desde la Chrome Web Store, con tu confirmación. Sin ella, UI Discover no captura selectores en páginas web; escritorio, Java y SAP siguen funcionando.	Marcado.

   El motor que comparten Designer y Agent (el Runner) se instala siempre, no es una opción.

   

   Clic en Install. Con All users, Windows pide permiso de administrador.

4. Installing

   Barra de progreso con el detalle de qué está copiando: los ejecutables, los paquetes de actividades, los accesos directos y, según lo que elegiste, la extensión del navegador, el inicio automático del Agent (Current user only) o el servicio ZoanAgentService (Agent Service).

   

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

5. Finish

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

   • Accesos directos en el menú Inicio y en el Escritorio: Zoan Designer y Zoan Agent.
   • Una entrada en Configuración → Aplicaciones llamada «Zoan Platform», para desinstalar.
   • Con Current user only, el inicio automático del Agent en la bandeja al iniciar sesión.
   • Con Agent Service, el servicio ZoanAgentService registrado y en marcha.

   

   Clic en Launch Designer para abrirlo, o cierra el instalador.

Conectar el Agent a Zoan Cloud

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

1. Abre Zoan Agent desde el menú Inicio.

2. Pantalla de vinculación

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

   • URL de Zoan Cloud — la URL de tu portal (ej. https://acme.cloud.zoansoftware.com). Cópiala tal como aparece en el navegador.
   • Machine Key — la clave que muestra el portal al crear la máquina con Nueva máquina en Centro › Máquinas.

   

3. Pega los valores y clic en «Vincular este equipo»

   El Agent contacta a Zoan Cloud, 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

   Abre Centro › Máquinas en el ambiente. 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 vinculación 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 Zoan Cloud de una máquina compartida.

Gestionar el servicio Windows

Cuando instalas con All users y marcas Zoan Agent Service, 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 Zoan Cloud puede dirigir ejecuciones tanto al modo atendido como al desatendido, según cómo configures los procesos.

Actualizar el Agent

El instalador deja activas las actualizaciones automáticas (servicio Zoan Update Service): el Agent se actualiza solo cuando no tiene ejecuciones en curso, sin cerrar nada por su cuenta, y conserva la conexión a Zoan Cloud. Cuando hay una versión lista, la persona ve el aviso Actualización de Zoan lista con Instalar ahora o Más tarde, y en el menú de la bandeja aparece Actualizar: Agent vX. En el portal, el detalle de la máquina muestra la versión instalada y la disponible. Ver Configuración › Actualizaciones automáticas.

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 «Vincular este equipo» está deshabilitado	El Agent se abrió como usuario normal	Cerralo y reabrilo como administrador (clic derecho → Ejecutar como administrador)
“No se pudo contactar a Zoan Cloud”	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 Zoan Cloud. 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.