Saturn Studio – Credencial Microsoft Teams (Microsoft Graph)

Este módulo conecta Saturn Studio con Microsoft Graph para operar en Teams (leer/enviar mensajes, crear chats, gestionar miembros, etc.) usando OAuth 2.0.

1) Iniciar sesión y registrar la aplicación

  1. Entra a Azure Portal → Microsoft Entra ID → Registros de aplicaciones
    (o usa el acceso directo del portal a la lista de apps).
  2. Haz clic en Nuevo registro.
  3. Nombre: pon un nombre identificable (ej.: Saturn Studio – Teams).
  4. Tipos de cuentas compatibles (elige uno):

Opción (audiencia) ¿Quién puede iniciar sesión? Qué pones en Tenant ID en Saturn Studio
Inquilino único (Single-tenant) Solo usuarios de tu organización GUID de tu tenant (Directory (tenant) ID)
Multiinquilino (solo organizaciones) Usuarios de cualquier directorio (sin cuentas personales) Usa organizations o el tenant GUID que necesites
Multiinquilino + cuentas personales Org. + cuentas personales (MSA) Usa common (o un tenant GUID si quieres fijar uno)

Nota: muchas API de Teams no funcionan con cuentas personales. Para escenarios de empresa, usa Inquilino único o Multiinquilino (organizational).

  1. URI de redirección

    • Tipo: Web
    • URL: https://studio.rocketbot.com
      (Debe coincidir exactamente con lo que muestre el formulario de la credencial en Saturn Studio.)

  2. Haz clic en Registrar.

2) Obtener identificadores y secreto

En la ficha de la aplicación copia:

  • Application (client) ID → será tu Client ID.
  • Directory (tenant) ID → será tu Tenant ID (si usas single-tenant).

Guía recomendada para esta sección: Microsoft Learn

Ve a Certificados y secretos → Nuevo secreto de cliente.

  • Define la vigencia (elige la mayor posible que cumpla tu política).
  • Copia el valor del secreto inmediatamente (no el ID), se oculta luego.

3) Agregar permisos (Microsoft Graph → Delegados)

Ruta: Permisos de API → Agregar un permiso → Microsoft Graph → Permisos delegados.

Esenciales (OIDC)

  • openid, offline_access, email.

Teams (elige solo lo necesario, principio de menor privilegio)

  • Canales:

    • Channel.ReadBasic.All (ver nombres y descripciones de canales).
    • Guía recomendada para esta sección: Microsoft Learn+1
    • Mensajes de canal: ChannelMessage.Read.All (leer) y ChannelMessage.Send (enviar).
    • Guía recomendada para esta sección: Microsoft Learn+1

  • Chats 1:1 / grupales:

    • Chat.Read, Chat.ReadWrite, Chat.Create.
    • Guía recomendada para esta sección: Graph Permissions+1
    • (Opcional avanzado) Chat.ManageDeletion.All para borrar/restaurar chats — requiere rol admin.
    • Guía recomendada para esta sección: Graph Permissions+1

  • Equipos/miembros:

    • Team.ReadBasic.All, TeamMember.Read.All, TeamMember.ReadWrite.All (agregar/quitar miembros).
    • Guía recomendada para esta sección: Microsoft Learn+1

Muchas operaciones de Teams no admiten cuentas personales; para “Delegated (personal Microsoft account)” suele mostrarse Not supported en la tabla de permisos.

Guía recomendada para esta sección: Microsoft Learn+1

Cuando termines, haz clic en Conceder consentimiento de administrador para tu organización (evita que cada usuario deba aprobar permisos).

Guía recomendada para esta sección: Microsoft Learn+1

4) Cargar la credencial en Saturn Studio (módulo Microsoft Teams)

Completa los campos:

Campo Descripción Ejemplo
Client ID Application (client) ID de tu app registrada xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Tenant ID common, organizations o el GUID del tenant (según tu elección en “Tipos de cuentas”) common
Client Secret Valor del secreto de cliente generado ******

Guarda y realiza el Sign in / Consent desde el módulo.



Saturn Studio – Credencial iLovePDF

iLovePDF permite convertir, comprimir, unir, dividir y editar PDFs. Este módulo conecta Saturn Studio con la iLovePDF API para automatizar esas tareas dentro de tus flujos.

¿Qué es este módulo?

El módulo se autentica con Public Key y Secret Key de iLovePDF. Con esas credenciales, Saturn Studio gestiona el flujo estándar de la API (Start → Upload → Process → Download).

La plataforma ofrece una cuenta gratuita con 250 archivos/mes para pruebas y desarrollo.

