Saturn Studio – Credencial Google Sheets

La integración con Google Sheets en Saturn Studio puede hacerse de dos maneras:

Método Básico (Conexión rápida)

Pasos

  1. Abre el módulo Google Sheets en Saturn Studio.
  2. Haz clic en New para crear una nueva credencial.
  3. Asigna un nombre a la credencial.
  4. Haz clic en Conectar con Google.
  5. Selecciona tu cuenta y acepta los permisos solicitados.

✅ Listo: la credencial queda registrada para funciones básicas de Google Sheets.

Configuración Avanzada (OAuth 2.0 con Google Cloud)

Este método da mayor control de permisos y seguridad. Define manualmente los accesos que usará Saturn Studio.

Crear / elegir proyecto y habilitar APIs

  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 obtener las credenciales de Calendly en Saturn Studio, sigue estos pasos:

1. Acceso al módulo Calendly

Desde el módulo Calendly en Saturn Studio, podrás crear o editar tu credencial.

2. Crear una nueva credencial

Para crear la credencial, haz clic en New.

3. Asignar un nombre a la credencial

Ingresa un nombre para la credencial y luego haz clic en Connect to Calendly.

4. Registrar en Calendly

Esto abrirá una nueva pestaña con la página oficial de Calendly, donde deberás registrarte si aún no tienes cuenta.

5. Conectar Saturn Studio con Calendly

Después de registrarte, Calendly te pedirá que le des permiso para conectar con Saturn Studio. Una vez otorgado el permiso, Saturn Studio se conectará automáticamente con Calendly.



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.

📚 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).



Saturn Studio – Voximplant

📌 ¿Qué es este módulo?

Este módulo integra Voximplant, la plataforma en la nube para automatización de comunicaciones, directamente con Saturn Studio. Permite a los robots gestionar interacciones en tiempo real, como esperar y recibir llamadas, ejecutar escenarios de voz interactivos (IVR), y consultar historiales y números telefónicos.

Gracias a esta integración, puedes automatizar completamente las operaciones de un centro de contacto, crear sistemas de notificación por voz, o desarrollar flujos de trabajo complejos que se activan a partir de una llamada entrante, todo orquestado desde la lógica de un robot en Saturn Studio.

📚 Descripción de los comandos

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

🪝 Subscribe to Webhook

Suscribe un webhook a Voximplant para recibir eventos. (Este comando prepara la conexión para otros, como “Wait for a call”).

📥 Wait for a call

Espera una llamada entrante desde Voximplant.

Parámetro Descripción Ejemplo
Credential Credencial de Voximplant necesaria para esperar mensajes. credential
Simplify data Simplifica los datos de la llamada. true
Assign result to variable Variable donde se almacenará el resultado. {“call_id”: 356714616, “caller_number”: “12027731097”, “callee_number”: “1423561719409”, “callee_name”: “John”, “callee_lastname”: “Doe”, “callee_email”: “johndoe@example.com”, “direction”: “outgoing”, “start_time”: “2025-02-26T151527”, “duration”: 3, “status”: “unknown”, “record_url”: “”}

📜 Get Call History

Obtiene el historial de llamadas de una cuenta de Voximplant.

Parámetro Descripción Ejemplo
Credential Credencial de Voximplant necesaria para obtener el historial. credential
From Date La fecha “desde” para obtener el historial. 20-02-2025
To Date La fecha “hasta” para obtener el historial. 20-02-2025
Call ID El ID de la llamada para obtener el historial. 2921787
Limit El número máximo de registros a devolver. 10
Assign result to variable Variable donde se almacenará el resultado. {“success”:true,”result”:[{“id”:355384437,”attempt_num”:1,”calllist_item_id”:null,”domain_id”:17767,”session_id”:”1649024222″,”scenario_id”:45485,”datetime_start”:”2025-02-25 131922″,”phone_a”:”12027731097″,”phone_b”:”1433171659189″,”is_incoming”:false,”call_result_code”:1,”duration”:4,”record_url”:null,”call_cost”:”0.23375301″,”call_data”:”{“UTC”: “UTC”, “email”: “johndoe@Rocketbot.com”, “names”: “Juan”, “phone”: “1433171659189”, “asr_input”: “”, “lastnames”: “Pablo”}”,”call_resources”:”[{“cost”: 0.001153, “unit”: “”, “used_at”: “2025-02-25 131927”, “description”: “VoiceMail”, “resource_type”: “VOICEMAILDETECTION”, “transaction_id”: 32829863870004, “resource_quantity”: 1, “resource_usage_id”: 758004330}, {“cost”: 0.0126, “unit”: “”, “used_at”: “2025-02-25 131947”, “description”: “TextToSpeech”, “resource_type”: “TTS_TEXT_MICROSOFT”, “transaction_id”: 32829895880004, “resource_quantity”: 625, “resource_usage_id”: 758004329}]”,”call_calls”:”[{“cost”: 0.22, “call_id”: 1311309171, “duration”: 3, “incoming”: false, “start_time”: “2025-02-25 131947”, “successful”: true, “local_number”: “12027731097”, “remote_number”: “1433171659189”, “transaction_id”: 32829895780004, “remote_number_type”: “pstn”}]”,”call_records”:”[]”,”call_status”:false,”recalc”:true,”campaign_id”:null,”processing”:false,”scenario_version_id”:300456,”has_call_logs”:true,”user_id”:null,”dialing_time”:24,”completion_code”:”AMD”,”queue_id”:null,”user_group_id”:null,”callback_at”:null}],”_meta”:{“limit”:1,”cursor”:null}}

