Saltearse al contenido
Nappai Documentation

Trello Comment Component

El Trello Comment Component te permite crear, leer, actualizar y eliminar comentarios en tarjetas de Trello directamente desde tu dashboard de Nappai. Conecta este componente a tus flujos de trabajo y automatiza la gestión de comentarios sin salir de la plataforma.

¿Cómo funciona?

El componente se comunica con la API de Trello mediante un objeto TrelloApi. Cuando seleccionas una operación, el componente envía la solicitud correspondiente (POST, GET, PUT o DELETE) usando el token OAuth y la clave API que has configurado en la credencial Trello Task API. Los resultados se devuelven como objetos Data, que pueden ser usados por otros componentes o por el agente 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: Añade un nuevo comentario a la tarjeta especificada.
  • Read All: Recupera todos los comentarios de la tarjeta.
  • Update: Modifica el contenido de un comentario existente.
  • Delete: Elimina un comentario de la 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

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 (Create, Read All, Update o Delete).

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

  • Card ID: Identificador de la tarjeta de Trello donde se gestionará el comentario.

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

  • Comment Body: Texto del comentario que quieres crear o actualizar.

    • Visible en: Create, Update

  • Comment ID: Identificador del comentario que quieres actualizar o eliminar.

    • Visible en: Update, Delete

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

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

  • Tool Name: Nombre del tool que se mostrará al agente cuando este componente esté conectado como herramienta.

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

  • Tool Description: Descripción detallada de lo que hace el tool, útil para que el agente lo elija correctamente.

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

  • Tools arguments metadata: Metadatos de los argumentos que el tool acepta.

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

Credencial requerida
Este componente necesita una credencial de tipo Trello Task API.

  1. Ve a la sección de credenciales de Nappai y crea una nueva credencial llamada Trello Task API.
  2. Obtén un OAuth APP token y una API Key de Trello (puedes seguir la guía oficial de Trello).
  3. Selecciona esa credencial en el campo Credential del componente.

Salidas

  • Data: Devuelve la información resultante de la operación (por ejemplo, el comentario creado, la lista de comentarios, o el estado de éxito).
  • Tool: Si el componente está conectado como herramienta, devuelve la representación del tool para que el agente lo utilice.

Ejemplo de Uso

Supongamos que quieres añadir un comentario a una tarjeta existente:

  1. Operation: Selecciona Create.
  2. Card ID: Introduce el ID de la tarjeta (por ejemplo, 5f8d2c3a9b1e2a4d5c6f7g8h).
  3. Comment Body: Escribe el texto del comentario (por ejemplo, ¡Revisado!).
  4. Credential: Selecciona la credencial Trello Task API que configuraste.
  5. Ejecuta el flujo.
    El componente enviará una solicitud POST a la API de Trello y devolverá un objeto Data con el comentario creado, que puedes usar en pasos posteriores (por ejemplo, enviar una notificación o registrar la acción en un log).

Componentes Relacionados

  • Trello API Component – Permite realizar otras operaciones básicas con Trello (crear tarjetas, mover listas, etc.).
  • Trello Board Component – Gestiona tableros y listas dentro de Trello.

Consejos y Mejores Prácticas

  • Usa Mapping Mode cuando necesites procesar varios comentarios a la vez (por ejemplo, al migrar datos de otro sistema).
  • Guarda los IDs de tarjetas y comentarios en una base de datos para facilitar actualizaciones futuras.
  • Prueba la operación Read All antes de actualizar o eliminar para asegurarte de que estás apuntando al comentario correcto.
  • Maneja los errores: si la API devuelve un error, revisa que el token y la clave estén correctos y que la tarjeta exista.

Consideraciones de Seguridad

  • La credencial Trello Task API almacena tu token OAuth y API Key encriptados dentro de Nappai.
  • No compartas el ID de la tarjeta ni el contenido del comentario en logs públicos.
  • Asegúrate de que solo usuarios autorizados tengan acceso a la credencial y al componente.