Cómo generar las credenciales de iLovePDF

  1. Crear cuenta / Iniciar sesión
    Regístrate o inicia sesión en el portal de desarrolladores para acceder a tu consola.
  2. Acceder al panel (Developer Console)
    Al registrarte tendrás un Default Project ya creado con su par de claves (Public Key + Secret Key). Desde la consola puedes crear nuevos proyectos; cada proyecto genera su propio par de claves.
  3. Obtener las claves
    En API Keys del proyecto copia tu Public Key y Secret Key. (La guía “Quick Start” indica obtenerlas desde la sección API Keys de la consola).

Configurar la credencial en Saturn Studio

  1. Abre el módulo iLovePDF en Saturn Studio.
  2. Haz clic en New para crear una nueva credencial.
  3. Completa los campos:

Campo Descripción Ejemplo
Credential name Nombre identificador de la credencial ilovepdf-prod
Public Key Clave pública del proyecto iLovePDF project_public_key
Secret Key Clave secreta asociada al proyecto project_secret_key

  1. Guarda la credencial. A partir de aquí podrás usar las acciones de iLovePDF (convertir, unir, dividir, comprimir, etc.) dentro de tus flujos.

Notas útiles

  • Si necesitas más volumen que el plan gratuito, puedes aumentar el límite mensual desde Pricing.
  • La API dispone de librerías oficiales (PHP, .NET, Ruby, Node.js) que ya gestionan la firma JWT con Public/Secret Key.
  • Guia oficial de iLoveAPI – A PDF REST API for developers



Saturn Studio – Hugging Face

¿Qué es este módulo?

Hugging Face es una plataforma de IA de código abierto que ofrece modelos de lenguaje, visión por computadora y más. Facilita el uso e implementación de modelos de machine learning de vanguardia dentro de Saturn Studio

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

Comandos disponibles

  • Chat completion
  • Summarize Text
  • Translate Text
  • Generate Embeddings
  • Generate an Image

Descripción de los comandos

1) Chat completion

Completa un chat usando un modelo de Inferencia de Hugging Face.

Parámetro Descripción Ejemplo
Credential Credencial de Hugging Face necesaria para completar el chat Mis credenciales de Hugging Face
Model ID del modelo en Hugging Face para completar el chat Model
Provider Proveedor para ejecutar la inferencia cerebras
Text Texto del mensaje a completar Text
Max tokens Máximo de tokens a generar 300
Temperature Temperatura de muestreo. Valores altos generan respuestas más creativas; valores bajos, más conservadoras. Rango 0–2, por defecto 1 1
Assign result to variable Variable donde se almacenará el resultado. Ejemplo de salida: {“response”:”Hi there! 😊 How can I assist you today?”,”model_used”:”Qwen/Qwen3-32B”,”input_messages”:[{“role”:”user”,”content”:”Hello chat”}],”usage”:{“prompt_tokens”:10,”completion_tokens”:102,”total_tokens”:112}} {var}

2) Summarize Text

Resume un texto usando un modelo de Inferencia de Hugging Face.

Parámetro Descripción Ejemplo
Credential Credencial de Hugging Face necesaria para resumir el texto Mis credenciales de Hugging Face
Model ID del modelo en Hugging Face para resumir Model
Provider Proveedor para ejecutar la inferencia cerebras
Text Texto a resumir Text
Min Length Longitud mínima del resumen 300
Max Length Longitud máxima del resumen 500
Assign result to variable Variable donde se almacenará el resultado. Ejemplo de salida: {“response”:”Keep it simple and open-ended…”,”model_used”:”facebook/bart-large-cnn”,”input_text”:”That’s a greeting…”} {var}

3) Translate Text

Traduce un texto usando un modelo de Inferencia de Hugging Face.

Parámetro Descripción Ejemplo
Credential Credencial de Hugging Face necesaria para traducir el texto Mis credenciales de Hugging Face
Model ID del modelo en Hugging Face para traducir Model
Provider Proveedor para ejecutar la inferencia cerebras
Text Texto a traducir Text
Language Idioma destino de la traducción (por ejemplo: ‘en’ inglés, ‘es’ español, ‘fr’ francés) en
Assign result to variable Variable donde se almacenará el resultado. Ejemplo de salida: {“response”:”Usos principales NLLB-200 es un modelo de traducción automática…”,”model_used”:”Helsinki-NLP/opus-mt-en-es”,”input_text”:”Primary intended uses NLLB-200 is a machine translation model…”} {var}

4) Generate Embeddings

Genera embeddings para un texto usando un modelo de Inferencia de Hugging Face.

