Gmail — Get email by ID

Gmail — Get email by ID

Tipo: gmail-get-email  ·  Paquete: Gmail v1.0.4  ·  Salida: Dictionary<string,object>

Trae un correo completo a partir de su ID: cuerpo (texto y HTML), cabeceras (remitente, destinatarios, asunto, fecha) e información de adjuntos. Úsala cuando Get emails te dio la lista sin cuerpo y ahora necesitas el contenido de uno concreto.

Cómo funciona

Opera sobre la sesión creada con Gmail — Connect. Pásala en el parámetro session, o coloca esta actividad dentro del body de Gmail — Connect para heredarla automáticamente.

El id es el que viene en cada elemento de la lista de Get emails (clave id) o el que devuelven Send, Reply y Forward. Solo lee: no marca el correo como leído.

El cuerpo se arma recorriendo las partes del mensaje: toma la primera parte de texto plano y la primera HTML. Si el correo solo trae HTML, body contiene ese HTML sin etiquetas, útil para buscar texto o pasarlo a AI Extract.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
id	string	—	ID del mensaje (de Get emails).

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
session	ZoanGmailSession	—	Sesión de Gmail — Connect (se hereda dentro del body).

Salida

Devuelve un Dictionary<string,object> con las mismas claves que cada elemento de Get emails con includeBody activado:

Clave	Tipo	Contenido
id, threadId	string	ID del mensaje y de su conversación.
from, to, cc, subject, date	string	Cabeceras tal cual (cc es null si no hay).
snippet	string	Fragmento del inicio del mensaje.
labels	List<string>	IDs de las etiquetas del correo.
unread	bool	true si está sin leer.
body	string	Texto plano; si solo hay HTML, el HTML sin etiquetas; "" si no hay cuerpo.
bodyHtml	string	Cuerpo HTML, o null.
attachments	List<Dictionary>	Un elemento por adjunto: filename, mimeType, size (bytes), attachmentId. Lista vacía si no hay.

La lista attachments describe los adjuntos pero no los descarga; para guardarlos usa Download attachments.

Errores comunes

Mensaje	Causa y solución
'id' es obligatorio.	id está vacío o la expresión devolvió null.
Requested entity was not found.	No hay un correo con ese ID en el buzón (se eliminó, o el ID es de otro buzón).
No hay una sesión de Gmail disponible. …	No pasaste session y la actividad no está dentro del body de Connect.

Ejemplo

Gmail — Connect   credential = credential("gmail-soporte")
 └─ body:
      Gmail — Get emails   query = "is:unread subject:pedido"   → output: nuevos
      For each   item in nuevos
       └─ Gmail — Get email by ID   id = item["id"]   → output: correo
          AI Extract   prompt = str(correo["body"])   schema = …   → output: pedido
          Gmail — Download attachments   id = correo["id"]   folder = "C:\pedidos"   → output: archivos

Actividades relacionadas

• Gmail — Get emails — obtener la lista y sus IDs.
• Gmail — Reply — responder al correo.
• Gmail — Download attachments — guardar sus adjuntos.
• Todas las actividades de Gmail