Saturn Studio — Google Ads

Google Ads es la plataforma de publicidad en línea de Google que permite a las empresas crear anuncios para llegar a su público objetivo a través de la red de Google, incluidos la búsqueda, los sitios web asociados, YouTube y más. Con Google Ads, las empresas pueden aumentar su visibilidad, atraer tráfico a sus sitios web y generar ventas a través de campañas publicitarias personalizadas y dirigidas.

Para saber cómo obtener las credenciales, haga clic aquí.

Descripción de los comandos

Obtener una campaña (Get a Campaign)

Obtiene una campaña en Google Ads.

Parámetro Descripción Ejemplo
Credencial Credencial de Google Ads necesaria para obtener una campaña. My Google Ads credentials
ID de cliente administrador ID de cliente administrador a obtener. 1234567890
ID de cliente cliente ID de cliente cliente a obtener. 0987654321
ID de campaña ID de campaña a obtener. Campaign ID
Asignar resultado a variable Variable donde se almacenará el resultado. {var}

Obtener muchas campañas (Get Many Campaigns)

Obtiene muchas campañas en Google Ads.

Parámetro Descripción Ejemplo
Credencial Credencial de Google Ads necesaria para obtener muchas campañas. My Google Ads credentials
ID de cliente administrador ID de cliente administrador a obtener. 1234567890
ID de cliente cliente ID de cliente cliente a obtener. 0987654321
Rango de fechas Seleccione el rango de fechas para las campañas. Date Range
Estado de la campaña Seleccione el estado de la campaña. Campaign Status
Asignar resultado a variable Variable donde se almacenará el resultado. {var}


Saturn Studio — Google Translate

Google Translate es una aplicación de Google que permite traducir textos.

Descripción de los comandos

Traducir un idioma (Translate a Language)

Traduce un texto a otro idioma.

Parámetros Descripción Ejemplo
Credencial Credencial de Google Translate necesaria para buscar los eventos. My Google Translate credentials
Texto Texto que desea traducir. Texto a traducir
Traducir a Seleccione el idioma al que desea traducir el texto. Idioma a traducir
Asignar resultado a variable Variable donde se almacenará el resultado. Ejemplo [{"input_text": "Good morning", "translated_text": "Buenos días"}]. {var}


Saturn Studio — Google Big Query

Google Big Query es una aplicación de Google que permite consultar grandes volúmenes de datos.

Descripción de los comandos

Ejecutar una consulta SQL (Execute a SQL Query)

Ejecuta una consulta SQL en Google Big Query.

Parámetros Descripción Ejemplo
Credencial Credencial de Google Big Query necesaria para realizar consultas. My Google Big Query credentials
ID del Proyecto ID del proyecto de Google Cloud donde se encuentra la base de datos. ingrese el ID del proyecto
Consulta SQL Escriba la consulta SQL que desea ejecutar en Google Big Query. SELECT name, age FROM mydataset.mytable WHERE age > 30
Opciones Ingrese las opciones de consulta en formato JSON. Ejemplo {"useLegacySql": false, "maxResults": 100}. Opciones
Asignar resultado a variable Variable donde se almacenará el resultado. {var}

Insertar filas en una tabla (Insert Rows in a Table)

Inserta filas en una tabla de Google BigQuery.

Parámetros Descripción Ejemplo
Credencial Credencial de Google BigQuery necesaria para insertar filas en una tabla. My Google BigQuery credentials
ID del Proyecto ID del proyecto de Google Cloud donde se encuentra la base de datos. ingrese el ID del proyecto
Nombre del Dataset Nombre del conjunto de datos de Google BigQuery donde se encuentra la tabla. ingrese el nombre del dataset
Nombre de la Tabla Nombre de la tabla de Google BigQuery donde se insertarán las filas. ingrese el nombre de la tabla
Filas a insertar Ingrese las filas que desea insertar en formato JSON. Ejemplo [{"name": "John", "age": 30}, {"name": "Jane", "age": 25}]. [{"name": "John", "age": 30}, {"name": "Jane", "age": 25}]
Opciones Ingrese las opciones de consulta en formato JSON. Ejemplo {"ignoreUnknownValues": true, "skipInvalidRows": true}. Opciones
Asignar resultado a variable Variable donde se almacenará el resultado. {var}


