Saturn Studio – Trello - Rocketbot Docs

Table of Contents

📌 ¿Qué es este módulo?

Este módulo integra Saturn Studio con Trello, la popular herramienta de gestión de proyectos. Permite a los robots conectarse directamente a la API de Trello para automatizar la creación y gestión de tableros, listas, tarjetas y miembros.

Gracias a esta integración, puedes incluir la administración de tus proyectos en flujos de trabajo más amplios. Por ejemplo, un robot puede crear automáticamente una tarjeta de Trello cuando llega un correo importante, o mover tareas entre listas basándose en el estado de un proceso en otro sistema, centralizando y automatizando la gestión de tareas.

📚 Descripción de los comandos

A continuación se detallan los comandos disponibles para la integración con Trello:

📋 Create Board

Crea un nuevo tablero en Trello.

Parámetro	Descripción	Ejemplo
Credential	Credencial de Trello necesaria para crear un tablero.	credential
Name	Nombre del tablero a crear.	My Board
Visibility	Visibilidad del tablero. El valor por defecto es privado.	Private, Public or Organization
Assign result to variable	Variable donde se almacenará el resultado.	{“board”:{“id”:”67db340daf9e65aq8D765dcd”,”name”:”My Test Board”,”privacy”:”public”,”url”:”https//[suspicious link removed]”}}

🔍 Get a Board

Obtiene un tablero de Trello por su ID.

Parámetro	Descripción	Ejemplo
Credential	Credencial de Trello necesaria para obtener un tablero.	credential
Board ID	ID del tablero que se desea obtener.	67db340daf9e65aq8D765dcd
Assign result to variable	Variable donde se almacenará el resultado.	{“board”:{“id”:”67db340daf9e65aq8D765dcd”,”name”:”My Test Board”,”privacy”:”public”,”url”:”https//[suspicious link removed]”}}

👤 Add Member to Board

Añade un miembro a un tablero en Trello.

Parámetro	Descripción	Ejemplo
Credential	Credencial de Trello necesaria para añadir un miembro.	credential
Board ID	ID del tablero al que se añadirá el miembro.	67db340daf9e65aq8D765dcd
Email Address	Correo electrónico del miembro a añadir.	johndoe@example.com
Tipo de Miembro	Tipo de miembro a añadir al tablero.	Admin, Normal or Observer
Full Name	Nombre completo del miembro a añadir.	John Doe
Assign result to variable	Variable donde se almacenará el resultado.	{“member”:{ “id”:”67dc1bdc6h2a1a3ca080d26f”,”username”:”johndoedoe”,”fullName”:”John Doe”,”email”:”johndoe@gmail.com”}}

➕ Create a List

Crea una nueva lista en un tablero de Trello.

Parámetro	Descripción	Ejemplo
Credential	Credencial de Trello necesaria para crear una lista.	credential
Board ID	ID del tablero donde se creará la lista.	67db340daf9e65aq8D765dcd
Name	Nombre de la lista a crear.	My List
Assign result to variable	Variable donde se almacenará el resultado.	{“list”:{“id”:”67qh684t1eec43cbfeb40d54″,”name”:”This List”,”boardId”:”67qh684t1eec43cbfeb40d54″}}

🔍 Get a List

Obtiene una lista de Trello por su ID.

Parámetro	Descripción	Ejemplo
Credential	Credencial de Trello necesaria para obtener una lista.	credential
List ID	ID de la lista que se desea obtener.	67db340daf9e65aq8D765dcd
Assign result to variable	Variable donde se almacenará el resultado.	{“list”:{“id”:”67dc561d4hfc23cbfeb40d54″,”name”:”This List”,”boardId”:”27sh65e5ghdba37739759cc2″,”cards”:{“openPerList”:{“status”:”ok”,”disableAt”:5000,”warnAt”:4000},”totalPerList”:{“status”:”ok”,”disableAt”:1000000,”warnAt”:800000}}}}

✉️ Create a Card

Crea una nueva tarjeta en una lista de Trello.

Parámetro	Descripción	Ejemplo
Credential	Credencial de Trello necesaria para crear una tarjeta.	credential
List ID	ID de la lista donde se creará la tarjeta.	67db340daf9e65aq8D765dcd
Name	Nombre de la tarjeta a crear.	My Card
Description	Descripción de la tarjeta a crear.	Description of the card
File path	Ruta a una imagen o archivo PDF local para adjuntar.	image.jpg
Assign result to variable	Variable donde se almacenará el resultado.	{“card”:{“id”:”67dh31fft258410468a83021″,”name”:”Other Card”,”desc”:”Card description”,”listId”:”67dc214hbffc42cbfeb40d54″,”attachment”:null}}

🔍 Get a Card

Obtiene una tarjeta de Trello por su ID.

Parámetro	Descripción	Ejemplo
Credential	Credencial de Trello necesaria para obtener una tarjeta.	credential
Card ID	ID de la tarjeta que se desea obtener.	67db340daf9e65aq8D765dcd
Assign result to variable	Variable donde se almacenará el resultado.	{“card”:{“id”:”67dh31fft258410468a83021″,”name”:”Other Card”,”desc”:”Card description”,”listId”:”67dc214hbffc42cbfeb40d54″,”attachment”:[]}}

🧪 Ejemplo de uso

Flujo de soporte técnico: Automatizar la creación de una nueva tarjeta en el tablero de “Soporte” cada vez que se recibe un correo con el asunto “Incidencia”.
Sincronización de proyectos: Leer un archivo de Excel con hitos de un proyecto y usar los comandos para crear un tablero, listas y tarjetas correspondientes en Trello.
Gestión de equipos: Añadir automáticamente a un nuevo empleado al tablero de “Onboarding” cuando su perfil es creado en el sistema de RRHH.
Reporte de avances: Usar los comandos “Get a List” y “Get a Card” para leer el estado de todas las tareas en un tablero y generar un informe de progreso que se envía por correo.

🧩 Requisitos

Tener una cuenta de Trello.
Generar las credenciales desde tu cuenta de Trello (API Key y Token). Este par de valores se utilizará para la credencial en Saturn Studio.
Conocer los IDs de los tableros, listas o tarjetas con los que se desea interactuar para los comandos que así lo requieran.
Asegurarse de que la cuenta de Trello asociada a las credenciales tenga los permisos adecuados para realizar las acciones deseadas (ej: permiso para crear tableros, añadir miembros, etc.).