Este documento explica cómo integrar y autenticar el módulo Google Chat dentro de Saturn Studio, permitiendo acceder, leer y administrar chats de Google de forma segura.
La integración puede realizarse mediante dos métodos OAuth 2.0 con Google Cloud.

Configuración OAuth 2.0 con Google Cloud

Este método brinda mayor control sobre los permisos y seguridad, ideal para entornos de trabajo colaborativos o producción.

Crear / elegir proyecto y habilitar APIs

• Ingresa a Google Cloud Console.
• Inicia sesión con tu cuenta de Google.
• Crea un nuevo proyecto o selecciona uno existente desde la barra superior.

• Desde la barra de búsqueda, busca y habilita la siguiente API:

  • Google Chat API (requerida para crear Chat Apps y permitir la integración de servicios con Google Chat)

• Verifica que la API quede con estado Habilitado.
  Si no lo está, la autenticación podría completarse, pero las llamadas devolverán errores del tipo access_not_configured.

Configurar la Pantalla de consentimiento OAuth

• En el menú lateral, entra a:
  APIs y servicios → Pantalla de consentimiento OAuth → Configurar pantalla de consentimiento.

• Completa los campos solicitados:

  • Nombre de la aplicación
  • Correo de soporte
  • (Opcional) Logo, dominio, enlaces de privacidad y términos.

• Elige el tipo de usuario según tu caso:

Tipo de usuario	Descripción	Recomendación
Interno	Solo usuarios de tu organización (requiere dominio Google Workspace).	Úsalo si tu equipo pertenece al mismo dominio.
Externo	Permite acceso a cualquier cuenta de Google (modo de prueba).	Ideal para uso personal o con cuentas @gmail.com.

🔸 Nota: en modo Externo (prueba) deberás agregar manualmente a los usuarios de prueba, incluido tu propio correo.
Solo esos usuarios podrán autorizar la app mientras esté en prueba.

Guarda los cambios al finalizar.

Agregar scopes (permisos) a la app

1. Desde la misma sección de Pantalla de consentimiento OAuth, ve a Acceso a los datos → Agregar o quitar permisos.
2. Añade los siguientes scopes recomendados:

Scope	Descripción
https://www.googleapis.com/auth/chat.spaces	Permite administrar y acceder a espacios de Google Chat (creación, lectura y actualización de espacios donde la app está instalada).
https://www.googleapis.com/auth/chat.messages	Permite enviar, leer y administrar mensajes dentro de Google Chat.
https://www.googleapis.com/auth/chat.memberships	Permite ver y gestionar miembros (usuarios y bots) dentro de los espacios de Google Chat.
https://www.googleapis.com/auth/userinfo.email	Accede al correo del usuario autenticado.
https://www.googleapis.com/auth/chat.messages.readonly	Permite leer mensajes existentes en Google Chat dentro de los espacios donde la app está instalada.
openid	Requerido para la autenticación mediante OAuth 2.0.

Crear el Client ID y Client Secret

• Ve a APIs y servicios → Credenciales → Crear credencial → ID de cliente de OAuth.
• Completa los datos de la siguiente manera:

  • Tipo de aplicación: Aplicación web
  • Nombre: Saturn Studio
  • URIs de redirección: https://studio.rocketbot.com/

• Al guardar, Google generará:

  • Client ID
  • Client Secret
    Cópialos y resérvalos.

Configurar la aplicación de Google Chat

1. En Google Cloud Console, ve a “APIs y servicios” > “Google Chat API”
2. Haz clic en “Configuración” o “Configuration” en el menú lateral
3. En la sección “Estado de aplicación”, selecciona “ACTIVA”
4. Completa la información de la aplicación:

   • Nombre de la app: Nombre de tu aplicación de Chat
   • URL del avatar: URL de la imagen del avatar de tu app
   • Descripción: Descripción breve de tu aplicación

5. Haz clic en “Guardar”

Nota importante: La configuración de la Chat App es necesaria para que la API de Google Chat funcione correctamente con OAuth 2.0.

Cargar credenciales en Saturn Studio

1. Regresa al módulo Google Contacts en Saturn Studio.
2. Selecciona el modo Avanzado (OAuth).
3. Pega el Client ID y Client Secret obtenidos en los campos correspondientes.
4. Guarda la credencial y realiza la conexión.

✅ Listo: tu credencial avanzada quedará configurada correctamente para el uso completo del módulo Google Contacts.

📌 Notas importantes

• Usuarios externos (modo de prueba): agrega los correos de los usuarios en la lista de “Usuarios de prueba”. De lo contrario, no podrán autorizar la app.
• Interno: solo disponible con cuentas de dominio empresarial (Google Workspace).
• Scopes y APIs: los scopes otorgan permisos, pero las APIs habilitadas son las que permiten ejecutar las acciones.
• URIs de redirección: deben coincidir exactamente con la configuración de Google Cloud.
• Verificación: si deseas publicar la app (modo producción) y usas scopes sensibles, Google podría solicitar verificación del dominio, logo y políticas de privacidad.

