Saturn Studio – Credencial Gmail

Este documento describe el procedimiento paso a paso para generar y configurar las credenciales de Gmail para Saturn Studio a través de Google Cloud Console.

Habilitación de APIs en Google Cloud

Para que la integración de servicios funcione correctamente, es mandatorio activar las APIs necesarias en su proyecto de desarrollo:

  1. Acceda a Google Cloud Console e inicie sesión.
  2. Seleccione su proyecto activo (o cree uno nuevo desde el selector superior si fuera necesario).
  3. Utilice la barra de búsqueda superior para localizar e ingresar a cada uno de los siguientes servicios:

    • Google Gmail API (Requerida para la gestión y automatización de correos electrónicos).
    • Google Drive API (Requerida si sus flujos de trabajo involucran listar, crear archivos o utilizar el selector de Google Drive integrado).

  4. En la pestaña de cada API, haga clic en el botón Habilitar y verifique que el estado cambie satisfactoriamente a “Habilitada”.

Nota de integración: Si alguna de las APIs requeridas no se encuentra explícitamente activa, el proceso inicial de autenticación podría completarse de forma engañosa, pero cualquier llamada posterior a los endpoints fallará arrojando el error de sistema access_not_configured.

Configuración de la Pantalla de Consentimiento OAuth

La pantalla de consentimiento define la identidad de la aplicación ante los usuarios y delimita las restricciones de acceso antes de la publicación formal.

Ruta de acceso: APIs y servicios → Pantalla de consentimiento OAuth → Configurar pantalla de consentimiento.

Paso A: Registro de Datos Básicos

Complete los campos obligatorios del formulario de identidad visual de la aplicación:

  • Nombre de la aplicación
  • Correo electrónico de soporte al usuario
  • (Opcional) Enlaces a la Política de Privacidad, Términos del Servicio y el dominio verificado de su organización.

Paso B: Selección del Tipo de Usuario

Determine el alcance y el tipo de audiencia que tendrá la integración basándose en la siguiente matriz de control:

Tipo de Usuario ¿Quién puede usar la app? Acciones Requeridas
Interno Exclusivo para usuarios que pertenecen a su misma organización (bajo un dominio administrado en Google Workspace). No admite cuentas personales genéricas (@gmail.com). No requiere añadir usuarios de prueba (testers). Cualquier cuenta bajo el dominio corporativo puede autorizar el flujo de forma directa.
Externo Cualquier usuario con una cuenta de Google activa. La aplicación iniciará obligatoriamente en modo de prueba (Testing). Debe registrar manualmente las direcciones de correo de los usuarios de prueba (incluyendo su propia cuenta). Solo estas cuentas tendrán acceso mientras la app esté en prueba.

En caso de elegir tipo de usuarios externos 

Debemos de dirigirnos una vez creada y finalizada la creación de consentimiento OAuth a lo siguiente:

Nos dirigimos a Público y abajo debemos de elegir usuario de prueba, en este caso debe de ser del usuario propio y aquellos quienes quieran tener el acceso a la credencial.

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

Declaración de Alcances (Scopes) Necesarios

Durante la fase de configuración, debe registrar de manera estricta los permisos de datos que Saturn Studio utilizará para interactuar con la suite de Google.

Instrucciones de carga:

  1. Dentro de la configuración de la Pantalla de consentimiento, diríjase a la sección Acceso a los datos.
  2. Haga clic en el botón Agregar o quitar permisos.
  3. En la ventana emergente, desplácese hasta el final y seleccione la opción Agregar permisos manualmente.
  4. Copie y pegue en el bloque de texto la siguiente lista exacta de alcances (un scope por línea):

https://www.googleapis.com/auth/gmail.modify
https://www.googleapis.com/auth/gmail.readonly
https://www.googleapis.com/auth/gmail.labels
https://www.googleapis.com/auth/userinfo.profile
https://www.googleapis.com/auth/userinfo.email
openid
https://mail.google.com/
https://www.googleapis.com/auth/userinfo.email

  1. Haga clic en Agregar a la tabla y posteriormente presione Actualizar y guardar para consolidar los cambios en el proyecto.

