SQL Server es un motor de base de datos relacional de Microsoft, diseñado para gestionar volúmenes de información críticos con alta disponibilidad y seguridad. Para integrar este motor en sus flujos de trabajo, es imperativo configurar una credencial de conexión que actúe como el puente técnico entre el robot y el servidor.

Obtención de Parámetros Técnicos

La información necesaria para establecer la conexión se encuentra centralizada en las herramientas de administración del servidor. Los datos presentados en su borrador han sido verificados y son técnicamente precisos según los estándares de Microsoft:

• SQL Server Management Studio (SSMS): Principal interfaz para identificar nombres de servidor y bases de datos.
• SQL Server Configuration Manager: Herramienta esencial para habilitar protocolos TCP/IP y verificar puertos activos.

Parámetros de Configuración en el Módulo

Al registrar una nueva credencial, deberá completar los siguientes campos obligatorios y opcionales en la interfaz:

Parámetros de Seguridad y Cifrado

El manejo de certificados y cifrado es crítico para el éxito de la conexión, especialmente en entornos corporativos o de nube:

Encrypt Connection

Determina si el tráfico de datos entre el cliente y el servidor viaja cifrado mediante TLS.

• True: Habilita el cifrado. Si el servidor exige TLS y esta opción está apagada, la conexión fallará.
• False: Envía datos en texto plano (no recomendado para entornos fuera de una red local segura).

Trust Server Certificate

Controla cómo se valida el certificado de seguridad del servidor.

• True: El cliente acepta el certificado del servidor sin validarlo contra una autoridad externa. Es común en desarrollo con certificados autofirmados.
• False: El cliente exige que el certificado sea emitido por una autoridad de confianza (CA). Es el estándar de seguridad para producción.

Regla Técnica: La opción Trust Server Certificate solo entra en funcionamiento si Encrypt Connection está activo.

Consideraciones de Red y Validación

Para asegurar que el comando de consulta funcione correctamente, verifique los siguientes puntos de infraestructura:

1. Firewall: El puerto 1433 debe permitir tráfico entrante y saliente, o bien, debe permitirse explícitamente el proceso sqlservr.exe.
2. Conexiones Remotas: Asegúrese de que SQL Server esté configurado para aceptar conexiones desde otras IPs (TCP/IP habilitado en Configuration Manager).
3. Verificación Final: Es obligatorio utilizar el botón Test Connection. Una prueba exitosa garantiza que el usuario tiene permisos de lectura/escritura y que el túnel de seguridad es compatible.

Buenas Prácticas Generales

• Principio de Menor Privilegio: No utilice el usuario administrador sa. Cree un usuario dedicado con acceso exclusivo a las tablas que el robot necesita procesar.
• Certificados en Producción: En entornos críticos, evite el uso de Trust Server Certificate = True. Utilice certificados válidos para prevenir ataques de interceptación (MITM).
• Puertos Estáticos: Siempre que sea posible, especifique el puerto manualmente para evitar problemas de resolución en instancias con nombres dinámicos.

El Market de Templates de Saturn Studio es un catálogo centralizado que permite a los usuarios explorar, previsualizar y utilizar plantillas de bots pre-construidas. Esta herramienta está diseñada para acelerar el desarrollo de proyectos de automatización al proporcionar estructuras base funcionales que pueden ser integradas al espacio de trabajo con un solo clic.

Exploración del Catálogo

Al navegar a la sección Market, el sistema despliega un tablero con tarjetas individuales para cada plantilla disponible. Cada tarjeta proporciona información clave para evaluar la utilidad del bot sin necesidad de abrirlo:

• Iconos de módulos: Muestra hasta 4 iconos de los módulos que utiliza el bot (ej. OpenAI, Gmail, SQL). Si utiliza más, aparece un indicador “+N”.
• Detalle al pasar el cursor: Al posicionar el puntero sobre un icono, se revela el nombre del módulo y la cantidad de comandos empleados.
• Información general: Incluye el nombre del template, el autor (administrador que lo creó), una descripción breve de hasta 120 caracteres y su categoría.

Si no hay templates disponibles, veras un mensaje indicando “No templates found — No bot templates are currently available”.

Vista Previa de Plantillas

Antes de añadir un bot a su workspace, puede realizar una inspección visual completa haciendo clic en cualquier parte de la tarjeta.

Características de la Previsualización

• Modo Solo Lectura: En la parte superior aparecerá el indicador “Read Only”, confirmando que no es posible realizar cambios, mover nodos o eliminar conexiones en esta ventana.
• Interactividad: Permite hacer zoom y scroll para explorar la lógica del flujo y los comandos utilizados.
• Interfaz Adaptable: La ventana de vista previa es redimensionable para ajustarse a sus necesidades de visualización.