Enviar correos mediante SMTP y leer correos desde un servidor IMAP.

Descripción de los comandos

Send email

Enviar correo utilizando SMTP.

Configuración SMTP y IMAP server

Parámetro	Descripción	ejemplo
Credential	Credencial de correo	My email credentials
Recipient	Correo del destinatario	to@mail.com
Subject	Asunto del correo	Subject
Message	Contenido del correo	Mensaje del correo
Assign result to variable	Variable donde se almacenará el resultado	{var}

Read all email

Leer todos los correos de una carpeta.

Parámetro	Descripción	ejemplo
Credential	Credencial de correo	My email credentials
Inbox folder	Carpeta donde se buscarán los correos	INBOX
Email status	Estado de los correos a buscar
Number of emails to search	Cantidad de correos a buscar	10
Subject (optional)	Asunto del correo a buscar	BUY
Sent by (optional)	Correo del remitente a buscar	test@email.com
Assign result to variable	Variable donde se almacenará el resultado	variable

Este módulo permite enviar correos mediante SMTP y leer correos desde un servidor IMAP.
Para utilizar los comandos, es necesario configurar una credencial con los datos correctos del servidor de correo.

Cómo configurar las credenciales de correo

A continuación se detallan los pasos para crear una credencial válida dentro de Saturn Studio.

Abrir la ventana de credenciales

Al utilizar un comando del módulo (por ejemplo Send email), se abrirá la ventana:

Configure SMTP and IMAP server

En esta ventana se completan los parámetros necesarios para enviar y recibir correo.

Completar los campos de la credencial

Credential name

Nombre identificador para reconocer la credencial dentro del sistema.

SMTP server

Servidor SMTP utilizado para enviar correos.
Depende del proveedor del correo.

SMTP port

Puerto SMTP del servidor.
Valores más utilizados:

• 465
• 587

Use SSL in SMTP

Marcar si el servidor requiere conexión segura (SSL) para el envío.

IMAP server

Servidor IMAP utilizado para la lectura de correos.

IMAP port

Puerto IMAP del servidor.
Valores más utilizados:

• 993 (IMAP con SSL)
• 143 (IMAP sin SSL)

Use SSL in IMAP

Marcar si el servidor IMAP utiliza conexión segura.

User

Dirección de correo utilizada para autenticarse en SMTP e IMAP.

Password

Contraseña de la cuenta o contraseña de aplicación, según lo requiera el proveedor del correo.

Configuraciones recomendadas por proveedor

Los siguientes valores se basan en las configuraciones estándar utilizadas para SMTP e IMAP:

Proveedor	SMTP server	SMTP port	SSL SMTP	IMAP server	IMAP port	SSL IMAP
Gmail (Google)	smtp.gmail.com	465	Sí	imap.gmail.com	993	Sí
Outlook / Hotmail / Office 365	smtp-mail.outlook.com	587	No	imap-mail.outlook.com	993	Sí
Yahoo Mail	smtp.mail.yahoo.com	465	Sí	imap.mail.yahoo.com	993	Sí

Notas importantes:

• Algunos proveedores requieren “contraseñas de aplicación” para el acceso IMAP/SMTP.
• En Gmail puede ser necesario generar una clave especial para permitir el acceso desde aplicaciones externas.
• Si ocurre un error de autenticación, revisar el usuario, contraseña y configuración de seguridad del proveedor.

Guardar la credencial

Una vez completados los datos:

1. Revisar que la información sea correcta.
2. Seleccionar Save credentials.

La credencial quedará registrada y disponible para todos los comandos del módulo.

Credencial lista para usar

Con la credencial configurada, se pueden utilizar los comandos:

• Send email
• Read all email

El módulo se encargará automáticamente de la autenticación SMTP e IMAP.

Este módulo permite conectar Saturn Studio con Bitbucket para listar repositorios, obtener commits, consultar pull requests y automatizar flujos de trabajo.
Para utilizarlo, es necesario crear una credencial OAuth dentro del Workspace de Bitbucket.

Cómo obtener la credencial de Bitbucket

Sigue los pasos detallados para generar el Client ID y Client Secret, y luego configurarlos dentro de Saturn Studio.

Iniciar sesión en Atlassian / Bitbucket

• Ingresa a:
  https://id.atlassian.com/login
• Accede con tu cuenta Atlassian o crea una nueva si no tienes una.
• Una vez dentro, puedes acceder a Bitbucket desde:
  https://bitbucket.org/

Acceder al Workspace de Bitbucket

Los OAuth Consumers se gestionan a nivel de Workspace, no de usuario.

