Saltearse al contenido
Nappai Documentation

Trello List Component

El Trello List Component te permite crear, leer, actualizar y eliminar listas dentro de un tablero de Trello directamente desde tu flujo de trabajo en Nappai. Con él puedes automatizar tareas como mover tarjetas a nuevas listas, crear listas nuevas cuando cambie el estado de un proyecto, o borrar listas que ya no se usan.

¿Cómo funciona?

El componente se conecta a la API de Trello usando un token OAuth y una clave de API que ya debes haber guardado en la sección de credenciales de Nappai. Cuando seleccionas una operación, el componente envía la solicitud correspondiente a Trello y devuelve los datos recibidos. Si el componente se usa como herramienta de un agente, también expone una salida “Tool” que el agente puede invocar.

Operaciones

Este componente ofrece varias operaciones que puedes seleccionar según lo que necesites hacer. Solo puedes usar una operación a la vez:

  • Create: Crea una nueva lista dentro del tablero especificado.
  • Read: Obtiene los detalles de una lista existente.
  • Read All: Recupera todas las listas de un tablero.
  • Update: Modifica el nombre de una lista existente.
  • Delete: Elimina una lista del tablero.

Para usar el componente, primero selecciona la operación que necesitas en el campo Operation (Operación).

Entradas

Modo de Mapeo (Mapping Mode)

Este componente cuenta con un modo especial llamado “Mapping Mode” (Modo de Mapeo). Cuando activas este modo mediante el interruptor, se habilita una entrada adicional llamada Mapping Data y cada campo de entrada te ofrece tres formas diferentes de proporcionar datos:

  • Fixed (Fijo): Escribes el valor directamente en el campo.
  • Mapped (Mapeado): Conectas la salida de otro componente para usar su resultado como valor.
  • Javascript: Escribes código Javascript para calcular el valor dinámicamente.

Esta flexibilidad te permite crear flujos de trabajo más dinámicos y conectados.

Campos de Entrada

Los siguientes campos están disponibles para configurar este componente. Cada campo puede estar visible en diferentes operaciones:

  • Operation: Selecciona la acción que quieres ejecutar.

    • Visible en: Create, Read, Read All, Update, Delete

  • Board ID: Identificador del tablero donde se gestionará la lista.

    • Visible en: Create, Read All

  • List Id: Identificador de la lista que quieres leer, actualizar o borrar.

    • Visible en: Read, Update, Delete

  • List Name: Nombre de la lista que se creará o actualizará.

    • Visible en: Create, Read, Update

  • Mapping Mode: Habilita el modo de mapeo para procesar varios registros a la vez.

    • Visible en: Create, Read, Read All, Update, Delete

  • Tool Name: Nombre que aparecerá ante el agente cuando el componente se use como herramienta.

    • Visible en: Create, Read, Read All, Update, Delete

  • Tool Description: Descripción detallada de la herramienta para que el agente sepa cuándo usarla.

    • Visible en: Create, Read, Read All, Update, Delete

  • Tools arguments metadata: Metadatos que describen los argumentos que la herramienta acepta.

    • Visible en: Create, Read, Read All, Update, Delete

  • Credential: Selecciona la credencial Trello Task API que ya has configurado en Nappai.

    • Visible en: Create, Read, Read All, Update, Delete

Nota sobre credenciales

  1. Ve a la sección de credenciales de Nappai y crea una nueva credencial llamada Trello Task API.
  2. Proporciona el Trello Oauth token y el Trello Api Key que obtuviste desde la página de desarrolladores de Trello.
  3. En el componente, selecciona esa credencial en el campo Credential.

Salidas

  • Data: Devuelve los datos recibidos de Trello (por ejemplo, la información de la lista creada o leída).
  • Tool: Cuando el componente se usa como herramienta, expone una salida de tipo Tool que el agente puede invocar.

Ejemplo de Uso

Supongamos que quieres crear una nueva lista llamada “En revisión” en el tablero con ID abcd1234.

  1. Arrastra el Trello List Component al flujo.
  2. Selecciona Operation → Create.
  3. En Board ID escribe abcd1234.
  4. En List Name escribe En revisión.
  5. Asegúrate de haber seleccionado la credencial Trello Task API en el campo Credential.
  6. Ejecuta el flujo.
    El componente devolverá en la salida Data un objeto con la información de la lista recién creada, que puedes usar en pasos posteriores (por ejemplo, para mover tarjetas a esa lista).

Componentes Relacionados

  • Trello Board Component – Gestiona tableros de Trello (crear, leer, actualizar, borrar).
  • Trello Card Component – Gestiona tarjetas dentro de listas (crear, leer, actualizar, borrar).

Consejos y Mejores Prácticas

  • Reutiliza credenciales: Crea una sola credencial Trello Task API y úsala en todos los componentes que necesiten acceder a Trello.
  • Usa Mapping Mode cuando necesites procesar varias listas a la vez (por ejemplo, crear una lista por cada proyecto).
  • Controla los errores: Si la API devuelve un error, el flujo se detendrá; considera agregar un bloque de manejo de errores para registrar el problema.
  • Limita los permisos: Si solo necesitas leer listas, configura la credencial con permisos de solo lectura para mayor seguridad.

Consideraciones de Seguridad

  • Los tokens OAuth y las claves de API se guardan como secretos en Nappai; no los expongas en el flujo.
  • Evita compartir la salida Data que contiene información sensible de Trello con usuarios que no necesiten verla.
  • Si usas el componente como herramienta de un agente, revisa que el agente solo tenga acceso a las herramientas que realmente necesita.