Saturn Studio – Credencial Google Forms

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

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

Pasos:

  1. Ingresa al módulo Google Forms en Saturn Studio.
  2. Haz clic en el botón “New” para crear una nueva credencial.
  3. Asigna un nombre a la credencial.
  4. Haz clic en “Conectar con Google”.
  5. Selecciona tu cuenta de Google y otorga los permisos solicitados.

✅ Una vez autenticado, podrás utilizar las funciones básicas del módulo con acceso rápido a tus formularios.

Configuración Avanzada (OAuth con Google Cloud)

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

Crear / elegir proyecto y habilitar APIs

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

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

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

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

Configurar Pantalla de consentimiento OAuth

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

Completa los campos:

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

Tipos de usuario para la Pantalla de consentimiento OAuth

Opción ¿Quién puede usar la app? Qué debes hacer
Interno Solo usuarios dentro del mismo dominio Google Workspace.
No funciona con cuentas personales @gmail.com.		 – No es necesario agregar testers.
– Todos los usuarios del dominio pueden autorizar.
– Recomendado solo si toda tu organización usa Workspace.
Usuarios externos Cualquier usuario con Cuenta de Google.
La app inicia en modo de prueba.		 – Agrega manualmente los correos de prueba (incluyéndote).
– Solo usuarios en la lista podrán autenticar.
– Para publicar a Producción sin testers, Google puede requerir verificación si usas scopes sensibles.

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

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

Agregar scopes (permisos)

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

Scopes necesarios para Google Forms:

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

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

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

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

openid

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

Crear Client ID y Client Secret

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

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

  • Una vez completado, Google te proporcionará:

    • Client ID
    • Client Secret

Copia ambos datos y guárdalos.

Ingresar datos en Saturn Studio

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



Saturn Studio – Google Drive

¿Qué es este módulo?

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

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

Para obtener la credencial de este módulo, puede ingresar en el siguiente enlace Credencial Google Drive

📌 Descripción de los comandos

📑 Listar archivos de una carpeta

Lista los archivos contenidos en una carpeta de Google Drive.

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

🔍 Buscar archivos y carpetas

Busca archivos y carpetas en Google Drive.

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

⬇️ Descargar archivo

Descarga un archivo desde Google Drive.

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

⬆️ Subir archivo

Sube un archivo a Google Drive.

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

📂 Crear carpeta

Crea una nueva carpeta en Google Drive.

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

❌ Eliminar archivo

Elimina un archivo de Google Drive.

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

📌 Ejemplo de uso

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

✅ Requisitos

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



Saturn Studio – Credencial Google Drive

Para integrar Google Drive con Saturn Studio, puedes hacerlo mediante una conexión rápida (básica) o una configuración avanzada con OAuth 2.0 a través de Google Cloud.

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

Pasos:

  1. Accede al módulo Google Drive en Saturn Studio.
  2. Haz clic en el botón “New” para crear una nueva credencial.
  3. Asigna un nombre a la credencial.
  4. Haz clic en “Conectar con Google”.
  5. Selecciona tu cuenta de Google y otorga los permisos solicitados.

✅ Una vez autorizado el acceso, la credencial estará lista para ser utilizada en flujos automáticos con acceso básico a Google Drive.

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

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