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

Google Books es una aplicación de Google que permite el acceso a una biblioteca digital.

Para obtener las credenciales, haz clic aquí.

Descripción de los comandos

Obtener muchos volúmenes (Get Many Volumes)

Obtiene información sobre muchos libros en Google Books.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Google Books necesaria para buscar los libros.	My Google Books credentials
Consulta de búsqueda	Términos de búsqueda para encontrar los libros. Ejemplo: harry potter, intitle:harry potter, inauthor:rowling.	Search query
Límite	Número de libros a obtener.	20
Asignar resultado a variable	Variable donde se almacenará el resultado. Ejemplo [“items” {“id” “ASD123”, “title” “Harry Potter”, “authors” [“J.K. Rowling”], “publishedDate” “2020-01-01”, “publisher” “Bloomsbury”, “pageCount” 500, “categories” [“Fiction”], “language” “en”, “description” “A book about a young wizard.”, “averageRating” 4.5, “thumbnail” “http//[example.com/thumbnail.jpg](https://example.com/thumbnail.jpg)”, “infoLink” “http//[example.com/info](https://example.com/info)”, “previewLink” “http//[example.com/preview](https://example.com/preview)”].	{var}

Obtener un volumen (Get a Volume)

Obtiene información sobre un libro en Google Books.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Google Books necesaria para buscar los libros.	My Google Books credentials
ID del Volumen	Ingrese el ID del volumen.	Volume ID
Asignar resultado a variable	Variable donde se almacenará el resultado.	{var}

Para integrar el módulo de Google Books con Saturn Studio, es necesario configurar una credencial de tipo OAuth 2.0 en la consola de Google Cloud. Este procedimiento permite que el robot acceda a la biblioteca digital y recupere información de volúmenes de forma autorizada.

Crear / elegir proyecto y habilitar APIs

• Ingresa a Google Cloud Console.
• Inicia sesión con tu cuenta de Google.
• Crea un nuevo proyecto o selecciona uno existente desde la barra superior.

Habilitación de la API

Antes de configurar las credenciales, debe activar el acceso al servicio:

• Diríjase a la biblioteca de APIs en la consola de Google Cloud.
• Busque Books API y haga clic en Habilitar.
• Este paso es obligatorio para que Google procese las solicitudes de búsqueda del robot.

Configuración de la Pantalla de consentimiento OAuth

Debe definir la identidad de su aplicación para permitir la vinculación con Saturn Studio.

En el menú lateral, entra a:
APIs y servicios → Pantalla de consentimiento OAuth → Configurar pantalla de consentimiento.

• Completa los campos solicitados:

  • Nombre de la aplicación
  • Correo de soporte
  • (Opcional) Logo, dominio, enlaces de privacidad y términos.

• Elige el tipo de usuario según tu caso:

Tipo de usuario	Descripción	Recomendación
Interno	Solo usuarios de tu organización (requiere dominio Google Workspace).	Úsalo si tu equipo pertenece al mismo dominio.
Externo	Permite acceso a cualquier cuenta de Google (modo de prueba).	Ideal para uso personal o con cuentas @gmail.com.

Nota: en modo Externo (prueba) deberás agregar manualmente a los usuarios de prueba, incluido tu propio correo.
Solo esos usuarios podrán autorizar la app mientras esté en prueba.

Guarda los cambios al finalizar.

Configuración de Permisos (Scopes)

Durante la edición de la pantalla de consentimiento, debe añadir los permisos específicos para operar con la biblioteca digital:

Permiso (URL de Scope)	Función Técnica
.../auth/books	Permiso principal para gestionar y buscar en su biblioteca de Google Books.
.../auth/userinfo.profile	Acceso a la información básica del perfil del usuario.
.../auth/userinfo.email	Permite ver la dirección de correo electrónico asociada.
openid	Estándar necesario para la autenticación de identidad.

Creación del ID de cliente de OAuth

Una vez configurada la pantalla de consentimiento, genere los identificadores técnicos:

1. Vaya a la sección APIs y servicios > Credenciales.
2. Seleccione Crear credenciales > ID de cliente de OAuth.
3. Tipo de aplicación: Seleccione Aplicación web.
4. URIs de redireccionamiento autorizados: Ingrese la URL de su instancia de Saturn Studio (ejemplo: https://studio.rocketbot.com).

Parámetros para Saturn Studio

Copie los siguientes valores generados por Google en el formulario de credenciales de Saturn Studio:

Parámetro	Descripción
Client ID	Identificador público de su aplicación ante los servidores de Google.
Client Secret	Llave privada confidencial necesaria para validar la conexión.

Privacidad del Secreto: El Client Secret solo se muestra una vez al momento de la creación. Asegúrese de guardarlo en un lugar seguro o descargar el archivo JSON inmediatamente.

Para integrar Google Translate (Cloud Translation API) con Saturn Studio, es necesario configurar una credencial de tipo OAuth 2.0. Este procedimiento permite que su robot realice traducciones automáticas de texto de manera segura y autorizada.

Crear / elegir proyecto y habilitar APIs

• Ingresa a Google Cloud Console.
• Inicia sesión con tu cuenta de Google.
• Crea un nuevo proyecto o selecciona uno existente desde la barra superior.

Habilitación de la API

El primer paso es activar el motor de traducción en su proyecto de Google Cloud:

• Diríjase a la biblioteca de APIs en la consola de Google Cloud.
• Busque Cloud Translation API y haga clic en Habilitar.
• Sin esta activación, las solicitudes de traducción serán rechazadas por el servidor.

Configuración de la Pantalla de consentimiento OAuth

En el menú lateral, entra a:
APIs y servicios → Pantalla de consentimiento OAuth → Configurar pantalla de consentimiento.

• Completa los campos solicitados:

  • Nombre de la aplicación
  • Correo de soporte
  • (Opcional) Logo, dominio, enlaces de privacidad y términos.

• Elige el tipo de usuario según tu caso:

Tipo de usuario	Descripción	Recomendación
Interno	Solo usuarios de tu organización (requiere dominio Google Workspace).	Úsalo si tu equipo pertenece al mismo dominio.
Externo	Permite acceso a cualquier cuenta de Google (modo de prueba).	Ideal para uso personal o con cuentas @gmail.com.

🔸 Nota: en modo Externo (prueba) deberás agregar manualmente a los usuarios de prueba, incluido tu propio correo.
Solo esos usuarios podrán autorizar la app mientras esté en prueba.

Guarda los cambios al finalizar.

Configuración de Permisos (Scopes)

Durante la edición de la pantalla de consentimiento, deberá agregar los permisos específicos para el servicio de traducción:

Permiso (URL de Scope)	Función Técnica
.../auth/cloud-translation	Permiso total para enviar textos a traducir y detectar idiomas.
.../auth/cloud-platform	Acceso genérico a los servicios de Google Cloud Platform.
.../auth/userinfo.profile	Acceso a la información básica del perfil.
openid	Necesario para validar la identidad mediante OAuth.

Creación del ID de cliente de OAuth

Una vez configurada la pantalla de consentimiento, genere las llaves de acceso:

1. Vaya a APIs y servicios > Credenciales.
2. Haga clic en Crear credenciales > ID de cliente de OAuth.
3. Tipo de aplicación: Elija Aplicación web.
4. URIs de redireccionamiento autorizados: Ingrese la URL de su instancia de Saturn Studio (ejemplo: https://studio.rocketbot.com/).

Parámetros para Saturn Studio

Copie y pegue los siguientes valores en el formulario de creación de credenciales dentro de Saturn Studio:

Parámetro	Descripción
Client ID	El identificador único de su aplicación cliente.
Client Secret	La llave secreta que autentica la comunicación entre servidores.

Seguridad de la Llave: El Client Secret es información sensible. No la comparta y asegúrese de copiarla inmediatamente, ya que por seguridad Google podría ocultarla tras cerrar el asistente de creación.