1. En la esquina superior izquierda de Bitbucket, selecciona el Workspace que utilizarás.
2. En el menú lateral del Workspace, haz clic en:
   Workspace settings

Crear un OAuth Consumer

Este paso genera el Client ID y el Client Secret que Saturn Studio requiere.

• Dentro de Workspace settings, selecciona:
  OAuth consumers
• Haz clic en Add consumer.
• Completa los campos obligatorios:
  Name: Nombre identificador para la integración
  Description: Descripción breve del uso
  Callback URL: Ingresar una URL de retorno válida
• En permisos (Scopes), habilita como mínimo:

  • Repositories: Read
  • Pull requests: Read
  • Webhooks: Read
  • Pipelines: Read

• Guarda los cambios.

Después de guardarlo, Bitbucket mostrará dos valores:

• Key → Este valor debe usarse como Client ID
• Secret → Este valor debe usarse como Client Secret

Configurar la credencial en Saturn Studio

Al utilizar cualquier comando del módulo Bitbucket, Saturn Studio mostrará la ventana de configuración de credenciales:

Bitbucket Credentials

Los campos son:

• Credential name
• Client ID
• Client Secret
• Botón: Connect to Bitbucket
• Botón: Save credentials

Completar la credencial

1. Credential name:
   Escribe un nombre descriptivo para identificar la credencial.
2. Client ID:
   Ingresa el valor obtenido como Key del OAuth Consumer.
3. Client Secret:
   Ingresa el valor Secret generado por Bitbucket.
4. Haz clic en Connect to Bitbucket para verificar la conexión.
5. Si la validación es correcta, haz clic en Save credentials.

Proceso finalizado

Una vez guardada la credencial, podrás utilizar todos los comandos del módulo Bitbucket:

• List Repositories
• Get Repository
• List Commits
• Trigger New Commits
• Trigger New Pull Requests
• Get Pull Request

La autenticación se gestionará automáticamente mediante los valores configurados.

Bitbucket es una plataforma web de desarrollo colaborativo que permite a los equipos gestionar repositorios Git, revisar código y automatizar flujos de trabajo mediante pipelines. Es ampliamente utilizada en entornos empresariales y por equipos que integran herramientas de Atlassian como Jira y Trello.

Descripción de los comandos

Trigger New Commits

Dispara cuando se realizan nuevos commits en un repositorio de Bitbucket.

Cómo obtener las credenciales de Bitbucket

