Gmail — Forward

Gmail — Forward

Tipo: gmail-forward  ·  Paquete: Gmail v1.0.4  ·  Salida: string

Reenvía un correo existente a otras personas, como el botón Reenviar de Gmail: incluye el mensaje original con sus datos (remitente, fecha, asunto, destinatarios) y, por defecto, sus adjuntos. Puedes añadir un comentario encima y adjuntar archivos extra.

Sirve para derivar un correo al área que corresponde: una factura a contabilidad, una queja a servicio al cliente, una solicitud al responsable de aprobarla.

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.

1. Trae el correo indicado en id (de Get emails) completo, con sus adjuntos.
2. Arma el reenvío: tu comentario (body), debajo un bloque ---------- Forwarded message --------- con los datos del mensaje original (From, Date, Subject, To) y su contenido. El asunto lleva el prefijo Fwd: (si ya lo tenía, no se repite).
3. Si el original tiene HTML o activas isHtml, el reenvío va en HTML; si no, en texto plano. Cuando va en HTML con isHtml = false, tu comentario se trata como texto: se escapa y sus saltos de línea se conservan.
4. Añade los adjuntos originales (salvo que desactives includeAttachments) y los de attachments.
5. Lo envía desde la cuenta de la sesión, dentro del mismo hilo del correo original, y devuelve el ID del mensaje enviado.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
id	string	—	ID del correo a reenviar.
to	string | List	—	Destinatario(s): texto con las direcciones separadas por comas o punto y coma, o una lista de direcciones.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
session	ZoanGmailSession	—	Sesión de Gmail — Connect (se hereda dentro del body).
cc	string | List	—	Destinatario(s) en copia: texto separado por comas o punto y coma, o una lista.
bcc	string | List	—	Destinatario(s) en copia oculta: texto separado por comas o punto y coma, o una lista.
body	string	""	Comentario que va encima del mensaje reenviado.
isHtml	bool	false	Si es true, el comentario se interpreta como HTML.
includeAttachments	bool	true	Si es true, reenvía los adjuntos originales.
attachments	string | List	—	Ruta de un archivo, o lista de rutas, a adjuntar además de los originales.

Salida

Devuelve un string con el ID del mensaje reenviado. Asígnalo a una variable si lo necesitas después; si no, puedes ignorarlo.

Errores comunes

Mensaje	Causa y solución
'id' es obligatorio.	id está vacío o la expresión devolvió null.
'to' es obligatorio.	No indicaste destinatario, o la lista está vacía.
No se encontró el archivo adjunto.	Una de las rutas de attachments no existe en la máquina donde corre el robot.
Requested entity was not found.	No hay un correo con ese ID en el buzón.

Ejemplo

Derivar a contabilidad los correos con factura y archivarlos:

Gmail — Connect   credential = credential("gmail-recepcion")
 └─ body:
      Gmail — Get emails   query = "in:inbox subject:factura has:attachment"   → output: facturas
      For each   correo in facturas
       └─ Gmail — Forward   id = correo["id"]   to = "contabilidad@example.com"
                            body = "Factura recibida para registro."
          Gmail — Archive   id = correo["id"]

Reenviar sin los adjuntos originales, pero con un archivo propio:

Gmail — Forward   id = correo["id"]   to = "gerencia@example.com"   cc = "auditoria@example.com"
                  includeAttachments = false   attachments = rutaResumen

Varias direcciones

En to, cc y bcc puedes escribir las direcciones en un solo texto separadas por comas o punto y coma ("ana@example.com, luis@example.com"), o pasar una lista de direcciones, por ejemplo una variable armada en el flujo (destinatarios).

Actividades relacionadas

• Gmail — Reply — responder al remitente en lugar de reenviar.
• Gmail — Send — enviar un correo nuevo.
• Gmail — Archive — sacar el correo de la bandeja tras reenviarlo.
• Todas las actividades de Gmail