🔢 Get Numbers

Obtiene números de una cuenta de Voximplant.

Parámetro Descripción Ejemplo
Credential Credencial de Voximplant necesaria para obtener números. credential
Phone Number El número de teléfono a obtener. 1433171659189
Assign result to variable Variable donde se almacenará el resultado. {“success”:true,”result”:[{“id”:8660,”domain_id”:17767,”auto_charge”:true,”can_be_used”:true,”category_name”:”GEOGRAPHIC”,”phone_country_code”:”US”,”phone_purchase_date”:”2024-02-27 094918″,”required_verification”:null,”verification_status”:”NOT_REQUIRED”,”deactivated”:false,”unverified_hold_until”:null,”canceled”:false,”phone_next_renewal”:”2025-02-27″,”phone_number”:”12027731097″,”phone_price”:”1.0000″,”phone_region_id”:null,”redirect_number”:null,”deleted”:false,”is_sms_enabled”:false,”is_sms_supported”:false,”description”:null,”allowed_callerids”:true}],”_meta”:{“totalCount”:1,”pageCount”:1,”currentPage”:1,”perPage”:20}}

▶️ Run Scenario

Ejecuta un escenario en Voximplant.

Parámetro Descripción Ejemplo
Credential Credencial de Voximplant necesaria para ejecutar un escenario. credential
Scenario ID El ID del escenario a ejecutar. 2066
Caller ID El ID de llamada (número) a utilizar. 2212003838
Variables Variables a enviar al escenario. [{“Name”: “John”, “Lastame”: “Doe”, “Age”: 30}]
Assign result to variable Variable donde se almacenará el resultado. {“success”: true,”result”: true}

🧪 Ejemplo de uso

  • IVR de Atención al Cliente: Utilizar “Wait for a call” para recibir una llamada y “Run Scenario” para lanzar un menú de voz interactivo que guíe al cliente.
  • Campañas de Voz: Crear un robot que lea una lista de clientes desde una base de datos y use “Run Scenario” en un bucle para llamar a cada uno y reproducir un mensaje promocional.
  • Auditoría y Reportería: Programar un robot para que use “Get Call History” semanalmente para obtener todas las llamadas, calcular costos y duraciones, y generar un informe.
  • Verificación Telefónica: Como parte de un proceso de registro, ejecutar un escenario que llame al usuario y le pida que ingrese un código en su teclado para validar su número.

🧩 Requisitos

  1. Tener una cuenta activa en la plataforma Voximplant.
  2. Disponer de las credenciales de API de Voximplant (como API Key, Account ID) para ser utilizadas en el parámetro Credential.
  3. Haber configurado previamente las aplicaciones, reglas y escenarios de voz en el panel de control de Voximplant.
  4. Conocer los IDs de los escenarios, llamadas o números para los comandos que requieran una consulta específica.



Saturn Studio – Twilio

📌 ¿Qué es este módulo?

Este módulo integra Twilio, la plataforma de comunicaciones en la nube, directamente en Saturn Studio. Permite a los robots enviar y recibir mensajes SMS, mensajes de WhatsApp y realizar llamadas de voz, automatizando la interacción con clientes, empleados o sistemas a través de canales de comunicación directos.

Con esta integración, los flujos de trabajo en Saturn Studio pueden notificar a los usuarios sobre eventos importantes, enviar recordatorios de citas, implementar sistemas de verificación por código, o incluso realizar llamadas automáticas para entregar información crítica, todo de manera programada y eficiente.

📚 Descripción de los comandos

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

💬 Create a Message

Crea y envía un mensaje (SMS o WhatsApp) a través de Twilio.