Parámetro	Descripción	ejemplo
Credential	Credencial de Bitbucket necesaria para monitorear commits	credential
Workspace	Workspace donde se encuentra el repositorio	workspace-name
Repository	Selecciona el repositorio a monitorear	repository-name
Branch	Selecciona la rama a monitorear para nuevos commits	branch-name
Limit	Número máximo de commits a revisar por ejecución	10
Assign result to variable	Variable donde los nuevos commits serán almacenados. Example {“commits”[{“id””abc123def456″,”type””commit”,”hash””abc123def456″,”message””Add new feature for automated deployment”,”date””2025-07-10T143000+0000″,”author”{“display_name””Alice Developer”,”username””alice.dev”},”parents”[{“hash””def456abc123”}],”links”{“html””https//bitbucket.org/ai_team/automator_ai_engine/commits/abc123def456″,”diff””https//api.bitbucket.org/2.0/repositories/ai_team/automator_ai_engine/diff/abc123def456″}}],”new_commits_count”1,”repository””ai_team/automator_ai_engine”,”branch””main”}	{var}

Trigger New Pull Requests

Dispara cuando se crean nuevos pull requests en un repositorio de Bitbucket.

Parámetro	Descripción	ejemplo
Credential	Credencial de Bitbucket necesaria para monitorear pull requests	credential
Workspace	Workspace donde se encuentra el repositorio	workspace-name
Repository	Selecciona el repositorio a monitorear	repository-name
State	Estado de los pull requests a monitorear	OPEN
Limit	Máximo de pull requests a revisar por ejecución	10
Assign result to variable	Variable donde los nuevos pull requests serán almacenados. Example {“pull_requests”[{“id”123,”type””pullrequest”,”title””Add new authentication module”,”description””This PR adds OAuth2 authentication support”,”state””OPEN”,”created_on””2025-07-10T143000+0000″,”updated_on””2025-07-10T154500+0000″,”author”{“display_name””Bob Developer”,”username””bob.dev”},”source”{“branch””feature/oauth2″,”commit””xyz789abc123”},”destination”{“branch””main”,”commit””abc123def456″},”reviewers”[],”links”{“html””https//bitbucket.org/ai_team/automator_ai_engine/pull-requests/123″}}],”new_pull_requests_count”1,”repository””ai_team/automator_ai_engine”,”state””OPEN”}	{var}

List Repositories

Lista los repositorios de Bitbucket.

Parámetro	Descripción	ejemplo
Credential	Credencial de Bitbucket necesaria para listar repositorios	credential
Workspace	Workspace donde se encuentran los repositorios	workspace-name
Query	Filtro o nombre del repositorio	language=”nodejs”
Sort	Orden por created_on o updated_on	created_on
Limit	Máximo de repositorios a obtener	10
Assign result to variable	Variable donde se almacenará el resultado. Example {“repositories”[{“uuid””{a1b2c3d4-5678-90ab-cdef-1234567890ab}”,”name””automator_ai_engine”,”full_name””ai_team/automator_ai_engine”,”description””Core engine for AI-driven task automation platform.”,”is_private”true,”language””python”,”created_on””2023-05-12T102543.123456+0000″,”updated_on””2025-07-05T134829.789654+0000″,”size_mb”112.8,”mainbranch””main”,”fork_policy””no_public_forks”,”project”{“key””AUTO”,”name””Automator”,”uuid””{ffeeddcc-bbaa-9988-7766-554433221100}”},”owner”{“display_name””ai_team”,”username””ai_team”,”uuid””{123e4567-e89b-12d3-a456-426614174000}”,”type””team”},”workspace”{“name””ai_team”,”slug””ai_team”,”uuid””{123e4567-e89b-12d3-a456-426614174000}”},”links”{“html””https//bitbucket.org/ai_team/automator_ai_engine”,”avatar””https//bytebucket.org/ravatar/%7Ba1b2c3d4-5678-90ab-cdef-1234567890ab%7D?ts=python”,”clone”[{“name””https”,”href””https//johnsmith@bitbucket.org/ai_team/automator_ai_engine.git”},{“name””ssh”,”href””git@bitbucket.orgai_team/automator_ai_engine.git”}],”commits””https//api.bitbucket.org/2.0/repositories/ai_team/automator_ai_engine/commits”,”branches””https//api.bitbucket.org/2.0/repositories/ai_team/automator_ai_engine/refs/branches”,”pullrequests””https//api.bitbucket.org/2.0/repositories/ai_team/automator_ai_engine/pullrequests”,”downloads””https//api.bitbucket.org/2.0/repositories/ai_team/automator_ai_engine/downloads”}}],”page”1,”size”1,”next””https//api.bitbucket.org/2.0/repositories/ai_team?pagelen=1&page=2″,”pagelen”1}	{var}

Get a Repository

Obtiene un repositorio de Bitbucket.

Parámetro	Descripción	ejemplo
Credential	Credencial de Bitbucket necesaria para obtener un repositorio	credential
Workspace	Workspace donde se encuentra el repositorio	workspace-name
Repository	Selecciona el repositorio a obtener	repository-name
Assign result to variable	Variable donde se almacenará la información del repositorio. Example {“repository”{“name””demo_repo”,”full_name””example_team/demo_repo”,”description””Demo repository for frontend preview”,”is_private”false,”language””javascript”,”mainbranch””main”,”workspace””example_team”,”project”{“key””EX”,”name””Example Project”},”updated_on””2025-07-08T153000.000Z”,”size_mb”42.7,”links”{“html””https//bitbucket.org/example_team/demo_repo”,”avatar””https//bytebucket.org/ravatar/%7Bexample-avatar%7D?ts=nodejs”,”commits””https//api.bitbucket.org/2.0/repositories/example_team/demo_repo/commits”,”branches””https//api.bitbucket.org/2.0/repositories/example_team/demo_repo/refs/branches”,”pullrequests””https//api.bitbucket.org/2.0/repositories/example_team/demo_repo/pullrequests”}}}	{var}

List Commits

Lista commits de un repositorio de Bitbucket.

Parámetro	Descripción	ejemplo
Credential	Credencial necesaria para listar commits	credential
Workspace	Workspace donde se encuentra el repositorio	workspace-name
Repository	Selecciona el repositorio a consultar	repository-name
Branch	Rama desde donde listar commits	branch-name
Limit	Máximo de commits a obtener	10
Assign result to variable	Variable donde se almacenará el resultado. Example {“commits”[{“hash””a1b2c3d4e5f6g7h8i9j0k”,”message””Initial commit with demo files\n”,”date””2025-07-08T144500+0000″,”author”{“display_name””Alice Devbot”,”avatar””https//secure.gravatar.com/avatar/demo1234567890?d=https%3A%2F%2Fexample.com%2Favatars%2FAD.png”},”parents”[{“hash””z9y8x7w6v5u4t3s2r1q0”}],”links”{“html””https//bitbucket.org/example_team/demo_repo/commits/a1b2c3d4e5f6g7h8i9j0k”,”diff””https//api.bitbucket.org/2.0/repositories/example_team/demo_repo/diff/a1b2c3d4e5f6g7h8i9j0k”,”approve””https//api.bitbucket.org/2.0/repositories/example_team/demo_repo/commit/a1b2c3d4e5f6g7h8i9j0k/approve”}}],”page”1,”size”1,”next””https//api.bitbucket.org/2.0/repositories/example_team/demo_repo/commits?pagelen=1&page=2″}	{var}

Get Pull Request

Obtiene un Pull Request específico.

Parámetro	Descripción	ejemplo
Credential	Credencial de Bitbucket necesaria para obtener un pull request	credential
Workspace	Workspace donde se encuentra el repositorio	workspace-name
Repository	Selecciona el repositorio a consultar	repository-name
Pull Request ID	ID del pull request	150
Includes	Información adicional a incluir	Commits, Activity, Diff
Assign result to variable	Variable donde se almacenará la información del pull request. Example {“pull_request”{“id”42,”title””Add AI module integration”,”description””* ✨ (ai-module) add OpenAI integration for chat interface with retry logic\n* 📝 (ai-module) update README with usage examples and error codes\n\n”,”state””MERGED”,”created_on””2025-06-01T120000.000000+0000″,”updated_on””2025-06-02T093000.000000+0000″,”merge_commit”{“hash””abc123def456”,”links”{“self”{“href””https//api.bitbucket.org/2.0/repositories/example_team/demo_repo/commit/abc123def456”},”html”{“href””https//bitbucket.org/example_team/demo_repo/commits/abc123def456″}},”type””commit”},”close_source_branch”true,”author”{“display_name””Alice Devbot”,”avatar””https//secure.gravatar.com/avatar/abc123xyz456?d=https%3A%2F%2Fexample.com%2Favatar%2FAD.png”},”source”{“branch””feature-ai-module”,”commit””fed456cba321″,”repository””example_team/demo_repo”},”destination”{“branch””main”,”commit””123abc456def”,”repository””example_team/demo_repo”},”reviewers”[],”participants”[],”links”{“html””https//bitbucket.org/example_team/demo_repo/pull-requests/42″,”diff””https//api.bitbucket.org/2.0/repositories/example_team/demo_repo/diff/example_team/demo_repofed456cba321\r123abc456def?from_pullrequest_id=42&topic=true”,”commits””https//api.bitbucket.org/2.0/repositories/example_team/demo_repo/pullrequests/42/commits”,”comments””https//api.bitbucket.org/2.0/repositories/example_team/demo_repo/pullrequests/42/comments”,”activity””https//api.bitbucket.org/2.0/repositories/example_team/demo_repo/pullrequests/42/activity”}}}	{var}

monday.com ofrece una API que permite interactuar con tableros, ítems, columnas y archivos a través de peticiones autenticadas mediante un API Token personal.
Esta credencial permite conectar Saturn Studio con tu cuenta de monday para ejecutar acciones del módulo.

Cómo obtener la credencial de monday.com

Ingresar a la API de monday

• Inicia sesión en tu cuenta de monday.com.
• Ve a tu foto de perfil (arriba a la izquierda en el menú).
• Selecciona Admin (o Administración).
• Abre la sección API.
  También podés ir directo desde el enlace oficial:
  https://support.monday.com/hc/es/articles/360005144659–Tiene-monday-com-una-API

Allí encontrarás tu API Token personal.

Generar o copiar el API Token

Dentro del panel de API verás:

• Tu API Token actual
• La opción de generar nuevos tokens si necesitás uno exclusivo para Saturn Studio

Cada token representa un acceso personal con permisos de tu usuario.

Copiar el API Token

Haz clic en “Copiar” (Copy Token).

Este token es el que vas a pegar en Saturn Studio como credencial.

Da permisos completos sobre tu cuenta monday igual que tu usuario.

Configurar la Credencial en Saturn Studio

Cuando abras el módulo monday.com y presiones New, aparecerá esta ventana:

Campos de la credencial

Campo	Descripción	Ejemplo
Credential name	Nombre para identificar esta credencial	My monday Credential
Api Token	Token personal obtenido en monday.com	eyJhbGciOiJIUzI1…

Validar la credencial

1. Pega el token dentro del campo Api Token.
2. Haz clic en Check (opcional, verifica autenticación).
3. Haz clic en Save credentials.

¡Listo!
Tu credencial está configurada y ya podés usar todos los comandos del módulo monday.com en Saturn Studio.

Notas importantes

• El API Token pertenece al usuario que lo genera → el módulo tendrá exactamente sus permisos.
• Si borrás el token desde monday.com, dejará de funcionar en Saturn Studio.
• Podés generar múltiples tokens si querés separar ambientes (producción / testing).
• monday.com utiliza un sistema de autenticación simple basado en API Token, no OAuth.

monday es una plataforma de gestión del trabajo que ayuda a los equipos a planificar, organizar y colaborar en proyectos de forma visual. Ofrece tableros personalizables, automatizaciones e integraciones con diversas herramientas.

Descripción de los comandos

Trigger Board

Dispara cuando un board en monday presenta cambios.

Parámetro	Descripción	Ejemplo
Credential	Credencial de monday para monitorear	credential
Check every N minutes	Intervalo de verificación en minutos	1
Boards	Selecciona el board a monitorear	Select a board
Assign result to variable	Variable donde se guardarán los cambios Example {“board”{“id””9784563210″,”name””Orion”,”updated_at””2025-07-21T151243Z”,”columns”[{“id””name”,”title””Name”,”type””name”},{“id””project_owner”,”title””Owner”,”type””people”},{“id””project_status”,”title””Status”,”type””status”},{“id””date”,”title””Due Date”,”type””date”},{“id””priority_1″,”title””Priority”,”type””status”},{“id””numbers”,”title””Budget”,”type””numbers”},{“id””files_1″,”title””Files”,”type””file”},{“id””project_timeline”,”title””Timeline”,”type””timeline”},{“id””last_updated”,”title””Last Updated”,”type””last_updated”},{“id””location_mksz30va”,”title””Location”,”type””location”}]},”change_type””board_changed”,”changes”[{“type””board_renamed”,”old_name””Orion Dev”,”new_name””Orion”},{“type””board_updated”,”old_updated_at””2025-07-21T151101Z”,”new_updated_at””2025-07-21T151243Z”}]}	{var}

Trigger Item Column Value

Dispara cuando el valor de una columna en un ítem cambia.

Parámetro	Descripción	Ejemplo
Credential	Credencial de monday	credential
Check every N minutes	Intervalo de verificación	1
Boards	Board donde se monitorean los ítems	Select a board
Columns	Columna a monitorear	Select a column
Limit	Número máximo de cambios (default 10)	10
Assign result to variable	Variable donde se guardarán los cambios Example [{“id””9785623145″,”name””Orion Alpha”,”change_type””new_item”,”updated_at””2025-07-21T151722Z”},{“id””9785623156″,”name””Beta Test”,”change_type””new_item”,”updated_at””2025-07-21T151908Z”},{“id””9785623168″,”name””Delta Phase”,”change_type””new_item”,”updated_at””2025-07-19T104411Z”}]	{var}

List Boards

Lista todos los boards disponibles en monday.

Parámetro	Descripción	Ejemplo
Credential	Credencial de monday	My monday credentials
Assign result to variable	Variable donde se guardarán los boards Example {“boards”[{“id””1234567890″,”name””SaturnStudio”}]}	{var}

List Board Items

Lista los ítems de un board específico.

Parámetro	Descripción	Ejemplo
Credential	Credencial de monday	My monday credentials
Boards	Board del cual obtener los ítems	Select a board
Assign result to variable	Variable donde se guardarán los ítems Example {“items”[{“id””100001″,”name””Task Alpha”},{“id””100002″,”name””Development”},{“id””100003″,”name””Project Orion”}]}	{var}

Create Board

Crea un nuevo board en monday.

Parámetro	Descripción	Ejemplo
Credential	Credencial de monday	My monday credentials
Name	Nombre del nuevo board	My New Board
Board Kind	Tipo de board (Private o Public)	Private
Assign result to variable	Variable donde se guardará el board creado Example {“board”{“id””9686092193″,”name””LocalBoard”}}	{var}

Get an Item’s Column Value

Obtiene el valor de una columna específica de un ítem.

Parámetro	Descripción	Ejemplo
Credential	Credencial de monday	My monday credentials
Boards	Board	Select a board
Items	Ítem del que se obtiene el valor	Select an item
Columns	Columna a consultar	Select a column
Assign result to variable	Variable donde se guardará el resultado Example {“item”{“data”{“items”[{“id””9611019969″,”name””Saturn”,”column_values”[]}]},”extensions”{“request_id””78db737a-fe6e-9381-88a7-9cab1f4c224f”}}}	{var}

Update an Item’s Column Value

Actualiza el valor de una columna en un ítem.

Parámetro	Descripción	Ejemplo
Credential	Credencial de monday	My monday credentials
Boards	Selecciona el board	Select a board
Items	Ítem a actualizar	Select an item
Columns	Columna a modificar	Select a column
Assign result to variable	Variable donde se guardará la actualización Example {“item”{“id””9611019969″,”name””Saturn”,”column_values”[{“id””project_owner”,”value””{“changed_at””2025-07-16T101243.123Z”,”personsAndTeams”[{“id”78546111,”kind””person”}]}”,”text””Luciana Gomez”},{“id””project_status”,”value””{“index”2,”changed_at””2025-07-17T142350.417Z”}”,”text””In progress”},{“id””date”,”value””{“date””2025-08-10″,”changed_at””2025-07-17T142530.226Z”}”,”text””2025-08-10″},{“id””priority_1”,”value””{“index”90,”changed_at””2025-07-17T142712.891Z”}”,”text””Medium”},{“id””text9″,”value”””Meeting scheduled with external provider for adjustments””,”text””Meeting scheduled with external provider for adjustments”},{“id””numbers”,”value”””12″”,”text””12″},{“id””files_1”,”value””{“files”[{“name””business_proposal.pdf”,”assetId”3895232341,”isImage””false”,”fileType””ASSET”,”createdAt”1707398934000,”createdBy””40202275″}]}”,”text””https//rocketbot-global.monday.com/protected_static/30438402/resources/3895232341/business_proposal.pdf”},{“id””project_timeline”,”value””{“to””2025-08-20″,”from””2025-08-05″,”changed_at””2025-07-17T142946.713Z”}”,”text””2025-08-05 – 2025-08-20″},{“id””last_updated”,”value””{“updated_at””2025-07-17T143111Z”,”updater_id””78546111″}”,”text””2025-07-17 143111 UTC”},{“id””location_mksz30va”,”value””{“lat”-34.6037,”lng”-58.3816,”address””Buenos Aires, Argentina”,”changed_at””2025-07-17T143111.298Z”}”,”text””Buenos Aires, Argentina”}]}}	{var}

Upload File to an Item’s Column

Sube un archivo a una columna tipo archivo.

Parámetro	Descripción	Ejemplo
Credential	Credencial de monday	My monday credentials
Boards	Board	Select a board
Items	Ítem	Select an item
Columns	Columna donde subir el archivo	Select a column
File path	Ruta del archivo a subir	image.jpg
Assign result to variable	Variable donde se guardará la información del archivo  Example {“item”{“id””9876543210”},”file”{“name””Resume – John Smith.pdf”,”uploaded”true}}	{var}

Add Column to Board

Agrega una nueva columna a un board.

Parámetro	Descripción	Ejemplo
Credential	Credencial de monday	My monday credentials
Boards	Selecciona el board	Select a board
Column Type	Tipo de columna a crear	Select a column type
Column Title	Título de la nueva columna	New Column
Assign result to variable	Variable donde se guardará la columna creada Example {“column”{“id””text_mkyzqty5″,”title””New Column”,”type””text”}}	{var}

¿Qué es este módulo?

Este módulo permite integrar Saturn Studio con Salesforce, una plataforma CRM basada en la nube que ayuda a las empresas a gestionar relaciones con clientes, ventas, marketing, servicio al cliente y más. A través de esta integración, puedes buscar, obtener, crear y gestionar registros de manera automatizada.

Cómo obtener las credenciales de Salesforce

1. En Salesforce, ve a Setup → App Manager.
2. Haz clic en New Connected App.
3. Completa los campos básicos:

   • Nombre de la App
   • Correo de contacto

4. En la sección API (Enable OAuth Settings):

   • Marca “Enable OAuth Settings”.
   • Introduce el Callback URL (por ejemplo: https://studio.rocketbot.com/).
   • Selecciona los OAuth Scopes necesarios.

5. Guarda la App. Una vez creada, Salesforce generará:

   • Consumer Key
   • Consumer Secret

6. Luego, en Setup → Auth. Providers, crea un proveedor de autenticación si lo requiere el flujo OAuth.
7. Finalmente, en Setup → Named Credentials, crea una nueva Named Credential que utilice el Auth Provider, el Consumer Key/Secret y el URL de negocio.

---

Parámetros clave

Parámetro	Descripción	Ejemplo
Domain URL	URL de tu instancia Salesforce (por ejemplo My Domain)	https://myorg-dev.my.salesforce.com
Consumer Key	Identificador público de la Connected App	3MVG9…5Qh
Consumer Secret	Secreto privado asociado a la Connected App	1952123456789012345
Callback/Redirect URI	URL de redirección usada en el flujo OAuth	https://studio.rocketbot.com/
OAuth Scopes	Permisos que la app solicitará	full, refresh_token, offline_access

Módulo de Inteligencia Artificial – Saturn Studio

El Tool Agent es un componente del módulo IA que permite crear agentes inteligentes capaces de razonar, generar respuestas y ejecutar acciones conectadas con otros módulos de Saturn Studio.

Este agente utiliza modelos de lenguaje avanzados y puede combinar la generación de texto con la ejecución de comandos o consultas hacia herramientas externas (por ejemplo, Gmail, Google Calendar, Notion, Supabase, etc.), actuando como un agente operativo y contextual.

📌 ¿Qué es este módulo?

El Tool Agent es un sistema autónomo de inteligencia artificial diseñado para percibir su entorno, procesar información y tomar decisiones racionales para alcanzar objetivos específicos.

A diferencia de un agente de solo conversación, este módulo puede utilizar herramientas conectadas (módulos de Saturn Studio) para realizar acciones o recuperar información antes de generar su respuesta final con IA.

⚙️ Comandos disponibles

🧠 Tools AI

Parámetro	Descripción	Ejemplo
Credential	Credencial del proveedor de IA (por ejemplo, OpenAI). Debe haberse creado previamente en el módulo correspondiente.	OPENAI – test
Model	Modelo de lenguaje a utilizar para procesar las instrucciones y generar respuestas.	gpt-4o
Input Prompt	Instrucción o texto de entrada que el agente recibirá. Puede incluir variables dinámicas como {var_name}.	“Genera un correo de agradecimiento a partir del evento {evento_nombre}”
Tools (Fuentes y Acciones)	Define los módulos o herramientas conectadas que el agente puede usar para recuperar información o ejecutar acciones. Estos módulos funcionan como extensiones que amplían la capacidad del agente (por ejemplo: leer emails, buscar eventos o escribir registros).	Gmail, Google Calendar, Notion
Assign result to variable	Variable donde se almacenará la respuesta o acción generada por el agente.	resultado_tools

🧩 Ejemplo de uso

1. Crea o selecciona una Credencial de IA (por ejemplo, OpenAI) desde su módulo correspondiente.
2. En el flujo de Saturn Studio, arrastra el comando Tools AI.
3. Completa los campos:

   • Credential: OPENAI – test
   • Model: gpt-4o
   • Input Prompt: “¿Cuáles son mis eventos del día y envía un correo con el resumen?”
   • Tools: Google Calendar, Gmail
   • Assign result to variable: respuesta_final

4. Al ejecutar el flujo, el agente consultará las herramientas seleccionadas (en este caso Calendar y Gmail), procesará la información con IA y devolverá una respuesta automática con acción ejecutada.

🧩 Requisitos

• Tener configurada una credencial válida del proveedor de IA (OpenAI, Hugging Face, etc.).
• Contar con módulos conectados que el agente pueda usar como fuentes o acciones (por ejemplo, Gmail, Calendar, Supabase, etc.).
• Asignar una variable de salida para almacenar el resultado final.

¿Qué es este módulo?

El módulo Jira permite integrar Saturn Studio con la plataforma de gestión de proyectos Atlassian Jira, facilitando la automatización de tareas como creación, actualización, consulta o eliminación de incidencias.

Para poder utilizar los comandos del módulo, primero deberás configurar una credencial de Jira, la cual se compone de tres elementos esenciales:
Dominio, Usuario y API Token.

Cómo obtener las credenciales de Jira

1) Acceder al portal de Atlassian

Dirígete a:
🔗 https://id.atlassian.com/manage-profile/security/api-tokens

Este enlace te llevará directamente al panel de API Tokens de tu cuenta Atlassian, desde donde podrás crear y administrar tus claves personales.

2) Crear un nuevo token de API

En la sección API Tokens, haz clic en el botón:

🔹 Create API token

Aparecerá una ventana emergente solicitando un nombre descriptivo para el token, por ejemplo:

Saturn Studio Integration

Luego, presiona Create para generar el nuevo token.

3) Copiar el token generado

Una vez creado, Atlassian mostrará el nuevo API Token.
Haz clic en Copy to clipboard para copiarlo y guárdalo en un lugar seguro.
⚠️ Importante: Por razones de seguridad, no podrás volver a visualizarlo más adelante.

4) Obtener tu dominio y usuario

Antes de configurar la credencial en Saturn Studio, deberás identificar los siguientes datos:

Dato	Descripción	Ejemplo
Dominio	Dirección de tu espacio de Jira Cloud (sin https:// ni www).	tuequipo.atlassian.net
Usuario	Correo electrónico asociado a tu cuenta de Atlassian.	usuario@empresa.com
API Token	Token generado desde el paso anterior.	ATATT3xFfExampleToken123

5) Configurar en Saturn Studio

Abre Saturn Studio → Módulo Jira → New Credential

Completa los campos de la siguiente manera:

Campo	Descripción	Ejemplo
Credential name	Nombre para identificar tu credencial.	Mi Jira Credential
Domain	Tu dominio de Jira Cloud (sin https:// ni www).	tuequipo.atlassian.net
Username	Tu correo de Atlassian.	usuario@empresa.com
API Token	El token generado en Atlassian.	ATATT3xFfExampleToken123

Luego, presiona Check para verificar la conexión.
Si la validación es exitosa, haz clic en Save credentials.

✅ ¡Listo! Tu credencial de Jira queda registrada y podrás usarla en todos los comandos del módulo.

Requisitos

• Tener una cuenta activa en Atlassian Jira Cloud.
• Permisos para crear y gestionar API Tokens.
• Acceso al dominio de tu organización (por ejemplo: miempresa.atlassian.net).