Trello Card Component

Trello Card Component conecta tu flujo con tu cuenta de Trello para trabajar con tarjetas: crear una tarjeta nueva en una lista, consultar los datos de una tarjeta o todas las tarjetas de una lista, cambiar el nombre y la descripción de una tarjeta o eliminarla.

Es útil cuando las tareas nacen fuera de Trello, por ejemplo en un formulario, un correo o una conversación con un agente de IA, y quieres que aparezcan en tu tablero sin copiarlas a mano.

Cuándo usarlo

Cada solicitud que llega por un formulario de tu web debe convertirse en una tarjeta en la lista “Pendiente”.
Quieres un resumen diario con las tarjetas de una lista concreta.
Un agente de IA atiende peticiones del equipo y necesita crear o consultar tarjetas por sí mismo.
Un proceso termina en otro sistema y quieres eliminar la tarjeta que lo representaba.

Configuración

Necesitas una credencial Trello Task API con el token y la clave de API de tu cuenta de Trello. Consulta Credenciales.

Campo	Qué hace
Credential (obligatorio)	La credencial Trello Task API con la que se accede a tu cuenta.
Operation	Lo que hace el componente. Ver Operaciones. Por defecto, `Create`.
List ID (obligatorio)	El identificador de la lista. Solo en `Create` (lista donde se crea la tarjeta) y `Read All` (lista cuyas tarjetas quieres traer).
Card Id (obligatorio)	El identificador de la tarjeta. Solo en `Read`, `Update` y `Delete`.
Card Name (obligatorio)	El nombre de la tarjeta. Solo en `Create` y `Update`.
Card Description (obligatorio)	La descripción de la tarjeta. Solo en `Create` y `Update`.

Operaciones

Operación	Qué hace
`Create`	Crea una tarjeta nueva con el nombre y la descripción indicados en la lista elegida.
`Read`	Trae los datos de una tarjeta.
`Read All`	Trae todas las tarjetas de una lista.
`Update`	Cambia el nombre de una tarjeta y, si lo rellenas, su descripción.
`Delete`	Elimina la tarjeta de forma definitiva.

Resultado

La salida Data devuelve la tarjeta con la que has trabajado tal como la guarda Trello: su identificador, nombre, descripción, lista a la que pertenece y enlace, entre otros datos. Con Read All sale un elemento por cada tarjeta de la lista. Delete devuelve una confirmación.

Puedes conectar el resultado a un componente de correo o de mensajería para avisar al equipo, o a un agente para que lo use en su respuesta. El componente también se puede conectar a un Agente como herramienta, para que el agente decida cuándo crear o consultar tarjetas. Ver Tool Mode.

Ejemplo

Una agencia quiere que cada petición de su formulario de contacto se convierta en una tarjeta.

El formulario llega al flujo con el nombre del cliente y su mensaje.
Añade Trello Card Component con la operación Create.
En List ID pon el identificador de la lista “Nuevas peticiones”, en Card Name el nombre del cliente y en Card Description su mensaje.

Buenas prácticas

Para leer, cambiar o eliminar una tarjeta necesitas su identificador. Guárdalo cuando la crees, o consúltalo con Read All sobre su lista.
Delete no se puede deshacer. Si solo quieres sacar la tarjeta de la vista, muévela o archívala desde Trello.

Componentes relacionados

Trello Attachment Component: enlaces adjuntos a una tarjeta.