Trello Board Component
Trello Board Component conecta tu flujo con tu cuenta de Trello para trabajar con tableros: crear un tablero nuevo, consultar los datos de un tablero o todos los tableros de tu cuenta, cambiar el nombre de un tablero o eliminarlo.
Es útil cuando cada proyecto, cliente o campaña tiene su propio tablero y quieres crearlo o localizarlo sin entrar en Trello.
Cuándo usarlo
- Cada cliente nuevo que se da de alta debe tener su propio tablero de trabajo.
- Quieres obtener la lista de tus tableros para que un agente sepa dónde buscar.
- Un proyecto cambia de nombre en tu sistema de gestión y quieres que el tablero también lo cambie.
- Un agente de IA atiende peticiones del equipo y necesita consultar o crear tableros por sí mismo.
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. |
| Board ID (obligatorio) | El identificador del tablero. Solo en Read, Update y Delete. |
| Board Name (obligatorio) | El nombre del tablero. Solo en Create (nombre del tablero nuevo) y Update (nombre nuevo). |
Operaciones
| Operación | Qué hace |
|---|---|
Create | Crea un tablero nuevo con el nombre indicado. |
Read | Trae los datos de un tablero. |
Read All | Trae todos los tableros de la cuenta de la credencial. |
Update | Cambia el nombre de un tablero. |
Delete | Elimina el tablero de forma definitiva. |
Resultado
La salida Data devuelve el tablero con el que has trabajado tal como lo guarda Trello: su identificador, nombre y enlace, entre otros datos. Con Read All sale un elemento por cada tablero. Delete devuelve una confirmación.
El componente también se puede conectar a un Agente como herramienta, para que el agente decida cuándo crear o consultar tableros. Ver Tool Mode.
Ejemplo
Una agencia de marketing abre un tablero por cada cliente que firma.
- El flujo recibe el nombre del cliente desde el formulario de alta.
- Añade Trello Board Component con la operación
Create. - En Board Name pon el nombre del cliente, por ejemplo
Cliente - Panadería Ruiz. - Conecta el resultado a un Trello List Component con la operación
Createy el identificador del tablero nuevo en Board ID para crear las listas de trabajo.
Buenas prácticas
- Para leer, renombrar o eliminar un tablero necesitas su identificador. Guárdalo al crearlo o búscalo con
Read All. Deleteno se puede deshacer y se lleva todas las listas y tarjetas del tablero. Si solo quieres dejar de verlo, ciérralo desde Trello.
Componentes relacionados
- Trello List Component: las listas de un tablero.
- Trello Card Component: las tarjetas.
- Trello Webhook: arranca un flujo cuando cambia algo en Trello.