Módulo 2: Gmail y Email

Etiquetar y Organizar Correos

Descripción de la cápsula

Hasta ahora tus workflows leen y envían correos. Esta cápsula añade la tercera capacidad: organizar la bandeja. Aplicar etiquetas, quitarlas, marcar como leído, archivar.

Puede parecer lo menos glamoroso del módulo — "poner etiquetas" no suena a automatización poderosa. Pero es justo lo contrario: la organización es lo que hace que las automatizaciones de email sean confiables. Una etiqueta processed es lo que evita que un correo se responda dos veces (el problema de la cápsula 04). Una etiqueta urgent aplicada automáticamente es lo que hace que el equipo vea lo importante primero. Archivar lo resuelto es lo que mantiene la bandeja como un panel de "lo que falta" en vez de un pozo sin fondo.

En esta cápsula aprendes a usar las etiquetas como estado: marcas del workflow sobre los correos que le dicen "esto ya lo vi", "esto es de este tipo", "esto ya está hecho".

Lo que vas a aprender

Al terminar esta cápsula serás capaz de:

✅ Aplicar y quitar etiquetas a correos desde un workflow
✅ Marcar correos como leídos / no leídos
✅ Archivar correos para sacarlos de la bandeja
✅ Usar etiquetas como "estado" para evitar el doble procesamiento
✅ Diseñar un sistema de etiquetas para tus automatizaciones
✅ Combinar etiquetado con búsqueda y trigger en un ciclo coherente

Las operaciones de organización del nodo Gmail

El nodo Gmail, con Resource: Message, ofrece operaciones más allá de enviar y buscar:

Operación	Qué hace
Add Label	Aplica una o más etiquetas a un correo
Remove Label	Quita una o más etiquetas
Mark as Read	Marca el correo como leído
Mark as Unread	Marca el correo como no leído
(Archivar)	Sacar el correo de la bandeja de entrada (quitar la etiqueta `INBOX`)

Todas operan sobre un correo identificado por su id — el identificador único que viste en la cápsula 04.

En Gmail, "archivar" no es una operación con su propio botón en el nodo: archivar = quitar la etiqueta INBOX. El correo sigue existiendo y se puede buscar, pero ya no está en la bandeja de entrada. Es Remove Label con la etiqueta INBOX.

Aplicar una etiqueta

Configuración:

Resource: Message
Operation: Add Label
Message ID: {{ $json.id }} — el correo a etiquetar (viene del trigger o de Get Many)
Label Names or IDs: la etiqueta a aplicar

Las etiquetas deben existir en tu Gmail antes de aplicarlas. Créalas a mano en Gmail (menú lateral → Crear etiqueta nueva), o n8n tiene una operación de Label para crearlas por workflow. Para empezar, créalas a mano.

Etiquetas vs carpetas

Si vienes de Outlook: en Gmail las etiquetas no son carpetas. Un correo puede tener varias etiquetas a la vez (client, urgent, processed) y sigue siendo un solo correo. Esto es una ventaja: puedes marcar un correo con múltiples "estados" sin moverlo de lugar.

Las etiquetas como "estado"

Aquí está la idea central de la cápsula. Una etiqueta no es solo organización visual — es una marca de estado que el workflow puede leer y escribir.

El ciclo de vida de un correo procesado

Correo llega
   │
   ▼
Gmail Trigger lo captura (filtro: -label:processed)
   │
   ▼
El workflow lo procesa (clasifica, registra, responde...)
   │
   ▼
Gmail: Add Label "processed"   ← marca de estado: "esto ya está hecho"

El truco está en el filtro del trigger: -label:processed. El trigger solo dispara con correos que no tienen la etiqueta processed. Y al final, el workflow se la pone. Resultado: cada correo se procesa exactamente una vez, sin importar cuántas veces se ejecute el workflow ni si lo estás probando.

Esto resuelve el problema de doble procesamiento de la cápsula 04 — de forma robusta y visible (puedes ver en Gmail qué correos ya pasaron por el workflow).

Etiquetas de clasificación

Más allá de processed, las etiquetas pueden registrar qué tipo de correo es:

El workflow lee el asunto/cuerpo, decide que es una queja → Add Label "complaint"
Decide que es una consulta de ventas → Add Label "sales"
Decide que es urgente → Add Label "urgent"

Y como un correo puede tener varias etiquetas, uno puede ser sales + urgent + processed a la vez. El equipo abre Gmail, filtra por label:urgent y ve lo prioritario al instante — sin que nadie clasifique a mano.

Marcar como leído y archivar

Mark as Read

Útil cuando el workflow ya "atendió" un correo y no quieres que aparezca como pendiente para el humano:

Operation: Mark as Read
Message ID: {{ $json.id }}

Caso típico: un correo automático (una notificación de un sistema) que el workflow procesa — no tiene sentido que un humano lo vea como "no leído", el workflow ya hizo lo necesario.

Archivar (Remove Label: INBOX)

Operation: Remove Label
Message ID: {{ $json.id }}
Label: INBOX

Saca el correo de la bandeja. Caso típico: correos que el workflow resuelve completamente y que nadie necesita volver a ver — quedan archivados, buscables, pero fuera del camino.

Cuidado al archivar. Archivar correos automáticamente es potente pero arriesgado: si el workflow se equivoca, el humano nunca ve un correo que sí importaba. Empieza por solo etiquetar. Archiva automáticamente solo cuando confíes plenamente en que el workflow clasifica bien.

Diseñar un sistema de etiquetas

