Integración Gmail n8nAutomatiza Gmail con n8n.

Coloca una o varias etiquetas existentes sobre un mensaje concreto. Es el archivado que haría una persona a mano.

• Message ID: el identificador de Gmail del mensaje, del tipo 172ce2c4a72cc243, que suele venir del nodo anterior con una expresión, la sintaxis {{ $json.id }} que recoge un campo del item de entrada.
• Label Names or IDs: elige las etiquetas en el desplegable, que se rellena desde la credencial, o pasa sus identificadores con una expresión.

Borra un mensaje de inmediato y para siempre. Gmail no lo manda a la papelera, lo elimina, y ninguna operación posterior lo recupera.

• Message ID: el identificador del mensaje que se elimina. Haz antes un Get con ese identificador si hay dudas de que exista, porque uno equivocado corta la ejecución con Bad request - please check your parameters.

Lee un mensaje y lo devuelve al flujo con sus cabeceras y, si lo pides, sus adjuntos.

• Message ID: el mensaje que se recupera.
• Simplify: activado, el nodo devuelve identificadores, etiquetas y las cabeceras From, To, CC, BCC y Subject; desactivado, la respuesta completa en bruto.
• Download Attachments: los archivos vuelven como propiedades binarias con el nombre de Attachment Prefix más un índice que empieza en 0, de modo que attachment_ produce attachment_0.

Lista mensajes y los filtra antes de que entren en el flujo. Es la operación de informes del nodo.

• Return All: activado, n8n recorre todas las páginas de la API; desactivado, Limit fija cuántos mensajes vuelven.
• Search: la sintaxis de la caja de búsqueda de Gmail, has:attachment por ejemplo.
• Received After y Received Before: un selector de fecha, o una expresión con una cadena en formato ISO o una marca de tiempo en milisegundos.
• Read Status, Sender, Label Names or IDs: los mismos filtros del disparador, aplicados cuando hacen falta.

Pasa un mensaje a leído sin que nadie abra Gmail. Su sitio está al final de una rama, como señal de que el flujo ya hizo su parte.

• Message ID: el mensaje que el flujo acaba de tratar.

Devuelve un mensaje a los no leídos, donde una persona lo verá. Es el reverso de la operación anterior, y existe para los casos que la automatización no debe cerrar.

• Message ID: el mensaje que vuelve a manos humanas.

Quita etiquetas de un mensaje. Sin esto, un buzón acaba lleno de marcas que describían una situación de hace dos pasos.

• Message ID: el mensaje que se limpia.
• Label Names or IDs: las etiquetas que se retiran, elegidas en la lista o pasadas como identificadores con una expresión.

Contesta dentro de la conversación existente, así que el hilo llega entero al destinatario.

• Message ID: el mensaje al que se responde.
• Email Type: Text o HTML, y Message lleva el cuerpo.
• Reply to Sender Only: activado, responde solo al remitente; desactivado, a toda la lista de destinatarios.
• Append n8n Attribution: activado por defecto, añade la frase que avisa de un envío automático con n8n. Conviene apagarlo en correo de cliente.

Sale del buzón conectado para escribir un correo nuevo, fuera de cualquier hilo existente.

• To: una dirección, o varias separadas por comas.
• Subject, Message y Email Type: el asunto, el cuerpo, y Text o HTML.
• Sender Name: el nombre que ven los destinatarios en su bandeja, que rara vez coincide con la dirección.
• CC, BCC, Send Replies To y Attachments: los añadidos de siempre, más los archivos tomados de un campo del item de entrada.

Manda un correo y deja la ejecución en pausa hasta que el destinatario responde. Así entra una decisión humana en una cadena por lo demás automática.

• Response Type: Approval, quien lee decide desde el propio mensaje; Free Text, respuesta libre a través de un formulario; Custom Form, un formulario que tú defines.
• Type of Approval: Approve Only, o Approve and Disapprove para dos botones.
• Limit Wait Time: pone tope al tiempo de espera antes de que la ejecución siga sola.

Crea una etiqueta en el buzón. En Gmail, la etiqueta hace el papel de la carpeta.

• Name: el nombre visible, invoices por ejemplo.
• Label List Visibility: Show, Hide o Show If Unread en la lista de etiquetas de la interfaz web de Gmail.
• Message List Visibility: Show o Hide para los mensajes con esa etiqueta en la lista de mensajes.

Elimina una etiqueta del buzón. Conviene mirarlo dos veces antes de ponerlo en una ejecución programada.

• Label ID: el identificador de la etiqueta, no el nombre que se ve en Gmail. Un Get Many de etiquetas da la correspondencia, y un identificador inexistente termina la ejecución con Bad request - please check your parameters.

Devuelve el detalle de una etiqueta. Operación pequeña, útil sobre todo como red de seguridad.

• Label ID: el identificador de la etiqueta que se consulta.

Lista las etiquetas del buzón con sus identificadores. Es el camino más corto hacia los valores que piden las demás operaciones de etiqueta.

