Esta guía detalla los pasos necesarios para configurar y vincular de forma correcta su credencial de Nexus dentro de Saturn Studio.

1. Configuración Inicial en Saturn Studio

Para comenzar con la vinculación, diríjase al panel de control de la plataforma y realice lo siguiente:

1. Dentro del módulo, haga clic en el botón New Credential.
2. Complete los campos obligatorios del formulario con los siguientes datos:

   • Credential name: Asigne un nombre descriptivo para identificar la credencial en el futuro.
   • Nexus Server URL: Ingrese la dirección URL oficial de su servidor de Nexus.
   • Nexus Api Key: Campo destinado para la clave técnica de acceso (API Key) de la aplicación. Al lado derecho de este campo encontrará un botón de verificación denominado Check.

2. Obtención de la API Key en Nexus

Para conseguir la clave de acceso requerida, siga los pasos de navegación y control de permisos detallados a continuación:

1. En el formulario de Saturn Studio, haga clic en el enlace que indica “get your api key from ‘here'”. Esto lo redirigirá de manera automática al sitio web oficial de Nexus.
2. Inicie sesión con sus credenciales corporativas o complete el registro según corresponda.
3. Una vez dentro de la plataforma, su acceso dependerá del rol asignado en su cuenta:

Escenario A: El Dashboard se encuentra vacío

Si al ingresar no visualiza información ni aplicaciones, se debe a que el administrador central no lo ha asignado con el rol de Maker ni ha vinculado ninguna aplicación a su perfil. Bajo estas condiciones, no contará con los permisos necesarios para crear o ver aplicaciones. Para solucionarlo, debe comunicarse directamente con el administrador a cargo de Nexus para solicitar la elevación de privilegios.

Escenario B: Cuenta con permisos habilitados (Rol de Maker)

Si su administrador ya le otorgó permisos de Maker, podrá visualizar las aplicaciones asignadas o crear nuevas estructuras. Para generar la clave de una aplicación específica, realice el siguiente procedimiento:

• Seleccione y diríjase a la aplicación que desea vincular.
• En la barra de navegación superior, haga clic en la sección API Keys.
• Complete los parámetros solicitados:

  • Name: Asigne un nombre de identificación para la nueva clave.
  • Expiration: Seleccione el tiempo de vigencia de la clave (opciones disponibles de 30, 60, 90 días o de carácter ilimitado).

• Haga clic en el botón para generar la clave.

3. Vinculación Final

1. Una vez completado el paso anterior, la plataforma desplegará en la parte inferior el aviso de confirmación: “Api key created, copy this key now, you won’t be able to see it again”.
2. Copie la clave inmediatamente, ya que por motivos de seguridad no se volverá a mostrar en pantalla.
3. Regrese al formulario de Saturn Studio y pegue el código copiado en el campo Nexus Api Key.
4. Haga clic en el botón Check para validar la conexión. Una vez confirmada, la credencial quedará lista para ser utilizada por sus agentes de automatización.

Esta guía detalla los pasos obligatorios para configurar y vincular de forma correcta su credencial de Otobo dentro de Saturn Studio.

1. Configuración de la Credencial en Saturn Studio

Para registrar una nueva credencial, haga clic en el botón azul New y complete los siguientes campos en la ventana emergente:

• Credential name: Ingrese un nombre descriptivo que le permita identificar esta credencial en el futuro (ej. Otobo_Bandeja_Soporte).
• URL: Introduzca la dirección web o dominio base correspondiente a su instancia activa de Otobo Ejemplo: https://your-otobo-instance.com/
• User: Escriba el nombre de usuario de la cuenta con la que se conectará el agente automatizado para gestionar los tickets.
• Password: Ingrese la contraseña asociada al usuario previamente indicado.

2. ¿De dónde se obtiene la URL de Otobo exactamente?

Para conseguir el enlace correcto que requiere el campo URL, debe guiarse por los siguientes criterios técnicos:

• Instalaciones Cloud o Web Corporativa: Es la dirección exacta que utiliza su equipo de soporte en el navegador para ingresar diariamente al panel de atención al cliente. Debe copiarla desde la barra de direcciones, asegurándose de incluir el protocolo seguro https:// al inicio.
• Estructura limpia: Debe pegar únicamente el dominio base o raíz del servidor de su empresa (por ejemplo: [https://soporte.tuempresa.com].
• Qué evitar: Asegúrese de no incluir rutas internas, carpetas finales ni nombres de scripts de inicio en el campo de texto (como /otobo/index.pl o /customer.pl), ya que el módulo de Saturn Studio se encarga de estructurar esas rutas de forma automática al ejecutar las Moons.

3. Validación y Guardado

1. Una vez completados los campos de texto, haga clic en el botón Check situado en la esquina inferior derecha para verificar que Saturn Studio tenga comunicación exitosa con el servidor de Otobo.
2. Tras confirmar la validez de los datos introducidos, haga clic en el botón verde Save credentials para almacenar el registro de forma encriptada en el vault seguro.

Redis es un almacén de datos en memoria de código abierto que se utiliza como base de datos, caché y intermediario de mensajes (message broker).

Descripción de los comandos

Eliminar una Clave de Redis (Delete a Key From Redis)

Eliminar una clave de Redis.

Parámetros	Descripción	Ejemplo
Credencial (Credential)	Credencial de Redis necesaria para eliminar una clave.	credential
Clave (Key)	Clave que desea eliminar de Redis.	mykey
Asignar resultado a variable (Assign result to variable)	Variable donde se almacenará el resultado. Ejemplo {"key" "mykey", "deleted" true, "deleted_count" 1}	{var}

Establecer el valor de una Clave en Redis (Set the value of a Key in Redis)

Establecer el valor de una clave de Redis.

Parámetros	Descripción	Ejemplo
Credencial (Credential)	Credencial de Redis necesaria para establecer el valor de una clave.	credential
Clave (Key)	Clave que desea establecer en Redis.	mykey
Valor (Value)	Valor que desea establecer para la clave en Redis.	myvalue
Tipo de Clave (Key Type)	Tipo de dato de la clave en Redis.	Hash, List, Sets, String
Asignar resultado a variable (Assign result to variable)	Variable donde se almacenará el resultado. Ejemplo {"key" "mykey", "type" "string", "value" "myvalue", "success" true, "redis_result" "1"}	{var}

Obtener el valor de una Clave de Redis (Get the value of a Key from Redis)

Obtener el valor de una clave de Redis.

Parámetros	Descripción	Ejemplo
Credencial (Credential)	Credencial de Redis necesaria para obtener el valor de una clave.	credential
Clave (Key)	Clave que desea obtener de Redis.	mykey
Tipo de Clave (Key Type)	Tipo de dato de la clave en Redis.	Hash, List, Sets, String
Asignar resultado a variable (Assign result to variable)	Variable donde se almacenará el resultado. Ejemplo {"key" "mykey", "type" "string", "found" true, "value" "myvalue"}	{var}

Incrementar una Clave por 1 de Forma Atómica (Atomically Increment a Key By 1)

Incrementar una clave por 1 de forma atómica en Redis.

Parámetros	Descripción	Ejemplo
Credencial (Credential)	Credencial de Redis necesaria para incrementar una clave.	credential
Clave (Key)	Clave que desea incrementar en Redis.	mycounter
Expirar (Expire)	Tiempo de expiración para la clave en milisegundos. Si no se proporciona, la clave no expirará.	Expire
Restablecer el tiempo de expiración desde el primer incremento (Reset expiration time from the first increment)	Si está marcado, el tiempo de expiración se restablecerá cuando expire.	Resets the expiration time from the last increment
Restablece el tiempo de expiración desde el último incremento (If checked, the expiration time will be reset every time the key is incremented.)	Variable donde se almacenará el resultado. Ejemplo {"key" "mycounter", "value" 10, "expire" 5000, "success" true}	{var}

Devolver todas las Claves que Coincidan con un Patrón (Return all Keys Matching a Pattern)

Listar claves por patrón.

Parámetros	Descripción	Ejemplo
Credencial (Credential)	Credencial de Redis necesaria para listar claves.	credential
Patrón de Clave (Key Pattern)	Patrón para hacer coincidir claves en Redis.	Key pattern*
Obtener Valores (Get Values)	También devolver el valor de cada clave coincidente.	Get Values
Asignar resultado a variable (Assign result to variable)	Variable donde se almacenará el resultado. Ejemplo [{"pattern" "my*", "total" "3"}, [{items {"key" "user", "type" "string", "value" "Alice"}}]	{var}

Otobo es una plataforma de atención al cliente que ayuda a gestionar tickets de soporte, automatizar flujos de trabajo y brindar asistencia multicanal de manera eficiente.

Para obtener las credenciales, haga clic aquí.

Descripción de los comandos

Crear Ticket (Create Ticket)

Crear un ticket en Otobo.

Parámetros	Descripción	Ejemplo
Credencial (Credential)	Credencial de Otobo necesaria para obtener el ticket.	credential
Para el Cliente Usuario (To the Client User)	Correo electrónico del cliente usuario al que se le asignará el ticket.	To the Client User
Desde la Cola (From the Tail)	Desde qué cola se creará el ticket.	Junk, Misc, Postmaster, Raw
Asunto (Subject)	Asunto del ticket a crear.	Subject of the ticket
Descripción (Description)	Descripción del ticket a crear.	Description of the ticket
Prioridad (Priority)	Prioridad del ticket a crear.	Very Low, Low, Medium, High or Very High
Estado (Status)	Abierto, Pendiente, Resuelto o Cerrado.	Open, Pending, Resolved or Closed
Servicio Web (Web Service)	Servicio Web para crear el ticket.	Web Service
Ruta de la Operación (Operation Path)	Ruta de la operación en el servicio web. Ejemplo Ticket o TicketCreate.	Operation Path
Asignar resultado a variable (Assign result to variable)	Variable donde se almacenará el resultado. Ejemplo [{"ticket" { "ticketNumber" "12345", "ticketID" "67890", "articleID" "12345" }, "request" {"userLogin" "jsmith", "password" "****", "ticketID" "title" "Issue with my order", "queue" "postmaster", "priority" "3 medium", "state" "open", "customerUser" "correo@rocketbot.com"}, "article" {"subject" "Issue with my order", "body" "description of the issue", "contentType" "text/plain"}, "endpoint_used" "https//[otobo.com/otobo-webservice/GenericTicketConnector](https://otobo.com/otobo-webservice/GenericTicketConnector)", "service_name_used" {"service_name" "GenericTicketConnector", "operation_path_used" "TicketSearch"}}].	{var}

Buscar Tickets (Tickets Search)

Buscar tickets desde Otobo.

Parámetros	Descripción	Ejemplo
Credencial (Credential)	Credencial de Otobo necesaria para listar tickets.	credential
Servicio Web (Web Service)	Servicio Web para crear el ticket.	Web Service
Ruta de la Operación (Operation Path)	Ruta de la operación en el servicio web. Ejemplo TicketSearch.	Operation Path
Asignar resultado a variable (Assign result to variable)	Variable donde se almacenará el resultado. Ejemplo {"tickets" [""], "total" "1", "request_summary" {"service_name" "", "operation_path" ""}}.	{var}

Obtener Ticket (Get Ticket)

Obtener un ticket por ID desde Otobo.

Parámetros	Descripción	Ejemplo
Credencial (Credential)	Credencial de Otobo necesaria para obtener el ticket.	credential
ID del Ticket (Ticket ID)	ID del ticket a obtener.	8453
Servicio Web (Web Service)	Servicio Web para obtener el ticket.	Web Service
Ruta de la Operación (Operation Path)	Ruta de la operación en el servicio web. Ejemplo Ticket o TicketGet.	Operation Path
Asignar resultado a variable (Assign result to variable)	Variable donde se almacenará el resultado.	{var}

Actualizar Ticket (Update Ticket)

Actualizar un ticket existente en Otobo.

Parámetros	Descripción	Ejemplo
Credencial (Credential)	Credencial de Otobo necesaria para actualizar el ticket.	credential
ID del Ticket (Ticket ID)	ID del ticket a actualizar.	8453
Para el Cliente Usuario (To the Client User)	Correo electrónico del cliente usuario para reasignar el ticket.	To the Client User
Asunto (Subject)	Nuevo asunto del ticket. Si no desea actualizarlo, simplemente coloque el mismo asunto.	Subject of the ticket
Desde la Cola (From the Tail)	Desde qué cola se actualizará el ticket. No es necesario colocarlo, solo si desea actualizarlo.	Junk, Misc, Postmaster, Raw
Descripción (Description)	Nueva descripción del ticket. Si no desea actualizarla, simplemente coloque la misma descripción.	Description of the ticket
Prioridad (Priority)	Muy Baja, Baja, Media, Alta o Muy Alta.	Very Low, Low, Medium, High or Very High
Estado (Status)	Abierto, Pendiente, Resuelto o Cerrado.	Open, Pending, Resolved or Closed
Tiempo Pendiente (Pending Time)	Nuevo tiempo pendiente del ticket. Si no desea actualizarlo, simplemente coloque el mismo tiempo pendiente.	2026-04-24
Servicio Web (Web Service)	Servicio Web para actualizar el ticket.	Web Service
Ruta de la Operación (Operation Path)	Ruta de la operación en el servicio web. Ejemplo TicketUpdate.	Operation Path
Asignar resultado a variable (Assign result to variable)	Variable donde se almacenará el resultado. Ejemplo ["updated" "true", "ticket_id" "12", {"response" {"articleID" "123", "ticketID" "456", "ticketNumber" "OT12345"}, "request" {"userLogin" "jsmith", "password" "****", "ticketID" "12", "ticket" {"title" "Issue with my order", "queue" "postmaster", "priority" "3 medium", "state" "open", "pendingTime" {"year" "2026", "month" "04", "day" "24"}}, "article" {"subject" "Issue with my order", "body" "description of the issue", "contentType" "text/plain"}, "userID" "1", }}, "endpoint_used" "https//[otobo.com/otobo-webservice/GenericTicketConnector](https://otobo.com/otobo-webservice/GenericTicketConnector)", "service_name_used" {"service_name" "GenericTicketConnector", "operation_path_used" ""}, "request_summary" {"ticket_id" "12"}, "updated_fields" {"subject""true", "from_tail" "true", "priority" "true", "status" "true", "to_email" "true", "description" "true", "close_data" "true"}}].	{var}

Nexus es una plataforma de gestión de datos integrada en la Suite de Rocketbot, diseñada para conectar y administrar toda su información de manera eficiente. Más información.

Para obtener las credenciales, haga clic aquí.

Descripción de los comandos

Listar Tablas (List Tables)

Listar tablas de Nexus.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Nexus necesaria para obtener tareas.	credential
Asignar resultado a variable	Variable donde se almacenará el resultado. Ejemplo {"id" "46y1fd89-6f42-4c74-b473-cb542100a8t0", "appId" "3l106408-6b80-49de-8dcb-0cba1bf102d4", "name" "My Table", "displayName" "custom", "schema" {"columns" ["name" "name", "type" "string", "displayName" "Name"}]}, "createdAt" "2024-10-01T120000Z", "updatedAt" "2024-10-01T120000Z"}	{var}

Obtener Tabla (Get Table)

Obtener una tabla por ID de tabla.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Nexus necesaria para obtener la tabla.	credential
ID de la Tabla	ID de la tabla que desea obtener.	table_id
Asignar resultado a variable	Variable donde se almacenará el resultado. Ejemplo {"id" "46y1fd89-6f42-4c74-b473-cb542100a8t0", "appId" "3l106408-6b80-49de-8dcb-0cba1bf102d4", "name" "My Table", "displayName" "custom", "schema" {"columns" ["name" "name", "type" "string", "displayName" "Name"}]}, "createdAt" "2024-10-01T120000Z", "updatedAt" "2024-10-01T120000Z"}	{var}

