Índice de Documentación
IntroducciónInstalaciónInterfaz de BuilderLógica y SistemaArchivos y DatosWeb y APIsEscritorio y UIPro-Code & SDK
InicioDocumentaciónInstalación

Instalación y Guía de Inicio

Esta guía te guiará paso a paso para configurar tu entorno de desarrollo y ejecución de Vivabots. En pocos minutos tendrás tu primer robot listo para automatizar tareas.

Requisitos del Sistema

Antes de comenzar, asegúrate de cumplir con los siguientes requisitos en el equipo donde ejecutarás los bots:

  • Sistema Operativo: Windows 10/11 (64-bit) o Windows Server 2019/2022.
  • Procesador: Intel Core i3 o equivalente (se recomiendan i5 o superior para desarrollo).
  • Memoria RAM: Mínimo 4 GB (se recomiendan 8 GB).
  • Entorno de ejecución: .NET Desktop Runtime 8.0 o superior (el instalador lo descargará automáticamente si no está presente).
  • Acceso a Red: Conexión a internet saliente por puerto 443 para sincronización con Viva Consola (opcional para ejecución offline).

Paso 1: Instalar Viva Launcher

El motor de ejecución (Viva Launcher) es indispensable tanto para probar tus bots localmente como para ejecutar automatizaciones productivas.

  1. Ve al panel de administración de Viva Consola (o usa el enlace provisto por tu administrador).
  2. Dirígete a la sección Descargas y descarga el instalador VivaLauncherSetup.msi.
  3. Ejecuta el instalador y sigue los pasos del asistente de instalación.
  4. Una vez completado, el agente se ejecutará en segundo plano en tu barra de tareas como un ícono con el logotipo de Vivabots.

Paso 2: Conectar tu Agente a la Consola

Para que puedas programar y reportar logs de tus robots, el agente local debe estar emparejado con tu cuenta empresarial en la nube:

  1. Haz clic derecho en el ícono de Viva Launcher en la barra de tareas y selecciona Configuración.
  2. Copia la Clave de Activación de Agente provista en el panel de control de tu Viva Consola (bajo Agentes -> Agregar Agente).
  3. Pega la clave en la ventana de configuración local y presiona Conectar.
  4. Verás que el estado cambia a Conectado y Activo con un indicador verde.

Paso 3: Tu Primer Flujo en Viva Builder

Ahora que el motor de ejecución está listo, vamos a crear un pequeño flujo de prueba:

  1. Abre Viva Builder desde el menú Inicio.
  2. Haz clic en Nuevo Proyecto y asígnale el nombre MiPrimeraAutomatizacion.
  3. En la barra de herramientas izquierda, busca la actividad Escribir Log y arrástrala al lienzo de diseño.
  4. En el panel de propiedades a la derecha, introduce el mensaje: "¡Hola Mundo! Mi primer bot de Vivabots está funcionando."
  5. Presiona el botón de Ejecutar (Play) en la barra de herramientas superior para probarlo localmente.

Ejemplo de código de configuración (project.json)

Cada proyecto genera un archivo de metadatos legible. A continuación se muestra la estructura básica de un archivo de proyecto generado:

{
  "projectId": "viva-proj-982183",
  "name": "MiPrimeraAutomatizacion",
  "version": "1.0.0",
  "main": "Main.xaml",
  "dependencies": {
    "Vivabots.Core.Activities": "2.4.0",
    "Vivabots.Web.Activities": "1.8.2"
  }
}

Paso 4: Publicación a Producción

Cuando verifiques que el robot funciona correctamente en modo local:

  1. Haz clic en Publicar en el menú de Viva Builder.
  2. Selecciona tu entorno destino (por ejemplo, Staging o Producción).
  3. Escribe un comentario sobre los cambios y presiona Enviar.
  4. Ve a tu Viva Consola para programar disparadores (triggers) por horario o por eventos para que tu bot se ejecute en el servidor designado.
AnteriorIntroducciónSiguienteInterfaz de Builder