Saltearse al contenido
Nappai Documentation

Google Gmail Message

Interact with Google Gmail messages.
Este componente te permite enviar, leer, actualizar, eliminar y marcar correos electrónicos directamente desde tu cuenta de Gmail, así como responder a mensajes y gestionar etiquetas. Todo se hace a través de la API oficial de Gmail, lo que garantiza que tus datos se manejen de forma segura y conforme a las políticas de Google.

¿Cómo funciona?

El componente se conecta a la API de Gmail mediante una credencial de tipo GMail que debes configurar previamente en Nappai. Cuando seleccionas una operación, el componente construye la solicitud correspondiente (por ejemplo, messages.send para enviar un correo o messages.get para leer uno) y la envía a Gmail. Los resultados se devuelven como datos estructurados que pueden ser usados en otros componentes o como herramientas para agentes de IA.

  • Envío de correos: Se crea un mensaje MIME con asunto, cuerpo, destinatario y, opcionalmente, archivos adjuntos. Los archivos se suben usando el componente Binary y se adjuntan al mensaje.
  • Lectura de correos: Se recuperan los mensajes según filtros (etiquetas, consulta, número de correos). Si se habilita la descarga de adjuntos, se descargan y se pueden procesar con OCR o extracción de texto.
  • Actualización de etiquetas: Se reemplaza la lista de etiquetas del mensaje, manteniendo las etiquetas de borrador y enviado.
  • Eliminación y respuesta: Se eliminan o se envía una respuesta al mensaje original.
  • Marcado de mensajes: Se aplica un “mark” (etiqueta) predefinida al mensaje.

El componente también soporta Mapping Mode, que permite procesar varios registros de datos en lote, conectando salidas de otros componentes o usando valores fijos o expresiones JavaScript.

Operaciones

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

  • Send Message: Envía un correo electrónico nuevo o como borrador.
  • Get Message: Recupera uno o varios correos electrónicos, con opciones de filtrado y descarga de adjuntos.
  • Update Message Label: Cambia las etiquetas de un correo, reemplazando las existentes salvo las de borrador y enviado.
  • Delete Message: Elimina un correo de tu bandeja.
  • Reply Message: Envía una respuesta al correo especificado.
  • Realize Message Marks: Aplica una etiqueta (mark) predefinida al mensaje.

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:

  • Attachments: Archivos que se adjuntarán al correo. Se usan con el componente Binary para subir los archivos.

    • Visible en: Send Message

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

    • Visible en: Send Message, Get Message, Update Message Label, Delete Message, Reply Message, Realize Message Marks

  • Body: Texto que se usará como cuerpo del correo.

    • Visible en: Send Message

  • Save as draft.: Guarda el correo como borrador en lugar de enviarlo.

    • Visible en: Send Message

  • Enable OCR: Requiere Fetch Attachments y Process Attachments. Si está activado, extrae texto de imágenes adjuntas (PNG, JPG).

    • Visible en: Get Message

  • Fetch Attachments: Descarga los archivos adjuntos encontrados en los correos. Si está desactivado, los adjuntos se ignoran. Es obligatorio para procesar adjuntos.

    • Visible en: Get Message

  • Labels: Etiquetas para filtrar correos. En la operación de actualización, las etiquetas anteriores se reemplazan excepto las de borrador y enviado.

    • Visible en: Get Message, Update Message Label

  • Email Id.: Identificador del correo. Si no se proporciona en Get Message, se devolverán todos los correos.

    • Visible en: Get Message, Update Message Label, Delete Message, Reply Message, Realize Message Marks

  • Select Mark: Selecciona la etiqueta (mark) que quieres aplicar al mensaje.

    • Visible en: Realize Message Marks

  • Number of Emails to read: Cantidad de correos a leer. Si se deja vacío, se leerán 10 correos por defecto.

    • Visible en: Get Message

  • Process Attachments: Requiere Fetch Attachments. Si está activado, intenta extraer texto de los adjuntos descargados (PDF, DOCX).

    • Visible en: Get Message

  • Query: Consulta para filtrar correos. Se usa en Get Message para leer solo los correos que contengan la consulta.

    • Visible en: Get Message

  • Recipient: Dirección de correo del destinatario.

    • Visible en: Send Message

  • Reply Text: Texto que se enviará como respuesta al correo.

    • Visible en: Reply Message

  • Subject: Asunto que se usará en el correo.

    • Visible en: Send Message

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

    • Visible en: Send Message, Get Message, Update Message Label, Delete Message, Reply Message, Realize Message Marks

  • Tool Description: Descripción detallada de lo que hace la herramienta.

    • Visible en: Send Message, Get Message, Update Message Label, Delete Message, Reply Message, Realize Message Marks

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

    • Visible en: Send Message, Get Message, Update Message Label, Delete Message, Reply Message, Realize Message Marks

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

    • Visible en: Send Message, Get Message, Update Message Label, Delete Message, Reply Message, Realize Message Marks