• Return All: activado, vuelven todas las etiquetas; desactivado, Limit marca el máximo.

Escribe un correo en Borradores y se detiene. Nada sale del buzón hasta que una persona pulsa enviar, y eso lo convierte en la forma más prudente de automatizar una respuesta.

• Subject, Message y Email Type: el contenido del borrador, en Text o en HTML.
• To Email: opcional aquí, así que un borrador puede esperar sin destinatario.
• Thread ID: engancha el borrador a una conversación existente, del tipo 18cc573e2431878f.
• From Alias Name or ID: el alias desde el que saldrá el borrador.

Tira un borrador que el flujo ya no necesita. Es limpieza, pero evita que la carpeta Borradores se convierta en un cementerio.

• Draft ID: el identificador del borrador, con la forma r-3254521568507167962, que no tiene nada que ver con el de un mensaje.

Vuelve a leer un borrador, con adjuntos incluidos cuando el flujo los pide.

• Draft ID: el borrador que se recupera.
• Download Attachments: los archivos llegan como datos binarios, con el nombre de Attachment Prefix más un índice que arranca en 0.

Lista los borradores que duermen en el buzón, con la misma lógica de paginación que las operaciones de mensaje.

• Return All: activado, vuelven todos los borradores; desactivado, Limit corta la lista.
• Include Spam and Trash: activado, también cuentan los borradores guardados en Spam y Papelera.
• Download Attachments y Attachment Prefix: el mismo nombrado binario que en el Get individual.

La etiqueta que pones aquí cubre la conversación completa, no solo el último mensaje que llegó.

• Thread ID: el identificador de la conversación en Gmail, una cadena tipo 172ce2c4a72cc243, que suele llegar como {{ $json.threadId }} desde el nodo anterior.
• Label Names or IDs: eliges las etiquetas en la lista que n8n lee de la cuenta conectada, o pasas identificadores de etiqueta con una expresión cuando un paso previo ya decidió cuál toca.

¿Borrar de verdad? La conversación y todos sus mensajes se eliminan de forma inmediata y permanente, y no hay vuelta atrás. Si alguien puede necesitarlos después, la operación Trash es la adecuada.

• Thread ID: el identificador de la conversación sobre la que actúa el nodo. Un valor equivocado borra el hilo equivocado, así que conviene leerlo antes y pasarlo tal cual.

Leer una conversación devuelve sus mensajes en un solo item, y Simplify marca cuánto detalle entra en el flujo.

• Thread ID: el identificador de la conversación que se quiere recuperar.
• Simplify: activado por defecto, devuelve una versión simplificada en lugar de los datos en bruto, o sea identificadores de mensaje, etiquetas y las cabeceras From, To, CC, BCC y Subject. Desactívalo para la respuesta en bruto.
• Return Only Messages: dentro de Options, deja en la salida solo los mensajes del hilo.

Para trabajar sobre varias conversaciones a la vez, esta operación las lista y entrega un item por hilo.

• Return All y Limit: activo, Return All recorre las páginas de la API de Gmail hasta el final; desactivado, Limit fija cuántas conversaciones vuelven.
• Search: misma sintaxis que la caja de búsqueda de Gmail, por ejemplo has:attachment, así que una consulta ya probada a mano se reutiliza tal cual.
• Read Status: solo sin leer, solo leídas, o ambas.
• Received After y Received Before: dentro de una expresión, una fecha en formato ISO o una marca de tiempo en milisegundos.

Etiquetar sirve de poco si nadie limpia después. Esta operación quita etiquetas de una conversación cuando su estado cambia, y la vista filtrada de Gmail deja de acumular hilos ya cerrados.

• Thread ID: la conversación que pierde la etiqueta, normalmente la que acaba de traer el trigger.
• Label Names or IDs: las etiquetas que se retiran, elegidas en la lista o indicadas por identificador con una expresión; pueden salir varias a la vez.

La respuesta sale dentro de la conversación existente y no como un correo nuevo, que es lo que espera quien ya lleva varios mensajes intercambiados.

• Thread ID: la conversación a la que se engancha la respuesta.
• Email Type: Text o HTML, según lleve formato o no el cuerpo.
• Message: el cuerpo del correo, escrito en el editor de expresiones cuando mezcla texto fijo con datos de nodos anteriores.
• Reply to Sender Only: en Options, la respuesta va solo al remitente; Reply to Recipients Only la excluye, y CC, BCC, Sender Name y Attachments están en el mismo apartado.

La papelera saca la conversación y todos sus mensajes del buzón sin destruirlos, así que es la opción sensata cuando la regla de clasificación puede fallar.

• Thread ID: la conversación que pasa a la papelera, alimentada por cualquier paso anterior que devuelva un hilo.

A veces el filtro se pasa de listo y manda a la papelera un hilo que hacía falta. Esta operación lo recupera con todos sus mensajes y lo devuelve al buzón.

• Thread ID: el identificador del hilo que se restaura, guardado antes de mandarlo a la papelera.