Azure OpenAI es una solución de inteligencia artificial empresarial que permite acceder a modelos avanzados de lenguaje y visión, como GPT-4 y DALL-E, dentro de la infraestructura de seguridad de Microsoft Azure. Esta integración te permite automatizar tareas complejas de procesamiento de texto y análisis de datos.

Cómo crear el recurso de Azure OpenAI

Si es tu primera vez en Azure, sigue estos pasos para configurar tu entorno de trabajo desde cero:

1. Acceso al Portal: Inicia sesión en Azure portal, Si no tienes cuenta, deberás registrarte (Microsoft suele pedir una tarjeta de crédito para verificar tu identidad, aunque ofrece créditos de prueba).
2. Buscar el servicio: En la barra de búsqueda que aparece en la parte superior de la pantalla, escribe Azure OpenAI y haz clic en el servicio que tiene ese nombre.
3. Crear el recurso: Haz clic en el botón que dice + Crear (o Create).
4. Configuración inicial:

   • Suscripción: Selecciona la suscripción donde se cargarán los costos.
   • Grupo de recursos: Haz clic en “Crear nuevo” y asígnale un nombre (por ejemplo: MiGrupoIA). Esto sirve para mantener ordenados tus servicios.
   • Región: Elige una ubicación geográfica. Se recomienda seleccionar una que tenga disponibilidad de los modelos más recientes (como East US o Sweden Central).
   • Nombre: Escribe un nombre para identificar tu servicio. Este nombre debe ser único en todo Azure.
   • Nivel de precios: Selecciona la opción Standard S0.

5. Revisión y creación: Haz clic en el botón azul Revisar y crear en la parte inferior. Si todo es correcto, presiona Crear.
6. Finalización: Azure tardará un momento en desplegar el servicio. Cuando termine, aparecerá un mensaje de “Se completó la implementación”. Haz clic en el botón Ir al recurso.

Cómo obtener la Api Key y el Endpoint

Una vez que tu recurso esté listo, necesitas extraer dos datos clave para que Saturn Studio pueda comunicarse con Microsoft Azure:

