Saltearse al contenido
Nappai Documentation

Trello Card Component

El Trello Card Component te permite crear, leer, actualizar y eliminar tarjetas en Trello sin salir de tu panel de Nappai. Con él puedes automatizar tareas que involucren la gestión de tarjetas, como mover tareas entre listas, actualizar descripciones o borrar tarjetas completadas.

¿Cómo funciona?

El componente se conecta a la API de Trello mediante un objeto TrelloApi que recibe tu token OAuth y tu clave de API. Cuando seleccionas una operación (Create, Read, etc.), el componente llama al método correspondiente de la API y devuelve los datos de la tarjeta o un mensaje de éxito. Si activas el Mapping Mode, puedes procesar varios registros a la vez, enviando una lista de datos y obteniendo una lista de resultados.

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 tarjeta en la lista especificada.
  • Read: Obtiene los detalles de una tarjeta existente.
  • Read All: Recupera todas las tarjetas de una lista.
  • Update: Modifica el nombre y la descripción de una tarjeta existente.
  • Delete: Elimina una tarjeta.

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

Nota: Este componente requiere una credencial Trello Task API que debe seleccionarse en el campo Credential del componente. Primero configura la credencial en la sección de credenciales de Nappai y luego elígela aquí.

  • Operation: Selecciona la acción que quieres realizar con la tarjeta.
    • Visible en: Create, Read, Read All, Update, Delete
  • Card Description: Texto que aparecerá en la descripción de la tarjeta.
    • Visible en: Create, Update
  • Card Id: Identificador único de la tarjeta que quieres leer, actualizar o borrar.
    • Visible en: Read, Update, Delete
  • Card Name: Nombre de la tarjeta.
    • Visible en: Create, Update
  • List ID: Identificador de la lista donde se creará la tarjeta o de la que se leerán todas las tarjetas.
    • Visible en: Create, Read All
  • Mapping Mode: Habilita el modo de mapeo para procesar múltiples registros.
    • Visible en: Create, Read, Read All, Update, Delete
  • Tool Name: Nombre del asistente de IA que usará este componente cuando se conecte como herramienta.
    • Visible en: Create, Read, Read All, Update, Delete
  • Tool Description: Descripción detallada de lo que hace esta herramienta.
    • Visible en: Create, Read, Read All, Update, Delete
  • Tools arguments metadata: Metadatos de los argumentos que la herramienta acepta.
    • Visible en: Create, Read, Read All, Update, Delete

Salidas

  • Data: Devuelve la información de la tarjeta o la lista de tarjetas, según la operación. Se puede usar en otros componentes o en la salida de un asistente.
  • Tool: Permite que el componente actúe como una herramienta que un agente de IA puede invocar.

Ejemplo de Uso

Supongamos que quieres crear una nueva tarjeta llamada “Revisar informe” con la descripción “Revisar el informe trimestral antes del viernes” en la lista cuyo ID es 5f3a2b1c.

  1. Arrastra el Trello Card Component al lienzo.
  2. En el campo Operation, selecciona Create.
  3. Introduce el List ID (5f3a2b1c).
  4. Escribe “Revisar informe” en Card Name y la descripción en Card Description.
  5. Asegúrate de haber seleccionado la credencial Trello Task API en el campo Credential.
  6. Ejecuta el flujo.
    El componente devolverá un objeto Data con los detalles de la tarjeta recién creada, que puedes usar en pasos posteriores, por ejemplo, para enviar una notificación o actualizar otra base de datos.

Plantillas

(Esta sección se omite porque no hay plantillas que utilicen este componente.)

Componentes Relacionados

  • Trello Board Component – Gestiona tableros completos en Trello.
  • Trello List Component – Manipula listas dentro de un tablero.

Consejos y Mejores Prácticas

  • Revisa los IDs: Asegúrate de copiar correctamente los IDs de listas y tarjetas; un error simple puede provocar que la operación falle.
  • Usa Mapping Mode: Si necesitas crear o actualizar varias tarjetas a la vez, activa Mapping Mode y conecta una fuente de datos (por ejemplo, un CSV) para procesar todo en lote.
  • Controla los permisos: La credencial OAuth debe tener permisos de escritura si vas a crear, actualizar o borrar tarjetas.
  • Prueba en modo de prueba: Antes de ejecutar en producción, prueba la operación con una tarjeta de prueba para confirmar que todo funciona como esperas.

Consideraciones de Seguridad

  • Protege tu credencial: La credencial Trello Task API contiene tu token OAuth y clave de API. No la compartas públicamente y almacénala en la sección de credenciales de Nappai, donde está protegida.
  • Limita los permisos: Si solo necesitas leer tarjetas, crea una credencial con permisos de solo lectura para minimizar riesgos.
  • Monitorea el uso: Revisa los logs de Nappai para detectar cualquier operación inesperada o fallos de autenticación.