Saltearse al contenido
Nappai Documentation

Google Gmail Label

El componente Google Gmail Label te permite gestionar las etiquetas de tu cuenta de Gmail directamente desde el dashboard de Nappai. Con él puedes crear nuevas etiquetas, borrar las existentes o consultar la lista de etiquetas disponibles, todo sin salir de la plataforma.

¿Cómo funciona?

El componente se conecta a la API de Gmail de Google. Para ello necesita una credencial de tipo GMail que ya debe haber sido configurada en la sección de credenciales de Nappai. Cuando el componente se ejecuta, envía la solicitud correspondiente a la API (crear, borrar o obtener) y devuelve los resultados en formato de datos que pueden ser usados por otros componentes o por un agente de IA.

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 Label: Crea una nueva etiqueta en tu cuenta de Gmail con el nombre que especifiques.
  • Delete Label: Elimina una etiqueta existente usando su ID.
  • Get Label: Recupera la información de una etiqueta específica por su ID o, si el campo está vacío, devuelve todas las etiquetas de la cuenta.

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 Label, Delete Label o Get Label).

    • Visible en: Create Label, Delete Label, Get Label

  • Label Id: Identificador de la etiqueta que quieres borrar o consultar. Si lo dejas vacío en la operación Get Label, se devolverán todas las etiquetas.

    • Visible en: Delete Label, Get Label

  • Label Name: Nombre de la etiqueta que quieres crear.

    • Visible en: Create Label

  • Mapping Mode: Habilita el modo de mapeo para procesar varios registros en lote.

    • Visible en: Create Label, Delete Label, Get Label

  • Tool Name: Nombre del instrumento que se mostrará al agente cuando el componente se use como herramienta.

    • Visible en: Create Label, Delete Label, Get Label

  • Tool Description: Descripción detallada de lo que hace esta herramienta para que el agente la entienda.

    • Visible en: Create Label, Delete Label, Get Label

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

    • Visible en: Create Label, Delete Label, Get Label

Nota: Para usar este componente, primero debes configurar una credencial GMail en la sección de credenciales de Nappai y luego seleccionarla en el campo Credential del componente.

Salidas

  • Data: Resultado de la operación (por ejemplo, la lista de etiquetas o la confirmación de que se creó o borró una etiqueta). Se devuelve como un objeto de datos que puede ser conectado a otros componentes.
  • Tool: Representación de la herramienta que puede ser utilizada por un agente de IA. Permite que el agente invoque la operación directamente desde su flujo de trabajo.

Ejemplo de Uso

Crear una etiqueta

  1. Arrastra el componente Google Gmail Label al flujo de trabajo.
  2. En el campo Operation, selecciona Create Label.
  3. En Label Name, escribe el nombre de la etiqueta que deseas crear, por ejemplo, Proyecto X.
  4. Asegúrate de que la credencial GMail esté seleccionada.
  5. Ejecuta el flujo.
  6. La salida Data mostrará el ID y los detalles de la etiqueta recién creada.

Obtener todas las etiquetas

  1. Arrastra el componente al flujo.
  2. Selecciona Get Label en el campo Operation.
  3. Deja el campo Label Id vacío.
  4. Ejecuta el flujo.
  5. La salida Data contendrá una lista con todas las etiquetas de tu cuenta de Gmail.

Componentes Relacionados

  • Gmail Message Component – Gestiona los correos electrónicos en Gmail.
  • Gmail Thread Component – Trabaja con hilos de conversación en Gmail.
  • Google Drive Component – Accede a archivos y carpetas en Google Drive (útil si necesitas adjuntar archivos a correos).

Consejos y Mejores Prácticas

  • Reutiliza etiquetas: Crea una etiqueta una sola vez y reutilízala en varios flujos para mantener la consistencia.
  • Usa Mapping Mode: Cuando necesites procesar varias etiquetas a la vez, activa el modo de mapeo y conecta la salida de otro componente para pasar los IDs de forma dinámica.
  • Controla los permisos: Asegúrate de que la credencial GMail tenga los scopes necesarios (https://www.googleapis.com/auth/gmail.labels) para evitar errores de autorización.
  • Manejo de errores: Captura la salida Data y verifica si contiene un mensaje de error antes de continuar con el flujo.

Consideraciones de Seguridad

  • La credencial GMail contiene datos sensibles (Client Id, Client Secret). Guárdala en la sección de credenciales de Nappai y no la compartas públicamente.
  • Los tokens de acceso se renuevan automáticamente, pero revisa periódicamente los permisos concedidos a la aplicación en Google Cloud Console.
  • Evita exponer la salida Data que contiene IDs de etiquetas en logs públicos o en interfaces accesibles a usuarios no autorizados.