Primeros pasos

Esta guía te lleva desde cero conocimiento hasta tener tu primera automatización funcionando. Está pensada para alguien que nunca ha usado Zoan Nexus — y casi nadie ha tocado RPA antes. Cada paso explica qué vas a ver, qué tienes que hacer, y qué errores comunes pueden aparecer.

Al terminar vas a tener:

• Una cuenta de Zoan Nexus en tu propio subdominio.
• El Agent instalado y conectado en tu máquina Windows.
• Tu primer playbook diseñado, publicado y ejecutado con éxito.
• Logs de la ejecución visibles en el portal.

Tiempo estimado: 30 a 45 minutos la primera vez. Después, crear una nueva automatización toma minutos.

¿Qué necesitas?

• Una máquina con Windows 10 u 11 (o Windows Server 2016+) donde quieras que se ejecuten tus bots.
• Permisos de administrador en esa máquina (para instalar el Agent y registrarlo como servicio).
• Una conexión a internet estable.
• 15 minutos de paciencia con el wizard de instalación.

Visión general del flujo

Antes de meter las manos, así se ve el camino completo:

1. Solicitas tu cuenta de Nexus — recibimos tu correo y activamos tu tenant (un subdominio propio para tu organización).
2. Entras al portal — https://tu-empresa.nexus.zoansoftware.com con el correo y contraseña que te enviamos.
3. Creas un entorno (“Producción” o “Pruebas”) y dentro creas un agente, que te genera una Machine Key.
4. Descargas el Zoan Platform Setup y lo instalas con el wizard — incluye Designer y Agent en un solo paquete.
5. Abres Zoan Agent, pegas la URL y la Machine Key, y conectas.
6. Abres Zoan Designer, creas un proyecto, arrastras actividades al canvas y configuras parámetros.
7. Publicas el playbook al portal, lo asocias a un proceso del entorno, y lo ejecutas.
8. Ves los logs en tiempo real desde el portal.

A partir de aquí te llevamos paso a paso.

---

1. Conseguir tu cuenta de Nexus

Por ahora Zoan Nexus se entrega con acompañamiento: no hay registro automático desde la web. Esto nos permite asegurarnos de que recibes el tenant configurado correctamente, con tu plan asignado y un canal de soporte abierto desde el primer día.

1. Solicita tu cuenta

   Escribe a contacto@zoansoftware.com o llena el formulario en zoansoftware.com/contacto. Indica:

   • Nombre de tu organización.
   • Subdominio que quieres usar (ej. acme → acme.nexus.zoansoftware.com).
   • Plan de interés (Free, Starter, Pro).
   • Nombre y correo del primer usuario administrador.

2. Espera la activación

   En menos de un día hábil te llega un correo con:

   • URL de tu portal: https://tu-empresa.nexus.zoansoftware.com
   • Usuario y contraseña temporal.
   • Enlace para descargar el instalador.

   

---

2. Primer ingreso al portal

