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”.

¿Qué es X?

X (anteriormente Twitter) es una plataforma de microblogging y red social en tiempo real. Su API permite que herramientas como Saturn Studio automaticen la publicación de contenido, monitoreen interacciones y gestionen perfiles de forma programática.

Cómo obtener las credenciales de X

1. Acceso y Solicitud de Desarrollador

• Sesión y Registro: Debes iniciar sesión con tu cuenta de X y registrarte en el portal oficial de X Developer Platform.
• Solicitud de Acceso: Una vez registrado, es indispensable hacer la solicitud de acceso al nivel de API que necesites (Free, Basic o Pro). Sin esta aprobación explícita por parte de X, no podrás generar llaves de acceso válidas.

2. Creación de la Aplicación

• Una vez aprobada tu solicitud, dirígete al Dashboard y haz clic en “Create App”.
• Nombre de la App: Introduce un nombre único para identificar tu proyecto.
• Haz clic en “Get keys” para avanzar al siguiente paso.

3. Obtención de Consumer Keys

Inmediatamente después de crear la app, el sistema te proporcionará las llaves iniciales:

• API Key: Funciona como el Consumer Key en Saturn Studio.
• API Key Secret: Funciona como el Consumer Secret en Saturn Studio.
• Importante: Copia y resguarda estas llaves en un lugar seguro, ya que la plataforma no las volverá a mostrar por completo.

4. Generación de Access Tokens

Si ya tienes la app creada, sigue esta ruta:

• Entra a la configuración de tu aplicación (App settings) mediante el icono de engranaje.
• Selecciona la pestaña “Keys and tokens”.
• En el apartado Authentication Tokens, localiza Access Token and Secret y haz clic en “Generate”.
• Se generarán el Access Token y el Access Token Secret. Cópialos inmediatamente.

Configuración en Saturn Studio

Completa los campos en el módulo con la información recolectada:

• Tras ingresar los datos, utiliza el botón “Check” para validar la comunicación con los servidores de X.
• Finaliza presionando “Save credentials”.

Bibliografía de Consulta

Para más detalles sobre los límites de uso o niveles de suscripción, consulta la guía técnica oficial:

Documentación oficial:X Developer Docs – Authentication

¿Qué es Mercado Pago?

Mercado Pago es la solución fintech de Mercado Libre que permite procesar cobros, gestionar suscripciones y realizar pagos de forma segura tanto en entornos digitales como físicos. Al integrar esta credencial en Saturn Studio, podrás automatizar la conciliación de pagos, generar links de cobro y consultar el estado de tus transacciones en tiempo real.

Cómo obtener el Client ID y el Client Secret

Para vincular tu cuenta, es necesario registrar una aplicación en el portal de desarrolladores de Mercado Pago para generar las llaves de acceso.

1. Acceso y Creación

• En el módulo de Saturn Studio, haz clic en el enlace azul “here”.
• Inicia sesión con tu cuenta de Mercado Pago.
• En el panel de “Tus integraciones”, haz clic en el botón azul “Crear aplicación”.

2. Configuración de la Aplicación

• Identificación: Completa el nombre de la aplicación a gusto propio y acepta los términos.
• Tipo de Pago: Selecciona si planeas integrar Pagos online (Checkout, Bricks) o Pagos presenciales (QR, Point) según tu necesidad.
• Modelo de Integración: Elige el tipo de Checkout que utilizarás (ej. Checkout Pro o Checkout API) y continúa con el formulario.

3. Configuración de URL

Una vez creada la app, deberás dirigirte a la sección de edición para configurar el retorno de datos:

• Busca el apartado de Configuraciones avanzadas.
• Localiza el campo URLs de redireccionamiento.
• Pega exactamente la dirección: https://studio.rocketbot.com.

4. Obtención de Credenciales

• Una vez guardada la configuración, en el Dashboard podrás visualizar tus datos.
• Allí podrás copiar el Client ID y el Client Secret generados por Mercado Pago para tu cuenta.

Vinculación en Saturn Studio

1. Regresa al módulo de Saturn Studio e ingresa un Credential name para identificarla.
2. Pega el Mercado Pago Client ID y el Mercado Pago Client Secret en sus respectivos campos.
3. Haz clic en el botón “Check”.
4. Se abrirá una ventana de Mercado Pago; acepta los permisos de vinculación para finalizar el proceso.
5. Si los datos son correctos, haz clic en “Save credentials”.

¿Qué es Mistral.AI?

Mistral.AI es una plataforma de inteligencia artificial que ofrece modelos de lenguaje (LLM) de alto rendimiento y eficiencia. Su tecnología permite a desarrolladores y empresas integrar capacidades avanzadas de generación de texto, razonamiento lógico y análisis de datos en sus propias aplicaciones a través de una API potente y flexible.

Cómo obtener la Mistral AI API Key

Para que Saturn Studio pueda utilizar los modelos de Mistral, necesitas generar una llave de autenticación desde su consola oficial siguiendo estos pasos:

1. Acceso y Registro

• Acceso desde el módulo: En la configuración de Saturn Studio, haz clic en el enlace azul “here”. Este link te redirigirá automáticamente al sitio oficial de desarrolladores de Mistral.AI para crear tu API Key.
• REQUISITO INDISPENSABLE: Es una necesidad absoluta estar registrado previamente y pertenecer a una organización o equipo dentro de la plataforma. Si no cumples con este requisito, no tendrás acceso a la consola de administración de llaves.

2. Generación de la API Key

• Una vez dentro de tu workspace, dirígete a la sección de API Keys.
• Si no tienes ninguna, verás un botón central; de lo contrario, haz clic en “Create new key”.

3. Configuración de la Llave

• Key name: Completa este campo con el nombre que prefieras para identificar la integración. El nombre es a gusto propio.
• Expiration: Tienes la opción de programar una fecha de vencimiento automática si así lo deseas.
• Haz clic en el botón “Create new key” para confirmar.

4. Copia de la Credencial

• Paso Crítico: Al crearse la llave, aparecerá el código en pantalla.
• Haz clic en “Copy key” y pégala de inmediato en Saturn Studio. Por seguridad, Mistral no volverá a mostrar esta llave completa una vez que cierres la ventana.

Vinculación en Saturn Studio

1. Regresa al módulo, ingresa un Credential name y pega tu código en el campo Mistral AI API Key.
2. Haz clic en el botón “Check”.
3. Si la configuración es correcta, verás el mensaje de éxito (Success!) y el estado pasará a Connected.
4. Finalmente, haz clic en “Save credentials”.