1. Localizar el panel de llaves: Dentro de la pantalla principal de tu nuevo recurso, mira el menú lateral izquierdo. Debajo de la sección Resource Management (Administración de recursos), haz clic en Keys and Endpoint (Llaves y extremo).
2. Identificar los datos:

   • KEY 1: Este código alfanumérico es tu Api Key. Haz clic en el icono de la hoja de papel a la derecha para copiarlo.
   • Endpoint: Es la dirección URL que aparece debajo de las llaves (ejemplo: https://tu-recurso.openai.azure.com/). Cópiala completa.

Configuración en Saturn Studio

Para finalizar la vinculación, ingresa los datos en el módulo de credenciales de la siguiente manera:

1. Abre el módulo de Azure OpenAI en Saturn Studio y presiona New.
2. Credential name: Escribe un nombre para reconocer esta cuenta.
3. Api Key: Pega la llave que copiaste de KEY 1.
4. Endpoint: Pega la dirección URL completa del extremo.
5. Haz clic en el botón Check para verificar que la conexión sea válida.
6. Presiona Save credentials para guardar los cambios.

¿Qué es PostgreSQL?

PostgreSQL es uno de los sistemas de gestión de bases de datos relacionales de código abierto más avanzados y potentes del mundo. Este módulo permite a Saturn Studio conectarse de forma remota a tu servidor de base de datos para ejecutar consultas complejas, gestionar grandes volúmenes de datos y automatizar flujos de información empresarial.

Requisitos Previos: Acceso Remoto

⚠️ Importante: Dado que Saturn Studio opera desde la nube, no tiene acceso directo a servidores locales o redes privadas. Para que la conexión funcione, debes autorizar el tráfico externo.

1. Habilitar Acceso Remoto:

   • Configura tu servidor PostgreSQL (archivo pg_hba.conf) para permitir conexiones desde la dirección IP de Saturn Studio.
   • Asegúrate de que el servidor esté escuchando en la interfaz correcta (listen_addresses = '*').

2. Firewall / Puerto:

   • Verifica que el puerto de PostgreSQL (por defecto es el 5432) esté abierto en tu firewall para recibir conexiones TCP.

Cómo obtener los datos de conexión

1. Dirección del Servidor (Server Address):

   • Debes utilizar la IP Pública de tu servidor o su nombre de dominio (ej. db.tuempresa.com o 203.0.113.50).
   • ⛔ Error Común: Nunca utilices localhost o 127.0.0.1. Esto hará que Saturn Studio intente conectarse a sí mismo en lugar de a tu servidor.

2. Base de Datos y Usuario:

   • Obtén el nombre exacto de la base de datos a la que deseas acceder y las credenciales de un usuario con permisos suficientes para realizar consultas.

Configuración en Saturn Studio

Completa los campos de la credencial basándote en la interfaz del módulo:

• Credential name: Un nombre para identificar esta conexión (ej. Base de Datos Producción).
• Server address: La IP pública o dominio del servidor (recuerda no usar localhost).
• Server port: El puerto de conexión. Por defecto en PostgreSQL es 5432.
• User: Tu nombre de usuario de la base de datos.
• Password: La contraseña de dicho usuario.
• Database: El nombre de la base de datos específica a conectar.

Validación de la Credencial

• Una vez completados los campos, haz clic en Save credentials.
• Si la IP de Saturn Studio fue autorizada correctamente en tu servidor y los datos son válidos, el sistema confirmará la conexión exitosa.

Microsoft Teams 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. Su integración permite automatizar la comunicación interna, la gestión de canales y la programación de reuniones de forma eficiente.

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

Descripción de los Comandos

Obtener Equipos (Get Teams)

Recupera los equipos disponibles en Microsoft Teams asociados a la cuenta.

Listar Canales (List Channels)

Enumera los canales pertenecientes a un equipo específico de Microsoft Teams.

Crear Canal (Create Channel)

Crea un nuevo canal dentro de un equipo seleccionado.

Obtener Usuarios (Get Users)

Busca y recupera usuarios de la organización en Microsoft Teams.

Enviar Mensaje al Canal (Send Message to Channel)

Publica un mensaje de texto en un canal específico de un equipo.

Listar Mensajes (List Messages)

Obtiene el historial de mensajes de un canal determinado.

Enviar Mensaje al Usuario (Send Message to User)

Envía un mensaje directo y privado a un usuario de la organización.

Crear Reunión (Create Meeting)

Programa una nueva reunión o evento en Microsoft Teams.

TuFirma.digital es una plataforma de firma electrónica avanzada que permite gestionar documentos legales y comerciales de manera digital con plena validez jurídica. Al integrarla en Saturn Studio, es posible automatizar el envío de documentos para firma, consultar el estado de las rúbricas y gestionar certificados directamente desde tus flujos de trabajo.

Cómo obtener la API Key y la Secret Key

El proceso para obtener las credenciales de TuFirma.digital es estructurado y requiere una validación previa por parte de su equipo técnico para garantizar la seguridad de las firmas electrónicas.

1. Solicitud de Credenciales de Prueba

• Para iniciar la integración, debes contactar al equipo de soporte y solicitar el archivo de Postman junto con las credenciales de prueba.
• Es necesario proporcionar dos correos corporativos para configurar el entorno de test.
• Dato importante: El correo electrónico principal que designes será el encargado de actuar como el generador oficial de documentos en la API.

2. Integración y Fase de Prueba

• Una vez recibidas las llaves iniciales, deberás realizar la integración técnica utilizando el entorno de pruebas en Test.TuFirma.Digital.
• En esta etapa, podrás validar que el envío y la recepción de documentos funcionen correctamente antes de manejar información real o con validez legal definitiva.

3. Paso a Producción

• Una vez finalizado y aprobado el periodo de pruebas por el área de ingeniería, se te entregarán las credenciales definitivas.
• Con estas llaves de producción, ya estarás listo para operar en tu sistema de manera oficial.

Vinculación en Saturn Studio

Para conectar el módulo, sigue estos pasos con las credenciales finales que recibiste:

1. Abre el módulo de TuFirma.digital en Saturn Studio y haz clic en “New”.
2. Credential name: Asigna un nombre para identificar la conexión.
3. Api Key: Pega la llave de acceso proporcionada.
4. Secret Key: Pega la clave secreta de tu cuenta.
5. Haz clic en el botón “Check” para validar que la conexión con los servidores sea correcta.
6. Presiona “Save credentials” para finalizar.

¿Qué es Linkedin?

LinkedIn es la mayor red profesional del mundo. Este módulo permite a Saturn Studio conectarse con tu perfil o página de empresa para automatizar publicaciones y gestionar contenido profesional directamente desde tus flujos de trabajo.

Paso 1: Acceso y Requisitos

Para obtener las claves de conexión, necesitamos crear una “App” en el portal de desarrolladores de LinkedIn.

1. Dentro de Saturn Studio, en la configuración del módulo, haz clic en el enlace azul “here”. Esto te llevará directamente a linkedin.com/developers.
2. Inicia sesión con tu cuenta y haz clic en el botón Create app.

Paso 2: Completando el Formulario (Importante)

LinkedIn es estricto con los datos de sus aplicaciones. Para que te permita guardar la App, debes completar el formulario siguiendo estas reglas:

• App name: Elige un nombre para identificar tu integración (ej. Conexión Saturn Studio).
• LinkedIn Page: Este paso es obligatorio. Debes buscar y seleccionar una Página de Empresa existente de la cual seas administrador.

Nota: No puedes usar tu perfil personal aquí. Si no tienes una página de empresa, deberás crear una previamente en LinkedIn.

• Privacy policy URL: Debes pegar un enlace a la política de privacidad de tu web.

  • Tip: Si es para uso interno o pruebas, puedes poner temporalmente la URL principal de tu sitio web, pero el campo no puede quedar vacío.

• App logo: Es obligatorio subir una imagen. Debe ser un archivo cuadrado (ej. 100×100 píxeles), como el logo de tu empresa o un icono simple.
• Legal agreement: Marca la casilla para aceptar los términos y condiciones.

Una vez completado todo, haz clic en Create app.

Paso 3: Obtención de Credenciales

Con la aplicación ya creada, el sistema te mostrará el panel de administración.

1. Dirígete a la pestaña Auth (Autenticación) ubicada en la barra superior.
2. En la sección Application credentials, encontrarás los dos datos necesarios:

   • Client ID: Copia esta clave tal cual aparece.
   • Primary Client Secret: Haz clic en el ícono del ojo (👁️) para revelarla y cópiala.

Paso 4. Configuración del Redirect URI

El Redirect URI es la dirección a la que LinkedIn enviará el código de autorización tras el inicio de sesión. Si no coincide exactamente con la URL de Saturn Studio, la conexión será rechazada.

• Dirígete a la sección OAuth 2.0 settings.
• En el campo Authorized redirect URLs for your app, haz clic en el icono del lápiz y asegúrate de añadir:

  • https://studio.rocketbot.com

Paso 5. Selección de Scopes (Permisos)

Los “Scopes” definen qué acciones tiene permitido realizar Saturn Studio en tu cuenta. En la sección OAuth 2.0 scopes, debes verificar que tu aplicación tenga activos los siguientes permisos:

• openid: Permite el uso de tu nombre y foto de perfil para la identificación.
• profile: Proporciona acceso a la información básica de tu perfil profesional.
• w_member_social: Indispensable para que el bot pueda crear, modificar y eliminar publicaciones, comentarios y reacciones en tu nombre.

Configuración Final en Saturn Studio

Regresa a la pestaña de Saturn Studio y pega las claves que acabas de obtener:

1. Pega el Client ID y el Client Secret en sus campos correspondientes.
2. Haz clic en el botón azul Sign in with LinkedIn.
3. Se abrirá una ventana emergente de LinkedIn solicitando permisos para tu nueva App. Haz clic en Permitir (Allow).
4. Si la ventana se cierra sin errores, haz clic en Save credentials para guardar la conexión.

Google Meet es una aplicación de Google que permite realizar videollamadas y reuniones virtuales de forma gratuita. Su integración en Saturn Studio facilita la automatización de agendas, permitiendo crear, consultar y gestionar encuentros digitales de manera programática y eficiente.

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

Descripción de los Comandos

Crear un Meet (Create a Meet)

Crea una nueva reunión en Google Meet definiendo parámetros de tiempo, zona horaria y participantes.

Obtener un Meet (Get a Meet)

Recupera la información de un evento específico en Google Meet.

Eliminar un Meet (Delete a Meet)

Elimina un evento de reunión en Google Meet.

Actualizar un Meet (Update a Meet)

Actualiza los datos de un evento existente en Google Meet.

Listar Meets (List Meets)

Enumera las reuniones programadas en Google Meet dentro de un rango de fechas.

Google Tasks es una aplicación de gestión de tareas que permite crear, editar y organizar elementos pendientes de forma centralizada. Su integración facilita el seguimiento de objetivos diarios y la estructuración de flujos de trabajo de manera intuitiva y eficiente.

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

Descripción de los Comandos

Crear Tarea (Create Task)

Permite generar una nueva entrada en una lista de tareas específica.

Obtener Tarea (Get Task)

Recupera la información detallada de una tarea puntual.

Eliminar Tarea (Delete Task)

Remueve una tarea existente de una lista determinada.

Listar Tareas (List Tasks)

Devuelve todas las tareas presentes en una lista específica.

Actualizar Tarea (Update Task)

Modifica los atributos de una tarea ya creada.

Listar Listas de Tareas (List Tasks Lists)

Enumera los contenedores o listas de tareas disponibles en la cuenta.

Actualizar Lista (Update List)

Renombra o modifica una lista de tareas.

Obtener Lista (Get List)

Consulta los detalles específicos de una lista de tareas.

Eliminar Lista (Delete List)

Suprime una lista completa y todas las tareas contenidas en ella.

Crear Lista (Create List)

Genera una nueva lista de tareas en la cuenta vinculada.

¿Qué es Telegram?

Telegram es una plataforma de mensajería basada en la nube, reconocida por su velocidad y seguridad. Para integraciones en Saturn Studio, utilizamos la interfaz de Telegram Bots, lo que permite automatizar el envío de notificaciones, gestionar respuestas y conectar flujos de mensajería sin necesidad de un número de teléfono físico.

Cómo obtener la API Key (Bot Token)

Para vincular Telegram con Saturn Studio, es necesario generar un Bot Token único. A diferencia de otras plataformas, esta gestión se realiza directamente dentro de la aplicación de Telegram a través de la herramienta oficial de gestión de bots.

1. Acceso a BotFather

• Abre tu aplicación de Telegram (móvil o escritorio) e inicia sesión.
• En la barra de búsqueda, escribe @BotFather.
• Selecciona el usuario verificado (con la insignia azul ☑️) y haz clic en el botón Iniciar (o envía el comando /start).

2. Creación del Bot

• En el chat con BotFather, envía el comando /newbot.
• El sistema te pedirá un name (nombre público) para tu bot (ej. Mi Asistente Saturn). Escríbelo y envíalo.
• A continuación, te pedirá un username (nombre de usuario). Este debe ser único y terminar obligatoriamente en bot (ej. Test2026Rocket_bot).

3. Obtención del Token

• Si el nombre es válido, BotFather te enviará un mensaje de confirmación (“Done! Congratulations on your new bot…”).
• En ese mensaje, busca la sección que dice: “Use this token to access the HTTP API:”.
• Verás una cadena de caracteres larga (ej. 123456:ABC-DEF1234ghIkl...). Este es tu Telegram Api Key. Cópialo completo.

Configuración en Saturn Studio

Regresa a la pestaña de Saturn Studio donde tienes abierta la configuración de la credencial y completa los campos de la siguiente manera:

• Credential name: Un nombre identificador a tu elección para organizar tus credenciales.
• Telegram Api Key: Pega aquí el token que acabas de copiar desde BotFather.

Validación de la Credencial

• Haz clic en el botón Check situado a la derecha del campo de la API Key para verificar la conexión.
• Si el token es correcto, aparecerá un recuadro verde indicando: “Success! Credentials are valid and the request succeeded”.
• Finalmente, haz clic en Save credentials para guardar la configuración.

¿Qué es MySQL?

MySQL es uno de los sistemas de gestión de bases de datos relacionales más populares del mundo. Este módulo permite a Saturn Studio conectarse remotamente a tu servidor de base de datos para ejecutar consultas y gestionar información de manera automatizada.

Requisitos Previos: Acceso Remoto

⚠️ Importante: Como Saturn Studio opera desde la nube, no tiene acceso directo a tu servidor local. Para que la conexión funcione, debes autorizar el tráfico externo.

1. Habilitar Remote MySQL:

   • Dirígete a tu panel de hosting (ej. cPanel) y busca la herramienta Remote MySQL (MySQL Remoto).
   • Añade la Dirección IP de Saturn Studio a la lista de “Access Hosts” (Anfitriones de acceso) para permitir la conexión.
   • Nota: Si estás realizando pruebas y no conoces la IP exacta, puedes usar el comodín % temporalmente, aunque no se recomienda para entornos de producción por seguridad.

2. Firewall / Puerto 3306:

   • Asegúrate de que tu servidor tenga abierto el puerto 3306 para conexiones entrantes TCP.

Cómo obtener los datos de conexión

1. Dirección del Servidor (Server Address)

Debes ingresar la IP Pública de tu servidor o tu nombre de dominio (ej. db.midominio.com o 203.0.113.50).

⛔ Error Común: Nunca utilices localhost o 127.0.0.1. Esto hará que Saturn Studio intente conectarse a sí mismo en lugar de a tu servidor.

2. Base de Datos y Usuario

• En tu panel de control, ve a la sección MySQL Databases.
• Copia el nombre exacto de la base de datos (campo Database) y el usuario asignado a ella (campo User).

Configuración en Saturn Studio

Completa los campos de la credencial con la información recopilada:

• Credential name: Un nombre para identificar esta conexión (ej. Base de Datos Clientes).
• Server address: Tu IP pública o dominio (recuerda: no usar localhost).
• Server port: Por defecto es 3306.
• User: Tu usuario de base de datos.
• Password: La contraseña de dicho usuario.
• Database: El nombre de la base de datos a conectar.

Validación de la Credencial

• Haz clic en Save credentials.
• Si la IP de Saturn Studio fue autorizada correctamente en tu servidor y los datos son válidos, el sistema confirmará la conexión exitosa.

¿Qué es Voximplant?

Voximplant es una plataforma de comunicaciones en la nube que permite integrar funciones de voz, video y mensajería en aplicaciones web y móviles. Gracias a su potente infraestructura, facilita la automatización de llamadas entrantes y salientes, la creación de centros de contacto inteligentes y el procesamiento de audio en tiempo real, todo mediante una API flexible y escalable.

Cómo obtener el Access Token, Account Name y Region

Para vincular Voximplant con Saturn Studio, es necesario generar un token de acceso y conocer los identificadores de tu cuenta.

1. Acceso desde el módulo

• Dentro de la configuración del módulo en Saturn Studio, haz clic en el enlace azul “here” ubicado debajo del campo de Access Token.
• Esto te dirigirá al sitio oficial de Voximplant Kit.
• Inicia sesión con tus credenciales o regístrate si aún no tienes una cuenta.

2. Generación del API Token

• Una vez en el panel principal, dirígete a la sección de API tokens.
• Haz clic en el botón “Add API token” situado en la esquina superior derecha.
• En la ventana emergente, asigna un Name a la llave según tu preferencia (el nombre es a gusto propio) y haz clic en Save.
• Verás aparecer el Access token en la lista. Haz clic para copiarlo completamente.

3. Configuración en Saturn Studio

Regresa a Saturn Studio y completa los campos de la siguiente manera:

• Credential name: Un nombre identificador a tu elección.
• Access Token: Pega el código que acabas de generar en Voximplant.
• Account Name: Ingresa el nombre de usuario o de cuenta con el que te registraste en Voximplant (ej. testrocketbot).
• Region: Especifica la región que estás utilizando en tu consola (ej. US).

Validación de la Credencial

• Haz clic en el botón “Check” para verificar la conexión.
• Si los datos son correctos, aparecerá un recuadro verde indicando: “Success! Credentials are valid and the request succeeded” y el estado pasará a Connected.
• Finalmente, haz clic en “Save credentials”.