Crear Tabla (Create Table)

Crear una tabla en Nexus.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Nexus necesaria para crear una tabla.	credential
Nombre Interno	Nombre interno de la tabla que desea crear.	Internal Name
Nombre para Mostrar	Nombre para mostrar de la tabla que desea crear.	Display Name
Columnas	Columnas de la tabla que desea crear, en formato JSON.	Columns
Asignar resultado a variable	Variable donde se almacenará el resultado. Ejemplo {"id" "46y1fd89-6f42-4c74-b473-cb542100a8t0", "appId" "3l106408-6b80-49de-8dcb-0cba1bf102d4", "name" "My Table", "displayName" "custom", "schema" {"columns" ["name" "name", "type" "string", "displayName" "Name"}]}, "createdAt" "2024-10-01T120000Z", "updatedAt" "2024-10-01T120000Z"}	{var}

Eliminar Tabla (Delete Table)

Eliminar una tabla por ID de tabla.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Nexus necesaria para eliminar una tabla.	credential
ID de la Tabla	ID de la tabla que desea eliminar.	Table Id
Asignar resultado a variable	Variable donde se almacenará el resultado. Ejemplo {"success" "true", "message" "Table deleted successfully", "TableId" "46y1fd89-6f42-4c74-b473-cb542100a8t0"}	{var}

