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?
Abre el módulo Hugging Face en Saturn Studio.
Haz clic en New para crear una nueva credencial.
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...
Haz clic en Check para validar la API Key.
Presiona Save credentials para guardar.
¿Cómo obtener la API Key (User Access Token) de Hugging Face?
Inicia sesión en tu cuenta de Hugging Face.
Ve a Settings → Access Tokens y elige New token.
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
Cópialo y guárdalo: el token comienza con hf_….
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.
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.
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.
Run robot or process
Robot: test/tests
Asignar resultado: {output}
System Wait
Segundos: 3
Get Last Status
Variable: {status}
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.
Saturn Studio – Credencial Gmail
Obtener las credenciales de Gmail en Saturn Studio
Configuración paso a paso:
2.1 Crear / elegir proyecto y habilitar APIs
Entra a Google Cloud Console y accede a tu proyecto (crea uno nuevo si hace falta).
Desde la barra de búsqueda superior, escribe y abre cada servicio para Habilitar:
Google Gmail API
Google Drive API (requerida si listarás/crearás archivos o usarás el selector de Drive).
En cada API, haz clic en Habilitar y verifica que el estado final quede como “Habilitada”.
Si una API no está habilitada, la autenticación puede funcionar, pero las llamadas a la API fallarán con el error access_not_configured.
2.2 Configurar Pantalla de consentimiento OAuth
Ruta: APIs y servicios → Pantalla de consentimiento OAuth → Configurar pantalla de consentimiento
Completa los datos básicos:
Nombre de la app
Correo de soporte
(Opcional) Política de privacidad, Términos del servicio y dominio verificado
Luego selecciona el tipo de usuario:
Tipos de usuario para la Pantalla de consentimiento OAuth
Opción
¿Quién puede usar la app?
Qué debes hacer
Interno
Solo usuarios de tu organización (dominio de Google Workspace). No funciona con cuentas @gmail.com personales.
– No necesitas agregar testers. Cualquier usuario del dominio puede autorizar. Úsalo si todo tu equipo pertenece al mismo dominio.
Usuarios externos
Cualquier usuario con Cuenta de Google, pero la app inicia en modo de prueba.
– Debes agregar manualmente a los usuarios de prueba (incluyéndote) para poder autorizar. Sólo esos usuarios podrán iniciar sesión mientras la app esté en prueba. Para abrirla a más usuarios/publicar, debes enviar a verificación si usas scopes sensibles/restringidos.
Notas importantes
Usar Google Gmail o Drive suele marcar los scopes como sensibles.
Para pasar la app a Producción (sin testers), Google puede solicitar:
Dominio verificado
Política de privacidad pública
Logo de aplicación
Verificación del equipo
Guarda los cambios.
Scopes necesarios para la integración con Gmail
Durante la configuración avanzada, asegúrate de incluir los siguientes scopes de autorización y para ello sigue las instrucciones:
Instrucciones:
Dentro de Pantalla de consentimiento, dirígete a la sección Acceso a los datos.
Haz clic en Agregar o quitar permisos.
Allí tendrás dos opciones:
Buscar y seleccionar permisos desde la lista disponible, o
Luego de pegarlos, agrégalos a la tabla y haz clic en Actualizar y guardar.
Una vez terminado esto podremos crear un cliente OAuth en métricas.
Rellena los campos correspondientes:
Tipo de aplicación: selecciona “Aplicación web”.
Nombre de la app.
URLs de redirección
Una vez finalizado, Google generará tu:
Client ID
Client Secret
Copia ambos valores y pégalos en el módulo Gmail en Saturn Studio.
✅ Resultado final
Si todo fue ingresado correctamente, ya tendrás tu credencial de Gmail configurada en modo avanzado, lista para ser utilizada en flujos automatizados dentro de Saturn Studio.
Saturn Studio – Credencial Google Calendar
Para integrar Google Calendar con Saturn Studio, puedes hacerlo mediante modo básico o con una configuración avanzada a través de Google Cloud.
Método Básico (Conexión rápida)
Pasos:
Ingresa al módulo Google Calendar en Saturn Studio.
Haz clic en el botón “New” para crear una nueva credencial.
Asigna un nombre a la credencial.
Haz clic en “Conectar con Google” y selecciona tu cuenta.
Otorga los permisos solicitados por Saturn Studio.
✅ Una vez completado el proceso, la credencial estará lista para usar las funciones básicas del módulo.
Configuración Avanzada (OAuth 2.0 con Google Cloud)
Este método da mayor control de permisos y seguridad. Define manualmente los accesos que usará Saturn Studio.
Crear / elegir proyecto y habilitar APIs
Entra a Google Cloud Console y accede a tu proyecto (crea uno si hace falta).
Desde la barra de búsqueda superior, escribe y abre cada servicio para Habilitar:
Google Calendar API
Verifica que queden con estado Habilitado.
Si una API no está habilitada, la autenticación puede funcionar, pero las llamadas fallarán por access_not_configured.
Configurar Pantalla de consentimiento OAuth
Ruta: APIs y servicios → Pantalla de consentimiento OAuth → Configurar pantalla de consentimiento.
Completa:
Nombre de la aplicación
Correo de soporte
(Opcional) Política de privacidad, Términos y dominio (recomendado para publicación/producción)
Público (tipo de usuario)
Elige uno y actúa según corresponda:
Opción
¿Quién puede usar la app?
Qué debes hacer
Interno
Solo usuarios de tu organización (dominio de Google Workspace). No funciona con cuentas @gmail.com personales.
No necesitas agregar testers. Cualquier usuario del dominio puede autorizar. Úsalo si todo tu equipo pertenece al mismo dominio.
Usuarios externos
Cualquier usuario con Cuenta de Google, pero la app inicia en modo de prueba.
Debes agregar manualmente a los usuarios de prueba (incluyéndote) para poder autorizar. Sólo esos usuarios podrán iniciar sesión mientras la app esté en prueba. Para abrirla a más usuarios/publicar, debes enviar a verificación si usas scopes sensibles/restringidos.
Guarda los cambios.
Agregar scopes (permisos) a la app
Ruta: Pantalla de consentimiento OAuth → Acceso a los datos → Agregar o quitar permisos.Agrega manualmente los scopes que necesites (principio de menor privilegio):
Scopes recomendados para Google Calendar
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.events
https://www.googleapis.com/auth/userinfo.email
https://www.googleapis.com/auth/userinfo.profile
openid
Actualiza y guarda.
Crear Client ID y Client Secret
Ruta: APIs y servicios → Credenciales → Crear credencial → ID de cliente de OAuth.
Completa:
Tipo de aplicación: Aplicación web
Nombre: por ejemplo, Saturn Studio
URIs de redirección:
https://studio.rocketbot.com/
Al guardar, Google genera:
Client ID
Client Secret
Cópialos y resérvalos.
Cargar credenciales en Saturn Studio
Regresa al módulo Google Calendar en Saturn Studio.
En el modo Avanzado (OAuth), pega el Client ID y Client Secret en los campos correspondientes.
Guarda la credencial y realiza la conexión.
Notas importantes
Usuarios externos (modo de prueba): agrega tu correo y los de tu equipo en Usuarios de prueba. Si no están en la lista, verán error al autorizar.
Interno: solo disponible con Google Workspace. Si usas cuenta personal @gmail.com, deberás elegir Usuarios externos.
Scopes y APIs: los scopes permiten solicitar permisos; habilitar la API permite realmente usarla. Necesitas ambos.
URIs de redirección: deben coincidir exactamente con lo configurado en Google Cloud.
Verificación: para publicar la app a producción (externa) y usar scopes sensibles/restringidos, Google puede requerir verificación (política de privacidad pública, dominio verificado, branding, etc.).
Saturn Studio – Credencial Google Docs
Para utilizar Google Docs en Saturn Studio, puedes optar por la integración mediante modo básico o configuración avanzada a través de Google Cloud.
1. Método Básico (Conexión rápida)
Pasos:
Accede al módulo Google Docs en Saturn Studio.
Haz clic en el botón “New” para crear una nueva credencial.
Asigna un nombre a la credencial.
Conéctate con tu cuenta de Google y otorga los permisos necesarios.
✅ Una vez conectado, la credencial básica estará lista para usar con las funciones predeterminadas del módulo.
2. Configuración Avanzada (OAuth con Google Cloud)
Este método ofrece control completo sobre los permisos y autenticación mediante OAuth 2.0.
2.1 Crear / elegir proyecto y habilitar APIs
Entra a Google Cloud Console y accede a tu proyecto (crea uno nuevo si hace falta).
Desde la barra de búsqueda superior, escribe y abre cada servicio para Habilitar:
Google Docs API
Google Drive API (requerida si listarás/crearás archivos o usarás el selector de Drive).
En cada API, haz clic en Habilitar y verifica que el estado final quede como “Habilitada”.
Si una API no está habilitada, la autenticación puede funcionar, pero las llamadas a la API fallarán con el error access_not_configured.
2.2 Configurar Pantalla de consentimiento OAuth
Ruta: APIs y servicios → Pantalla de consentimiento OAuth → Configurar pantalla de consentimiento
Completa los datos básicos:
Nombre de la app
Correo de soporte
(Opcional) Política de privacidad, Términos del servicio y dominio verificado
Luego selecciona el tipo de usuario:
Tipos de usuario para la Pantalla de consentimiento OAuth
Opción
¿Quién puede usar la app?
Qué debes hacer
Interno
Solo usuarios de tu organización (dominio de Google Workspace). No funciona con cuentas @gmail.com personales.
– No necesitas agregar testers. Cualquier usuario del dominio puede autorizar. Úsalo si todo tu equipo pertenece al mismo dominio.
Usuarios externos
Cualquier usuario con Cuenta de Google, pero la app inicia en modo de prueba.
– Debes agregar manualmente a los usuarios de prueba (incluyéndote) para poder autorizar. Sólo esos usuarios podrán iniciar sesión mientras la app esté en prueba. Para abrirla a más usuarios/publicar, debes enviar a verificación si usas scopes sensibles/restringidos.
Notas importantes
Usar Google Docs o Drive suele marcar los scopes como sensibles.
Para pasar la app a Producción (sin testers), Google puede solicitar:
Dominio verificado
Política de privacidad pública
Logo de aplicación
Verificación del equipo
Guarda los cambios.
2.3 Agregar los scopes (permisos)
Dentro de la pantalla de consentimiento, accede a la sección Acceso a los datos.
Haz clic en Agregar o quitar permisos.
Utiliza la opción “Agregar permisos manualmente” y pega los siguientes scopes:
Scopes requeridos para Google Docs:
https://www.googleapis.com/auth/documents
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/userinfo.email
https://www.googleapis.com/auth/userinfo.profile
openid
Añade estos scopes a la tabla, haz clic en Actualizar y guardar.
2.4 Crear el Client ID y Client Secret
Dirígete a APIs y servicios > Credenciales.
Haz clic en “Crear credencial” > “ID de cliente de OAuth”.
Completa los datos solicitados:
Tipo de aplicación: Aplicación web
Nombre de la aplicación (Saturn Studio)
URLs de redirección ( https://studio.rocketbot.com/ )
Una vez creada, Google te mostrará:
Client ID
Client Secret
Copia ambos.
2.5 Ingresar los datos en Saturn Studio
Vuelve al módulo Google Docs en Saturn Studio.
Pega el Client ID y Client Secret en los campos correspondientes del modo avanzado.