El flujo puede tardar aproximadamente 1 segundo en cargarse despues de abrir la ventana,
dependiendo del tamaño del template. Esto es normal.

Adición de un Template como Bot

Existen dos rutas para convertir una plantilla en un bot operativo en su entorno:

1. Desde la tarjeta: Utilizando el botón “+ Add Template as Bot” directamente en el catálogo.
2. Desde la vista previa: Tras revisar el flujo, puede seleccionar la misma opción en la parte inferior de la ventana.

Configuración de Identidad

Al iniciar el proceso de adición, se desplegará un formulario de registro:

• Folder: Selección del proyecto de destino (por defecto “Default project”).
• Name: Asignación de un nombre único al bot (mínimo 3 caracteres).
• Description: Resumen de la función del bot (permite generación mediante IA).

Una vez agregado, el bot es totalmente independiente de la plantilla original. Puede modificarlo libremente en su editor de flujo sin afectar el Market.

Administración (Exclusivo para Roles Admin)

Los usuarios con rol de administrador cuentan con permisos adicionales para gestionar el contenido del Market:

Publicar Nuevas Plantillas

1. Se requiere un archivo con extensión .json que contenga la estructura válida de un bot de Saturn Studio.
2. Al subir el archivo, el sistema realiza una validación técnica del JSON antes de permitir su publicación.
3. Tras la validación, se debe completar un formulario con el nombre, descripción y categoría para que sea visible para todos los usuarios.

Solo se aceptan archivos con extension .json. Si el archivo no es un JSON valido, se mostrara un
mensaje de error.

Eliminación de Contenido

Los administradores pueden retirar cualquier plantilla utilizando el botón rojo “Delete Template” en la tarjeta correspondiente. Esta acción requiere una confirmación adicional y es permanente e irreversible.

1. Busca el template que deseas eliminar en el Market
2. En la tarjeta del template, haz clic en el boton rojo “Delete Template”
3. Se abrira un modal de confirmacion
4. Confirma la eliminacion

Importante: La eliminacion es permanente. Una vez eliminado, el template dejara de estar disponible para todos los usuarios del Market.

Casos de Uso y Preguntas Frecuentes

La siguiente documentación le mostrará los Casos de Uso y las Preguntas Frecuentes. Haga clic aquí.

El Market de Templates está diseñado para ser un ecosistema dinámico donde la experiencia de los administradores se convierte en el punto de partida para nuevos desarrolladores. A continuación, presentamos los escenarios más comunes y las dudas frecuentes para dominar esta herramienta.

Casos de Uso

1. Inicio Rápido para Nuevos Usuarios

Escenario: Un usuario recién integrado a Saturn Studio necesita crear un bot pero no tiene experiencia previa en la construcción de flujos desde cero.

Solución:

• Exploración: Navega al Market para revisar las plantillas disponibles.
• Filtrado: Utiliza las categorías y los iconos de módulos para identificar un proceso similar al que necesita (ej. un bot que use Gmail o SQL).
• Análisis: Abre la vista previa para entender la lógica y los comandos aplicados.
• Implementación: Agrega el template a su workspace con un clic.
• Personalización: Ajusta las credenciales y variables específicas para su entorno.

2. Estandarización y Colaboración (Admin)

Escenario: Un administrador ha desarrollado un bot de alta eficiencia y desea que todo su equipo lo utilice como estándar para futuros proyectos.

Solución:

• Exportación: Descarga el bot funcional en formato .json.
• Publicación: Sube el archivo al Market mediante la sección “Upload Template File”.
• Documentación: Completa el nombre, una descripción clara y asigna una categoría.
• Disponibilidad: El template queda visible al instante para que todos los miembros del equipo lo utilicen como base.

3. Evaluación Previa al Uso

Escenario: Un usuario con un workspace saturado desea asegurarse de que un template realmente cumple con sus requisitos antes de importarlo.

Solución:

• Inspección: Accede a la tarjeta del template para abrir el visor visual.
• Exploración: Navega por los nodos y conexiones, redimensionando la ventana si el flujo es extenso para verlo con claridad.
• Decisión: Si el flujo es el correcto, procede a agregarlo ; de lo contrario, cierra la vista previa sin afectar su workspace y continúa explorando.

Preguntas Frecuentes (FAQ)

¿Puedo editar un template directamente desde la vista previa?

