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.

Las Variables Globales son un recurso centralizado diseñado para simplificar la gestión de datos que necesitan ser compartidos entre múltiples procesos. En lugar de configurar la misma información en cada robot, puedes definirla una sola vez y acceder a ella desde cualquier lugar de tu cuenta.

¿Para qué sirven?

Estas variables están pensadas para almacenar datos constantes o configuraciones maestras que todos tus robots deben conocer. Son ideales para:

• URLs de API: Si la dirección de tu servidor cambia, solo la actualizas en un lugar.
• Credenciales compartidas o Hosts de Base de Datos: Mantiene la consistencia técnica en todo tu ecosistema de automatización.
• Tokens o Flags de sistema: Información que debe ser idéntica para todos los procesos activos.

Interfaz de Gestión

Desde el panel lateral de Saturn Studio, puedes acceder al gestor de variables globales, donde encontrarás las siguientes herramientas:

La Tabla de Variables

La tabla principal muestra información detallada para mantener el control sobre los datos:

• Name: El identificador único de la variable.
• Value: El valor que será devuelto a los robots cuando la invoquen.
• Created / Updated: Marcas de tiempo para rastrear cuándo se creó o modificó el dato por última vez.
• Actions: Botones para editar o eliminar variables de forma individual.

Cómo Crear una Variable Global

Al hacer clic en + New Variable, se desplegará un modal con los siguientes campos obligatorios:

1. Variable Name (*): Se recomienda usar nombres descriptivos en mayúsculas (ej: API_URL, DATABASE_HOST). Importante: Los nombres deben ser únicos dentro de tu cuenta.
2. Variable Value (*): Aquí introduces el dato específico que quieres que tus robots recuperen.
3. Create Variable: Guarda el registro y lo hace disponible inmediatamente para todos tus procesos.

Uso en los Robots (Sintaxis)

Una vez creada, invocar una variable global dentro del editor de cualquier robot es muy sencillo. Solo debes usar la siguiente estructura:

{global.nombreDeTuVariable}

Por ejemplo, si creaste una variable llamada API_URL, dentro de tus comandos deberás escribir {global.API_URL} para que Saturn Studio reemplace ese texto por el valor real durante la ejecución.

Amazon S3 (Simple Storage Service) es un servicio de almacenamiento en la nube que te permite guardar, proteger y recuperar archivos y datos de forma segura y escalable. Su integración en Saturn Studio facilita la gestión automatizada de activos digitales, copias de seguridad y transferencia de archivos a gran escala.

¿Cómo obtener las credenciales? Haz clic aquí

Descripción de los Comandos

Cargar Archivo (Upload File)

Sube un archivo local a un contenedor (bucket) específico en AWS S3.

Descargar Archivo (Download File)

Descarga un archivo desde un bucket de AWS S3 a tu entorno local.

Obtener Lista de Objetos en un Bucket (Get List of Objects in a Bucket)

Recupera un listado de todos los objetos almacenados dentro de un bucket específico.

Obtener Lista de Buckets (Get List of Buckets)

Enumera todos los buckets disponibles asociados a la cuenta de AWS.

Amazon S3 (Simple Storage Service) es un servicio de almacenamiento en la nube que permite guardar, proteger y recuperar archivos y datos de forma segura y escalable. Su integración en Saturn Studio es fundamental para automatizar flujos que requieran el manejo persistente de activos digitales o copias de seguridad.

Cómo obtener las llaves de acceso (IAM)

El proceso de obtención de credenciales para S3 es idéntico al de otros servicios de AWS, variando únicamente el permiso específico que se le otorga al usuario.

1. Creación del Usuario en la Consola de AWS

• Inicia sesión en tu Consola de administración de AWS.
• En el buscador superior, selecciona el servicio IAM.
• En el menú lateral, dirígete a Users (Usuarios) y haz clic en el botón Add Users.

2. Configuración de Permisos

Para que Saturn Studio pueda gestionar tus archivos, el usuario debe tener acceso al servicio de almacenamiento:

• En la pantalla de Set permissions, selecciona la opción Attach policies directly.
• En el buscador de políticas, escribe s3 y selecciona la casilla de AmazonS3FullAccess.
• Finaliza el proceso de creación del usuario.

3. Generación de las Access Keys

Una vez que el usuario esté creado, accede a su perfil para generar las llaves:

• Haz clic en la pestaña Security credentials.
• Desplázate hasta Access keys y haz clic en Create access key.
• Selecciona el caso de uso Other y asigna una descripción opcional (ej. Saturn_S3_Key).
• IMPORTANTE: Se mostrarán tu Access key y tu Secret access key. Debes copiarlas y pegarlas directamente en el módulo, ya que la llave secreta no volverá a mostrarse por seguridad.

Vinculación en Saturn Studio

Para finalizar la configuración, abre la ventana de credenciales del módulo de AWS S3 y completa los campos:

1. Credential name: Ingresa un nombre para identificar esta conexión.
2. AWS Region: Selecciona la región donde se encuentran tus buckets de S3 (ej. us-east-1).
3. AWS Access Key ID: Pega el identificador de acceso que copiaste de la consola de AWS.
4. AWS Secret Access Key: Pega la llave secreta correspondiente.
5. Haz clic en el botón Check para verificar que los permisos de S3 sean válidos.
6. Presiona Save credentials para guardar los cambios.

Asana es una plataforma líder en gestión de trabajo y productividad diseñada para ayudar a los equipos a organizar tareas, proyectos y objetivos en un solo lugar. Al integrarla con Saturn Studio, puedes automatizar la creación de tareas y la gestión de flujos de trabajo colaborativos de manera eficiente.

Cómo obtener el Access Token

Para vincular Asana con Saturn Studio, necesitas generar un token de acceso desde la consola de desarrolladores de Asana siguiendo estos pasos:

1. Acceso desde Saturn Studio

• Dentro del módulo de Asana en Saturn Studio, localiza y haz clic en el enlace azul “here” ubicado debajo del campo de Access Token.
• Esto te redirigirá automáticamente al portal de Asana para desarrolladores.
• Inicia sesión con tu cuenta de Asana o regístrate si aún no posees una.

2. Navegación a la Consola de Desarrolladores

• Haz clic en tu foto de perfil para acceder a la Configuración (Settings).
• Dirígete a la pestaña de Apps (Aplicaciones).
• Al final de esta sección, busca y haz clic en el enlace “View developer console” (Ver consola de desarrolladores).

3. Generación del Access Token

• En la sección de Personal Access tokens, haz clic en el botón “+ Create new token”.
• Token name: Asigna un nombre descriptivo para identificar el token, por ejemplo, “Saturn Studio”.
• Marca la casilla de aceptación de los términos y haz clic en “Create token”.
• Importante: Se mostrará el token generado. Haz clic en “Copy” para copiarlo y guárdalo en un lugar seguro, ya que no se volverá a mostrar completo.

Vinculación en Saturn Studio

Regresa a Saturn Studio para finalizar la configuración de la credencial:

1. En el campo Credential name, ingresa un nombre para identificar esta conexión.
2. En el campo Access Token, pega el código alfanumérico que acabas de copiar desde Asana.
3. Haz clic en el botón azul “Connect to Asana”.
4. Si los datos son correctos, el sistema mostrará un recuadro verde con el mensaje “Success! connected successfully” y el estado cambiará a Connected.
5. Finalmente, haz clic en “Save credentials”.