1. Abre la URL que llegó en el correo (https://tu-empresa.nexus.zoansoftware.com).

   

2. Inicia sesión con el correo y la contraseña temporal.

3. Cambia tu contraseña cuando el sistema te lo pida. Usa una contraseña fuerte: el portal guarda credenciales sensibles de tus sistemas.

4. Aterrizas en el Dashboard del tenant. Vas a ver un resumen vacío — todavía no hay entornos ni ejecuciones.

   

---

3. Crear tu primer entorno

Un entorno (environment) es un espacio aislado donde viven los recursos: agentes, procesos, credenciales, ejecuciones. Lo típico es tener Producción, Pruebas y Desarrollo separados, pero para empezar con uno alcanza.

1. Ve a Environments en el menú lateral izquierdo.

2. Clic en “Nuevo entorno” (botón arriba a la derecha).

   

3. Llena el formulario:

   • Nombre: Pruebas (cambiable después).
   • Descripción: opcional.

   

4. Guardar. El entorno queda creado y entras directo a su detalle.

---

4. Crear un agente dentro del entorno

El agente representa la máquina física o virtual donde van a ejecutarse los bots. Cuando lo creas en el portal, te devuelve una Machine Key — una clave que el Agent (la app desktop) usa para identificarse contra Nexus.

1. Dentro del entorno, haz clic en la pestaña Agentes (es la primera pestaña, marcada con un ícono de robot).

2. Clic en “Crear agente” (o ”+”).

   

3. Ingresa un nombre para el agente. Convención: nombre identificable de la máquina (ej. WIN-CONTABILIDAD-01, VM-AUTOMATION-EU-01).

   

4. Guardar. Inmediatamente aparece un modal con la Machine Key:

   

   ¡Importante!

   La Machine Key solo se muestra una vez. Cópiala con el botón a la derecha de cada campo y pégala en un lugar seguro temporal (notepad, gestor de contraseñas) — la necesitas en el siguiente paso. Si la pierdes, tienes que regenerarla y reconfigurar el Agent.

5. Copia la Machine Key con el botón de copiar. También anotá el agentId (te sirve para referenciar el agente desde la API).

6. Cierra el modal. El agente aparece en la lista con estado offline — todavía no hay nada conectado del lado de la máquina.

---

5. Descargar e instalar Zoan Platform

Zoan Platform es un único instalador que trae el Designer + el Agent. No hay instaladores separados.

1. Descarga el instalador

   Hay dos formas:

   • Desde el portal: hay un enlace de descarga en el header del tenant o en la página de cada agente.
   • Desde el correo de activación: incluye el enlace directo.

   El archivo es ZoanPlatformSetup.exe, aproximadamente 80–120 MB.

   

2. Ejecútalo como administrador

   Doble clic en ZoanPlatformSetup.exe. Windows pregunta si quieres permitir cambios — clic en Sí.

   Consejo

   Si la máquina es compartida y quieres que el Agent se ejecute como servicio (para que arranque automáticamente con Windows), necesitas ejecutarlo como administrador. Si solo lo vas a usar tú en tu sesión, puedes elegir “Current user only” en el wizard y no necesitas admin.

3. Verificación automática de dependencias

   Antes de mostrar el wizard, el instalador chequea dos cosas:

   • .NET 8 Desktop Runtime (necesario para que las apps Windows funcionen).
   • Microsoft Edge WebView2 Runtime (motor de browser embebido que usa la UI).

   Si alguna falta, el instalador te pregunta si quieres descargarla. Acepta — la instalación es transparente.

4. Wizard de instalación (5 pasos)

   Paso 1: Welcome

   Pantalla de bienvenida con un enlace a los Términos de Servicio y la Política de Privacidad. Clic en Get started.

   

   Paso 2: Components

   Lista de componentes a instalar. Por defecto vienen todos seleccionados:

   • Zoan Designer — IDE visual para diseñar playbooks.
   • Zoan Agent — runtime que ejecuta los bots.
   • Zoan Runner — motor de ejecución (necesario para que Designer y Agent se ejecuten playbooks).
   • Session Capture — utilidad para grabar la pantalla durante ejecuciones desatendidas.

   Si esta máquina solo va a ejecutar bots (no diseñar), puedes desmarcar Designer. Si solo la usas para diseñar (no para ejecutar bots de Nexus), puedes desmarcar Agent.

   

   Clic en Next.

   Paso 3: Install location

   Dos decisiones:

   • Scope:

     • All users — instala para todos los usuarios de Windows. Requiere admin. Recomendado para servidores donde el Agent debe arrancar como servicio.
     • Current user only — solo tu cuenta de Windows. No requiere admin, pero el Agent no arranca automáticamente al boot — solo cuando entras a tu sesión.

   • Destination folder — dónde se instalan los archivos. Por defecto:

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

   

   Clic en Next.

   Paso 4: Installing

   Barra de progreso con el detalle de qué está copiando. Si elegiste All users, en este paso también:

   • Crea el servicio Windows ZoanAgentService.
   • Lo configura para arrancar automáticamente con el sistema.
   • Lo inicia inmediatamente.

   Si elegiste Current user only, configura el inicio automático del Agent UI vía el registro de Windows (HKCU\...\Run).

   

   Paso 5: Done

   Confirmación de instalación exitosa con un check verde. Clic en Finish.

   El instalador crea:

   • Accesos directos en Inicio → Zoan Designer y Inicio → Zoan Agent.
   • Accesos directos en el escritorio (opcional).
   • Una entrada en Agregar o quitar programas llamada “Zoan Platform” para desinstalación futura.

   

---

6. Conectar el Agent a Nexus

Aquí usas la Machine Key que copiaste en el paso 4.

1. Abre Zoan Agent desde el menú Inicio o el ícono del escritorio.

2. Pantalla “Conectar este equipo”

   La primera vez que abres el Agent, te recibe esta pantalla. Hay dos campos:

   • URL de Nexus — la URL de tu portal (ej. https://acme.nexus.zoansoftware.com).
   • Machine Key — la clave que copiaste del portal.

   

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

   El Agent valida la URL, contacta a Nexus, registra la conexión y guarda la configuración. Si todo va bien, en 2-3 segundos cambia a la pantalla principal.

   

4. Verifica que aparece como online en el portal

   Volvé al portal del tenant, entra al entorno → pestaña Agentes. El agente que creaste antes debería figurar ahora con estado online (verde) en lugar de offline.

   

Errores comunes

• “No se pudo conectar”: verifica que la URL es exacta (con https:// y sin slash final), que no hay firewall bloqueando el puerto 443 desde tu máquina hacia Nexus, y que la Machine Key está bien copiada (sin espacios al inicio o final).
• “Machine Key inválida”: la clave ya fue usada, fue regenerada en el portal, o el agente fue eliminado. Volvé al portal y regenera la clave.
• El Agent aparece online pero a los pocos segundos vuelve a offline: posible problema de proxy corporativo. Contacta a soporte.

---

7. Diseñar tu primer playbook

Ahora viene la parte divertida: armar una automatización.

Para este tutorial vamos a hacer algo sencillo: un playbook que abra Wikipedia, busque “Robotic process automation” y guarde el primer párrafo en una variable.

1. Abre Zoan Designer desde el menú Inicio.

   

2. Crea un proyecto nuevo

   Clic en Nuevo proyecto. El Designer te pide:

   • Nombre del proyecto: Tutorial Wikipedia
   • Ubicación: por defecto sugiere Documentos\Zoan\Proyectos\ — dejalo así o cambialo.

   

3. Conocé la interfaz del Designer

   Al abrir el proyecto vas a ver 4 áreas:

   • Paleta (izquierda) — todas las actividades disponibles, agrupadas por paquete.
   • Canvas (centro) — donde arrastras las actividades para armar el flujo.
   • Panel de propiedades (derecha) — parámetros de la actividad seleccionada.
   • Panel de variables (abajo) — variables del playbook.

   

4. Arrastra tu primera actividad

   En la paleta, escribe browser en el buscador. Aparecen las actividades del paquete Browser. Arrastra Open Browser al canvas.

   

5. Configura Open Browser

   Clic en el nodo browser-open que acabás de poner. El panel de propiedades a la derecha se abre con los parámetros:

   • Browser: deja chrome.
   • URL: https://es.wikipedia.org/wiki/Automatización_robótica_de_procesos
   • Headless: false (queremos ver el browser para este tutorial).
   • Output: escribe page — esto guarda la sesión del navegador en una variable llamada page.

   

6. Agregá una actividad para esperar el contenido

   En la paleta, busca page-wait-for. Arrastra Page Wait For debajo del Open Browser.

   Configura:

   • Page: = page (referencias la variable que creaste en el paso anterior con una expresión).
   • Selector: #mw-content-text p (un selector CSS al primer párrafo).
   • Timeout: 10000 (10 segundos).

   

7. Extraé el texto del primer párrafo

   Arrastra Page Get Text debajo.

   Configura:

   • Page: = page
   • Selector: #mw-content-text p
   • Output: firstParagraph

8. Registra el resultado en un log

   Arrastra Log (del paquete Core).

   Configura:

   • Level: info
   • Message: = "Primer párrafo: " + firstParagraph

9. Cierra el browser al final

   Arrastra Browser Close y configura Browser: = page.

10. Tu playbook debería verse así

    

---

8. Ejecutar localmente para validar

Antes de publicar el playbook a Nexus, conviene probarlo en tu propia máquina. El Designer puede ejecutar contra tu Agent local.

1. Verifica que el Agent esté online (revisa el ícono en la bandeja del sistema — debe tener un círculo verde).

2. Clic en “Ejecutar” en la toolbar del Designer (botón con ícono de play).

3. Mira el panel de logs (parte inferior). Vas a ver mensajes en tiempo real:

   [INFO] Iniciando ejecución
   [INFO] browser-open: chrome → es.wikipedia.org
   [INFO] page-wait-for: selector encontrado
   [INFO] page-get-text: 487 caracteres extraídos
   [INFO] Primer párrafo: La automatización robótica de procesos...
   [INFO] browser-close
   [OK]   Ejecución completada — 4.2s

   

4. Si algo falla, el panel de logs muestra el error. Las causas más frecuentes para este playbook serían:

   • Wikipedia cambió su layout y el selector #mw-content-text p ya no existe — actualizalo.
   • No tienes Chrome instalado — instala Chrome o cambia a edge en el parámetro Browser.
   • El Agent no está ejecutándose — abrilo desde el menú Inicio.

---

9. Publicar el playbook a Nexus

Una vez que funciona local, lo publicas al portal para que pueda ejecutarse desatendido.

1. En el Designer, clic en “Publicar” en la toolbar.

2. Llena la información de versión

   El Designer te pide:

   • Versión (semántica): 1.0.0 para la primera publicación.
   • Notas de release: opcional, pero útil para el historial.

   

3. Confirma. El Designer empaqueta el proyecto en un archivo .zoan, lo sube al portal de Nexus y queda asociado a tu tenant.

4. En el portal, ve a Paquetes (menú lateral). Vas a ver tu paquete Tutorial Wikipedia v1.0.0 listado.

   

---

10. Crear un proceso y ejecutar desde el portal

Un proceso asocia un paquete (en una versión específica) a un entorno. Es lo que ejecuta el agente cuando recibe una orden.

1. Volvé al entorno → pestaña Procesos.

2. Clic en “Nuevo proceso”.

3. Selecciona el paquete y la versión:

   • Paquete: Tutorial Wikipedia
   • Versión: 1.0.0
   • Nombre del proceso: Tutorial Wikipedia (autocompletado, puedes cambiarlo).

   

4. Guardar.

5. Ve a la pestaña Ejecuciones del entorno y clic en Nueva ejecución.

6. Selecciona:

   • Proceso: Tutorial Wikipedia
   • Agente: el que creaste (Nexus selecciona uno online automáticamente).

7. Confirmar. La ejecución pasa al estado queued y, en segundos, a running.

8. Mira los logs en tiempo real desde la misma pantalla.

   

9. Cuando termina queda en completed (verde) o failed (rojo). Haz clic en la ejecución para ver el detalle: logs completos, duración, código de salida.

   

---

¡Felicitaciones! 🎉

Tu primer bot está ejecutándose en producción. A partir de aquí puedes:

• Probar otras actividades del catálogo — Excel, Outlook, OCR, bases de datos, SFTP.
• Programar el bot con un trigger para que se ejecute automáticamente cada día/semana.
• Usar credenciales para que tus bots accedan a sistemas que requieren login sin exponer contraseñas en el código.
• Conocer los conceptos clave en más detalle.

¿Algo salió mal?

Problema	Dónde mirar
El instalador falla	Solución de problemas del Agent
El Agent no conecta	Estados del agente
El Designer no abre	Re-ejecuta el instalador con la opción “Reparar”
El playbook falla en producción	Logs de ejecución
Otra cosa	Conceptos o escribe a soporte@zoansoftware.com