No. La vista previa es estrictamente de solo lectura. Para realizar modificaciones, primero debe agregar el template a su workspace como un bot nuevo y luego abrirlo en el editor de flujo.

¿Qué sucede exactamente cuando agrego un template a mi workspace? Se crea una copia exacta del flujo del template como un bot independiente. Cualquier cambio que realice en este nuevo bot no afectará a la plantilla original del Market, permitiéndole experimentar con total libertad.

¿Qué representan los iconos en las tarjetas del Market? Indican los módulos técnicos (como OpenAI, Gmail o SQL) que el bot necesita para funcionar. Se muestran hasta 4 iconos; si hay más, verá un indicador “+N”. Al pasar el cursor sobre ellos, podrá ver el nombre del módulo y cuántos comandos de ese tipo utiliza el proceso.

¿Quiénes tienen permiso para subir o eliminar templates? Estas funciones están restringidas exclusivamente a usuarios con el rol de Administrador. Los usuarios regulares tienen permisos de exploración, previsualización y adición de bots.

¿Qué tipo de archivo se requiere para subir un nuevo template? El sistema solo acepta archivos con extensión .json que contengan la estructura válida de un bot de Saturn Studio. Si el archivo está dañado o no cumple con el formato, el sistema arrojará un error de validación.

SQLServer es un sistema de base de datos de Microsoft utilizado en todo el mundo para gestionar y administrar bases de datos de manera eficiente.

Descripción de los comandos

Consulta SQLServer (Query SQLServer)

Permite crear y ejecutar consultas personalizadas dentro de una base de datos SQLServer.

Zoom es una plataforma de colaboración líder que integra servicios de videoconferencia, chat, almacenamiento de archivos y aplicaciones en una interfaz unificada. Su integración con Saturn Studio permite automatizar la gestión de reuniones, optimizando la productividad y la coordinación de los equipos de trabajo.

Para ver la documentación de los comandos del módulo de Zoom, haga clic aquí

Obtención de las Credenciales

Para establecer la conexión técnica entre ambas plataformas, es necesario configurar una aplicación de servidor siguiendo estos pasos:

Configuración de Acceso en Zoom Marketplace

Para que el robot pueda interactuar con la infraestructura de Zoom sin intervención humana, es necesario establecer un puente de comunicación técnica mediante el estándar Server-to-Server OAuth.

Inicio de Sesión y Acceso al Portal

El proceso comienza en el centro de gestión para desarrolladores. Debe ingresar con su cuenta corporativa en la siguiente dirección:

https://marketplace.zoom.us

Creación de la Aplicación de Servidor

Una vez dentro del portal, el sistema permite registrar una nueva integración siguiendo esta ruta técnica:

1. Panel de Desarrollo: Diríjase al extremo superior derecho de la interfaz, junto al icono de su perfil, y posicione el cursor sobre la opción Develop.
2. Constructor de Apps: En el menú desplegable, seleccione Build app.
3. Selección de Protocolo: Dentro de las opciones disponibles, elija Server-to-Server OAuth App. Este es el método más seguro para integraciones de “servidor a servidor” (backend), ya que no requiere que un usuario inicie sesión manualmente cada vez que el robot se ejecuta.
4. Identificación: Haga clic en Create, asigne un nombre a la aplicación (ej: Saturn_Automation_Service) y confirme la creación.

Extracción de Parámetros Técnicos

Tras la creación, el sistema generará las credenciales necesarias. Toda la información requerida por Saturn Studio se encuentra centralizada en la pestaña lateral izquierda denominada App Credentials.

Deberá copiar íntegramente los siguientes tres valores:

• Account ID: El identificador maestro de su cuenta organizacional.
• Client ID: El identificador único de la aplicación recién creada.
• Client Secret: La clave privada que autentica la conexión.

Vinculación y Validación en Saturn Studio

El último paso se realiza dentro de la interfaz de Saturn Studio.

1. Ingreso de Datos: Pegue el Account ID, Client ID y Client Secret en los campos correspondientes del formulario de credenciales de Zoom.
2. Verificación Técnica: Una vez completados los campos, haga clic en el botón Check. Este comando realiza una “llamada de prueba” (handshake) a los servidores de Zoom para validar que los datos sean correctos.
3. Confirmación: Si los datos coinciden, el sistema mostrará un mensaje de éxito y la credencial quedará lista para ser utilizada en cualquier robot de su cuenta

Las API Keys actúan como llaves maestras que permiten que aplicaciones externas se comuniquen de forma segura con Saturn Studio. Si necesitas que un software de terceros active un robot o consulte datos de tu cuenta sin darle tu contraseña personal, aquí es donde generas ese acceso controlado.