Parámetro Descripción Ejemplo
Credential Credencial de Twilio necesaria para crear un mensaje. credential
Send mode Modo de envío del mensaje. SMS or WhatsApp
From Número de teléfono que enviará el mensaje. +15005550006
To Número de teléfono que recibirá el mensaje. +15005550006
Message Body El mensaje que será enviado. Message
Assign result to variable Variable donde se almacenará el resultado. [{“body”: “Hola, este es un saludo de Saturn Studio”, “numSegments”: “1”, “direction”: “outbound-api”, “from”: “+15005550006”, “to”: “+15005550005”, “dateUpdated”: “2024-12-04T183627.000Z”, “errorMessage”: null, “uri”: “/2010-04-01/Accounts/ACc0a38f96f87ebc57f5a5405bc6a8fe6c/Messages/SM971b134c3a799d1e3865ac663442590b.json”, “accountSid”: “ACc0a38f96f87ebc57f5a5405bc6a8fe6c”, “sid”: “SM971b134c3a799d1e3865ac663442590b”}]

📂 List Messages

Lista todos los mensajes en Twilio, con opción de filtrado.

Parámetro Descripción Ejemplo
Credential Credencial de Twilio necesaria para listar mensajes. credential
From Phone number Leer mensajes enviados solo desde este número. +15005550006
To Phone number Leer mensajes enviados solo a este número. +15005550006
Limit Limitar el número de mensajes a devolver. 3
Assign result to variable Variable donde se almacenará el resultado. [{“id”: “recZX9AJjpJXvsveG”, “createdTime”: “2024-11-22T124734.000Z”, “fields”: {“Direction”: “Washington 412”, “Name”: “John”, “Age”: “1”, “Status”: “In progress”, “Lastname”: “Doe”}}]

🔍 Get a Message

Obtiene un mensaje específico de Twilio por su ID.

Parámetro Descripción Ejemplo
Credential Credencial de Twilio necesaria para obtener un mensaje. credential
Message ID El ID del mensaje que se desea obtener. SMdc0aa16b74f7096f322a6f1f4f94c93f
Assign result to variable Variable donde se almacenará el resultado. {“body”: “Hola, este es un saludo de Saturn Studio”, “numSegments”: “1”, “direction”: “outbound-api”, “from”: “whatsapp+14155238886”, “to”: “whatsapp+14155238886”, “dateUpdated”: “2024-12-04T190343.000Z”, “errorMessage”: null, “uri”: “/2010-04-01/Accounts/AC933390f4bec449eb14882d85c73b8596/Messages/SMc164e584b9d0f83b139e816b13df0051.json”, “accountSid”: “AC933390f4bec449eb14882d85c73b8596”, “sid”: “SMc164e584b9d0f83b139e816b13df0051”}

🗑️ Delete a Message

Elimina un mensaje en Twilio.

Parámetro Descripción Ejemplo
Credential Credencial de Twilio necesaria para eliminar un mensaje. credential
Message ID El ID del mensaje que se desea eliminar. SMdc0aa16b74f7096f322a6f1f4f94c93f
Assign result to variable Variable donde se almacenará el resultado (true o false). true

📞 Create a Call

Crea una llamada en Twilio.

Parámetro Descripción Ejemplo
Credential Credencial de Twilio necesaria para crear una llamada. credential
From Número de teléfono que realizará la llamada. +14173612192
To Número de teléfono que recibirá la llamada. +14173612192
Use TwiML Usar TwiML para controlar la llamada. true or false
URL La URL que será usada para crear la llamada. https://demo.twilio.com/welcome/voice/
Message Body El mensaje que será enviado. Message
Assign result to variable Variable donde se almacenará el resultado. {“sid”: “CA878c4e99ea30c769aa4aaa8980b0170d”, “dateCreated”: null, “dateUpdated”: null, “accountSid”: “AC58011c1dd799a0144ba44be81013f9b0”, “to”: “+14173612192”, “from”: “+14173612192”, “phoneNumberSid”: “PNdc93d68cdcfe37ba043ec872a5c39e46”, “status”: “queued”, “startTime”: null, “endTime”: null, “duration”: null, “direction”: “outbound-api”, “answeredBy”: null, “groupSid”: null, “callerName”: null, “queueTime”: “0”, “bodyMessage”: “Rocketbot call”}

📂 List Calls

Lista todas las llamadas en Twilio, con opción de filtrado.

Parámetro Descripción Ejemplo
Credential Credencial de Twilio necesaria para listar llamadas. credential
From Phone number Listar llamadas hechas solo desde este número. +14173612192
To Phone number Listar llamadas hechas solo a este número. +14173612192
Limit Limitar el número de llamadas a devolver. 3
Assign result to variable Variable donde se almacenará el resultado. [{“id”: “recZX9AJjpJXvsveG”, “createdTime”: “2024-11-22T124734.000Z”, “fields”: {“Direction”: “Washington 412”, “Name”: “John”, “Age”: “1”, “Status”: “In progress”, “Lastname”: “Doe”}}]