Para que las etiquetas automáticas no se vuelvan un caos, decide un esquema antes de empezar:

Tipo de etiqueta	Ejemplos	Propósito
Estado de proceso	`processed`, `pending-review`	Control del workflow (evitar doble proceso)
Clasificación	`sales`, `support`, `complaint`, `invoice`	De qué trata el correo
Prioridad	`urgent`, `can-wait`	Qué atender primero

Recomendaciones:

Prefijo para las del workflow: algo como auto/processed, auto/sales deja claro que las puso una automatización y no se mezclan con las manuales.
Pocas y claras: 5-8 etiquetas bien definidas funcionan mejor que 30 que nadie recuerda.
Documenta el esquema: si el equipo comparte la bandeja, que todos sepan qué significa cada etiqueta.

Trampas comunes

Trampa 1: Aplicar una etiqueta que no existe

Qué pasa: El workflow intenta Add Label "processed" pero esa etiqueta no existe en Gmail → error.

Cómo evitar: Crea las etiquetas en Gmail antes de usarlas en el workflow. O usa la operación de crear etiqueta una vez.

Trampa 2: Olvidar marcar como procesado

Qué pasa: El workflow procesa el correo pero no le pone la etiqueta processed. En la siguiente ejecución (o al probar) lo vuelve a procesar.

Cómo evitar: El Add Label "processed" debe ser el último paso del workflow, en todas las ramas. Si el correo se procesó, se marca — sin excepción.

Trampa 3: Archivar demasiado pronto en producción

Qué pasa: Confías en un workflow nuevo y le pones a archivar automáticamente. Clasifica mal un correo importante, lo archiva, nadie lo ve. Cliente molesto.

Cómo evitar: Empieza por solo etiquetar. Observa unas semanas que el workflow clasifica bien. Solo entonces, archivar automáticamente.

Trampa 4: Confundir etiquetas con carpetas

Qué pasa: Vienes de Outlook y crees que poner una etiqueta "mueve" el correo. Esperas que Add Label "sales" lo saque de la bandeja.

Cómo evitar: Etiqueta = marca, no movimiento. El correo sigue en la bandeja y tiene la etiqueta. Para sacarlo de la bandeja, hay que archivar (Remove Label INBOX) explícitamente.

Trampa 5: El Message ID equivocado

Qué pasa: Aplicas la etiqueta usando un ID que no es el del correo correcto (apuntaste al threadId en vez del id, o a un ID de otro nodo).

Cómo evitar: El id del mensaje identifica un correo concreto; el threadId identifica la conversación completa. Para etiquetar un correo, usa {{ $json.id }} del correo correcto.

Ejercicio: el ciclo completo de procesamiento

Objetivo: construir el patrón "trigger → procesar → marcar como procesado" que evita el doble proceso.

Preparación

Crea en Gmail una etiqueta llamada auto/processed.

Tu tarea

Construye un workflow: Gmail Trigger → Set → Gmail (Add Label)
- Gmail Trigger: filtro Search subject:[TICKET] -label:auto/processed
- Set: captura sender = {{ $json.from }}, subject = {{ $json.subject }} (simula "procesar")
- Gmail Add Label: Message ID {{ $json.id }}, etiqueta auto/processed
Activa el workflow
Mándate un correo con asunto [TICKET] prueba
Espera ~1 minuto: el workflow dispara, "procesa" y le pone auto/processed
Clave: verifica que el workflow no vuelve a dispararse con ese correo — el filtro -label:auto/processed ya lo excluye

Checklist de éxito:

El correo recibió la etiqueta auto/processed
El workflow disparó una sola vez para ese correo
Un segundo correo [TICKET] sin la etiqueta sí dispara — el filtro funciona en ambos sentidos

Resumen y siguiente paso

El nodo Gmail organiza la bandeja: Add/Remove Label, Mark as Read/Unread, archivar
En Gmail, archivar = quitar la etiqueta INBOX; las etiquetas no son carpetas — un correo puede tener varias
La idea central: usar etiquetas como estado — processed evita el doble procesamiento, las de clasificación registran de qué trata el correo
El patrón clave: trigger con filtro -label:processed → procesar → Add Label "processed" como último paso
Diseña un esquema de etiquetas antes de empezar: estado, clasificación, prioridad — pocas, claras, con prefijo
Archivar automáticamente es arriesgado: empieza solo etiquetando, archiva solo cuando confíes en la clasificación
5 trampas: etiqueta inexistente, olvidar marcar procesado, archivar muy pronto, confundir etiquetas con carpetas, Message ID equivocado

Antes de avanzar deberías poder:

Aplicar y quitar etiquetas desde un workflow
Explicar cómo una etiqueta processed evita el doble procesamiento
Diseñar un esquema básico de etiquetas para automatizaciones

Lo que sigue (cápsula 07):

Tienes todas las piezas: enviar, recibir, buscar, etiquetar. La cápsula 07 cubre lo que sale mal en producción y no es de lógica: correos que caen en spam, límites de envío de Gmail, threading de conversaciones, y permisos. El manual de troubleshooting de Gmail.

Recursos adicionales

n8n Gmail node Docs - Operaciones de etiquetas y estado.
Gmail: crear y usar etiquetas - Cómo funcionan las etiquetas en Gmail.
Gmail labels vs folders - Por qué las etiquetas no son carpetas.

Creado: Mayo 14, 2026 Versión: 1.0

← AnteriorBuscar y Filtrar Correos Siguiente →Troubleshooting de Gmail