Saturn Studio – Credencial Zendesk

Para utilizar el módulo de Zendesk en Saturn Studio, es necesario configurar una credencial que permita la comunicación segura entre el robot y su instancia de soporte. Esta configuración requiere identificar su subdominio y generar un token de acceso desde el panel de administración de Zendesk.

1. Obtención del Subdominio

Su subdominio es el identificador único de su cuenta y aparece antes de .zendesk.com en la URL. Puede encontrarlo de las siguientes maneras :

  • Página principal del Centro de administración: El subdominio se visualiza directamente en la página de inicio del Centro de administración.
  • Verificación de la URL: Aparece en la URL de su cuenta, después de https:// y antes de .zendesk.com. Por ejemplo, en https://yoursubdomain.zendesk.com, el subdominio es yoursubdomain.
  • Selección de subdominio: Si ha iniciado sesión recientemente, puede usar la función de elegir subdominio en la página de inicio de sesión.
  • Solicitud por correo electrónico: Puede obtener una lista de los subdominios vinculados a su dirección de correo electrónico a través de la página de recordatorio de inicio de sesión de Zendesk.

2. Generación del Token de API

El Token de API actúa como una contraseña segura para aplicaciones externas. Para obtenerlo:

  1. Inicie sesión en Zendesk como administrador.
  2. Vaya al Centro de administración > Canales > API de Zendesk.
  3. Asegúrese de que el Acceso mediante token de API esté habilitado.
  4. Haga clic en Agregar token de API para generar uno nuevo.

Seguridad del Token: Copie y guarde el token inmediatamente en un lugar seguro. Por motivos de seguridad, Zendesk no permite volver a visualizarlo una vez que se cierra la ventana de creación.

3. Configuración en Saturn Studio

Una vez obtenidos los datos, abra el panel de configuración de credenciales de Zendesk en Saturn Studio y complete los siguientes campos:

Parámetro Descripción Ejemplo
Credential name Nombre descriptivo para identificar la credencial en el futuro. Zendesk Principal
Subdomain La parte de su URL que aparece justo antes de .zendesk.com. empresa
Email Correo electrónico del usuario con permisos para usar la API. nombre@micompania.com
API Token El token alfanumérico generado previamente en Zendesk. abcd123efgh456...


Saturn Studio – Zendesk

Zendesk es una plataforma de soporte al cliente que ayuda a gestionar tickets de soporte, automatizar flujos de trabajo y ofrecer asistencia multicanal de manera eficiente.

Descripción de los comandos

Crear Ticket (Create Ticket)

Crea un ticket en Zendesk.