🔍 Get a Call

Obtiene una llamada específica de Twilio por su ID (SID).

Parámetro Descripción Ejemplo
Credential Credencial de Twilio necesaria para obtener una llamada. credential
Call ID (SID) El ID de la llamada que se desea obtener. SMdc0aa16b74f7096f322a6f1f4f94c93f
Assign result to variable Variable donde se almacenará el resultado. {“sid”: “CAde0fd68dc4ed3e9c05d875e5478333d9”, “dateCreated”: “2024-12-04T194253.000Z”, “dateUpdated”: “2024-12-04T194307.000Z”, “accountSid”: “AC58011c1dd799a0144ba44be81013f9b0”, “to”: “+14173612192”, “from”: “+14173612192”, “status”: “completed”, “startTime”: “2024-12-04T194301.000Z”, “endTime”: “2024-12-04T194307.000Z”, “duration”: “6”, “direction”: “outbound-api”, “answeredBy”: null, “forwardedFrom”: “+14173612192”, “callerName”: “”, “queueTime”: “0”}

🗑️ Delete a Call

Elimina una llamada en Twilio.

Parámetro Descripción Ejemplo
Credential Credencial de Twilio necesaria para eliminar una llamada. credential
Call ID (SID) El ID de la llamada que se desea eliminar. CAde0fd68dc4ed3e9c05d875e5478333d9
Assign result to variable Variable donde se almacenará el resultado (true o false). true

🧪 Ejemplo de uso

  • Notificaciones de sistema: Enviar un SMS a un administrador de sistemas cuando un servidor crítico deja de responder.
  • Recordatorios de citas: Automatizar el envío de un recordatorio por WhatsApp a los clientes 24 horas antes de su cita agendada.
  • Verificación de dos factores (2FA): Crear un robot que, como parte de un proceso de login, genere un código y lo envíe por SMS al usuario para que pueda continuar.
  • Encuestas de satisfacción: Realizar una llamada automática a un cliente después de una compra para que califique su experiencia, utilizando TwiML para gestionar las respuestas por tonos.

🧩 Requisitos

  1. Tener una cuenta de Twilio.
  2. Disponer del Account SID y el Auth Token de tu cuenta de Twilio. Estos dos valores conforman la credencial necesaria en Saturn Studio.
  3. Haber adquirido al menos un número de teléfono de Twilio para poder enviar mensajes o realizar llamadas.
  4. Asegurarse de que el número de destino sea válido y tenga el formato internacional correcto (ej: +15005550006).



Saturn Studio – tufirma.digital

📌 ¿Qué es este módulo?

Este módulo conecta Saturn Studio con la plataforma tufirma.digital, permitiendo automatizar por completo el ciclo de vida de la firma de documentos electrónicos con validez legal. Los robots pueden crear, enviar, consultar y gestionar documentos directamente desde un flujo de automatización.

La integración con Saturn Studio es ideal para procesos de negocio que requieren formalización. Por ejemplo, un robot puede tomar los datos de un nuevo cliente desde un CRM, generar un contrato, enviarlo a firmar a través de este módulo y, una vez firmado, descargarlo y archivarlo en el sistema correspondiente, todo sin intervención humana.

📚 Descripción de los comandos

A continuación se detallan los comandos disponibles para la integración con tufirma.digital:

✍️ Get Available Signatures

Obtiene las firmas disponibles desde tufirma.digital.

Parámetro Descripción Ejemplo
Credential Credencial de tufirma.digital necesaria para la consulta. credential
Assign result to variable Variable donde se almacenará el resultado. {“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”}]}

🔍 Get Signature

Obtiene una firma por su Id desde tufirma.digital.

