Gmail — Send

Gmail — Send

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

Envía un correo nuevo desde la cuenta de la sesión. Admite varios destinatarios, copia y copia oculta, cuerpo en texto plano o HTML y archivos adjuntos. Queda en Enviados, como si lo hubieras enviado desde Gmail.

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.

• Destinatarios: en to, cc o bcc escribe las direcciones separadas por comas o punto y coma ("ana@example.com; luis@example.com"), o pasa una lista de direcciones, por ejemplo una variable armada en el flujo (destinatarios). También acepta el formato con nombre (Ana Pérez <ana@example.com>).
• Remitente: siempre la dirección del buzón de la sesión.
• Cuerpo: si activas isHtml, body se envía como HTML; si no, como texto plano.
• Adjuntos: una ruta o una lista de rutas; cada archivo debe existir en la máquina donde corre el robot y se adjunta con su nombre. Si falta uno, no se envía nada. A diferencia de los destinatarios, un texto con varias rutas separadas por comas no se divide: para varios archivos usa una lista.

Gmail admite mensajes de hasta 25 MB, adjuntos incluidos. Para archivos más grandes, compártelos con Google Drive y envía el enlace.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
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.
subject	string	""	Asunto del correo.
body	string	""	Cuerpo del correo (texto plano o HTML).
isHtml	bool	false	Si es true, el cuerpo se interpreta como HTML.
attachments	string | List	—	Ruta de un archivo, o lista de rutas, a adjuntar.

Salida

Devuelve un string con el ID del mensaje enviado. Sirve como id de las demás actividades, por ejemplo para etiquetarlo con Apply label. Si no lo necesitas, puedes ignorarlo.

Errores comunes

Mensaje	Causa y solución
'to' es obligatorio.	to está vacío o la lista no tiene direcciones.
No se encontró el archivo adjunto.	Una ruta de attachments no existe en la máquina del robot. Verifícala con File Exists antes de enviar.
Error ParseException al leer una dirección	Alguna dirección de to, cc o bcc está mal escrita.
Request had insufficient authentication scopes.	La conexión no tiene permiso para enviar correo. Revisa sus alcances en Zoan Cloud.

Ejemplo

Gmail — Connect   credential = credential("gmail-reportes")
 └─ body:
      Excel to PDF   path = "C:\reportes\ventas.xlsx"   → output: pdf
      Gmail — Send   to = "gerencia@example.com; finanzas@example.com"   cc = "auditoria@example.com"
                     subject = "Reporte de ventas"   body = "<p>Adjunto el reporte del día.</p>"   isHtml = true
                     attachments = pdf   → output: idEnviado
      Gmail — Apply label   id = idEnviado   labels = "Reportes"

Actividades relacionadas

• Gmail — Connect — abrir la sesión.
• Gmail — Reply — responder dentro de un hilo existente.
• Gmail — Get emails — buscar correos.
• Todas las actividades de Gmail