¿Para qué sirven?

A diferencia de las credenciales de usuario, una API Key está diseñada para la integración entre máquinas. Son esenciales para:

• Conectar Saturn Studio con plataformas de automatización externas .
• Permitir que desarrolladores externos interactúen con tu infraestructura de bots mediante la API de la plataforma.
• Mantener la seguridad: puedes revocar una llave específica en cualquier momento sin afectar tu acceso principal.

Gestión de la Interfaz

Desde el menú lateral (icono de la llave), accederás al panel principal de API Keys. Aquí encontrarás un resumen de todas tus llaves activas y su estado de uso.

Tabla de Monitoreo

Proceso de Creación

Para generar un nuevo acceso, sigue estos pasos dentro del modal de configuración:

1. Definir Identidad y Caducidad

Haz clic en + New API Key. Se abrirá una ventana donde deberás:

• Name: Ingresar un nombre único y descriptivo.
• Expires In: Seleccionar el tiempo de vida de la llave (desde 1 mes hasta 1 año). Por seguridad, se recomienda establecer fechas de expiración cortas si el uso es temporal.

2. Generación y Resguardo

Al hacer clic en Generate API Key, el sistema creará el token alfanumérico.

Aviso de Seguridad Crítico: Esta es la única vez que verás la llave completa. Saturn Studio no almacena este código en texto plano por razones de seguridad. Cópiala y guárdala en un gestor de contraseñas seguro. Si la pierdes, deberás borrarla y generar una nueva.

Seguridad y Mantenimiento

• No compartas tus llaves: Trata una API Key con la misma precaución que una contraseña. Si sospechas que alguien ha tenido acceso a ella, elimínala de inmediato desde la columna Actions.
• Rotación: Es una buena práctica crear llaves nuevas y eliminar las antiguas cada cierto tiempo para mantener la integridad de tus integraciones.

Markdown PDF es una herramienta diseñada para convertir archivos Markdown en documentos PDF, preservando el formato y permitiendo la personalización del estilo y de la salida.

Descripción de los comandos

Markdown a PDF

Convierte un archivo Markdown en un documento PDF.

Zoom es una plataforma de colaboración que integra chat, videollamadas, almacenamiento de archivos y aplicaciones en un solo lugar para mejorar la productividad del equipo.

Descripción de los comandos

Crear Zoom (Create Zoom)

Crea una reunión en Zoom.

Obtener Zoom (Get Zoom)

Obtiene Zoom desde Microsoft Zoom.

Eliminar Zoom (Delete Zoom)

Elimina una reunión en Zoom.

Actualizar Zoom (Update Zoom)

Actualiza una reunión en Zoom.

Listar Zoom (List Zoom)

Lista las reuniones de Zoom.

Saturn Studio facilita la colaboración entre desarrolladores mediante la creación de equipos y el uso de robots compartidos. A través del menú lateral, es posible gestionar el acceso a recursos, distribuir tareas y asegurar una comunicación eficiente dentro de un equipo de trabajo, lo que potencia la productividad y la coordinación en proyectos de automatización.

Gestión de Equipos (Teams)

La sección de Teams permite invitar a múltiples desarrolladores para trabajar y ejecutar procesos de forma conjunta.

Interfaz de Equipos

En la pantalla principal de Teams se visualiza un listado con la siguiente información:

Crear y Editar un Equipo

Para configurar un equipo nuevo, debe seguir estos pasos:

1. Nombre y Descripción: Asigne un nombre (mínimo 3 caracteres) y una descripción al equipo.
2. Invitación de Miembros: Agregue desarrolladores ingresando su correo electrónico en el campo correspondiente.
3. Lista de Integrantes: Debajo de la opción de invitación, aparecerá la lista de miembros con permisos para ejecutar los procesos que se compartan en el futuro.

Robots Compartidos (Shared Robots)

El apartado de Shared Robots permite que un desarrollador comparta sus robots o procesos con grupos específicos de los cuales es miembro.

Cómo compartir un Robot

1. Haga clic en el botón + Share a Robot.
2. Selección de Grupo: Elija el equipo o grupo donde desea subir el robot.
3. Selección de Robot: Elija el proceso específico que quiere compartir y guarde los cambios.

Detalle de la Información Compartida

Una vez compartido, la interfaz mostrará los siguientes datos técnicos:

