Saturn Studio – Credencial Google Drive

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

Configuración (OAuth con Google Cloud)

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

Crear / elegir proyecto y habilitar APIs

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

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

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

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

Configurar Pantalla de consentimiento OAuth

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

Completa los campos requeridos:

  • Nombre de la aplicación
  • Correo de soporte
  • (Opcional) Logo, dominios verificados, política de privacidad, términos
  • Tipo de usuario

Tipos de usuario para la Pantalla de consentimiento OAuth

Opción ¿Quién puede usar la app? Qué debes hacer
Interno Solo usuarios de tu organización (dominio de Google Workspace). No funciona con cuentas @gmail.com personales. No necesitas agregar testers. Cualquier usuario del dominio puede autorizar. Úsalo si todo tu equipo pertenece al mismo dominio.
Usuarios externos Cualquier usuario con Cuenta de Google, pero la app inicia en modo de prueba. Debes agregar manualmente a los usuarios de prueba (incluyéndote) para poder autorizar. Sólo esos usuarios podrán iniciar sesión mientras la app esté en prueba. Para abrirla a más usuarios/publicar, debes enviar a verificación si usas scopes sensibles/restringidos.

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

Agregar permisos (scopes) manualmente

  • Dentro de la pantalla de consentimiento, accede a la sección Acceso a los datos.
  • Haz clic en Agregar o quitar permisos.
  • Utiliza la opción “Agregar permisos manualmente” y pega los siguientes scopes:

Scopes necesarios para Google Drive:

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

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

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

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

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

openid

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

Crear el Client ID y Client Secret

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

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

  • Google generará automáticamente:

  • Client ID
  • Client Secret

Copia ambos códigos y guárdalos.

Ingresar los datos en Saturn Studio

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



Saturn Studio – Credencial Google Sheets

La integración con Google Sheets en Saturn Studio .

Configuración (OAuth 2.0 con Google Cloud)

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

Crear / elegir proyecto y habilitar APIs

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

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

  3. Verifica que queden con estado Habilitado.

Si una API no está habilitada, la autenticación puede funcionar, pero las llamadas fallarán por access_not_configured.

Configurar Pantalla de consentimiento OAuth

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

Completa:

  • Nombre de la aplicación
  • Correo de soporte
  • (Opcional) Política de privacidad, Términos y dominio (recomendado para publicación/producción)

Público (tipo de usuario)

Elige uno y actúa según corresponda:

Opción ¿Quién puede usar la app? Qué debes hacer
Interno Solo usuarios de tu organización (dominio de Google Workspace). No funciona con cuentas @gmail.com personales. No necesitas agregar testers. Cualquier usuario del dominio puede autorizar. Úsalo si todo tu equipo pertenece al mismo dominio.
Usuarios externos Cualquier usuario con Cuenta de Google, pero la app inicia en modo de prueba. Debes agregar manualmente a los usuarios de prueba (incluyéndote) para poder autorizar. Sólo esos usuarios podrán iniciar sesión mientras la app esté en prueba. Para abrirla a más usuarios/publicar, debes enviar a verificación si usas scopes sensibles/restringidos.

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

Guarda los cambios.

Agregar scopes (permisos) a la app

Ruta: Pantalla de consentimiento OAuth → Acceso a los datos → Agregar o quitar permisos.

Agrega manualmente los scopes que necesites (principio de menor privilegio):

Scopes recomendados para Google Sheets

  • https://www.googleapis.com/auth/spreadsheets (leer/escribir en hojas)
  • https://www.googleapis.com/auth/spreadsheets.readonly (solo lectura)
  • https://www.googleapis.com/auth/drive (acceso a archivos de Drive: listar/crear/mover, etc., úsalo solo si lo necesitas)
  • https://www.googleapis.com/auth/userinfo.email
  • https://www.googleapis.com/auth/userinfo.profile
  • openid

Actualiza y guarda.

Crear Client ID y Client Secret

Ruta: APIs y servicios → Credenciales → Crear credencial → ID de cliente de OAuth.

Completa:

  • Tipo de aplicación: Aplicación web
  • Nombre: por ejemplo, Saturn Studio
  • URIs de redirección:

    • https://studio.rocketbot.com

Al guardar, Google genera:

  • Client ID
  • Client Secret

Cópialos y resérvalos.

Cargar credenciales en Saturn Studio

  1. Regresa al módulo Google Sheets en Saturn Studio.
  2. En el modo Avanzado (OAuth), pega el Client ID y Client Secret en los campos correspondientes.
  3. Guarda la credencial y realiza la conexión.

Notas importantes

  • Usuarios externos (modo de prueba): agrega tu correo y los de tu equipo en Usuarios de prueba. Si no están en la lista, verán error al autorizar.
  • Interno: solo disponible con Google Workspace. Si usas cuenta personal @gmail.com, deberás elegir Usuarios externos.
  • Scopes y APIs: los scopes permiten solicitar permisos; habilitar la API permite realmente usarla. Necesitas ambos.
  • URIs de redirección: deben coincidir exactamente con lo configurado en Google Cloud.
  • Verificación: para publicar la app a producción (externa) y usar scopes sensibles/restringidos, Google puede requerir verificación (política de privacidad pública, dominio verificado, branding, etc.).



Saturn Studio – Credencial Groq

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

Credencial Groq

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

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

¿Cómo obtener la API Key de Groq?

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

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

Verificación

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



Saturn Studio – Credencial Calendly

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

Creación de la aplicación en Calendly

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

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

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

Configuración de la credencial en Saturn Studio

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



Saturn Studio – X

¿Qué es este módulo?

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

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

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

Descripción de los comandos

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

Create Tweet

Crea un tuit en X.

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

Search Tweets

Busca tuits en X.

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

Get User ID

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

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

Get Mentions

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

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

Get User Timeline

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

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

Retweet

Retuitea un tuit.

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

Get Tweet Information

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

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

Ejemplo de uso

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

Requisitos

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



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.

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

Descripción de los comandos

A continuación se detallan los comandos disponibles para la integración con 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.

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

Descripción de los comandos

A continuación se detallan los comandos disponibles para la integración con 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.

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

Descripción de los comandos

A continuación se detallan los comandos disponibles para la integración con 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.

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

Descripción de los comandos

A continuación se detallan los comandos disponibles para la integración con 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.