Para utilizar el módulo de Discord en Saturn Studio, es necesario crear previamente una aplicación en Discord Developer Portal y luego configurar la credencial dentro de Saturn Studio.
Si no tienes una cuenta de Discord, deberás crear una antes de continuar.
Crear una nueva aplicación Haz clic en New Application, asigna un nombre a la aplicación y confirma la creación.
Obtención del Client ID
Acceder a OAuth2 Dentro de la aplicación creada, dirígete al menú lateral y selecciona OAuth2.
Copiar el Client ID En la sección Client Information, copia el valor de Client ID. Este valor será utilizado posteriormente en Saturn Studio.
Obtención del Bot Token
Acceder a la sección Bot En el menú lateral de la aplicación, selecciona la opción Bot.
Generar el token Haz clic en el botón Reset Token para generar un nuevo Bot Token. Copia el token generado y guárdalo en un lugar seguro, ya que es necesario para la conexión con Saturn Studio.
Configuración de permisos del bot
Seleccionar permisos Dentro de la sección Bot, desplázate hacia abajo hasta la sección de permisos del bot y selecciona los permisos necesarios según el uso que tendrá el módulo de Discord.
Obtener el Permissions Integer Al seleccionar los permisos, Discord generará automáticamente un valor numérico llamado Permissions Integer.
Guardar el número de permisos Este número es el que debe ingresarse en el campo Permissions dentro de la credencial de Discord en Saturn Studio.
Configuración de la credencial en Saturn Studio
Acceso al módulo Discord Desde Saturn Studio, abre el módulo de Discord y selecciona cualquier comando.
Crear una nueva credencial En el campo Credential, haz clic en New para crear una nueva credencial.
Completar los datos de la credencial
Campo
Descripción
Credential name
Nombre identificador de la credencial
Client ID
Client ID obtenido desde la sección OAuth2 de Discord
Bot Token
Token generado en la sección Bot
Permissions (optional)
Número obtenido del Permissions Integer en Discord
Guardar credencial Una vez completados los campos, haz clic en Save credentials. La credencial quedará lista para ser utilizada por los comandos del módulo Discord.
Saturn Studio – Discord
Discord es una plataforma de comunicación diseñada para comunidades, equipos y amigos. Ofrece chat de voz, video y texto en servidores organizados por canales. Gracias a la integración de bots y herramientas de automatización, Discord permite una colaboración eficiente y una mejor gestión de comunidades.
Se activa cuando se envían nuevos mensajes en un canal de Discord.
Parámetro
Descripción
Ejemplo
Credential
Credencial de Discord necesaria para monitorear mensajes
credential
Channel
Canal donde se monitorearán los mensajes
Limit
Cantidad máxima de mensajes a verificar por ejecución
10
Assign result to variable
Variable donde se almacenarán los nuevos mensajes. Ejemplo: [{“id””1498765432109876543″,”type””message”,”channel_id””1378901234567890123″,”content”””,”timestamp””2025-07-15T100200.789000-0300″,”author”{“id””712345678901234567″,”username””emilyjones”,”display_name””EmilyJ”,”avatar””b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2″,”bot”false},”attachments”[],”embeds”[],”mentions”[],”edited_timestamp”null},{“id””1498765555123456789″,”type””message”,”channel_id””1378901234567890123″,”content”””,”timestamp””2025-07-15T100523.456000-0300″,”author”{“id””823456789012345678″,”username””davidbrown”,”display_name””DaveB”,”avatar””f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7″,”bot”false},”attachments”[],”embeds”[],”mentions”[{“id””712345678901234567″,”username””emilyjones”}],”edited_timestamp”null}]
{var}
List Channel Message
Lista los mensajes de un canal en Discord.
Parámetro
Descripción
Ejemplo
Credential
Credencial de Discord necesaria para listar los mensajes de un canal
credential
Channel
Canal del cual se listarán los mensajes
Limit
Cantidad máxima de mensajes a listar
10
Assign result to variable
Variable donde se almacenará el resultado. Ejemplo: {“messages”[{“id””1352247694133537975″,”channel_id””1352247694133537951″,”content””Hello World!”,”timestamp””2025-03-21T173609.206000+0000″,”author””SaturnStudio”}]}
{var}
Send Message
Envía un mensaje a un canal en Discord.
Parámetro
Descripción
Ejemplo
Credential
Credencial de Discord necesaria para enviar un mensaje
credential
Channel
Canal donde se enviará el mensaje
Message
Mensaje a enviar al canal
Hello World!
Assign result to variable
Variable donde se almacenará el resultado. Ejemplo: {“message”{“id””1587223342258503905420″,”channel_id””1876890285316370061″,”content””Hello World!”,”timestamp””2025-03-20T211117.721000+0000″}}
{var}
Send Media
Envía un archivo multimedia a un canal en Discord.
Parámetro
Descripción
Ejemplo
Credential
Credencial de Discord necesaria para enviar un archivo multimedia
credential
Channel
Canal donde se enviará el mensaje
File path
Ruta local de la imagen o archivo PDF a enviar
image.jpg
Assign result to variable
Variable donde se almacenará el resultado. Ejemplo: {“message”{“id””1352697674473537975″,”channel_id””1352329058106970061”,”attachments”[{“id””1352697674473534971″,”filename””file.pdf”,”size”106108,”url””https//cdn.discordapp.com/attachments/1352329058106970061/1352697674473534971/file.pdf?ex=67def509&is=67dda389&hm=8d71b044b090e64f8aeba72ec0c340628dea48abed447c353feb51a7703abf20&”,”proxy_url””https//media.discordapp.net/attachments/1352329058106970061/1352697674473534971/file.pdf?ex=67def509&is=67dda389&hm=8d71b044b090e64f8aeba72ec0c340628dea48abed447c353feb51a7703abf20&”,”content_type””application/pdf”,”content_scan_version”0,”title””File”}],”timestamp””2025-03-21T173609.206000+0000″}}
{var}
Create Channel
Crea un canal en Discord.
Parámetro
Descripción
Ejemplo
Credential
Credencial de Discord necesaria para crear un canal
Variable donde se almacenará el resultado. Ejemplo: {“channel”{“id””1354486288261208896″,”guild_id””1352328370585803061″,”name””rocket_channel”,”type”2}}
{var}
Saturn Studio – Reddit
Reddit es una plataforma impulsada por la comunidad donde los usuarios comparten enlaces, textos e imágenes, participan en discusiones y votan contenido según sus intereses.
Descripción de los comandos
Trigger Posts
Ejecuta el disparador cuando se publican nuevos posts en un subreddit.
Parámetros
Descripción
Ejemplo
Credential
Credencial de Reddit necesaria para monitorear publicaciones
credential
Check every N minutes
Intervalo de verificación en minutos
1
Subreddit
Subreddit donde se desea monitorear publicaciones. No es necesario agregar el prefijo “r/”
programming
Limit
Número máximo de publicaciones a revisar por ejecución
Subreddit donde se desea crear la publicación. No es necesario agregar el prefijo “r/”
programming
Title
Título de la publicación
New Post Title
Text
Contenido del post
This is a new post
Assign result to variable
Variable donde se guardará el resultado. Ejemplo: {“post”{“subreddit””learnprogramming”,”title””TestSaturn”,”text””This is a test for the new Rocketbot app “SaturnStudio””,”success”true}}
{var}
Submit a Comment
Envía un comentario en una publicación de Reddit.
Parámetros
Descripción
Ejemplo
Credential
Credencial de Reddit necesaria para enviar un comentario
Lista subreddits mediante una búsqueda por consulta.
Parámetros
Descripción
Ejemplo
Credential
Credencial de Reddit necesaria para listar subreddits
credential
Query
Texto de búsqueda para encontrar subreddits
programming
Limit
Número máximo de resultados a listar
20
Assign result to variable
Variable donde se guardará el resultado. Ejemplo: {“subreddits”[{“display_name””programming”,”title””programming”,”subscribers”6780499,”public_description””Computer Programming”,”url””/r/programming/”},{“display_name””C_Programming”,”title””C”,”subscribers”199204,”public_description””The subreddit for the C programming language”,”url””/r/C_Programming/”}]}
{var}
Saturn Studio – Microsoft SharePoint
Microsoft SharePoint es una plataforma de colaboración desarrollada por Microsoft que permite a las empresas gestionar documentos, compartir información y automatizar flujos de trabajo. Sus funciones clave incluyen almacenamiento en la nube, gestión de contenido, control de versiones e integración con Microsoft 365.
Descripción de los comandos
Get Sites
Obtener sitios de SharePoint
Parámetro
Descripción
Ejemplo
Credential
Credencial de Microsoft necesaria para obtener los sitios de SharePoint
credential
Asignar resultado a variable
Variable donde se almacenará el resultado
{var}
Get Lists
Obtener listas de un sitio de SharePoint
Parámetro
Descripción
Ejemplo
Credential
Credencial de Microsoft necesaria para obtener las listas de SharePoint
Pinecone es una plataforma de código abierto que ofrece una alternativa a Firebase, con un conjunto completo de herramientas de backend, que incluyen bases de datos en tiempo real, autenticación y servicios API.
Descripción de los comandos
Obtener indice
Obtener un indice de una base de datos de Pinecone
Parámetros
Descripción
ejemplo
Credencial
Credencial de Pinecone necesaria para obtener un índice
credential
Nombre del indice
El nombre del indice a obtener
Nombre del indice
Asignar resultado a variable
Variable donde se almacenará el resultado. Ejemplo {“table”[{“id”4,”created_at””2025-03-31T164319.794747+0000″,”name””John”,”lastname””Doe”},{“id”5,”created_at””2025-03-31T164356.786912+0000″,”name””John”,”lastname””Doe”}]}
{var}
Eliminar Índice
Eliminar un índice de una base de datos de Pinecone
Parámetros
Descripción
ejemplo
Credencial
Credencial de Pinecone necesaria para eliminar un índice
credential
Nombre del índice
El nombre del índice a eliminar
Mi nombre indice
Asignar resultado a variable
Variable donde se almacenará el resultado. Ejemplo {“table”[{“id”450102905661143,”created_at””2025-04-03T190051.148+0000″,”name””Wikipedia”,”lastname””web”,”embed””[-0.053218544,-0.025654549…]”}]}
{var}
Crear Índice
Crear un índice en una base de datos de Pinecone
Parámetros
Descripción
ejemplo
Credencial
Credencial de Pinecone necesaria para crear un índice
credencial
Nombre del Índice
El nombre del índice a crear
nombre del índice
Dimensión
La dimensión de los vectores
Seleccionar dimensión
Métrica
La métrica de distancia para el índice de vectores
Seleccionar métrica
Proveedor de Nube
El proveedor de nube para el índice
Seleccionar proveedor de nube
Región
La región para el índice
Seleccionar región
Asignar resultado a variable
Variable donde se almacenará el resultado. Ejemplo {“table”[{“id”450102905661143,”created_at””2025-04-03T190051.148+0000″,”name””Wikipedia”,”lastname””web”,”embed””[-0.053218544,-0.025654549…]”}]}
{var}
Obtener un Vector
Obtener un vector de un índice de Pinecone
Parámetros
Descripción
ejemplo
Credencial
Credencial de Pinecone necesaria para obtener un vector
credential
Nombre del Índice
El nombre del índice que contiene el vector
mi-indice
ID del Vector
El ID único del vector a recuperar
vector-id-123
Namespace
Namespace donde está almacenado el vector
namespace
Asignar resultado a variable
Variable donde se almacenará el resultado. Ejemplo {“bucket”{“id””Rocket”,”name””Rocket”,”owner”””,”public”true,”file_size_limit”1024,”allowed_mime_types”[“image/png”],”created_at””2025-03-31T190849.061Z”,”updated_at””2025-03-31T190849.061Z”}}
{var}
Insertar Vector
Insertar un vector en un índice de Pinecone
Parámetros
Descripción
ejemplo
Credencial
Credencial de Pinecone necesaria para insertar vectores
credential
Nombre del índice
El nombre del índice en el que se insertarán los vectores
Nombre del índice
Namespace
El namespace para el vector (opcional)
predeterminado
ID del Vector
Identificador único para el vector
vector-123
Valores Densos
Valores del vector separados por comas (ej 0.12, -0.45, 0.89)
Variable donde se almacenará el resultado. Ejemplo {“table””saturn_table”,”embed_column””embed”,”processed_rows”[{“id”8550467265849849,”text””{{“data_”[{“filename””sitefetch_1743693799824.txt”,”id””483171b10ebf1f8b5ebcc22ecaad0f2f7851f6613ca22496fb9557c0b485b34f27b388498fbe9b48efe2903645035e38″,”size”154,”provider””sitefetch”}],”content”{“/”{“title””Sitefetch”,”url””https//sitefetch.vercel.app/”,”content””[Buy me a Ko-fi]”}}}.content./.content”,”embedding_preview””[-0.0442160926759243, -0.019968125969171524, 0.024202141910791397, -0.03914377838373184, 0.07313912361860275…]”,”embedding_length”384,”created_at””2025-04-03T152336.083Z”,”name””Wikipedia”,”lastname””web”}],”total_rows”1}
{var}
Generar vector embedding
Generar un embedding en pinecone
Parámetros
Descripción
ejemplo
Credencial
Credencial de Pinecone necesaria para generar un embedding
credential
Credencial de AI
Selecciona la credencial de AI a utilizar
Nombre
Modelo de Embedding
Selecciona el modelo de embedding a utilizar
Nombre
Contenido de Texto
El contenido de texto para generar el embedding
Ingresa texto para generar embedding
Asignar resultado a variable
Variable donde se almacenará el resultado. Ejemplo {“table””saturn_table”,”embed_column””embed”,”processed_rows”[{“id”8550467265849849,”text””{{“data_”[{“filename””sitefetch_1743693799824.txt”,”id””483171b10ebf1f8b5ebcc22ecaad0f2f7851f6613ca22496fb9557c0b485b34f27b388498fbe9b48efe2903645035e38″,”size”154,”provider””sitefetch”}],”content”{“/”{“title””Sitefetch”,”url””https//sitefetch.vercel.app/”,”content””[Buy me a Ko-fi]”}}}.content./.content”,”embedding_preview””[-0.0442160926759243, -0.019968125969171524, 0.024202141910791397, -0.03914377838373184, 0.07313912361860275…]”,”embedding_length”384,”created_at””2025-04-03T152336.083Z”,”name””Wikipedia”,”lastname””web”}],”total_rows”1}
{var}
Buscar vector
Buscar vectores en un índice de Pinecone
Parámetros
Descripción
ejemplo
Credencial
Credencial de Pinecone necesaria para buscar vectores
credential
Nombre del índice
El nombre del índice en el que se buscarán los vectores
Mi índice
ID del Vector
ID del vector para encontrar vectores similares
doc_1_1763137241657
Top K
Número de vectores similares a retornar
10
Namespace
Namespace donde buscar (opcional)
predeterminado
Asignar resultado a variable
Variable donde se almacenará el resultado. Ejemplo {“insertedRows”[{“id”14,”created_at””2025-03-31T173647.646493+0000″,”name””John”,”lastname””Doe”},{“id”15,”created_at””2025-03-31T173647.646493+0000″,”name””Dave”,”lastname””Davinson”}]}
{var}
Eliminar Vector
Eliminar un vector de un índice de Pinecone
Parámetros
Descripción
ejemplo
Credencial
Credencial de Pinecone necesaria para eliminar un vector
credential
Nombre del Índice
El nombre del índice donde está almacenado el vector
nombre del índice
ID del Vector
ID del vector a eliminar
doc_1_1763137241657
Asignar resultado a variable
Variable donde se almacenará el resultado. Ejemplo {“file”{“path””C\Users\Desktop\saturn_studio\Rocketbot Icon.jpg”,”id””3aa9f15a-b93c-4765-92cc-e0574f71b446″,”fullPath””AAAAAA/C/Users/Desktop/saturn_studio/Rocketbot Icon.jpg”}}
{var}
Saturn Studio – PDF Reader
PDF Reader es una herramienta diseñada para extraer texto y datos tabulares desde archivos PDF de forma automática.
Descripción de los comandos
Leer archivo PDF
Lee un archivo PDF y extrae su contenido en texto y tablas.
Parámetros
Descripción
Ejemplo
Ruta del archivo PDF
Ruta local del archivo PDF desde donde se extraerá texto y tablas
file.pdf
Página
Número de página a procesar. Si no se especifica, se procesarán todas las páginas
2
Fila
Número de fila a extraer de las tablas. Si no se especifica, se procesarán todas las filas
[1, 5]
Parsear tabla
Si es verdadero, el módulo procesará la tabla y devolverá datos estructurados. Si es falso, devolverá texto crudo
true
Asignar resultado a variable
Variable donde se almacenará el resultado. Ejemplo: {“extractedValue”:[{“name1″:”Juan Pérez”},{“name2″:”María González”},{“name3″:”Carlos López”},{“name4″:”Ana Martínez”}]}
{var}
Saturn Studio – Credencial Google Tasks
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.
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 Tasks API (requerida para crear, editar y eliminar tareas y sus listas)
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
Desde la misma sección de Pantalla de consentimiento OAuth, ve a Acceso a los datos → Agregar o quitar permisos.
Añade los siguientes scopes recomendados:
Scope
Descripción
https://www.googleapis.com/auth/userinfo.email
Accede al correo del usuario autenticado.
openid
Requerido para la autenticación mediante OAuth 2.0.
https://www.googleapis.com/auth/tasks
Crear, editar, organizar y borrar todas tus tareas
https://www.googleapis.com/auth/tasks.readonly
Consultar tus tareas.
Actualiza y guarda los cambios.
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.
Cargar credenciales en Saturn Studio
Regresa al módulo Google Tasks en Saturn Studio y selecciona para crear una nueva credencial.
Pega el Client ID y Client Secret obtenidos en los campos correspondientes.
Guarda la credencial y realiza la conexión.
✅ Listo: tu credencial avanzada quedará configurada correctamente para el uso completo del módulo Google Tasks.
📌 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.
Saturn Studio – Facebook Messenger
Facebook Messenger es una plataforma de mensajería instantánea que permite a las empresas comunicarse directamente con clientes, automatizar respuestas con bots y mejorar la atención al cliente en tiempo real.
Descripción de los comandos
Subscribe to Webhook
Suscribirse a un webhook de Facebook Messenger
Parámetro
Descripción
Ejemplo
(Sin parámetros)
Suscribe un webhook de Facebook Messenger
—
Wait for a Message
Esperar un evento de Facebook Messenger
Parámetro
Descripción
Ejemplo
Credential
Credencial de Facebook Messenger necesaria para esperar un mensaje
credential
Assign result to variable
Variable donde se almacenará el resultado. Ejemplo: {“time”:1753191774240,”id”:”222220000000001″,”messaging”:[{“sender”:{“id”:”1234567890123456″},”recipient”:{“id”:”222220000000001″},”timestamp”:1753191773631,”message”:{“mid”:”m_XYZ123abcDEF456ghiJKL789mnopQRS_tUVWxyz”,”text”:”Running tests for SaturnStudio”}}]}
{var}
List Chats
Listar chats de Facebook Messenger
Parámetro
Descripción
Ejemplo
Credential
Credencial de Facebook Messenger necesaria para listar chats
credential
Assign result to variable
Variable donde se almacenará el resultado. Ejemplo: {“chats”:[{“id”:”t_8675309123456789″,”updated_time”:”2025-07-20T14:25:00+0000″,”participant_id”:”1122334455667788″,”participant_name”:”John Smith”,”can_reply”:true,”message_count”:5},{“id”:”t_9988776655443322″,”updated_time”:”2025-07-19T08:10:30+0000″,”participant_id”:”8877665544332211″,”participant_name”:”Emily Johnson”,”can_reply”:false,”message_count”:0}]}
{var}
Send Message
Enviar un mensaje a un usuario en Facebook Messenger
Parámetro
Descripción
Ejemplo
Credential
Credencial de Facebook Messenger necesaria para enviar un mensaje
credential
User
Selecciona el usuario al que querés enviar el mensaje
1234213123123
Message
Mensaje a enviar
Hello, this is a reply to your comment
Assign result to variable
Variable donde se almacenará el resultado. Ejemplo: {“status”:”Message sent successfully”,”message”:”Hi there!”,”message_id”:”m_aBc123XyZ789_MeSsAgE001xYzKLMnOpQrStUv”,”recipient_id”:”1234567890123456″}
{var}
Send File
Enviar un archivo a un usuario en Facebook Messenger
Parámetro
Descripción
Ejemplo
Credential
Credencial de Facebook Messenger necesaria para enviar un archivo
credential
User
Selecciona el usuario al que querés enviar el archivo
1234213123123
URL
URL del archivo a enviar. Puede ser una imagen o un PDF.
Obtener mensajes de un usuario en Facebook Messenger
Parámetro
Descripción
Ejemplo
Credential
Credencial de Facebook Messenger necesaria para obtener mensajes
credential
Chat User
Seleccioná el usuario del cual querés obtener los mensajes
1234213123123
Limit
Número de mensajes a recuperar
10
Assign result to variable
Variable donde se almacenará el resultado. Ejemplo: {“messages”:[{“id”:”m_AbC123Def456_GHi789Jkl012″,”message”:”Hey there!”,”from_id”:”9988776655443322″,”from_name”:”ChatBot”,”created_time”:”2025-07-20T10:45:00+0000″,”attachments”:[]},{“id”:”m_XyZ987Wvu654_Tsr321Qpo098″,”message”:”How can I help you?”,”from_id”:”9988776655443322″,”from_name”:”ChatBot”,”created_time”:”2025-07-20T10:40:00+0000″,”attachments”:[]}],”conversation_id”:”t_1234567899876543″,”total_count”:2,”status”:”Messages retrieved successfully”}
{var}
Saturn Studio – Evolution API WhatsApp
Evolution API es una API gratuita y de código abierto para integrar WhatsApp en aplicaciones, permitiendo enviar y recibir mensajes, gestionar instancias y más funcionalidades avanzadas.
Descripción de los comandos
Crear instancia
Crear una nueva instancia de WhatsApp en Evolution API
Parámetros
Descripción
Ejemplo
Credencial
Credencial de Evolution API necesaria para crear instancias
credencial
Nombre de la instancia
Nombre único para identificar la instancia de WhatsApp
Usar el comando “Crear instancia” con el nombre “mi_bot”
Usar el comando “Conectar a WhatsApp” para generar el QR
Usar el comando “Obtener código QR” para mostrar el QR al usuario
Escanear el QR con WhatsApp
2. Enviar un mensaje
Una vez conectada la instancia, usar el comando “Enviar mensaje” con:
Nombre de instancia: “mi_bot”
Número: “5491123456789”
Mensaje: “¡Hola! Este es un mensaje desde Evolution API”
3. Recibir mensajes
Usar el comando “Esperar mensaje” para recibir mensajes entrantes a través de webhooks.
Notas importantes
Cada instancia debe tener un nombre único
Los números de teléfono deben incluir el código de país sin el signo +
Los webhooks requieren una URL accesible públicamente
Evolution API maneja automáticamente la conexión de WhatsApp Web
El módulo es compatible con todas las funcionalidades principales de WhatsApp
Saturn Studio – Credencial Google Chat
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.
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
Desde la misma sección de Pantalla de consentimiento OAuth, ve a Acceso a los datos → Agregar o quitar permisos.
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.
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.
Actualiza y guarda los cambios.
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
En Google Cloud Console, ve a “APIs y servicios” > “Google Chat API”
Haz clic en “Configuración” o “Configuration” en el menú lateral
En la sección “Estado de aplicación”, selecciona “ACTIVA”
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
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
Regresa al módulo Google Contacts en Saturn Studio.
Selecciona el modo Avanzado (OAuth).
Pega el Client ID y Client Secret obtenidos en los campos correspondientes.
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.