• Group: El equipo donde se ha compartido el recurso.
• Robot: Nombre del proceso y su número de versión actual.
• Description: Información adicional sobre el funcionamiento del bot.
• Shared by: Datos del emisor (Nombre y Email) que compartió el proceso.
• Actions: Botones para Ejecutar el proceso o Eliminarlo del grupo compartido.

Visualización General

Al finalizar la creación del equipo y compartir el proceso, el sistema actualiza automáticamente el contador en la sección de Teams, permitiendo visualizar cuántos robots compartidos tiene cada grupo en tiempo real.

Los Webhooks son herramientas de comunicación en tiempo real que permiten a aplicaciones externas (como Facebook, GitHub o servicios de pago) enviar notificaciones automáticas a Saturn Studio. En lugar de que tu robot esté preguntando constantemente si hay novedades, el sistema externo envía la información de manera inmediata a una dirección URL única, lo que dispara la ejecución del bot al instante.

Interfaz de Gestión (Panel Lateral)

Una vez que has configurado y guardado un robot que contenga un comando de Webhook, la información de control aparecerá automáticamente en la sección Webhooks del menú lateral izquierdo.

Visualizar cola de tareas /  View tasks queue

Botones de Acción (Actions)

• Papelera (Rojo): Elimina permanentemente el Webhook y su URL del servidor.
• Escoba/Borrador (Amarillo): Limpia el historial de tareas y pone los contadores a cero.
• Ojo (Verde): Permite ver los detalles técnicos de la configuración actual del Webhook.

Al inspeccionar las ejecuciones de un Webhook, se despliega este modal que lista cada petición recibida de forma individual.

• ID: Identificador único alfanumérico de la petición recibida.
• Header / Body / Query / Data: Indican la cantidad de parámetros o el peso de la información recibida en cada sección de la petición HTTP.
• Status: Muestra si la tarea específica fue completada o si presentó algún error.
• Updated: Tiempo transcurrido desde que se recibió la petición.
• Botón de Ver (Ojo Azul): Abre el desglose detallado de los datos crudos (raw data) de esa tarea específica.

Detalle de Datos de Tarea (View tasks data)

Este panel es fundamental para la depuración (debugging), ya que muestra exactamente qué información envió la aplicación externa a Saturn Studio.

• Headers: Contiene los metadatos de la conexión (IP de origen, tipo de navegador, tokens de autenticación, etc.).
• Body: El contenido principal del mensaje, generalmente en formato JSON.
• Query: Parámetros enviados directamente en la URL (ej: ?id=123).
• Params: Parámetros de ruta procesados.
• Response: La respuesta que Saturn Studio devolvió al servidor emisor tras recibir el mensaje.

Descripción de los Comandos

Para usar esta tecnología, encontrarás los siguientes módulos dentro de la categoría Webhooks del editor.

1. Recibir Webhook (Receive Webhook)

• Webhook URL: Es la dirección estática que genera el sistema para tu bot.
• HTTP Method: El protocolo de comunicación. Puedes elegir entre GET, POST, PUT o DELETE.
• Response mode: Define cómo se le avisa al emisor que el dato llegó. Puede ser Immediately (al instante), After robot execution (al terminar el bot) o de forma manual con el comando de respuesta.
• Assign result to Variable: El nombre de la variable donde se guardará toda la información recibida (el cuerpo del mensaje).

2. Responder Webhook (Response Webhook)

Se utiliza cuando necesitas enviar una respuesta personalizada o específica después de procesar los datos.

• Task ID: El identificador de la tarea a la que estás respondiendo.
• Response: El texto o JSON que quieres devolver a la aplicación original.
• Headers: Encabezados técnicos opcionales para la respuesta.

Configuración Avanzada (Pestaña Config)

Dentro de los módulos, puedes ajustar el comportamiento ante fallos:

• Retry on Error: Número de intentos (de 0 a 10) si ocurre un fallo al recibir.
• Wait Between Retries: Segundos de espera entre cada intento de recuperación.

Cómo funciona todo en conjunto

1. En el Editor: Colocas el módulo Receive Webhook al principio de tu robot. Al configurarlo, copias la URL.
2. En la App Externa: Pegas esa URL en la configuración de la aplicación que quieres conectar (por ejemplo, en las opciones de desarrollador de WhatsApp o Facebook).
3. El Evento: Cuando sucede algo afuera, esa app envía un mensaje a la URL.
4. La Ejecución: Saturn Studio detecta el mensaje, “despierta” al robot y guarda los datos en la Variable que elegiste.
5. El Monitoreo: Puedes ir al menú principal, entrar a Webhooks y ver cuántas veces ha funcionado y si hubo errores.