Creación de Credenciales (Cliente OAuth)

Una vez completada la pantalla de consentimiento, se deben generar los identificadores de seguridad que enlazarán ambas plataformas.

  • Ruta de acceso: APIs y servicios → Credenciales → Crear credenciales → ID de cliente OAuth.

Complete los campos del formulario con los siguientes criterios:

  1. Tipo de aplicación: Seleccione estrictamente Aplicación web.
  2. Nombre de la app: Defina un nombre descriptivo para identificar el cliente (ej. Saturn Studio Integración Gmail).
  3. URLs de redirección autorizados: Ingrese la URL de redirección oficial de Saturn Studio.

Al hacer clic en Crear, Google Cloud Console desplegará una ventana emergente con dos valores fundamentales de seguridad:

  • ID de cliente (Client ID)
  • Secreto de cliente (Client Secret)

En caso que no aparezca el Client Secret

 Debe de dirigirse a clientes, luego de ello hacemos click al cliente (hacer click en el nombre de cliente) y allí crear un client secret, copie el dato porque no se volverá a mostrar.

Pegar datos y finalizar

Copia ambos valores con exactitud y páguelos dentro de los campos correspondientes en el módulo de configuración de la credencial de Gmail en su entorno de Saturn Studio.

Por último debe de hacer click en sign in with google, haga click en continuar y habilitar todos los permisos y ya tendrá habilitada la credencial de gmail.



Saturn Studio – Credencial Google Calendar

Para integrar Google Calendar con Saturn Studio, puedes hacerlo mediante una configuración avanzada a través de Google Cloud.

Configuración (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

  1. Entra a Google Cloud Console y accede a tu proyecto (crea uno si hace falta).
  2. Desde la barra de búsqueda superior, escribe y abre cada servicio para Habilitar:

    • Google Calendar API

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

  1. Regresa al módulo Google Calendar en Saturn Studio.
  2. En el modo Avanzado (OAuth), pega el Client ID y Client Secret en los campos correspondientes.
  3. 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 una configuración a través de Google Cloud.

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

  1. Entra a Google Cloud Console y accede a tu proyecto (crea uno nuevo si hace falta).
  2. 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).

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

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

  1. Vuelve al módulo Google Docs en Saturn Studio.
  2. Pega el Client ID y Client Secret en los campos correspondientes del modo avanzado.



Saturn Studio – Credencial Google Forms

La integración de Google Forms con Saturn Studio puede realizarse mediante una conexión rápida (básica) o utilizando una configuración avanzada a través de Google Cloud (OAuth 2.0).

Configuración Avanzada (OAuth con Google Cloud)

La configuración avanzada permite gestionar permisos personalizados, acceso granular y seguridad reforzada a través de Google Cloud.

Crear / elegir proyecto y habilitar APIs

  1. Accede a Google Cloud Console.
  2. Inicia sesión con tu cuenta de Google.
  3. Crea un nuevo proyecto o selecciona uno existente.
  4. Desde la barra superior, busca y habilita:

    • Google Forms API
    • Google Drive API (necesaria si listarás/crearás archivos o accederás al Drive)

  5. Verifica que las APIs queden con estado: Habilitada.

📌 Si una API no está habilitada, la autenticación puede funcionar, pero las llamadas fallarán con error “access_not_configured”.

Configurar Pantalla de consentimiento OAuth

Ruta: APIs y servicios → Pantalla de consentimiento OAuth → Configurar pantalla de consentimiento

Completa los campos:

  • Nombre de la aplicación
  • Correo de soporte
  • (Opcional) Logo, política de privacidad y términos
  • 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 dentro del mismo dominio Google Workspace.
No funciona con cuentas personales @gmail.com.		 – No es necesario agregar testers.
– Todos los usuarios del dominio pueden autorizar.
– Recomendado solo si toda tu organización usa Workspace.
Usuarios externos Cualquier usuario con Cuenta de Google.
La app inicia en modo de prueba.		 – Agrega manualmente los correos de prueba (incluyéndote).
– Solo usuarios en la lista podrán autenticar.
– Para publicar a Producción sin testers, Google puede requerir verificación si usas scopes sensibles.