Actualizar Tabla (Update Table)

Actualizar una tabla por ID de tabla.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Nexus necesaria para actualizar una tabla.	credential
ID de la Tabla	ID de la tabla que desea actualizar.	Table Id
Nombre para Mostrar	Nombre para mostrar de la tabla que desea actualizar.	Display Name
Parámetros a actualizar	Permite actualizar los parámetros de una tabla, en formato JSON.	{parameters}
Asignar resultado a variable	Variable donde se almacenará el resultado. Ejemplo {"success" "true", "data" {"id" "46y1fd89-6f42-4c74-b473-cb542100a8t0", "appId" "3l106408-6b80-49de-8dcb-0cba1bf102d4", "name" "My Table", "displayName" "custom", "schema" {"columns" ["name" "name_1", "type" "string", "displayName" "Name 1"}]}, "createdAt" "2024-10-01T120000Z", "updatedAt" "2024-10-01T120000Z"}	{var}

Listar Filas (List Rows)

Listar filas en una tabla.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Nexus necesaria para listar filas en una tabla.	credential
ID de la Tabla	ID de la tabla de la que desea obtener los resultados.	table_id
Asignar resultado a variable	Variable donde se almacenará el resultado. Ejemplo [{"id" "46y1fd89-6f42-4c74-b473-cb542100a8t0", "tableId" "26k9fd89-6f42-4c74-b473-cb542100a2l5", "data" {"name" "John Doe"}, "createdAt" "2024-10-01T120000Z", "updatedAt" "2024-10-01T120000Z"}]	{var}

Insertar Fila (Insert Row)

Insertar una fila en una tabla.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Nexus necesaria para insertar una fila en una tabla.	credential
Tabla	Tabla donde se insertará la fila.	Select a table
Datos de la Fila	Datos para insertar en la fila, en formato JSON.	Parameters
Asignar resultado a variable	Variable donde se almacenará el resultado. Ejemplo {"id" "46y1fd89-6f42-4c74-b473-cb542100a8t0", "tableId" "26k9fd89-6f42-4c74-b473-cb542100a2l5", "data" {"name" "John Doe"}, "createdAt" "2024-10-01T120000Z", "updatedAt" "2024-10-01T120000Z"}	{var}

Actualizar Fila (Update Row)

Actualizar una fila en una tabla.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Nexus necesaria para actualizar una fila en una tabla.	credential
ID de la Fila	ID de la fila que desea actualizar.	row id
Datos de la Fila	Datos para actualizar en la fila, en formato JSON.	{parameters}
Asignar resultado a variable	Variable donde se almacenará el resultado. Ejemplo {"id" "46y1fd89-6f42-4c74-b473-cb542100a8t0", "tableId" "26k9fd89-6f42-4c74-b473-cb542100a2l5", "data" {"name" "John Doe"}, "createdAt" "2024-10-01T120000Z", "updatedAt" "2024-10-01T120000Z"}	{var}

