Gmail

Descripcion

Modulo para operaciones completas de Gmail: listar, enviar, responder, borradores y gestion de emails. Incluye multiples sub-nodos para diferentes operaciones.

Requisitos

Credencial Google OAuth configurada con permisos de Gmail (gmail.modify o gmail.compose)

Sub-nodos disponibles

1. List Emails

Lista emails de la bandeja de entrada con filtros opcionales.

Campo	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Cuenta Google OAuth
maxResults	number	No	Cantidad maxima de emails (1-100). Default: 10
labelIds	select	No	Carpeta/etiqueta: Inbox, Sent, Drafts, Spam, etc.
query	text	No	Filtro de busqueda Gmail
includeBody	boolean	No	Incluir cuerpo completo del email. Default: false

Ejemplos de filtros (query):

from:user@gmail.com — emails de un remitente
is:unread — solo no leidos
subject:factura — con “factura” en el asunto
is:unread from:banco@mail.com — combinar filtros
has:attachment — con adjuntos
after:2024/01/01 before:2024/12/31 — rango de fechas

Salida:

{
  "emails": [
    {
      "id": "18abc123",
      "threadId": "18abc120",
      "from": "Juan <juan@gmail.com>",
      "to": "yo@gmail.com",
      "subject": "Factura Enero",
      "date": "Mon, 15 Jan 2024 10:30:00 +0000",
      "snippet": "Adjunto la factura...",
      "body": "Texto completo del email...",
      "htmlBody": "<html>...</html>",
      "isUnread": true
    }
  ]
}

2. List Unread Emails

Atajo para listar solo emails no leidos (pre-configura is:unread e includeBody: true).

Campo	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Cuenta Google OAuth
maxResults	number	No	Cantidad maxima. Default: 10
query	text	No	Filtro adicional (ya incluye `is:unread`)
includeBody	boolean	No	Incluir cuerpo completo. Default: true

3. Get Email

Obtiene un email especifico por su ID con todos los detalles.

Campo	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Cuenta Google OAuth
messageId	text	No	ID del email (directo o `{{id}}`)
messageIdKey	text	No	Campo con el ID. Default: `id`
format	select	No	Formato: Completo, Solo metadatos, Minimo

4. Send Email

Envia un email con soporte para adjuntos, CC, BCC y formato HTML.

Campo	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Cuenta Google OAuth
to	text	Si	Destinatario(s) separados por coma
subject	text	Si	Asunto del email
body	rich_text	Si	Cuerpo del mensaje (HTML por defecto)
attachments	textarea	No	Rutas de archivos adjuntos

Formato de adjuntos:

Una ruta por linea: /path/to/file.pdf
Variable con array: {{attachments}}
Separados por coma: /path/file1.pdf, /path/file2.xlsx

Salida:

{
  "sentEmail": {
    "id": "18abc456",
    "threadId": "18abc456",
    "labelIds": ["SENT"],
    "attachmentCount": 2
  }
}

5. Reply Email

Responde a un email existente manteniendo el hilo de conversacion.

Campo	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Cuenta Google OAuth
originalMessageId	text	No	ID del email original (directo o `{{id}}`)
originalMessageIdKey	text	No	Campo con el ID original. Default: `originalMessageId`
replyBody	textarea	Si	Contenido de la respuesta
isHtml	boolean	No	El cuerpo es HTML. Default: false

Flujo tipico:

[List Unread] -> [Iterator] -> [AI Agent responde] -> [Reply Email]
                  cada email     genera respuesta     {{id}} del email original

6. Create Draft

Crea un borrador de email en Gmail sin enviarlo.

Campo	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Cuenta Google OAuth
to	text	Si	Destinatario(s)
subject	text	Si	Asunto
body	textarea	Si	Cuerpo del mensaje
isHtml	boolean	No	El cuerpo es HTML. Default: false

7. List Labels

Lista todas las etiquetas/carpetas de Gmail (INBOX, SENT, custom labels, etc.).

Campo	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Cuenta Google OAuth

8. Mark as Read

Marca un email como leido o como no leido.

Campo	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Cuenta Google OAuth
messageId	text	No	ID del email (directo o `{{id}}`)
messageIdKey	text	No	Campo con el ID. Default: `messageId`
markAsRead	select	No	Marcar como leido / no leido. Default: leido

9. Trash Email

Mueve un email a la papelera de Gmail.

Campo	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Cuenta Google OAuth
messageId	text	No	ID del email (directo o `{{id}}`)
messageIdKey	text	No	Campo con el ID. Default: `messageId`

Ejemplo de Uso

Auto-responder emails no leidos

[Trigger cron cada 5min] -> [List Unread] -> [Iterator] -> [AI Agent] -> [Reply Email] -> [Mark as Read]

Crear borrador para revision

[HTTP Trigger] -> [Create Draft] -> [Notificar por Slack]
   datos del formulario    borrador listo para revisar

Procesar adjuntos

[List Emails query:"has:attachment"] -> [Get Email] -> [Procesar adjunto] -> [Upload to Drive]

Notas

Errores comunes

Error	Causa	Solucion
`Se requiere destinatario (to)`	Campo “Para” vacio	Rellena el destinatario
`Se requiere asunto (subject)`	Campo “Asunto” vacio	Rellena el asunto
`Se requiere originalMessageId`	No se indico que email responder	Pasa el ID con `{{id}}` de un nodo anterior
`Se requiere messageId`	No se indico que email marcar/eliminar	Pasa el ID del email
`Insufficient Permission`	La cuenta no tiene permisos de Gmail	Reconecta la cuenta con permisos de Gmail

Nodos Relacionados

Google Calendar - Gestionar eventos de calendario
Google Drive - Gestionar archivos en Drive
Google Sheets - Operar con hojas de calculo