Gmail Message

Gmail Message conecta tu flujo con tu buzón de Gmail para trabajar con correos sueltos: enviar un correo nuevo (o guardarlo como borrador), leer los últimos correos de una etiqueta, responder a un correo, cambiar sus etiquetas, marcarlo como leído o no leído y eliminarlo.

Es útil cuando el correo forma parte de un proceso: avisos que se envían solos, correos de clientes que un agente de IA lee y responde, o facturas que llegan por correo y hay que procesar.

Cuándo usarlo

Quieres enviar a un cliente un correo de confirmación, con un documento adjunto, al final de un flujo.
Cada mañana quieres leer los correos sin leer de la bandeja de entrada y que un agente los resuma.
Un agente de IA atiende consultas por correo y necesita responder en el mismo hilo.
Quieres archivar o etiquetar los correos de un proveedor después de procesarlos.
Necesitas descargar los adjuntos de los correos que llegan con facturas y extraer su texto.

Configuración

Necesitas una credencial Google Gmail, que se conecta iniciando sesión con tu cuenta de Google. Para enviar, responder, etiquetar, marcar o eliminar correos, la credencial debe tener el acceso Create, Update, Delete, Read; con Read Only solo puedes leer. Consulta Credenciales.

Campo	Qué hace
Credential (obligatorio)	La credencial Google Gmail de la cuenta con la que trabajas.
Operation	Lo que hace el componente. Ver Operaciones. Por defecto, `Send Message`.
Recipient	Solo en `Send Message`. La dirección de correo del destinatario. Obligatorio.
Subject	Solo en `Send Message`. El asunto del correo. Obligatorio.
Body	Solo en `Send Message`. El texto del correo. Obligatorio. Si lo escribes en HTML, el correo se envía con formato.
Attachments	Solo en `Send Message`. Los archivos que se adjuntan. Conecta aquí un componente que entregue archivos, o un enlace a un archivo.
Save as draft.	Solo en `Send Message`. Si lo activas, el correo se guarda en Borradores en lugar de enviarse.
Email Id.	El identificador del correo con el que trabajas. Obligatorio en `Reply Message`, `Update Message Label`, `Realize Message Marks` y `Delete Message`. En `Get Message` es opcional: si lo rellenas, solo devuelve ese correo.
Reply Text	Solo en `Reply Message`. El texto de la respuesta. Obligatorio.
Number of Emails to read	Solo en `Get Message`. Cuántos correos leer, empezando por los más recientes. Por defecto, 10.
Labels	En `Get Message`, la etiqueta de la que se leen los correos (por ejemplo `INBOX` para la bandeja de entrada). En `Update Message Label`, las etiquetas que se añaden, se quitan o se ponen. La lista se carga con las etiquetas de tu cuenta al elegir la credencial.
Select Action	Solo en `Update Message Label`. `Add` añade las etiquetas elegidas, `Remove` las quita y `Replace` quita todas las que tiene el correo y pone solo las elegidas. Por defecto, `Add`.
Select Mark	Solo en `Realize Message Marks`. `Read` marca el correo como leído y `Unread` como no leído. Por defecto, `Read`.

Operaciones

Operación	Qué hace
`Send Message`	Envía un correo nuevo, o lo guarda como borrador si activas Save as draft.
`Get Message`	Lee los últimos correos de una etiqueta, con su texto, remitente, destinatarios, asunto y fecha.
`Reply Message`	Responde al remitente de un correo, dentro del mismo hilo y con el asunto precedido de `Re:`.
`Update Message Label`	Añade, quita o sustituye las etiquetas de un correo.
`Realize Message Marks`	Marca un correo como leído o como no leído.
`Delete Message`	Elimina un correo de forma definitiva, sin pasar por la papelera.

Opciones avanzadas

Solo en Get Message:

Campo	Qué hace
Query	Filtra los correos con la misma búsqueda que usarías en Gmail, por ejemplo `from:facturas@proveedor.com`, `is:unread` o `has:attachment`.
Fetch Attachments	Descarga los adjuntos de los correos leídos. Por defecto, desactivado.
Process Attachments	Requiere Fetch Attachments. Extrae el texto de los adjuntos, por ejemplo de un PDF o de un documento de Word. Por defecto, desactivado.
Enable OCR	Requiere Fetch Attachments. Lee el texto que aparece en las imágenes adjuntas, por ejemplo una foto de un tique. Por defecto, desactivado.

Resultado

La salida Data depende de la operación:

En Get Message, un elemento por cada correo, con el texto del correo, el remitente (sender), los destinatarios (to y cc), el asunto (subject), la fecha en formato día/mes/año, el identificador del correo (id) y de su hilo (thread_id), un resumen corto (snippet), sus etiquetas y, si los has pedido, los adjuntos.
En Send Message, los datos del correo enviado o del borrador, con su identificador.
En Reply Message, Update Message Label y Realize Message Marks, los datos del correo después del cambio.
En Delete Message, una confirmación.

Puedes conectar el resultado a un agente de IA para que resuma o responda los correos, o a otro componente que guarde los datos, por ejemplo en una hoja de cálculo. El componente también se puede conectar a un Agente como herramienta, para que el agente decida cuándo leer o enviar correos. Ver Tool Mode.

Ejemplo

Una academia quiere enviar el horario a cada alumno que se matricula.

El formulario de matrícula llega al flujo con el nombre y el correo del alumno.
Añade Gmail Message con la operación Send Message.
En Recipient pon el correo del alumno, en Subject Tu horario de clases y en Body un saludo con su nombre.
Conecta a Attachments el componente que entrega el PDF con el horario.
Ejecuta el flujo con una matrícula de prueba y comprueba que el correo llega.

Buenas prácticas

El texto del correo que devuelve Get Message sale de la versión en texto sin formato. Si un correo solo tiene versión con formato, el texto puede llegar vacío; el resumen corto (snippet) llega siempre.
En Get Message, Email Id. solo encuentra el correo si está entre los que se leen con Number of Emails to read, Labels y Query. Si buscas uno antiguo, amplía la búsqueda.
Replace en Select Action también quita la etiqueta INBOX, así que el correo sale de la bandeja de entrada. Usa Add o Remove si solo quieres cambiar una etiqueta.
Delete Message no se puede deshacer. Si prefieres poder recuperar el correo, usa la operación Trash Thread de Gmail Thread.

Componentes relacionados

Gmail Thread: trabajar con conversaciones completas.
Gmail Label: crear y eliminar etiquetas.
Gmail Webhook: iniciar un flujo cuando llega un correo.