Nubox es una plataforma de software basada en la nube que ofrece soluciones de contabilidad, facturación electrónica y gestión empresarial para pequeñas y medianas empresas en América Latina.

Descripción de los comandos

Emitir Documentos de Venta (Issue Sales Documents)

Crea documentos de venta en Nubox.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Nubox necesaria para crear documentos de venta.	credential
Emitir documento	Cuerpo JSON para enviar.	[{…}]
Asignar resultado a variable	Variable donde se almacenará el resultado.	{var}

Obtener una o más Ventas (Get one or more Sales)

Obtiene uno o más documentos de venta de Nubox.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Nubox necesaria para obtener documentos de venta.	credential
Fecha de Inicio	Fecha de inicio y fin separada por comas para filtrar documentos de venta por fecha de creación (ej., 2025-01-01,2025-01-31).	start date
Fecha de Fin	Fecha de inicio y fin separada por comas para filtrar documentos de venta por fecha de creación (ej., 2025-01-01,2025-01-31).	end date
Asignar resultado a variable	Variable donde se almacenará el resultado.	{var}

Obtener una Venta Específica (Get a Specific Sale)

Obtiene una venta específica de Nubox.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Nubox necesaria para obtener una venta específica.	credential
ID de Venta	El identificador único de la venta a recuperar.	sale id
Asignar resultado a variable	Variable donde se almacenará el resultado.	{var}

Obtener Detalles de Documento de Venta (Get Sales Document Details)

Obtiene los detalles de un documento de venta de Nubox.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Nubox necesaria para obtener detalles del documento de venta.	credential
ID de Documento	El identificador único del documento de venta del cual se recuperarán los detalles.	Document id
Asignar resultado a variable	Variable donde se almacenará el resultado.	{var}

Obtener Documentos de Referencia (Get Reference Documents)

Obtiene documentos de referencia de Nubox.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Nubox necesaria para obtener documentos de referencia.	credential
ID de Documento	El identificador único del documento de venta del cual se recuperarán los documentos de referencia.	Document id
Incluir No Contabilizables	Indica si se deben incluir documentos de referencia no contabilizables en los resultados.	Include Unaccountable
Asignar resultado a variable	Variable donde se almacenará el resultado.	{var}

Descargar PDF (Download PDF)

Descarga el archivo PDF de un documento de venta de Nubox.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Nubox necesaria para descargar archivos PDF.	credential
ID de Documento	ID interno del documento en Nubox.	document id
Plantilla	Formato de la plantilla PDF.
Asignar resultado a variable	Variable donde se almacenará el resultado.	{var}

Descargar XML (Download XML)

Descarga el archivo XML de un documento de venta de Nubox.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Nubox necesaria para descargar archivos XML.	credential
ID de Documento	ID del documento de transacción de Nubox (parámetro de ruta).	document id
Accept	Formato de respuesta. application/xml devuelve XML; application/json devuelve XML en Base64 dentro de un JSON.
Asignar resultado a variable	Variable donde se almacenará el resultado.	{var}

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}

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}

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}

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

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}

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.

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.

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

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}