Parámetro Descripción Ejemplo
Credential Credencial de Hugging Face necesaria para generar embeddings Mis credenciales de Hugging Face
Model ID del modelo en Hugging Face para generar embeddings Model
Text Texto a procesar Text
Provider Proveedor para ejecutar la inferencia cerebras
Truncate Si está habilitado, el texto se truncará al máximo permitido por el modelo. Útil para textos largos (habilitado)
Assign result to variable Variable donde se almacenará el resultado. Ejemplo de salida: {“response”:[[0.02355957,-0.01794434,0.00296021,0.01513672,…]],”model_used”:”Qwen/Qwen3-Embedding-8B”,”input_text”:”Primary intended uses NLLB-200…”,”dimensions”:4096} {var}

5) Generate an Image

Genera una imagen a partir de un prompt usando un modelo de Inferencia de Hugging Face.

Parámetro Descripción Ejemplo
Credential Credencial de Hugging Face necesaria para generar la imagen Mis credenciales de Hugging Face
Model ID del modelo en Hugging Face para generar la imagen Model
Prompt Prompt desde el que se generará la imagen Prompt
Provider Proveedor para generar la imagen cerebras
Assign result to variable Variable donde se almacenará el resultado. Ejemplo de salida: [{“filename”:”saturn_hugging-face_1747255067961.png”,”id”:”2500b30f…”,”size”:3163231,”provider”:”hugging-face”}] {var}

Requisitos

  • Contar con una credencial de Hugging Face válida (User Access Token, formato hf_…).
  • ID de modelo válido de Hugging Face y, cuando corresponda, proveedor soportado (por ejemplo, cerebras).



Saturn Studio – Credencial Hugging Face

Este módulo permite integrar Saturn Studio con los modelos de inferencia de Hugging Face, habilitando tareas como resumen de texto, traducción, entre otros.

¿Cómo crear una credencial de Hugging Face en Saturn Studio?

  1. Abre el módulo Hugging Face en Saturn Studio.
  2. Haz clic en New para crear una nueva credencial.
  3. Completa los campos:

Campo Descripción Ejemplo
Credential name Nombre para identificar la credencial. huggingface-prod
API Key Pega tu User Access Token de Hugging Face (formato hf_…). hf_xxxxx...

  1. Haz clic en Check para validar la API Key.
  2. Presiona Save credentials para guardar.

¿Cómo obtener la API Key (User Access Token) de Hugging Face?

  1. Inicia sesión en tu cuenta de Hugging Face.
  2. Ve a Settings → Access Tokens y elige New token.
  3. Selecciona el rol de tu token y ponle un nombre:

    • read: solo lectura (recomendado si solo harás descargas/uso de inferencia).
    • write: lectura + escritura (necesario si vas a subir/editar repos).
    • fine-grained: acceso específico a recursos; ideal para producción

  4. Cópialo y guárdalo: el token comienza con hf_….
  5. Pégalo en el campo API Key de la credencial en Saturn Studio y guarda.

Nota: Los User Access Tokens pueden usarse como bearer token para llamadas de inferencia (Inference Providers / Inference API).

Recomendaciones de seguridad

  • Un token por proyecto/ambiente (p. ej., uno para local, otro para producción) para poder revocarlos sin afectar otros usos.
  • Evita filtrar el token en repos públicos; si se filtra, róta el token desde Settings → Access Tokens.

Guia Oficial de Hugging Face



Saturn Studio – Credencial HubSpot

HubSpot es una plataforma CRM que ofrece herramientas para marketing, ventas, atención al cliente y gestión de contenido.
Este módulo de Saturn Studio permite interactuar con la API de HubSpot para automatizar tareas como la creación y actualización de contactos, negocios y empresas.

¿Qué es este módulo?

Este módulo conecta Saturn Studio con HubSpot mediante autenticación OAuth 2.0.
Para utilizarlo, es necesario crear una aplicación en el portal de desarrolladores de HubSpot y obtener las credenciales correspondientes (Client ID, Client Secret y Auth URL).

Cómo generar las credenciales de HubSpot

Debes ser un superadministrador para instalar una aplicación en una cuenta de HubSpot.

  1. Acceder al portal de desarrolladores de HubSpot

  2. Crear una nueva aplicación

    • En el panel, selecciona Apps → Create App.
    • Ingresa un nombre y una descripción para tu aplicación.

  3. Configurar la autenticación OAuth

    • Ve a la pestaña Auth.
    • En Redirect URLs, agrega: https://studio.rocketbot.com.
    • Selecciona los scopes (permisos) necesarios para tu integración, por ejemplo:

      • crm.objects.contacts.read
      • crm.objects.contacts.write
      • crm.objects.companies.read
      • crm.objects.companies.write
      • (Agrega más según las funciones que quieras usar)

  4. Registrar la aplicación

    • Guarda la configuración.
    • Copia el Client ID y Client Secret que se mostrarán en la pestaña Auth.