📌 Nota: Google Forms y Drive suelen activar scopes sensibles. Para pasar a Producción, Google puede solicitar:

  • Dominio verificado
  • Política de privacidad pública
  • Logo y branding
  • Revisión manual

Agregar scopes (permisos)

  • Dentro de la pantalla de consentimiento, ve a Acceso a los datos.
  • Haz clic en Agregar o quitar permisos.
  • Utiliza la opción “Agregar permisos manualmente”.

Scopes necesarios para Google Forms:

https://www.googleapis.com/auth/forms.body

https://www.googleapis.com/auth/forms.responses.readonly

https://www.googleapis.com/auth/userinfo.email

https://www.googleapis.com/auth/userinfo.profile

openid

  • Copia y pega estos scopes, agrégalos a la tabla y haz clic en Actualizar y guardar.

Crear Client ID y Client Secret

  • Ve a APIs y servicios > Credenciales.
  • Haz clic en “Crear credencial” > “ID de cliente de OAuth”.
  • Configura:

    • Tipo de aplicación: Aplicación web
    • Nombre de la aplicación (Saturn Studio)
    • URLs de redirección (https://studio.rocketbot.com)

  • Una vez completado, Google te proporcionará:

    • Client ID
    • Client Secret

Copia ambos datos y guárdalos.

Ingresar datos en Saturn Studio

  1. Vuelve al módulo Google Forms en Saturn Studio.
  2. Pega el Client ID y el Client Secret en los campos correspondientes del modo avanzado.



Saturn Studio – Google Drive

¿Qué es este módulo?

El módulo de Google Drive permite interactuar con el servicio de almacenamiento en la nube de Google. Con este módulo podrás listar, buscar, subir, descargar, crear carpetas y eliminar archivos de tu cuenta de Google Drive, de forma sencilla y segura.

Este módulo requiere autenticación mediante una credencial de Google Drive que deberás generar previamente para habilitar la integración.

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

Descripción de los comandos

Listar archivos de una carpeta

Lista los archivos contenidos en una carpeta de Google Drive.

Parámetro Descripción Ejemplo
Credencial Credencial de Google Drive necesaria para listar los archivos Mis credenciales de Google Drive
Carpeta Carpeta de Google Drive donde se buscarán los archivos Carpeta
Asignar resultado a variable Variable donde se almacenará el resultado {var}

Buscar archivos y carpetas

Busca archivos y carpetas en Google Drive.

Parámetro Descripción Ejemplo
Credencial Credencial de Google Drive necesaria para buscar archivos Mis credenciales de Google Drive
Tipo de búsqueda Tipo de búsqueda a realizar Tipo de búsqueda
Nombre Nombre del archivo o carpeta a buscar Nombre
Filtro avanzado Filtro avanzado para la búsqueda name contains ‘hello’ and name contains ‘goodbye’
Asignar resultado a variable Variable donde se almacenará el resultado {var}

Descargar archivo

Descarga un archivo desde Google Drive.

Parámetro Descripción Ejemplo
Credencial Credencial de Google Drive necesaria para descargar el archivo Mis credenciales de Google Drive
Archivo Archivo de Google Drive a descargar Archivo
Asignar resultado a variable Variable donde se almacenará el resultado {var}

Subir archivo

Sube un archivo a Google Drive.

Parámetro Descripción Ejemplo
Credencial Credencial de Google Drive necesaria para subir el archivo Mis credenciales de Google Drive
Ruta del archivo Ruta del archivo a subir Ruta del archivo
Carpeta Carpeta de Google Drive donde se subirá el archivo Carpeta
Asignar resultado a variable Variable donde se almacenará el resultado {var}

Crear carpeta

Crea una nueva carpeta en Google Drive.

Parámetro Descripción Ejemplo
Credencial Credencial de Google Drive necesaria para crear la carpeta Mis credenciales de Google Drive
Nombre Nombre de la carpeta a crear Nombre
Si existe, crear de todas formas Pasar True, si la carpeta existe, crear igualmente True
Carpeta Carpeta de Google Drive donde se creará la nueva carpeta Carpeta
Asignar resultado a variable Variable donde se almacenará el resultado {var}

Eliminar archivo

Elimina un archivo de Google Drive.

Parámetro Descripción Ejemplo
Credencial Credencial de Google Drive necesaria para eliminar el archivo Mis credenciales de Google Drive
Archivo Archivo de Google Drive a eliminar Archivo
Asignar resultado a variable Variable donde se almacenará el resultado {var}

Ejemplo de uso

  1. Listar los archivos de la carpeta “Documentos Compartidos”.
  2. Subir un archivo “informe.pdf” a la carpeta “Proyectos”.
  3. Descargar el archivo “plan.xlsx” y asignar el resultado a la variable {archivo_descargado}.

Requisitos

  • Tener una cuenta activa de Google.
  • Crear y configurar la credencial de Google Drive en Saturn Studio.
  • Contar con conexión a internet para establecer la comunicación con la API de Google.



Saturn Studio – Credencial Google Drive

Para integrar Google Drive con Saturn Studio, puedes hacerlo mediante una configuración con OAuth 2.0 a través de Google Cloud.

Configuración (OAuth con Google Cloud)

Este método te permite definir permisos personalizados (scopes) y tener mayor control sobre la autenticación.

Crear / elegir proyecto y habilitar APIs

  1. Dirígete a Google Cloud Console.
  2. Inicia sesión con tu cuenta de Google.
  3. Crea un nuevo proyecto o selecciona uno existente.
  4. En la barra de búsqueda superior, habilita:

    • Google Drive API (obligatoria para todas las funciones del módulo)

  5. Comprueba que el estado final de cada API sea: Habilitada.

📌 Si la API no está habilitada, la autenticación podría funcionar, pero las operaciones devolverán el error access_not_configured.

Configurar Pantalla de consentimiento OAuth

Ruta: APIs y servicios → Pantalla de consentimiento OAuth → Configurar pantalla de consentimiento

Completa los campos requeridos:

  • Nombre de la aplicación
  • Correo de soporte
  • (Opcional) Logo, dominios verificados, política de privacidad, términos
  • 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.

📌 Google Drive utiliza scopes sensibles y restringidos, lo que puede requerir verificación si deseas publicar la aplicación para uso externo masivo.

Agregar permisos (scopes) manualmente

  • 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 necesarios para Google Drive:

https://www.googleapis.com/auth/drive

https://www.googleapis.com/auth/drive.file

https://www.googleapis.com/auth/drive.readonly

https://www.googleapis.com/auth/userinfo.email

https://www.googleapis.com/auth/userinfo.profile

openid

  1. Copia y pega los permisos anteriores.
  2. Agrega los scopes a la tabla.
  3. Haz clic en Actualizar y guardar.

Crear el Client ID y Client Secret

  • Ve a APIs y servicios > Credenciales.
  • Haz clic en “Crear credencial” > “ID de cliente de OAuth”.
  • Completa los campos requeridos:

    • Tipo de aplicación: Aplicación web
    • Nombre de la app (Saturn Studio)
    • URLs de redirección (https://studio.rocketbot.com)

  • Google generará automáticamente:

  • Client ID
  • Client Secret

Copia ambos códigos y guárdalos.

Ingresar los datos en Saturn Studio

  1. Regresa al módulo Google Drive en Saturn Studio.
  2. Pega el Client ID y el Client Secret en los campos correspondientes del modo avanzado



Saturn Studio – Credencial Google Sheets

La integración con Google Sheets en Saturn Studio .

Configuración (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

  1. Entra a Google Cloud Console y accede a tu proyecto (crea uno si hace falta).
  2. Desde la barra de búsqueda superior, escribe y abre cada servicio para Habilitar:

    • Google Sheets API
    • Google Drive API (requerida si listarás/crearás archivos o usarás el selector del Drive)

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

Nota: Usar Drive y Sheets suele marcar scopes como sensibles. Para pasar a Producción (sin lista de testers) es probable que Google solicite verificación de la app (dominio verificado, logo, política de privacidad, etc.).

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 Sheets

  • https://www.googleapis.com/auth/spreadsheets (leer/escribir en hojas)
  • https://www.googleapis.com/auth/spreadsheets.readonly (solo lectura)
  • https://www.googleapis.com/auth/drive (acceso a archivos de Drive: listar/crear/mover, etc., úsalo solo si lo necesitas)
  • 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

  1. Regresa al módulo Google Sheets en Saturn Studio.
  2. En el modo Avanzado (OAuth), pega el Client ID y Client Secret en los campos correspondientes.
  3. 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 Groq

Para conectar Saturn Studio con Groq, seguí estos pasos desde el módulo correspondiente:

Credencial Groq

  1. Ingresá al módulo Groq en Saturn Studio.
  2. Hacé clic en el botón “New” para crear una nueva credencial.
  3. Se abrirá un formulario donde deberás:

    • Asignar un nombre a la credencial.
    • Pegar tu API Key de Groq.

¿Cómo obtener la API Key de Groq?

  • Hacé clic en el enlace que aparece dentro del módulo (te llevará al sitio oficial de Groq).
  • Registrate o iniciá sesión en tu cuenta.
  • Creá una nueva API Key, asignale un nombre y Groq te proporcionará el código correspondiente.

  • Copiá esa API Key y pegala en el campo correspondiente dentro de Saturn Studio.

Verificación

Una vez ingresada la clave, podés hacer clic en “Check” o “Verificar” para confirmar que la conexión sea correcta.



Saturn Studio – Credencial Calendly

Para utilizar el módulo de Calendly en Saturn Studio, es necesario crear previamente una aplicación en Calendly y luego configurar la credencial dentro de Saturn Studio.

Creación de la aplicación en Calendly

  1. Acceder al portal de desarrolladores
    Ingresa a:
    https://developer.calendly.com/console/apps
  2. Crear una nueva aplicación
    Haz clic en Create App y completa los datos solicitados.
  3. Configurar la URL de redirección
    En el campo Redirect URL, debes colocar exactamente:
    studio.rocketbot.com
  4. Obtener las credenciales
    Al crear la aplicación, Calendly generará:

  • Client ID: puede verse posteriormente al editar la aplicación.
  • Client Secret: se muestra solo una vez al momento de crear la app y no puede volver a visualizarse.

Guarda ambos valores, ya que serán necesarios para la conexión.

Configuración de la credencial en Saturn Studio

  1. Acceso al módulo Calendly
    Desde Saturn Studio, abre el módulo Calendly.
  2. Crear una nueva credencial
    Haz clic en New para crear una nueva credencial.
  3. Asignar nombre y conectar
    Ingresa un nombre para la credencial y luego haz clic en Connect to Calendly.
  4. Autorización en Calendly
    Se abrirá una nueva pestaña con la página oficial de Calendly.
    Inicia sesión con tu cuenta de Calendly y autoriza la conexión con Saturn Studio.
  5. Conexión completada
    Una vez otorgados los permisos, Saturn Studio se conectará automáticamente con Calendly y la credencial quedará lista para su uso.



Saturn Studio – X

¿Qué es este módulo?

Este módulo integra X (antes Twitter), la plataforma de medios sociales, directamente en Saturn Studio. Permite a los robots interactuar con la red social para automatizar tareas como la publicación de tuits, la búsqueda de contenido, el monitoreo de menciones y la obtención de información sobre usuarios y sus publicaciones.

Con esta integración, puedes conectar la gestión de tus redes sociales con otros procesos de negocio. Por ejemplo, un robot puede publicar automáticamente en X las nuevas entradas de un blog, monitorear la opinión pública sobre una marca buscando palabras clave, o crear alertas cuando un cliente importante tuitee sobre un tema específico.

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

Descripción de los comandos

A continuación se detallan los comandos disponibles para la integración con X:

Create Tweet

Crea un tuit en X.

Parámetro Descripción Ejemplo
Credential Credencial de X necesaria para crear tuits. credential
Message El mensaje que será enviado. Hello Rocketbot
Assign result to variable Variable donde se almacenará el resultado. {“data”: {“id”: “1460323737035677698”, “text”: “Hello Rocketbot”}}

Search Tweets

Busca tuits en X.

Parámetro Descripción Ejemplo
Credential Credencial de X necesaria para buscar tuits. credential
Search type recent: últimos 7 días. all: histórico completo. Recent
Search El término o frase que se desea buscar. Rocketbot_es
Total results Número de tuits a devolver (por defecto, 10). 10
Assign result to variable Variable donde se almacenará el resultado. {“data”: [{“id”: “1293593516040269825”, “text”: “RT @Rocketbot_es: ¡Estamos aprendiendo sobre automatización!”}], “meta”: {“newest_id”: “1293593516040269825”, “result_count”: 1}}

Get User ID

Obtiene el ID de un usuario a partir de su nombre de usuario.

Parámetro Descripción Ejemplo
Credential Credencial de X necesaria para obtener el usuario. credential
Username El nombre de usuario cuyo ID se desea obtener. Rocketbot_es
Assign result to variable Variable donde se almacenará el resultado. {“data”: {“id”: “2244994945”, “name”: “Rocketbot”, “username”: “Rocketbot_es”}}

Get Mentions

Obtiene los tuits que mencionan a un usuario específico por su ID.

Parámetro Descripción Ejemplo
Credential Credencial de X necesaria para obtener menciones. credential
Total results Número de menciones a devolver (por defecto, 10). 10
User ID El ID del usuario cuyas menciones se desean obtener. 2244994945
Assign result to variable Variable donde se almacenará el resultado. {“data”: [{“id”: “1460323737035677698”, “text”: “@Rocketbot_es, ¡su plataforma es increíble!”}], “meta”: {“result_count”: 1}}

Get User Timeline

Obtiene la cronología (timeline) de un usuario.

Parámetro Descripción Ejemplo
Credential Credencial de X necesaria para obtener la cronología. credential
Total results Número de tuits a devolver (por defecto, 10). 10
User ID El ID del usuario cuya cronología se desea obtener. 2244994945
Assign result to variable Variable donde se almacenará el resultado. {“data”: [{“id”: “1293593516040269825”, “text”: “¡Hola, mundo!”}], “meta”: {“result_count”: 1}}

Retweet

Retuitea un tuit.

Parámetro Descripción Ejemplo
Credential Credencial de X necesaria para retuitear. credential
Tweet ID El ID del tuit que se desea retuitear. 1293593516040269825
Assign result to variable Variable donde se almacenará el resultado. {“data”: {“retweeted”: true}}

Get Tweet Information

Obtiene la información de un tuit a partir de su ID.

Parámetro Descripción Ejemplo
Credential Credencial de X necesaria para obtener información. credential
Tweet ID El ID del tuit del que se desea obtener información. 1293593516040269825
Assign result to variable Variable donde se almacenará el resultado. {“data”: {“id”: “1293593516040269825”, “text”: “Este es el contenido del tuit.”, “author_id”: “2244994945”, “created_at”: “2025-06-23T10:00:00.000Z”}}

Ejemplo de uso

  • Monitoreo de Marca: Utilizar “Search Tweets” para buscar menciones del nombre de una empresa o producto y analizar el sentimiento de los comentarios.
  • Publicación Automática: Programar un robot que use “Create Tweet” para publicar noticias o actualizaciones del blog de la empresa a una hora específica.
  • Atención al Cliente: Emplear “Get Mentions” para identificar cuando un usuario menciona la cuenta de soporte y crear automáticamente un ticket en un sistema de gestión de incidencias.
  • Análisis de Competencia: Ejecutar “Get User Timeline” sobre las cuentas de la competencia para recopilar y analizar sus últimos tuits y estrategias de comunicación.

Requisitos

  1. Tener una cuenta de desarrollador en la plataforma X (Twitter).
  2. Crear una aplicación en el Portal de Desarrollador de X para obtener las credenciales de la API (API Key, API Key Secret, Access Token y Access Token Secret).
  3. La credencial en Saturn Studio se debe configurar con las claves y tokens obtenidos.
  4. Asegurarse de que la aplicación creada en X tenga los permisos (scopes) necesarios para realizar las acciones deseadas (ej: tweet.read, tweet.write, user.read).