Saltearse al contenido
Nappai Documentation

Trello Board Component

El Trello Board Component te permite crear, leer, actualizar y eliminar tableros en Trello directamente desde el dashboard de Nappai. Con una sola configuración puedes automatizar tareas que involucren tableros de Trello, integrando la API de Trello de forma sencilla y segura.

¿Cómo funciona?

El componente se conecta a la API de Trello usando un token OAuth y una clave de API que el usuario debe haber guardado previamente en la sección de credenciales de Nappai bajo el nombre Trello Task API. Cuando seleccionas una operación, el componente envía la solicitud correspondiente a la API de Trello y devuelve la respuesta como un objeto Data. Si el componente se usa como herramienta (tool), también expone un objeto Tool que puede ser llamado por los agentes de IA de Nappai.

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 un nuevo tablero en Trello con el nombre especificado.
  • Read: Obtiene la información de un tablero existente usando su ID.
  • Read All: Recupera la lista de todos los tableros del usuario.
  • Update: Cambia el nombre de un tablero existente usando su ID.
  • Delete: Elimina un tablero existente usando su ID.

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 realizar con el tablero.

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

  • Board ID: El identificador único del tablero en Trello. Se necesita para leer, actualizar o eliminar un tablero.

    • Visible en: Read, Update, Delete

  • Board Name: El nombre que tendrá el tablero al crearlo o actualizarlo.

    • Visible en: Create, Update

  • Mapping Mode: Habilita el modo de mapeo para procesar múltiples registros en lote.

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

  • Tool Name: El nombre que se mostrará al agente cuando el componente se utilice como herramienta.

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

  • Tool Description: Una descripción detallada de lo que hace esta herramienta, útil para que el agente la elija correctamente.

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

  • Tools arguments metadata: Define la metadata de los argumentos que la herramienta recibirá.

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

  • Credential: Selecciona la credencial previamente configurada Trello Task API que contiene el token OAuth y la clave de API.

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

Nota: Los campos de credencial (Trello Oauth token, Trello Api Key) no aparecen aquí porque ya están incluidos en la credencial seleccionada.

Salidas

  • Data: Devuelve la respuesta de la API de Trello como un objeto Data. Puedes usar esta salida para pasar la información a otros componentes o para mostrarla en el dashboard.
  • Tool: Si el componente se usa como herramienta, expone un objeto Tool que puede ser llamado por los agentes de IA de Nappai.

Ejemplo de Uso

Supongamos que quieres crear un nuevo tablero llamado “Proyecto X” y luego leer su información:

  1. Crear Tablero

    • Selecciona la operación Create.
    • Ingresa el nombre del tablero en Board Name.
    • Selecciona la credencial Trello Task API.
    • Ejecuta el componente.
    • La salida Data contendrá el ID del nuevo tablero.

  2. Leer Tablero

    • Copia el Board ID obtenido en el paso anterior.
    • Cambia la operación a Read.
    • Pega el ID en el campo Board ID.
    • Ejecuta el componente.
    • La salida Data mostrará los detalles del tablero.

Componentes Relacionados

  • TrelloCardComponent – Gestiona tarjetas dentro de un tablero.
  • TrelloListComponent – Gestiona listas dentro de un tablero.

Consejos y Mejores Prácticas

  • Reutiliza credenciales: Configura la credencial Trello Task API una sola vez y selecciónala en cada componente que la necesite.
  • Usa Mapping Mode: Cuando necesites procesar varios tableros a la vez (por ejemplo, crear varios tableros en lote), activa Mapping Mode y conecta la entrada “Mapping Data” a la salida de otro componente que genere la lista de nombres.
  • Maneja errores: Si la operación falla, revisa la respuesta en la salida Data; la API de Trello devuelve mensajes claros de error.

Consideraciones de Seguridad

  • Protege tus credenciales: La credencial Trello Task API almacena tu token OAuth y clave de API. No compartas la credencial ni la exportes a entornos públicos.
  • Limita permisos: Cuando crees la credencial en Trello, asigna solo los permisos necesarios (por ejemplo, solo lectura o solo escritura) según la operación que vas a usar.
  • Revisa logs: Nappai registra las llamadas a la API; revisa los logs para detectar accesos inesperados.