Nota: El campo Credential (credencial de Gmail) es obligatorio pero no se muestra en la lista de entradas. Configúralo en la sección de credenciales de Nappai antes de usar el componente.

Salidas

  • Data: Resultado de la operación (por ejemplo, el ID del correo enviado, los datos del correo leído, etc.).
  • Tool: Representación de la herramienta que puede ser usada por agentes de IA.

Ejemplo de Uso

Enviar un correo con adjunto

  1. Configura la credencial: Ve a Credenciales → Agregar credencial → selecciona GMail y completa el Client Id, Client Secret y acceso a Google Drive.
  2. Arrastra el componente Google Gmail Message al flujo.
  3. En el campo Operation, elige Send Message.
  4. Completa los campos visibles:
    • Recipient: ejemplo@dominio.com
    • Subject: Informe mensual
    • Body: Adjunto encontrarás el informe del mes.
    • Attachments: Conecta la salida de un componente Binary que haya subido el archivo PDF.
    • Save as draft.: Desactivado (para enviar inmediatamente).
  5. Ejecuta el flujo.
  6. En la salida Data verás el ID del correo enviado y en Tool la herramienta lista para usar en agentes.

Leer correos con OCR

  1. Selecciona Get Message en el campo Operation.
  2. Marca Fetch Attachments y Process Attachments.
  3. Activa Enable OCR.
  4. Opcionalmente, define una Query (por ejemplo, subject: "Factura").
  5. Ejecuta el flujo.
  6. La salida Data incluirá los correos encontrados y, si se descargaron, el texto extraído de las imágenes adjuntas.

Componentes Relacionados

  • Binary Component: Se usa para subir archivos que se adjuntarán a los correos.
  • Google Drive Component: Permite acceder a archivos almacenados en Google Drive para usar como adjuntos.

Consejos y Mejores Prácticas

  • Usa etiquetas: Filtra correos con la entrada Labels para limitar la búsqueda y evitar leer correos irrelevantes.
  • Activa OCR solo cuando sea necesario: El procesamiento de OCR consume recursos y puede aumentar el tiempo de ejecución.
  • Gestiona los adjuntos: Si solo necesitas el texto, activa Process Attachments sin descargar los archivos completos.
  • Manejo de errores: Captura la salida Data y verifica si contiene errores antes de continuar con el flujo.
  • Seguridad: No compartas la credencial de Gmail en repositorios públicos; manténla en la sección de credenciales de Nappai.

Consideraciones de Seguridad

  • La credencial GMail debe configurarse con el mínimo de permisos necesarios (por ejemplo, solo acceso a Gmail y Drive si se usan adjuntos).
  • Los tokens de acceso se almacenan de forma segura en Nappai y no se exponen en los flujos.
  • Cuando uses Enable OCR, ten en cuenta que el contenido de las imágenes se envía a los servicios de Google para su procesamiento; asegúrate de que esto sea aceptable para tu política de privacidad.
  • Si compartes el flujo con otros usuarios, revisa que tengan los permisos adecuados para acceder a la credencial y a los datos de Gmail.