Parámetros Descripción Ejemplo
Credencial Credencial de Zendesk necesaria para crear el ticket. credential
Solicitante Selecciona el solicitante del ticket. john doe
Asunto Asunto del ticket. Ticket Subject
Descripción Descripción del ticket. Ticket Description
Tipo Tipo de ticket. Pregunta, Incidente, Problema o Tarea
Prioridad Prioridad del ticket. Baja, Normal, Alta o Urgente
Campos Personalizados Campos personalizados en formato JSON. Ejemplo [{“id”: 360012345, “value”: “value1”}]. Additional Information
Asignar resultado a variable Variable donde se almacenará el resultado. Ejemplo {“ticket”{“id”:35436,”url”:”https://company.zendesk.com/api/v2/tickets/35436.json”,”external_id”:null,”via”:{“channel”:”api”,”source”:{“from”:{},”to”:{},”rel”:null}},”created_at”:”2025-04-14T10:15:30Z”,”updated_at”:”2025-04-14T10:15:30Z”,”type”:”question”,”subject”:”Support Request”,”raw_subject”:”Support Request”,”description”:”Ticket description”,”priority”:”normal”,”status”:”open”,”recipient”:null,”requester_id”:123456789,”submitter_id”:123456789,”assignee_id”:null,”organization_id”:null,”group_id”:null,”collaborator_ids”:[],”follower_ids”:[],”email_cc_ids”:[],”forum_topic_id”:null,”problem_id”:null,”has_incidents”:false,”is_public”:true,”due_at”:null,”tags”:[],”custom_fields”:[],”satisfaction_rating”:null,”sharing_agreement_ids”:[],”fields”:[],”followup_ids”:[],”brand_id”:123456,”allow_channelback”:false,”allow_attachments”:true}}. {var}

Eliminar Ticket (Delete Ticket)

Elimina un ticket por ID de Zendesk.

Parámetros Descripción Ejemplo
Credencial Credencial de Zendesk necesaria para eliminar el ticket. credential
ID del Ticket ID del ticket a eliminar. 8453
Asignar resultado a variable Variable donde se almacenará el resultado. Ejemplo {“result”:”Ticket deleted successfully”, “id”:8453}. {var}

Listar Tickets (List Tickets)

Lista tickets de Zendesk.

Parámetros Descripción Ejemplo
Credencial Credencial de Zendesk necesaria para listar tickets. credential
Estado Ordenar tickets por. Creado en, Vence en, Actualizado en o Estado
Límite Límite de tickets a listar. 10
Asignar resultado a variable Variable donde se almacenará el resultado. Ejemplo {“tickets”:[{“cc_emails”:[“jane.doe@example.com”,”support@acme.io”],”fwd_emails”:[],”reply_cc_emails”:[“jane.doe@example.com”,”support@acme.io”],”ticket_cc_emails”:[“support@acme.io”],”ticket_bcc_emails”:[],”fr_escalated”:false,”spam”:false,”email_config_id”:1234567890,”group_id”:987654321,”priority”:2,”requester_id”:1122334455,”responder_id”:9988776655,”source”:2,”company_id”:5566778899,”status”:4,”subject”:”Problema de acceso a la cuenta – Ticket #8453″,”association_type”:null,”support_email”:”helpdesk@acme.freshdesk.com”,”to_emails”:[“jane.doe@example.com”],”product_id”:null,”id”:8453,”type”:”Issue”,”due_by”:”2025-04-20T13:45:00Z”,”fr_due_by”:”2025-04-18T11:30:00Z”,”is_escalated”:true,”created_at”:”2025-04-09T10:15:00Z”,”updated_at”:”2025-04-10T12:00:00Z”,”associated_tickets_count”:1,”tags”:[“login”,”urgent”],”structured_description”:null,”nr_due_by”:null,”nr_escalated”:false}]}. {var}

Obtener Ticket (Get Ticket)

Obtiene un ticket por ID de Zendesk.

Parámetros Descripción Ejemplo
Credencial Credencial de Zendesk necesaria para obtener el ticket. credential
ID del Ticket ID del ticket a obtener. 8453
Asignar resultado a variable Variable donde se almacenará el resultado. Ejemplo {“ticket”{“id”:35436,”url”:”https://company.zendesk.com/api/v2/tickets/35436.json”,”external_id”:null,”via”:{“channel”:”api”,”source”:{“from”:{},”to”:{},”rel”:null}},”created_at”:”2025-04-14T10:15:30Z”,”updated_at”:”2025-04-14T10:15:30Z”,”type”:”question”,”subject”:”Support Request”,”raw_subject”:”Support Request”,”description”:”Ticket description”,”priority”:”normal”,”status”:”open”,”recipient”:null,”requester_id”:123456789,”submitter_id”:123456789,”assignee_id”:null,”organization_id”:null,”group_id”:null,”collaborator_ids”:[],”follower_ids”:[],”email_cc_ids”:[],”forum_topic_id”:null,”problem_id”:null,”has_incidents”:false,”is_public”:true,”due_at”:null,”tags”:[],”custom_fields”:[],”satisfaction_rating”:null,”sharing_agreement_ids”:[],”fields”:[],”followup_ids”:[],”brand_id”:123456,”allow_channelback”:false,”allow_attachments”:true}}. {var}

Actualizar Ticket (Update Ticket)

Actualiza un ticket por ID de Zendesk.

Parámetros Descripción Ejemplo
Credencial Credencial de Zendesk necesaria para actualizar el ticket. credential
ID del Ticket ID del ticket a actualizar. 8453
Solicitante Selecciona el solicitante del ticket. john doe
Asunto Asunto del ticket. Ticket Subject
Descripción Descripción del ticket. Ticket Description
Tipo Tipo de ticket. Pregunta, Incidente, Problema o Tarea
Prioridad Prioridad del ticket. Baja, Normal, Alta o Urgente
Campos a actualizar Campos a actualizar en formato JSON. Ejemplo {“status”: “solved”, “priority”: “high”}. Campos a actualizar en formato JSON. Ejemplo: {“status”: “solved”, “priority”: “high”}
Asignar resultado a variable Variable donde se almacenará el resultado. Ejemplo. {var}

Generar Respuesta de Ticket (Generate Ticket Response)

Genera una respuesta por IA para un ticket de Zendesk.

Parámetros Descripción Ejemplo
Credencial Credencial de Zendesk necesaria para generar una respuesta de ticket. credential
Macro Selecciona una macro para usar como base de la respuesta. Las acciones de la macro se usarán como contexto para que la IA genere la respuesta. Selecciona una macro para usar como base de la respuesta
Ticket Selecciona el ticket para enviar la respuesta. My Ticket
Asignar resultado a variable Variable donde se almacenará la respuesta generada o el comentario creado. {var}


Saturn Studio – Gestión de Credenciales

El sistema de gestión de credenciales de Saturn Studio permite almacenar de forma segura las claves de acceso a diversos servicios, como OpenAI, Gmail y bases de datos, entre otros. Con las funcionalidades actuales, es posible colaborar en equipo sin comprometer la seguridad de los datos sensibles y flexibilizar el uso de los bots mediante variables dinámicas.

Credenciales Compartidas (Shared Credentials)

Las credenciales compartidas permiten otorgar acceso a otros usuarios o equipos sin necesidad de enviar contraseñas o llaves maestras de forma directa.

Beneficios Clave

Beneficio Descripción
Seguridad Los datos sensibles (API keys, contraseñas) nunca se exponen al receptor.
Control Total El propietario puede revocar el acceso en cualquier momento.
Eficiencia Ideal para equipos que requieren utilizar los mismos servicios de forma unificada.

Cómo compartir una credencial

  1. Navegue a la sección Credentials en Saturn Studio.
  2. Identifique la credencial en la lista y haga clic en el icono de Compartir.
  3. Seleccione el método de envío:

    • Por Email: Ingrese uno o más correos separados por comas y haga clic en Share.
    • Por Equipo: Elija el equipo del menú desplegable y haga clic en Share (todos los miembros recibirán acceso automáticamente).

Los usuarios recibirán una notificación por email informándoles que tienen una nueva credencial compartida.

Visualización de Credenciales Recibidas

Cuando un usuario o equipo comparte una credencial con usted, esta se integra automáticamente en su entorno de trabajo con las siguientes características visuales y operativas:

Elemento Descripción Técnica
Identificación Aparecen en su listado general de Credentials con un distintivo azul que indica "Shared by [Nombre]".
Uso en Bots Puede utilizarlas en cualquier comando de sus robots de la misma forma que una credencial propia.
Restricción de Seguridad Son de Solo Lectura (Read Only). El receptor tiene prohibido editar los valores internos o eliminar la credencial del sistema.

Revocación de Acceso (Propietario)

Si usted es el dueño de la credencial, tiene la potestad de retirar el acceso a cualquier colaborador o equipo de forma inmediata siguiendo estos pasos:

  1. Diríjase a la sección Credentials y localice la credencial que desea gestionar.
  2. Haga clic en el icono de Compartir para abrir el modal de gestión.
  3. Ubique la lista de usuarios en el apartado “Currently shared with”.

Gestión de permisos

Acción Procedimiento Resultado
Quitar Acceso Haga clic en la X roja situada al lado del correo del usuario o nombre del equipo. El acceso se revoca al instante y el receptor ya no podrá visualizar ni usar la credencial en sus procesos.
Confirmación El sistema mostrará un mensaje de éxito indicando que el acceso ha sido removido. El usuario desaparece de la lista de colaboradores autorizados.

Efecto Inmediato: Al revocar el acceso, cualquier robot del receptor que dependa de esa credencial fallará en su próxima ejecución, ya que la llave de acceso dejará de ser válida para ese usuario.

Variables tipo Credencial

Estas variables almacenan una referencia a una credencial en lugar de un valor estático, lo que permite parametrizar el comportamiento del bot sin modificar sus comandos internos.

Escenarios de Uso

  • Cambiar rápidamente la credencial que utiliza un bot.
  • Alternar entre diferentes entornos, como Desarrollo y Producción.
  • Parametrizar servicios sin editar el flujo de trabajo.

Configuración

  1. En el editor del robot, vaya a Variables y seleccione Add Variable.
  2. Defina el Name (ej. mi_conexion_db) y en Type seleccione Credential.
  3. Complete los campos técnicos:

    • Select Module: El servicio correspondiente (OpenAI, Gmail, etc.).
    • Credential: Seleccione la credencial específica a referenciar.

  4. Para utilizarla en un comando, escriba el nombre de la variable entre llaves en el campo de credencial: {mi_conexion_db}.

Casos de Uso Prácticos

Colaboración en Equipo: Un líder de equipo crea una API Key de OpenAI, la comparte “By Team” y todos los miembros pueden usarla en sus bots. Si la clave cambia, solo el líder necesita actualizarla en un único lugar.

Ambientes Múltiples: Puede crear una variable llamada db_connection. En desarrollo apunta a la base de pruebas y en producción simplemente se reasigna a la base real sin tocar el código del bot.

Centralización de Servicios: Ideal para cuando varios bots usan el mismo servicio (ej. Email). Crea una única credencial global y vincúlala mediante variables en cada robot; si la clave cambia, solo la actualizas en un lugar y todos los procesos se sincronizan automáticamente.

Preguntas Frecuentes

Pregunta Respuesta
¿Puedo ver los datos sensibles de una credencial compartida? No. Solo puede usarla; las contraseñas permanecen ocultas.
¿Qué pasa si el propietario elimina la credencial? El acceso se pierde automáticamente y los bots que la usen fallarán hasta configurar una nueva.
¿Puedo compartir una credencial que compartieron conmigo? No. Solo el propietario original tiene permisos de compartición.
¿Las variables funcionan con credenciales compartidas? Sí, puede crear una variable que apunte a una credencial que alguien más compartió con usted.


Saturn Studio – Credencial Google Ads

La API de Google Ads es una interfaz REST que permite administrar cuentas, campañas y reportes de publicidad de forma programática. Para que Saturn Studio pueda interactuar con estos servicios, es necesario configurar una credencial de tipo OAuth 2.0 que actúe como puente de autenticación seguro.

1. Habilitación de la API

Antes de generar las credenciales, debe asegurarse de que el servicio esté activo en su consola de desarrollador:

  • Acceda a la consola de Google Cloud.
  • Busque y habilite específicamente la Google Ads API.
  • Esta acción le permitirá gestionar cuentas y reportes mediante llamadas externas.

2. Scopes de Seguridad Requeridos

Para que la integración funcione con todos los permisos necesarios, debe asegurarse de incluir los siguientes alcances (scopes) en la configuración:

  • https://www.googleapis.com/auth/adwords
  • https://www.googleapis.com/auth/userinfo.profile
  • openid
  • https://www.googleapis.com/auth/userinfo.email

3. Creación del ID de Cliente OAuth

Una vez habilitada la API, proceda a generar los identificadores de acceso:

  1. Diríjase a la sección de API y servicios y seleccione la pestaña Credenciales.
  2. Haga clic en el botón Crear credenciales y seleccione la opción ID de cliente de OAuth.
  3. Tipo de aplicación: Seleccione obligatoriamente Aplicación web.
  4. Nombre: Asigne un nombre descriptivo para identificar la integración.

4. Configuración de URIs y Redireccionamiento

Este paso es crítico para asegurar que el flujo de autenticación regrese correctamente a la plataforma:

  • Debe ingresar la URL de su instancia en los campos de Orígenes autorizados de JavaScript y URIs de redireccionamiento autorizados.
  • Ejemplo de URI: https://qa-saturn.myrb.io.
  • Asegúrese de copiar la URL exacta de su entorno de Saturn Studio para evitar errores de coincidencia durante el inicio de sesión.

5. Obtención de Parámetros Técnicos

Al hacer clic en el botón Crear, el sistema desplegará una ventana emergente con la información necesaria para Saturn Studio:

Dato Importancia técnica
ID de cliente Identificador público de la aplicación en el ecosistema de Google.
Secreto del cliente Clave privada confidencial. No se podrá volver a visualizar tras cerrar el diálogo.

Resguardo de Seguridad: El Secreto del cliente debe almacenarse de forma segura inmediatamente después de su creación. Si se pierde o se cierra la ventana sin copiarlo, deberá generar una nueva credencial.



Saturn Studio – Credencial Xperience

Xperience es el módulo de Saturn Studio diseñado para la gestión de formularios, colas de trabajo y datos transaccionales directamente vinculados con el Orquestador. Para que el robot pueda consultar listas de formularios o añadir datos a una cola, es necesario establecer una conexión autenticada mediante una API Key.

Para utilizar el módulo Xperience, es indispensable contar con el servicio de Orquestador Rocketbot previamente contratado. Sin esta suscripción activa, no será posible acceder a las herramientas de gestión de formularios y colas transaccionales que ofrece este módulo.

Cómo obtener la API Key del Orquestador

Para configurar esta credencial, primero debe generar un token de acceso desde el panel del Orquestador siguiendo uno de estos dos métodos oficiales:

Método 1: Desde el Perfil de Usuario

  1. Inicie sesión en su cuenta del Orquestador.
  2. Diríjase a la sección de perfil en la parte superior derecha y haga clic en My Profile.
  3. Busque el apartado API Key. Allí podrá visualizar la llave actual o hacer clic en Refresh para generar una nueva.
  4. Copie el código alfanumérico resultante.

Método 2: Desde la Gestión de Usuarios (Admin)

  1. Vaya al menú lateral del Orquestador y seleccione la pestaña Users.
  2. Identifique el usuario al que desea asociar la credencial y haga clic en el menú lateral de los tres puntos.
  3. Seleccione la opción API Key y proceda a copiar o generar el token.

Seguridad y Expiración: Por motivos de seguridad, las API Keys del Orquestador tienen un periodo de vigencia de 2 años. Una vez transcurrido este tiempo, la conexión fallará y será necesario generar y actualizar la llave en Saturn Studio.

Para obtener más información sobre la obtención de la API Key del Orquestador, haga clic aquí.

Configuración del Formulario de Credenciales

Una vez obtenida la API Key, debe completar los campos en el panel de configuración de Saturn Studio:

Campo Descripción Ejemplo de Valor
Credential name Nombre descriptivo para identificar la conexión. Orquestador - Producción
URL Server (*) Dirección del servidor donde está alojado su Orquestador. roc.myrb.io o dev3.myrb.io
API Key (*) El token generado previamente en el Orquestador. eyJ0eXAiOiJKV1Qi...


Saturn Studio – Xperience

Xperience es el módulo de Saturn Studio diseñado para gestionar el ciclo de vida de la información transaccional mediante la integración de formularios y colas de datos del Orquestador. Permite a los robots capturar datos, filtrar registros y actualizar estados operativos de forma centralizada.

Para obtener las credenciales de Xperience en Saturn Studio, haga clic aquí.

Para utilizar el módulo Xperience, es indispensable contar con el servicio de Orquestador Rocketbot previamente contratado. Sin esta suscripción activa, no será posible acceder a las herramientas de gestión de formularios y colas transaccionales que ofrece este módulo.

Obtención del Form ID (Form Token)

Para interactuar con un formulario específico, la mayoría de los comandos requieren un identificador único denominado Form ID. Este valor debe extraerse directamente desde la interfaz del Orquestador:

  1. Inicie sesión en su instancia del Orquestador.
  2. Acceda a la sección Form Xperience en el menú lateral.
  3. Seleccione el formulario que desea utilizar y haga clic en el botón de edición.
  4. En la cabecera del formulario, localice el campo Form token y copie el código alfanumérico.
  5. Pegue este código en el parámetro Form ID del comando correspondiente en Saturn Studio.

Obtención del Queue ID

El Queue ID es el identificador numérico único de un registro o proceso dentro de una cola transaccional. Para obtenerlo, siga estos pasos:

  1. Inicie sesión en su instancia del Orquestador.
  2. En el menú lateral de navegación, despliegue la sección Form Xperience.
  3. Haga clic en la opción Queues.
  4. Se desplegará una tabla con el historial de ejecuciones y registros.
  5. Localice la columna denominada Id; el valor numérico que aparece allí (ejemplo: 12152) es el Queue ID que debe ingresar en Saturn Studio.

Descripción de los comandos

Obtener lista de formularios (Get form list)

Recupera todos los formularios disponibles vinculados a la credencial.

Parámetro Descripción Ejemplo
Credential Credencial de Orquestador configurada con la API Key. orchestrator - Test
Assign result to a Variable Variable donde se almacenará el listado de formularios. {form_list}

Obtener formulario por ID (Get form by ID)

Obtiene la información técnica de un formulario específico.

Parámetro Descripción Ejemplo
Credential Credencial de Orquestador necesaria para la consulta. orchestrator - Test
Form ID Identificador único (token) del formulario. VGJBQ9DBICYZ4CB
Assign result to a Variable Variable donde se guardarán los detalles del formulario. {form_details}

Obtener colas de un formulario (Get queues of a form)

Extrae el listado de colas asociadas a un formulario.

Parámetro Descripción Ejemplo
Credential Credencial de Orquestador. orchestrator - Test
Form ID Token del formulario del cual se desean las colas. VGJBQ9DBICYZ4CB
Reverse list Si se activa, ordena la lista de la más nueva a la más antigua. Check
Assign result to a Variable Variable donde se almacenará la lista de colas. {queue_list}

Obtener datos de una cola (Get data from a queue)

Trae los registros almacenados dentro de una cola específica.

Parámetro Descripción Ejemplo
Credential Credencial de Orquestador. orchestrator - Test
Queue ID ID de la cola transaccional. 125123
Form ID Token del formulario asociado. VGJBQ9DBICYZ4CB
Assign result to a Variable Variable donde se guardará la información de la cola. {queue_data}

Obtener datos del trabajo (Get job data)

Obtiene la información detallada de una tarea o “job” específico dentro del flujo transaccional del módulo Xperience.

Parámetro Descripción Ejemplo
Credential Credencial de Orquestador necesaria para la conexión. orchestrator - Test
Select form Menú desplegable para seleccionar el formulario asociado al trabajo. testumr
Queue ID Identificador numérico de la cola; permite el uso de variables {x}. 12152 o {id}
Assign result to a Variable Variable de Saturn Studio donde se almacenará el resultado de la consulta. {job_data}

Filtrar datos de una cola (Filter data from a queue)

Busca información específica dentro de una cola aplicando filtros.

Parámetro Descripción Ejemplo
Credential Credencial de Orquestador. orchestrator - Test
Select form Selección del formulario desde el menú desplegable. testumr
Filters Tabla de condiciones (Input ID, Filtro, Dato). email = user@test.com
Assign result to a Variable Variable donde se guardará el resultado del filtro. {filtered_data}

Descargar archivo (Download file)

Permite bajar archivos adjuntos desde una cola transaccional.

Parámetro Descripción Ejemplo
Credential Credencial de Orquestador. orchestrator - Test
Queue ID ID de la cola donde está el archivo. 125123
File name Nombre con el que se guardará el archivo localmente. factura_01.pdf
Assign result to a Variable Variable para confirmar la ruta o éxito de descarga. {download_status}

Actualizar estado de cola (Update Form queue status)

Modifica el estado lógico de un registro en la cola.

Parámetro Descripción Ejemplo
Credential Credencial de Orquestador. orchestrator - Test
Queue ID ID del registro a actualizar. 125123
Set status Nuevo estado a asignar (ej: Done, Error). Done
Assign result to a Variable Variable para almacenar la respuesta del servidor. {update_res}

Agregar datos a una cola (Add data to a queue)

Inserta un nuevo elemento de datos en la cola de un formulario.

Parámetro Descripción Ejemplo
Credential Credencial de Orquestador. orchestrator - Test
Form ID Token del formulario de destino. VGJBQ9DBICYZ4CB
Form Elements Mapeo de campos del formulario con valores/variables. nombre = {cliente}
Assign result to a Variable Variable donde se recibirá el ID del nuevo registro. {new_queue_id}


Saturn Studio – Credencial SQL Server

SQL Server es un motor de base de datos relacional de Microsoft, diseñado para gestionar volúmenes de información críticos con alta disponibilidad y seguridad. Para integrar este motor en sus flujos de trabajo, es imperativo configurar una credencial de conexión que actúe como el puente técnico entre el robot y el servidor.

Obtención de Parámetros Técnicos

La información necesaria para establecer la conexión se encuentra centralizada en las herramientas de administración del servidor. Los datos presentados en su borrador han sido verificados y son técnicamente precisos según los estándares de Microsoft:

  • SQL Server Management Studio (SSMS): Principal interfaz para identificar nombres de servidor y bases de datos.
  • SQL Server Configuration Manager: Herramienta esencial para habilitar protocolos TCP/IP y verificar puertos activos.

Parámetros de Configuración en el Módulo

Al registrar una nueva credencial, deberá completar los siguientes campos obligatorios y opcionales en la interfaz:

Campo Descripción Técnica Formato de Ejemplo
Server Address (*) Ubicación de red del servidor SQL. Puede ser IP, Hostname o Instancia. 192.168.1.10 o SERVER\SQLEXPRESS
Port Canal de comunicación TCP. El valor estándar es 1433. 1433
User (*) Usuario con autenticación de SQL Server. Requiere Modo Mixto habilitado en el servidor. db_robot_user
Password (*) Contraseña del usuario de base de datos. ********
Database Nombre del contenedor de datos. Si se omite, conecta a la base predeterminada (usualmente master). Produccion_Ventas

Parámetros de Seguridad y Cifrado

El manejo de certificados y cifrado es crítico para el éxito de la conexión, especialmente en entornos corporativos o de nube:

Encrypt Connection

Determina si el tráfico de datos entre el cliente y el servidor viaja cifrado mediante TLS.

  • True: Habilita el cifrado. Si el servidor exige TLS y esta opción está apagada, la conexión fallará.
  • False: Envía datos en texto plano (no recomendado para entornos fuera de una red local segura).

Trust Server Certificate

Controla cómo se valida el certificado de seguridad del servidor.

  • True: El cliente acepta el certificado del servidor sin validarlo contra una autoridad externa. Es común en desarrollo con certificados autofirmados.
  • False: El cliente exige que el certificado sea emitido por una autoridad de confianza (CA). Es el estándar de seguridad para producción.

Regla Técnica: La opción Trust Server Certificate solo entra en funcionamiento si Encrypt Connection está activo.

Consideraciones de Red y Validación

Para asegurar que el comando de consulta funcione correctamente, verifique los siguientes puntos de infraestructura:

  1. Firewall: El puerto 1433 debe permitir tráfico entrante y saliente, o bien, debe permitirse explícitamente el proceso sqlservr.exe.
  2. Conexiones Remotas: Asegúrese de que SQL Server esté configurado para aceptar conexiones desde otras IPs (TCP/IP habilitado en Configuration Manager).
  3. Verificación Final: Es obligatorio utilizar el botón Test Connection. Una prueba exitosa garantiza que el usuario tiene permisos de lectura/escritura y que el túnel de seguridad es compatible.

Buenas Prácticas Generales

  • Principio de Menor Privilegio: No utilice el usuario administrador sa. Cree un usuario dedicado con acceso exclusivo a las tablas que el robot necesita procesar.
  • Certificados en Producción: En entornos críticos, evite el uso de Trust Server Certificate = True. Utilice certificados válidos para prevenir ataques de interceptación (MITM).
  • Puertos Estáticos: Siempre que sea posible, especifique el puerto manualmente para evitar problemas de resolución en instancias con nombres dinámicos.