Configuración de la credencial en Saturn Studio

  1. Abre el módulo HubSpot en Saturn Studio.
  2. Haz clic en New para crear una nueva credencial.
  3. Completa los campos:

Campo Descripción
Credential name* Nombre identificador para la credencial (ej: Hubspot_Prod).
Client ID* Pega el Client ID obtenido en HubSpot.
Client Secret* Pega el Client Secret generado en HubSpot.
Auth URL* Usa la URL de autorización: https://app.hubspot.com/oauth/authorize

* Campos obligatorios

  1. Haz clic en Connect to HubSpot y sigue el flujo de autenticación.
  2. Guarda la credencial con Save credentials

Guia oficial de HubSpot para más información.



Saturn Studio – System

System Module – Saturn Studio

📌 ¿Qué es este módulo?

El módulo System brinda herramientas esenciales para manejar la ejecución de procesos en Saturn Studio. Incluye funciones para controlar tiempos de espera, manejar variables, registrar logs, ejecutar otros robots o procesos y generar excepciones cuando sea necesario.

Es ideal para coordinar la lógica de un flujo, dar trazabilidad a la ejecución y manejar errores de forma controlada.

⚙️ Comandos disponibles

Run robot or process

Ejecuta un robot o proceso creado en Saturn Studio o compartido en el marketplace.

Parámetro Descripción Ejemplo
Robot/Proceso Nombre del robot a ejecutar test/tests
Parámetros Variables que se pasan al robot {“user”:”admin”}
Asignar resultado a variable Guarda la salida en una variable {result}

System Wait

Hace que el flujo espere un tiempo específico antes de continuar.

Parámetro Descripción Ejemplo
Segundos Tiempo de espera en segundos 5

Set var

Asigna un valor a una variable dentro del flujo.

Parámetro Descripción Ejemplo
Data Valor que se asignará “admin”
Asignar resultado a variable Nombre de la variable {user}

Get Last Status

Obtiene el estado de la última ejecución de un proceso.

Parámetro Descripción Ejemplo
Variable Variable donde se guarda el estado {status}

Log Message

Escribe un mensaje en el log del proceso.

Parámetro Descripción Ejemplo
Mensaje Texto a registrar “Proceso completado”
Nivel Severidad (trace, info, warn, error, fatal) info

Raise Exception

Genera una excepción y detiene el flujo.

Parámetro Descripción Ejemplo
Mensaje Texto del error “Variable no encontrada”
Tipo de excepción Categoría del error (SystemError, RocketbotError, BusinessError, ValidationError) SystemError

🧪 Ejemplo de uso

Escenario: Ejecutar un proceso y validar su estado.

  1. Run robot or process

    • Robot: test/tests
    • Asignar resultado: {output}

  2. System Wait

    • Segundos: 3

  3. Get Last Status

    • Variable: {status}

  4. Log Message

    • Mensaje: “Estado final: {status}”
    • Nivel: info

🧩 Requisitos

Este módulo viene incluido en Saturn Studio y no requiere configuración adicional.



Saturn Studio – Credencial Deep Seek

Para obtener las credenciales de Deep Seek en Saturn Studio, sigue estos pasos:

1. Acceso al módulo Deep Seek

Dirígete al módulo Deep Seek en Saturn Studio y haz clic en New para crear una nueva credencial.

2. Asignar un nombre a la credencial

Ingresa un nombre para la credencial.

3. Obtener la API Key de Deep Seek

Haz clic en el enlace proporcionado debajo del campo de API Key, lo que abrirá una nueva pestaña con la página oficial de Deep Seek.

4. Registrarse en Deep Seek

Regístrate en la página oficial de Deep Seek si aún no tienes una cuenta.

5. Crear la API Key

Una vez registrado, Deep Seek te permitirá crear nuevas API Keys. Haz clic en el botón Create API Key.

6. Configurar la API Key

Asigna un nombre a la API Key y luego Deep Seek te proporcionará la clave. Copia esta API Key.

7. Ingresar la API Key en Saturn Studio

Regresa a Saturn Studio y pega la API Key en el módulo de Deep Seek.

8. Verificar la credencial

