El email sigue siendo la columna vertebral de la comunicación empresarial, y automatizarlo puede ahorrar horas cada semana. La integración de Gmail de n8n cubre todo el ciclo de vida del email: recibir y filtrar el correo entrante, enviar mensajes salientes, etiquetar, archivar e incluso combinar Gmail con IA para un manejo inteligente del correo electrónico.
Esta guía lo guía a través de la configuración completa, desde las credenciales de OAuth hasta los patrones de flujo de trabajo avanzados, incluidos los respondedores automáticos impulsados por IA y los correos electrónicos de resumen diario.
Omita la configuración y describa su automatización de Gmail en Scriflow para obtener un JSON de n8n listo para importar en segundos.
Configuración de las credenciales de OAuth de Gmail
Gmail requiere autenticación OAuth2. Aquí está el proceso de configuración completo:
1. Crea un proyecto de Google Cloud
- Ve a console.cloud.google.com y crea un nuevo proyecto (o selecciona uno existente).
- Navega a APIs & Services → Library y habilita la Gmail API.
- Ve a APIs & Services → OAuth consent screen.
- Elige el tipo de usuario External y completa el nombre de la aplicación (por ejemplo, "n8n Gmail Bot") y tu correo electrónico.
- Agrega el alcance
https://mail.google.com/(acceso completo a Gmail) o alcances más específicos según sea necesario. - Agrega tu propio correo electrónico como un Test User (obligatorio mientras la aplicación está en modo de prueba).
2. Crea credenciales de OAuth2
- Ve a Credentials → Create Credentials → OAuth 2.0 Client ID.
- Selecciona Web Application como el tipo de aplicación.
- Agrega la URL de devolución de llamada de OAuth de n8n como un URI de redireccionamiento autorizado:
https://your-n8n-instance.com/rest/oauth2-credential/callback - Copia el Client ID y el Client Secret.
3. Configura en n8n
- En n8n, ve a Credentials → New → Gmail OAuth2 API.
- Ingresa tu Client ID y Client Secret.
- Haz clic en Connect y sigue el flujo de autorización de Google.
- Otorga los permisos solicitados: n8n almacenará el token de forma segura.
Para las cuentas de Google Workspace (anteriormente G Suite), usa un tipo de pantalla de consentimiento OAuth Internal. No necesitarás agregar usuarios de prueba y la aplicación no requerirá la verificación de Google.
Nodo de activación de Gmail
El nodo Gmail Trigger sondea tu bandeja de entrada en busca de nuevos mensajes que coincidan con tus criterios. Así es como construyes flujos de trabajo de correo electrónico reactivos:
Eventos de activación disponibles
| Evento | Se activa cuando | Ideal para |
|---|---|---|
| Email Received | Llega un nuevo correo electrónico a la bandeja de entrada (o etiqueta) | Tickets de soporte, formularios de contacto, confirmaciones de pedidos |
| Label Added | Se aplica una etiqueta a un correo electrónico | Activar flujos de trabajo desde los propios filtros/reglas de Gmail |
Campos de salida del activador
Cada correo electrónico activado produce un objeto JSON enriquecido que puedes usar en los nodos posteriores:
Filtrado de correos electrónicos por remitente y asunto
No todos los correos electrónicos deben activar la misma acción. Usa nodos IF después del activador para enrutar diferentes correos electrónicos a través de diferentes rutas:
Filtrar por dominio del remitente
Filtrar por palabras clave del asunto
Usar el filtrado de etiquetas nativo de Gmail
Un enfoque más limpio: crea Filtros de Gmail en la configuración de Gmail para aplicar automáticamente etiquetas a los correos electrónicos. Luego, configura tu activador n8n para que solo se active en los correos electrónicos con esa etiqueta específica. Esto mueve la lógica de filtrado a Gmail, donde pertenece, manteniendo limpio tu flujo de trabajo n8n.
Acciones del nodo Gmail
El nodo Gmail admite todas las operaciones de correo electrónico principales:
from:boss@company.com has:attachment).Enviar correos electrónicos con n8n
La operación Send Email es sencilla pero tiene opciones importantes:
Enviar con archivos adjuntos
Adjunta archivos de nodos anteriores (por ejemplo, un PDF generado por un nodo Code o un archivo descargado a través de HTTP Request):
Flujo de trabajo de respuesta automática
Una automatización clásica de Gmail: reconoce automáticamente los correos electrónicos de soporte entrantes mientras un humano los revisa.
Estructura del flujo de trabajo
- Gmail Trigger: escucha los correos electrónicos con la etiqueta "Support".
- IF Node: excluye las respuestas automáticas (verificar:
$json.fromno contiene "noreply" y$json.subjectno comienza con "Re:"). - Gmail → Reply: envía el acuse de recibo usando el
threadIdoriginal. - Gmail → Add Label: aplica la etiqueta "Auto-Replied" para rastrear los correos electrónicos procesados.
- Slack: notifica al equipo de soporte con los detalles del correo electrónico.
Flujo de trabajo de resumen diario de correo electrónico
Agrega correos electrónicos importantes en un solo resumen diario, ideal para monitorear boletines, alertas o informes.
- Schedule Trigger: se ejecuta a las 7 AM todos los días de la semana.
- Gmail → Get Many Messages: busca correos electrónicos de las últimas 24 horas que coincidan con una consulta.
- Code Node: formatea los correos electrónicos en una tabla de resumen HTML.
- Gmail → Send Email: envía el resumen a tu correo electrónico personal o de equipo.
Patrón de reenvío y procesamiento
Reenvía los correos electrónicos entrantes a otro servicio mientras los procesas en paralelo:
- Gmail Trigger: llega un nuevo correo electrónico.
- Set Node: extrae el cuerpo del correo electrónico y los archivos adjuntos.
- Dos ramas paralelas:
- Rama A: Reenvía el correo electrónico original a una bandeja de entrada del equipo usando la operación Send de Gmail.
- Rama B: Guarda los detalles del correo electrónico en Airtable/Google Sheets para el registro y el análisis.
Combinación de Gmail con IA para un manejo inteligente del correo electrónico
Aquí es donde la integración de Gmail de n8n se vuelve realmente poderosa. Al enrutar los correos electrónicos a través de un modelo de IA, puedes crear respuestas automatizadas conscientes del contexto:
Flujo de trabajo de soporte al cliente de IA
- Gmail Trigger: nuevo correo electrónico en la etiqueta "Support".
- IF Node: filtra las respuestas automáticas y el spam.
- HTTP Request → OpenAI: envía el asunto y el cuerpo del correo electrónico a GPT-4o con un mensaje del sistema que define la personalidad del agente de soporte y tu conocimiento del producto.
- IF Node: verifica la puntuación de confianza de la IA (si el modelo indica que no puede responder con confianza, enruta a un humano).
- Gmail → Reply (rama verdadera): envía la respuesta generada por la IA.
- Slack (rama falsa): notifica a un agente humano para que se haga cargo.
Consejos para evitar los filtros de spam
Cuando envíes correos electrónicos automatizados a través de Gmail, sigue estas prácticas recomendadas para garantizar la capacidad de entrega:
- Personaliza cada correo electrónico: Incluye el nombre del destinatario en el asunto o el cuerpo. Los correos electrónicos masivos genéricos activan los filtros de spam.
- Evita las palabras desencadenantes de spam: Palabras como "¡GRATIS!", "URGENTE", "GARANTIZADO" y el uso excesivo de mayúsculas o signos de exclamación reducen la capacidad de entrega.
- Envía desde una dirección calentada: No uses una cuenta de Gmail nueva para la automatización masiva. Usa una dirección establecida con un historial de actividad de correo electrónico real.
- Respeta los encabezados de respuesta: Establece una dirección de respuesta válida para que los destinatarios (y los filtros de spam) puedan ver que el correo electrónico es legítimo.
- Agrega enlaces para cancelar la suscripción: Para cualquier automatización adyacente al marketing, incluye una forma para que los destinatarios opten por no participar. Los algoritmos de Gmail recompensan esto.
- Limita la velocidad de tus envíos: La API de Gmail tiene una cuota de ~500 correos electrónicos por día para las cuentas normales. Usa un nodo Wait entre los envíos si procesas grandes lotes.
- Alternativa de texto sin formato: Siempre incluye versiones HTML y de texto sin formato. Algunos filtros de spam penalizan los correos electrónicos solo HTML.
Cuentas estándar de Gmail: ~500 correos electrónicos/día a través de la API. Cuentas de Google Workspace: hasta 2000 correos electrónicos/día. Para volúmenes más altos, usa un servicio de correo electrónico transaccional dedicado (SendGrid, Mailgun, Postmark) a través del nodo HTTP Request en su lugar.
Preguntas Frecuentes
$json.from no contiene "noreply", "no-reply", "donotreply"; (2) $json.subject no comienza con "Re:", "Fwd:", "Automatic reply"; y (3) $json.labelIds no incluye "SENT". Esto detecta la mayoría de los escenarios de respuesta automática.