Parámetro Descripción Ejemplo
Credential Credencial de tufirma.digital necesaria para la consulta. credential
Signature Id ID de la firma que se desea obtener. 5128391293
Assign result to variable Variable donde se almacenará el resultado. {“documentos”:{“nombre”:”Contrato de Servicios”,”descripcion”:”Contrato firmado para prestación de servicios”,”firmantes”:[{“nombre”:”Pedro Perez”,”email”:”pedro.perez@example.com”,”tipo”:”simple”,”ready”:false}],”firmantesFea”:[],”viewers”:[{“nombre”:”Ana López”,”email”:”ana.lopez@example.com”}],”tags”:[“servicio”,”contrato”],”url”:”https//aws-tufirma-dev-v2.s3.us-east-2.amazonaws.com/1746817287261Contrato“,”fields”:[{“filler”:”pedro.perez@example.com”,”type”:”signature”,”required”:true,”name”:”Firma Principal”,”ready”:false},{“filler”:”Observaciones”,”type”:”text”,”required”:false,”name”:”Campo de Texto”,”ready”:false}],”historial”:[{“date”:”202550″,”data”:”CREATED”,”contexto”:”admin@example.com”}],”costCenterCode”:[]}}

📄 Get Document

Obtiene un documento por su Id desde tufirma.digital.

Parámetro Descripción Ejemplo
Credential Credencial de tufirma.digital necesaria para la consulta. credential
Document Id ID del documento que se desea obtener. 5128391293
Assign result to variable Variable donde se almacenará el resultado. {“documentos”:{“nombre”:”Contrato de Servicios”,”descripcion”:”Contrato firmado para prestación de servicios”,”firmantes”:[{“nombre”:”Pedro Perez”,”email”:”pedro.perez@example.com”,”tipo”:”simple”,”ready”:false}],”firmantesFea”:[],”viewers”:[{“nombre”:”Ana López”,”email”:”ana.lopez@example.com”}],”tags”:[“servicio”,”contrato”],”url”:”https//aws-tufirma-dev-v2.s3.us-east-2.amazonaws.com/1746817287261Contrato“,”fields”:[{“filler”:”pedro.perez@example.com”,”type”:”signature”,”required”:true,”name”:”Firma Principal”,”ready”:false},{“filler”:”Observaciones”,”type”:”text”,”required”:false,”name”:”Campo de Texto”,”ready”:false}],”historial”:[{“date”:”202550″,”data”:”CREATED”,”contexto”:”admin@example.com”}],”costCenterCode”:[]}}

📂 List Documents

Lista documentos desde tufirma.digital, con opción de filtrar por rango de fechas.

Parámetro Descripción Ejemplo
Credential Credencial de tufirma.digital necesaria para la consulta. credential
From Date Fecha “desde” para filtrar. Formato: YYYY-MM-DD. 2025-03-25
To Date Fecha “hasta” para filtrar. Formato: YYYY-MM-DD. 2025-03-31
Assign result to variable Variable donde se almacenará el resultado. {“documentos”:[{“nombre”:”Probando email”,”descripcion”:”lA dEsC”,”firmantes”:[{“nombre”:”daniel”,”email”:”usuariotestorg@yopmail.com”,”tipo”:”simple”,”ready”:false}],”firmantesFea”:[],”viewers”:[],”tags”:[“tag1″,”tag2″],”url”:”https//aws-tufirma-dev-v2.s3.us-east-2.amazonaws.com/1746717666511Probando%20email“,”fields”:[{“filler”:”usuariotestorg@yopmail.com”,”type”:”signature”,”required”:true,”name”:”NEW_FIELD_EMPTY”,”ready”:false},{“filler”:”Firmante”,”type”:”text”,”required”:true,”name”:”NEW_FIELD_EMPTY”,”ready”:false}],”historial”:[{“date”:”202548″,”data”:”CREATED”,”contexto”:”david@rocketbot.com”}],”costCenterCode”:[]},{“nombre”:”65806″,”firmantes”:[{“nombre”:”daviod”,”email”:”david@rocketbot.com”,”tipo”:”simple”,”ready”:true}],”firmantesFea”:[],”viewers”:[],”tags”:[],”documentoMimeType”:”application/pdf”,”url”:”https//aws-tufirma-dev-v2.s3.us-east-2.amazonaws.com/1746652691942-65806.pdf“,”fields”:[{“filler”:”david@rocketbot.com”,”type”:”signature”,”required”:true,”name”:”NEW_FIELD_EMPTY”,”ready”:false}],”historial”:[{“date”:”202547″,”data”:”SIGNED”,”contexto”:”david@rocketbot.com”},{“date”:”202547″,”data”:”CREATED”,”contexto”:”david@rocketbot.com”}]}]}

➕ Create Document

Crea un nuevo documento para ser firmado en tufirma.digital.

Parámetro Descripción Ejemplo
Credential Credencial de tufirma.digital necesaria para crear el documento. credential
File path Ruta al archivo local a subir. document.pdf
Document Name Nombre del documento a crear. Service Agreement
Description Descripción del documento a crear. A contract defining the terms of service between provider and client.
Signer’s Email Correo del firmante del documento. johndoe@example.com
Signer’s Name Nombre del firmante del documento. John Doe
Viewer Email Correo del visualizador del documento. johndoe@example.com
Viewer Name Nombre del visualizador del documento. John Doe
Tag Etiqueta para el documento a crear. Tag Service Agreement
Assign result to variable Variable donde se almacenará el resultado. {“document”:{“_id”:”123e4567e89b12d3a4564267″,”attachedDoc”:{“name”:”Contrato_Trabajo”,”mimetype”:”application/pdf”, …}}}

🧪 Ejemplo de uso

  • Automatización de RRHH: Al dar de alta a un nuevo empleado, el robot puede generar su contrato, usar “Create Document” para enviarlo a firmar y luego usar “Get Document” periódicamente para verificar si ya fue firmado.
  • Gestión de Acuerdos Comerciales: Un robot puede leer una lista de nuevos clientes desde un CRM, crear un acuerdo de servicios para cada uno y enviarlo a firmar, añadiendo al gerente de ventas como “visualizador”.
  • Auditoría y Reportería: Programar un robot para que, a fin de mes, use “List Documents” para obtener todos los documentos firmados y archive sus detalles en una hoja de cálculo o base de datos.
  • Consulta de Estado: Un chatbot interno podría permitir a los empleados consultar el estado de un documento. El usuario proporciona un ID, y el robot usa “Get Document” para devolverle la información de los firmantes y el historial.

🧩 Requisitos

  1. Tener una cuenta activa en la plataforma tufirma.digital.
  2. Disponer de la credencial de API (API Key o Token) proporcionada por tufirma.digital para ser utilizada en el parámetro Credential.
  3. Para crear documentos, el archivo base (ej: PDF) debe estar en una ruta local accesible para el robot.
  4. Conocer los IDs de las firmas o documentos para los comandos de consulta específica (“Get Signature” o “Get Document”).



Saturn Studio – Trello

📌 ¿Qué es este módulo?

Este módulo integra Saturn Studio con Trello, la popular herramienta de gestión de proyectos. Permite a los robots conectarse directamente a la API de Trello para automatizar la creación y gestión de tableros, listas, tarjetas y miembros.

Gracias a esta integración, puedes incluir la administración de tus proyectos en flujos de trabajo más amplios. Por ejemplo, un robot puede crear automáticamente una tarjeta de Trello cuando llega un correo importante, o mover tareas entre listas basándose en el estado de un proceso en otro sistema, centralizando y automatizando la gestión de tareas.

📚 Descripción de los comandos

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

📋 Create Board

Crea un nuevo tablero en Trello.

Parámetro Descripción Ejemplo
Credential Credencial de Trello necesaria para crear un tablero. credential
Name Nombre del tablero a crear. My Board
Visibility Visibilidad del tablero. El valor por defecto es privado. Private, Public or Organization
Assign result to variable Variable donde se almacenará el resultado. {“board”:{“id”:”67db340daf9e65aq8D765dcd”,”name”:”My Test Board”,”privacy”:”public”,”url”:”https//[suspicious link removed]”}}

🔍 Get a Board

Obtiene un tablero de Trello por su ID.

Parámetro Descripción Ejemplo
Credential Credencial de Trello necesaria para obtener un tablero. credential
Board ID ID del tablero que se desea obtener. 67db340daf9e65aq8D765dcd
Assign result to variable Variable donde se almacenará el resultado. {“board”:{“id”:”67db340daf9e65aq8D765dcd”,”name”:”My Test Board”,”privacy”:”public”,”url”:”https//[suspicious link removed]”}}

👤 Add Member to Board

Añade un miembro a un tablero en Trello.

Parámetro Descripción Ejemplo
Credential Credencial de Trello necesaria para añadir un miembro. credential
Board ID ID del tablero al que se añadirá el miembro. 67db340daf9e65aq8D765dcd
Email Address Correo electrónico del miembro a añadir. johndoe@example.com
Tipo de Miembro Tipo de miembro a añadir al tablero. Admin, Normal or Observer
Full Name Nombre completo del miembro a añadir. John Doe
Assign result to variable Variable donde se almacenará el resultado. {“member”:{ “id”:”67dc1bdc6h2a1a3ca080d26f”,”username”:”johndoedoe”,”fullName”:”John Doe”,”email”:”johndoe@gmail.com”}}

➕ Create a List

Crea una nueva lista en un tablero de Trello.

Parámetro Descripción Ejemplo
Credential Credencial de Trello necesaria para crear una lista. credential
Board ID ID del tablero donde se creará la lista. 67db340daf9e65aq8D765dcd
Name Nombre de la lista a crear. My List
Assign result to variable Variable donde se almacenará el resultado. {“list”:{“id”:”67qh684t1eec43cbfeb40d54″,”name”:”This List”,”boardId”:”67qh684t1eec43cbfeb40d54″}}

🔍 Get a List

Obtiene una lista de Trello por su ID.

Parámetro Descripción Ejemplo
Credential Credencial de Trello necesaria para obtener una lista. credential
List ID ID de la lista que se desea obtener. 67db340daf9e65aq8D765dcd
Assign result to variable Variable donde se almacenará el resultado. {“list”:{“id”:”67dc561d4hfc23cbfeb40d54″,”name”:”This List”,”boardId”:”27sh65e5ghdba37739759cc2″,”cards”:{“openPerList”:{“status”:”ok”,”disableAt”:5000,”warnAt”:4000},”totalPerList”:{“status”:”ok”,”disableAt”:1000000,”warnAt”:800000}}}}

✉️ Create a Card

Crea una nueva tarjeta en una lista de Trello.

Parámetro Descripción Ejemplo
Credential Credencial de Trello necesaria para crear una tarjeta. credential
List ID ID de la lista donde se creará la tarjeta. 67db340daf9e65aq8D765dcd
Name Nombre de la tarjeta a crear. My Card
Description Descripción de la tarjeta a crear. Description of the card
File path Ruta a una imagen o archivo PDF local para adjuntar. image.jpg
Assign result to variable Variable donde se almacenará el resultado. {“card”:{“id”:”67dh31fft258410468a83021″,”name”:”Other Card”,”desc”:”Card description”,”listId”:”67dc214hbffc42cbfeb40d54″,”attachment”:null}}

🔍 Get a Card

Obtiene una tarjeta de Trello por su ID.

Parámetro Descripción Ejemplo
Credential Credencial de Trello necesaria para obtener una tarjeta. credential
Card ID ID de la tarjeta que se desea obtener. 67db340daf9e65aq8D765dcd
Assign result to variable Variable donde se almacenará el resultado. {“card”:{“id”:”67dh31fft258410468a83021″,”name”:”Other Card”,”desc”:”Card description”,”listId”:”67dc214hbffc42cbfeb40d54″,”attachment”:[]}}

🧪 Ejemplo de uso

  • Flujo de soporte técnico: Automatizar la creación de una nueva tarjeta en el tablero de “Soporte” cada vez que se recibe un correo con el asunto “Incidencia”.
  • Sincronización de proyectos: Leer un archivo de Excel con hitos de un proyecto y usar los comandos para crear un tablero, listas y tarjetas correspondientes en Trello.
  • Gestión de equipos: Añadir automáticamente a un nuevo empleado al tablero de “Onboarding” cuando su perfil es creado en el sistema de RRHH.
  • Reporte de avances: Usar los comandos “Get a List” y “Get a Card” para leer el estado de todas las tareas en un tablero y generar un informe de progreso que se envía por correo.

🧩 Requisitos

  1. Tener una cuenta de Trello.
  2. Generar las credenciales desde tu cuenta de Trello (API Key y Token). Este par de valores se utilizará para la credencial en Saturn Studio.
  3. Conocer los IDs de los tableros, listas o tarjetas con los que se desea interactuar para los comandos que así lo requieran.
  4. Asegurarse de que la cuenta de Trello asociada a las credenciales tenga los permisos adecuados para realizar las acciones deseadas (ej: permiso para crear tableros, añadir miembros, etc.).



Saturn Studio – Tools

📌 ¿Qué es este módulo?

Este módulo agrupa un conjunto de herramientas fundamentales para la manipulación de datos y el control de flujos dentro de Saturn Studio. Estos comandos son los bloques de construcción básicos para cualquier automatización, permitiendo gestionar variables que almacenan la información que el robot procesa.

Su integración con Saturn Studio es total, ya que estas herramientas son la base para que los robots puedan recordar datos, tomar decisiones y ejecutar tareas de forma dinámica y ordenada.

📚 Descripción de los comandos

A continuación se detallan los comandos disponibles en este módulo:

⚙️ Set Variable

Establece o asigna un valor a una variable.

Parámetro Descripción Ejemplo
Value to assign to the variable Valor a asignar a la variable. Se pueden usar funciones de Javascript. ABC
Variable name Nombre de la variable a la que se le asignará el valor. {var_name}

🧪 Ejemplo de uso

  • Inicializar un contador: Establecer una variable contador con el valor 0 al inicio de un proceso repetitivo o bucle.
  • Guardar un dato fijo: Almacenar una URL, una ruta de archivo o un correo electrónico en una variable para reutilizarla fácilmente en varios pasos de la automatización.
  • Establecer un estado: Crear una variable estado_proceso y asignarle el valor iniciado o completado para controlar el flujo del robot y tomar decisiones basadas en ese estado.

🧩 Requisitos

  1. No existen requisitos especiales para este comando, ya que es una función nativa y fundamental de la plataforma.



Saturn Studio – Text Parser

Text Parser es un servicio que permite convertir imágenes a texto, PDF, entre otros formatos.

📌 ¿Qué es este módulo?

Este módulo ofrece un conjunto de herramientas esenciales para la manipulación y transformación de datos directamente en Saturn Studio. Su función principal es analizar (parsear) y convertir textos entre los formatos más comunes utilizados en la automatización de datos, como JSON, XML, HTML y CSV.

La integración con Saturn Studio permite a los flujos de trabajo procesar información de distintas fuentes de manera nativa. Por ejemplo, un robot puede obtener datos de una página web (HTML), extraer la información relevante, convertirla a JSON y luego filtrar solo los valores necesarios para continuar con el proceso, todo sin salir de la plataforma.

📚 Descripción de los comandos

A continuación se detallan los comandos disponibles para el procesamiento de texto:

🔍 Filter JSON

Filtra una clave o valor desde un JSON.

Parámetro Descripción Ejemplo
JSON JSON desde donde se extraerán los elementos. {“documentId”: “1XTQB1e0vCHpeU_uIf0UXvgOounetVAiIxT046TpqIEU”, “documentName”: “Rocketbot Job Doc”, “folderName”: “rocketbot”}
Filter Clave o valor a filtrar. documentId
Assign result to variable Variable donde se almacenará el resultado. {“result”: {“tagName”: “BODY”, “attributes”: {“class”: “home page-template-default page page-id-12 wp-custom-logo elementor-default elementor-kit-8 elementor-page elementor-page-12”}, “textContent”: null, “children”: [{“tagName”: “IMG”, “attributes”: {“height”: “1”, “width”: “1”, “style”: “displaynone”, “alt”: “fbpx”, “src”: “https//www.facebook.com/tr?id=229173555&ev=PageView&noscript=1”}, “textContent”: null, “children”: []}]}}

🌐 HTML to JSON

Convierte HTML a JSON.

Parámetro Descripción Ejemplo
HTML HTML desde donde se extraerán los elementos. <!DOCTYPE html><html lang=”en”><head> <meta charset=”UTF-8″> <meta name=”viewport” content=”width=device-width, initial-scale=1.0″> <title>Página Simple</title></head><body> <h1>Hola Mundo</h1> <p>Esta es una página HTML básica.</p></body></html>
Assign result to variable Variable donde se almacenará el resultado. {“result”: {“tagName”: “BODY”, “attributes”: {“class”: “home page-template-default page page-id-12 wp-custom-logo elementor-default elementor-kit-8 elementor-page elementor-page-12”}, “textContent”: null, “children”: [{“tagName”: “IMG”, “attributes”: {“height”: “1”, “width”: “1”, “style”: “displaynone”, “alt”: “fbpx”, “src”: “https//www.facebook.com/tr?id=229173555&ev=PageView&noscript=1”}, “textContent”: null, “children”: []}]}}

📄 Text to JSON

Convierte texto (con una estructura similar a YAML) a JSON.

Parámetro Descripción Ejemplo
Text Texto a convertir a JSON. name: John Doe &lt;br> age: 30 &lt;br> address: &lt;br> street: 123 Main St &lt;br> city: New York &lt;br> postalCode: 10001
Assign result to variable Variable donde se almacenará el resultado. {“result”: {“name”: “John Doe”, “age”: “30”, “address”: {“street”: “123 Main St”, “city”: “New York”, “postalCode”: “10001”}}}

⚙️ XML to JSON

Convierte XML a JSON.

Parámetro Descripción Ejemplo
XML XML a convertir a JSON. <person><name>John Doe</name><age>30</age></person>
Assign result to variable Variable donde se almacenará el resultado. {“result”: {“person”: {“name”: “John Doe”, “age”: “30”}}}

📊 CSV to JSON

Convierte CSV a JSON.

Parámetro Descripción Ejemplo
CSV CSV a convertir a JSON. name,age,city &lt;br> John,30,New York &lt;br> Jane,25,Los Angeles
Assign result to variable Variable donde se almacenará el resultado. {“result”: [{“name”: “John”, “age”: “30”, “city”: “New York”}, {“name”: “Jane”, “age”: “25”, “city”: “Los Angeles”}]}

🧪 Ejemplo de uso

  • Filter JSON: Extraer el ID de un producto desde la respuesta de una API para usarlo en una consulta posterior a otro sistema.
  • HTML to JSON: Realizar web scraping de una tabla de precios en una página y convertirla a JSON para analizar y comparar los valores.
  • CSV to JSON: Procesar un archivo .csv exportado desde Excel y convertirlo a un formato JSON para importarlo en una base de datos o aplicación web.
  • XML to JSON: Modernizar un flujo de trabajo que consume datos de un servicio web antiguo (que usa XML) para integrarlo con una aplicación moderna que solo acepta JSON.

🧩 Requisitos

  1. Tener el texto de origen (JSON, HTML, Texto, XML o CSV) disponible, ya sea como texto plano o almacenado en una variable.
  2. Conocer la estructura del dato de entrada para poder aplicar los filtros o conversiones de manera correcta.
  3. Asegurarse de que el formato del texto de entrada sea válido y no contenga errores de sintaxis (por ejemplo, un XML o JSON mal formado).