Eliminar Fila (Delete Row)

Eliminar una fila en una tabla.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Nexus necesaria para eliminar una fila en una tabla.	credential
ID de la Fila	ID de la fila que desea eliminar.	row id
Asignar resultado a variable	Variable donde se almacenará el resultado. Ejemplo {"success" "true", "message" "Row deleted successfully"}	{var}

Borrar Todas las Filas (Erase All Rows)

Borrar todas las filas en una tabla.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Nexus necesaria para borrar todas las filas en una tabla.	credential
ID de la Tabla	ID de la tabla de la que desea borrar todas las filas.	table_id
Asignar resultado a variable	Variable donde se almacenará el resultado. Ejemplo {"success" "true", "data" {"deletedCount" "5"}}	{var}

Actualizar Celda (Update Cell)

Actualizar una celda en una tabla.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Nexus necesaria para actualizar una celda en una tabla.	credential
ID de la Tabla	ID de la tabla donde se encuentra la celda.	table id
ID de la Fila	ID de la fila donde se encuentra la celda.	row id
ID de la Columna	ID de la columna donde se encuentra la celda.	column id
Nuevo Valor de Celda	Nuevo valor para la celda.	New value for the cell
Asignar resultado a variable	Variable donde se almacenará el resultado. Ejemplo {"success" "true", "data" {"id" "26k9fd89-6f42-4c74-b473-cb542100a2l5", "tableId" "46y1fd89-6f42-4c74-b473-cb542100a8t0", "data" {"name" "name", "age" "age", "address" "address", "createdAt" "2024-10-01T120000Z", "updatedAt" "2024-10-01T120000Z"}}	{var}

Listar Consultas (List Queries)

Listar consultas en una tabla.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Nexus necesaria para listar consultas en una tabla.	credential
Asignar resultado a variable	Variable donde se almacenará el resultado. Ejemplo [{"id" "46y1fd89-6f42-4c74-b473-cb542100a8t0", "appId" "26k9fd89-6f42-4c74-b473-cb542100a2l5", "dataSourceId" "78o9fd89-6f42-4c74-b473-cb542100x4i0", "name" "This is my query", "queryType" "READ", "config" {"operation""SELECT", "Limit" 100, "fields" [], "filters" [], "tableId" "46y1fd89-6f42-4c74-b473-cb542100a8t0"}, "createdAt" "2024-10-01T120000Z", "updatedAt" "2024-10-01T120000Z"}]	{var}

Ejecutar Consulta (Execute Query)

Ejecutar una consulta en una tabla.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Nexus necesaria para ejecutar una consulta en una tabla.	credential
ID de la Consulta	ID de la consulta que desea ejecutar.	Query Id
Parámetros de Consulta	Parámetros para ejecutar en la consulta, en formato JSON.	{parameters}
Asignar resultado a variable	Variable donde se almacenará el resultado. Ejemplo [{"id" "46y1fd89-6f42-4c74-b473-cb542100a8t0", "tableId" "26k9fd89-6f42-4c74-b473-cb542100a2l5", "data" {"name" "John Doe"}, "createdAt" "2024-10-01T120000Z", "updatedAt" "2024-10-01T120000Z"}]	{var}

Cloudflare es una plataforma de servicios en la nube que ofrece una variedad de soluciones para mejorar el rendimiento, la seguridad y la confiabilidad de sitios web y aplicaciones. Con este módulo, puede integrar las funcionalidades de Cloudflare en sus flujos de trabajo de Saturn Studio, permitiéndole gestionar sus recursos directamente desde la plataforma.

Cómo obtener las credenciales, click aquí.

Descripción de los comandos

Subir un Certificado (Upload a Certificate)

Sube un certificado a Cloudflare.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Cloudflare necesaria para subir un certificado.	credential
ID de Zona (Zone ID)	El ID de la zona donde se subirá el certificado.	Zone ID
Contenido del Certificado	El contenido del certificado que se va a subir.	Certificate Content
Llave Privada (Private Key)	El contenido de la llave privada asociada al certificado.	Private Key
Asignar resultado a variable	Variable donde se almacenará el resultado.	{var}

Eliminar un Certificado (Delete a Certificate)

Elimina un certificado de Cloudflare.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Cloudflare necesaria para eliminar un certificado.	credential
ID de Zona (Zone ID)	El ID de la zona donde se encuentra el certificado.	Zone ID
ID del Certificado	El ID del certificado que se desea eliminar.	Certificate ID
Asignar resultado a variable	Variable donde se almacenará el resultado.	{var}

Obtener un Certificado (Get a Certificate)

Obtiene la información de un certificado específico de Cloudflare.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Cloudflare necesaria para obtener un certificado.	credential
ID de Zona (Zone ID)	El ID de la zona donde se encuentra el certificado.	Zone ID
ID del Certificado	El ID del certificado que se desea obtener.	Certificate ID
Asignar resultado a variable	Variable donde se almacenará el resultado.	{var}

Obtener muchos Certificados (Get Many Certificates)

Obtiene una lista de certificados de Cloudflare.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Cloudflare necesaria para obtener los certificados.	credential
ID de Zona (Zone ID)	El ID de la zona donde se encuentran los certificados.	Zone ID
Límite (Limit)	El número máximo de certificados a recuperar.	Limit
Retornar todos (Return all)	Si se marca, se devolverán todos los certificados de la zona.	Return all
Estado (Status)	Selecciona el estado de los certificados que se desean recuperar.	Status
Asignar resultado a variable	Variable donde se almacenará el resultado.	{var}

Para gestionar los certificados de sus sitios web mediante Saturn Studio, es necesario configurar una credencial basada en un API Token. Este identificador permite que el robot realice operaciones de lectura y edición en sus zonas de Cloudflare de forma segura.

1. Obtención y Configuración del API Token

El proceso de creación debe realizarse en el portal oficial de Cloudflare siguiendo este orden lógico para asegurar que el robot tenga los accesos necesarios:

Paso 1: Acceso al Portal

En el formulario de credenciales de Saturn Studio, haga clic en el enlace “here” o acceda directamente a su cuenta en el panel de Cloudflare.

Paso 2: Navegación

En la barra de búsqueda superior del panel de Cloudflare, escriba “API Token” y seleccione la opción Account API tokens. Una vez allí, haga clic en el botón azul Create Token.

Paso 3: Selección de Plantilla

Puede utilizar una plantilla de edición de zona o seleccionar “Create Custom Token”. El sistema le asignará un nombre automático (ej. dawn-pine-98da), el cual puede conservar o modificar.

Paso 4: Configuración de Permisos (Scopes)

Este es el paso más importante. Antes de continuar, debe agregar las siguientes políticas de permisos para que los comandos de certificados en Saturn Studio funcionen:

Categoría de Permiso	Permiso Específico	Nivel de Acceso	Comandos Vinculados
Zone	SSL and Certificates	Edit	Upload, Delete, Get, Get Many
Zone	Zone	Read	Listado y lectura de zonas

Paso 5: Restricciones Opcionales

• Zone Resources: Seleccione “All zones” o una zona específica si desea limitar el alcance del robot.
• TTL (Expiración): Puede definir cuánto tiempo será válido el token.
• IP Filtering: Puede restringir el uso del token solo a la dirección IP de su servidor de Saturn Studio.

Paso 6: Finalización y Resguardo

Haga clic en Continue to summary y luego en Create Token.

Copie su token inmediatamente: Cloudflare solo mostrará el secreto alfanumérico una vez. Selecciónelo y guárdelo en un lugar seguro; si cierra esta ventana sin copiarlo, deberá generar uno nuevo.

---

2. Configuración en Saturn Studio

Una vez que tenga el token (ej: cfat_9FIAmNzOG...), regrese a Saturn Studio para completar la vinculación:

1. Nombre de la credencial: Asigne un nombre descriptivo (ej: Cloudflare_Certificados).
2. API Token: Pegue el código obtenido en el paso anterior.
3. Validación: Haga clic en el botón Check.

   • Si los permisos fueron configurados correctamente, el estado cambiará a “Connected” en color azul.
   • Verá el mensaje: “Success! Credentials are valid and the request succeeded”.

4. Guardar: Haga clic en Save credentials.

Dropbox es una plataforma de colaboración y almacenamiento en la nube que permite guardar, compartir y sincronizar archivos en múltiples dispositivos.

Cómo obtener las credenciales, click aquí.

Descripción de los comandos

Subir un archivo (Upload a File)

Sube un archivo a Dropbox.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Dropbox necesaria para subir archivos.	credential
Ruta del archivo	Ruta de destino en Dropbox.	/invoices/2019/invoice_1.pdf
Archivo local	Variable de archivo para subir cuando “Binary File” está habilitado. Ejemplo [{"name": "file1.txt", "path_lower": "/file1.txt", "path_display": "/file1.txt", "id": "idfile1", "client_modified": "2020-01-01T00:00:00Z", "server_modified": "2020-01-01T00:00:00Z", "rev": "9535f95cfdb3523000000033ba8ptr5", "size": "1234", "is_downloadable": "true", "content_hash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"}].	select file
Asignar resultado a variable	Variable donde se almacenará el resultado.	{var}

Eliminar un archivo (Delete a File)

Elimina un archivo en Dropbox.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Dropbox necesaria para eliminar archivos.	credential
ID del archivo	ID del archivo a eliminar en Dropbox.	File to delete ID
Asignar resultado a variable	Variable donde se almacenará el resultado. Ejemplo [{"message": "File deleted successfully", "name": "file1.txt"}].	{var}

Descargar un archivo (Download a File)

Descarga un archivo de Dropbox.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Dropbox necesaria para descargar archivos.	credential
Ruta del archivo	Ruta del archivo a descargar en Dropbox.	/invoices/2019/invoice_1.pdf
Asignar resultado a variable	Variable donde se almacenará el resultado. Ejemplo [{"filename": "invoice_1.pdf", "id": "p95r13ebe31c88aec9100d4ee579e29d7103177ac4c5784ebf9c397564e54e22", "size": 1234, "provider": "dropbox"}].	{var}

Mover un archivo (Move a file)

Mueve un archivo en Dropbox.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Dropbox necesaria para mover archivos.	credential
Ruta del archivo de origen	Ruta del archivo a mover en Dropbox.	/invoices/2019/invoice_1.pdf
Ruta del archivo de destino	Ruta donde se moverá el archivo en Dropbox.	/invoices/2020/invoice_1.pdf
Asignar resultado a variable	Variable donde se almacenará el resultado. Ejemplo ["metadata {".tag": "file", "name": "file1.txt", "path_lower": "/folder/file1.txt", "path_display": "/folder/file1.txt", "id": "idfile1", "client_modified": "2020-01-01T00:00:00Z", "server_modified": "2020-01-01T00:00:00Z", "rev": "9535f95cfdb3523000000033ba8ptr5", "size": "1234", "is_downloadable": "true", "content_hash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"}].	{var}

Crear una carpeta (Create a Folder)

Crea una carpeta en Dropbox.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Dropbox necesaria para crear carpetas.	credential
Nombre de la carpeta	Nombre de la carpeta a crear en Dropbox.	folder name
Asignar resultado a variable	Variable donde se almacenará el resultado. Ejemplo [{"metadata": {"name": "New Folder", "path_lower": "/invoices/2020", "path_display": "/invoices/2020", "id": "id2OCn0d58CrIOOOOOOOOODO"}}].	{var}

Eliminar una carpeta (Delete a Folder)

Elimina una carpeta en Dropbox.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Dropbox necesaria para eliminar carpetas.	credential
ID de la carpeta	ID de la carpeta a eliminar en Dropbox.	Folder to delete ID
Asignar resultado a variable	Variable donde se almacenará el resultado. Ejemplo [{"message": "Folder deleted successfully", "folder_name": "invoices"}].	{var}

Mover una carpeta (Move a Folder)

Mueve una carpeta en Dropbox.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Dropbox necesaria para mover carpetas.	credential
Ruta de la carpeta de origen	Ruta de la carpeta a mover en Dropbox.	/invoices
Ruta de la carpeta de destino	Ruta donde se moverá la carpeta en Dropbox.	/2021/invoices
Asignar resultado a variable	Variable donde se almacenará el resultado. Ejemplo ["metadata {".tag":"folder", "name": "invoices", "path_lower": "/2021/invoices", "path_display": "/2021/invoices", "id": "id2OCn0d58CrIOOOOOOOOODO"}].	{var}

Listar una carpeta (List a Folder)

Enumera el contenido de una carpeta en Dropbox.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Dropbox necesaria para listar carpetas.	credential
Ruta de la carpeta	Ruta de la carpeta a listar en Dropbox.	/invoices/2020/
Retornar todas las carpetas	Indica si se deben retornar todas las carpetas o solo los archivos en la carpeta especificada.	Return all folders
Asignar resultado a variable	Variable donde se almacenará el resultado. Ejemplo [{".tag": "folder", "name": "invoices", "path_lower": "/2021/invoices", "path_display": "/2021/invoices", "id": "id2OCn0d58CrIOOOOOOOOODO"}].	{var}

Para integrar Dropbox con Saturn Studio y permitir que el robot gestione archivos y carpetas, es necesario configurar una credencial basada en un Access Token. Siga estos pasos para registrar su aplicación y generar la clave de acceso con los permisos adecuados.

1. Creación de la Aplicación en Dropbox

El proceso comienza en el portal de desarrolladores de Dropbox para registrar el “puente” de conexión:

1. Acceso: En el formulario de credenciales de Saturn Studio, haga clic en el enlace “here” para dirigirse a la Consola de Aplicaciones de Dropbox.
2. Crear App: Haga clic en el botón “Create app”.
3. Configuración inicial:

   • 1. Choose an API: Seleccione Scoped access.
   • 2. Choose the type of access: Seleccione Full Dropbox para permitir el acceso a todos los archivos y carpetas necesarios para los comandos del módulo.
   • 3. Name your app: Asigne un nombre a su aplicación (ej. Saturn_Integration_Test).

4. Aceptar Términos: Marque la casilla de aceptación de términos y haga clic en Create app.

2. Configuración de Permisos (Permissions)

Para que los comandos de subir, borrar, descargar y listar funcionen correctamente, debe activar los siguientes permisos en la pestaña Permissions antes de generar el token:

Categoría	Permiso (Scope)	Descripción
Files and folders	files.metadata.write	Permite crear carpetas y mover archivos.
Files and folders	files.metadata.read	Requerido para listar el contenido de las carpetas.
Files and folders	files.content.write	Necesario para subir (Upload) y eliminar archivos.
Files and folders	files.content.read	Necesario para descargar (Download) archivos.

Guardar Permisos: Después de marcar los permisos, asegúrese de hacer clic en el botón Submit al final de la página para aplicar los cambios.

3. Generación del Access Token

Una vez configurados los permisos, proceda a generar la clave técnica:

1. Diríjase a la pestaña Settings de su aplicación en Dropbox.
2. Desplácese hacia abajo hasta encontrar la sección Generated access token.
3. Haga clic en el botón Generate.
4. Copie el código alfanumérico que aparecerá en pantalla.

4. Vinculación en Saturn Studio

Regrese al panel de Saturn Studio para finalizar la configuración:

1. Credential name: Asigne un nombre para identificar esta conexión (ej. Dropbox_Personal).
2. Access Token: Pegue el token generado en el paso anterior.
3. Conexión: Haga clic en el botón azul Connect to Dropbox.
4. Verificación: Si los permisos y el token son correctos, el botón cambiará a un estado verde con el mensaje “Connected ✓” y aparecerá el aviso: “Success! connected successfully.”.
5. Finalizar: Haga clic en Save credentials.

Para integrar Nubox con Saturn Studio, es fundamental configurar correctamente las credenciales que permiten el acceso a la API de Integraciones. Este proceso asegura que el robot opere en el entorno adecuado (pruebas o producción) con los permisos de partner autorizados.

1. Ambientes y URLs Base (baseUrl)

Para el desarrollo de su automatización, dispondrá de dos ambientes principales. La baseUrl que utilice dependerá de la fase de su proyecto:

• Ambiente de Certificación (Pruebas/UAT): Destinado exclusivamente a pruebas y validaciones durante la etapa de desarrollo. Permite realizar operaciones sin afectar datos reales.

  • URL: Es entregada por el equipo de soporte al momento de solicitar las credenciales de prueba.

• Ambiente Productivo: Entorno para operar con transacciones reales y clientes finales. Se debe utilizar únicamente cuando la integración haya sido completamente probada y certificada en UAT.

  • URL: Entregada junto con las credenciales definitivas.

Saturn Studio — Credencial Nubox

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. Para integrar este servicio con Saturn Studio, es necesario configurar las credenciales correspondientes según el ambiente de trabajo (Pruebas o Productivo).

---

1. Ambientes y URLs Base (baseUrl)

La baseUrl a utilizar dependerá de la fase de su proyecto:

• Ambiente de Certificación (Pruebas/UAT): Entorno destinado a validaciones durante el desarrollo donde se opera sin afectar datos reales.

  • Disponibilidad: Lunes a viernes, de 11:00 AM GMT a 00:00 AM GMT.
  • URL: Entregada por soporte técnico al solicitar las credenciales de prueba.

• Ambiente Productivo: Entorno para transacciones reales y clientes finales.

  • URL: Entregada una vez habilitada la cuenta productiva.

---

2. Obtención de Credenciales

Ambiente de Certificación (UAT)

Para obtener estas claves iniciales, siga estos pasos:

1. Envíe un correo a soporte@nubox.com.
2. Solicite las credenciales de la API de Integraciones para el ambiente de pruebas (UAT), indicando el nombre de su empresa y un contacto principal.
3. Recibirá el Token del Partner (Authorization), la API Key de la Empresa Cliente (X-Api-Key) y el Host/BaseUrl.

Ambiente Productivo

Una vez que el equipo de soporte habilite su cuenta y el acceso a la plataforma de Factura y Administración, proceda de la siguiente manera:

1. Acceso: Ingrese a su cuenta de Factura y Administración, haga clic en el icono del engranaje y entre al módulo de Integraciones & API.
2. Inicio: Haga clic en el botón “Iniciar” dentro de la sección de API.
3. Selección de integración: Elija una de las dos opciones disponibles:

   • A través de partners: Si un tercero realiza su integración, seleccione “A través de una empresa asociada a Nubox”, elija al partner del listado y presione Generar Credenciales. Su partner podrá visualizar las claves automáticamente.
   • Integración independiente: Si usará las credenciales por cuenta propia, seleccione “Directamente con Nubox (por mi cuenta, sin empresa asociada)” y presione Generar Credenciales.

4. Finalización: Tras el mensaje de éxito, las credenciales a utilizar se mostrarán en pantalla.

3. Configuración en Saturn Studio

Una vez recibida la información, complete el formulario de credenciales en Saturn Studio con los siguientes parámetros:

Parámetro	Descripción	Ejemplo
Base URL	La URL (Host) entregada por soporte para el ambiente correspondiente.	[https://api.nubox.com/certificacion](https://api.nubox.com/certificacion)
Token	El Token del Partner que lo identifica como integrador autorizado.	Token_Secreto_Partner
API Key	La X-Api-Key de la empresa cliente sobre la cual se realizarán las acciones.	Clave_Empresa_Cliente

Validación de conexión: Tras ingresar los datos, debe hacer clic en el botón “Check” para verificar que las claves y la URL son correctas antes de guardar la configuración.

Guia oficial de Nubox https://developers.nubox.com/api-docs