Haz clic en el botón de Check para comprobar que la API Key es correcta. Si todo está en orden, habrás creado correctamente la credencial de Deep Seek.



Saturn Studio – Credencial Freshdesk

Para obtener las credenciales de Freshdesk en Saturn Studio, sigue estos pasos:

1. Crear una nueva credencial

Accede al módulo Freshdesk en Saturn Studio y haz clic en New para crear una nueva credencial.

2. Completar los campos

Dentro del módulo, deberás completar los siguientes campos:

  • Nombre: Nombre identificador de la credencial.
  • Dominio: El subdominio de tu cuenta en Freshdesk (por ejemplo, si tu URL es tuempresa.freshdesk.com, el dominio es tuempresa).
  • API Key: La clave que obtendrás desde tu cuenta de Freshdesk (explicado abajo).

3. Obtener la API Key de Freshdesk

Sigue estos pasos para obtener tu API Key:

Inicia sesión en tu cuenta de Freshdesk.

Haz clic en tu foto de perfil en la esquina superior derecha y selecciona Profile Settings.

En el panel derecho, haz clic en la opción View API Key y completa la verificación captcha.

Copia la API Key que se muestra.

🔐 Importante: Guarda tu API Key en un lugar seguro, ya que se utiliza para autenticar integraciones con herramientas externas como Saturn Studio.

4. Ingresar la API Key en Saturn Studio

Vuelve al módulo Freshdesk en Saturn Studio y pega la API Key, junto con el nombre y el dominio correspondientes.

5. Verificar la credencial

Haz clic en el botón de verificación para confirmar que todo está correcto. Si no hay errores, la credencial quedará registrada y lista para ser utilizada.



Saturn Studio – Credencial Gemini

Para obtener las credenciales de Gemini en Saturn Studio, sigue estos pasos:

1. Acceso al módulo Gemini

Ingresa al módulo Gemini en Saturn Studio y haz clic en New para crear una nueva credencial.

2. Asignar nombre a la credencial

Ingresa un nombre descriptivo para identificar la credencial.

3. Obtener la API Key de Gemini

Haz clic en el enlace que aparece debajo del campo de API Key. Este enlace te redirigirá a Google AI Studio.

4. Acceder a Google AI Studio

En la interfaz de Google AI Studio, tendrás las siguientes opciones:

  • Probar Gemini
  • Ver las API Keys
  • Ver la documentación de la API

Acepta los términos y condiciones de uso de Google Gemini para continuar.

5. Crear la API Key

En el panel de API Keys, selecciona la opción para crear una nueva API Key.

Durante este proceso, se te pedirá que selecciones un proyecto activo en Google Cloud. Puedes usar uno existente o crear uno nuevo.

Una vez confirmado, se generará la API Key de Gemini. Cópiala y guárdala en un lugar seguro.

6. Ingresar la API Key en Saturn Studio

Vuelve a Saturn Studio, pega la API Key de Gemini en el campo correspondiente del módulo y completa la configuración.

7. Verificar la credencial

Haz clic en el botón de verificación para confirmar que la API Key es válida. Si todo está correcto, habrás creado correctamente tu credencial de Gemini.



Saturn Studio – Credencial GitHub

Para obtener las credenciales de GitHub en Saturn Studio, sigue estos pasos:

1. Acceso al módulo GitHub

Ingresa al módulo GitHub en Saturn Studio y haz clic en el botón New para crear una nueva credencial.

2. Completar los campos

En el módulo deberás completar los siguientes datos:

  • Nombre: Nombre identificador para la credencial.
  • Client ID
  • Client Secret

3. Obtener el Client ID y Client Secret de GitHub

Haz clic en el enlace que aparece debajo del campo para ser redirigido a la página oficial de GitHub.

Si no tienes una cuenta, regístrate primero.

4. Crear una nueva OAuth App

Una vez registrado, accede a la sección Developer settings > OAuth Apps y selecciona Create a new OAuth App.

Completa los campos requeridos (nombre de la app, URL de callback, etc.).

5. Generar las credenciales

Después de crear la app, GitHub te mostrará:

  • Client ID: visible inmediatamente.
  • Client Secret: se genera mediante un botón y debe copiarse inmediatamente ya que se muestra solo una vez.

Copia ambos códigos.

6. Ingresar los datos en Saturn Studio

Regresa al módulo GitHub en Saturn Studio y pega el Client ID y el Client Secret en sus respectivos campos.

7. Conectar con GitHub

Haz clic en el botón Connect to GitHub.

GitHub te pedirá autorización para conectar con Saturn Studio. Una vez concedido el permiso, las credenciales quedarán configuradas correctamente.