Send Mail

Este bloque de función permite enviar correos electrónicos usando Gmail SMTP. Está pensado para enviar mensajes de texto plano y archivos adjuntos opcionales desde los flujos de trabajo. El bloque espera que la cuenta remitente esté habilitada para acceso Gmail API / SMTP.

📥 Inputs

Subject - El asunto del correo (string).

Content - El cuerpo del mensaje (string).

Sender Address - La dirección Gmail que enviará el mensaje (string). Debe estar configurada para uso SMTP/API.

Mail API Password - La contraseña o clave API usada para autenticar la dirección remitente (string).

Receiver Address - La dirección de correo destino (string).

Attachment File Path - Ruta completa opcional del archivo a adjuntar (string). Dejar vacío si no hay adjunto.

Trigger - Señal booleana que inicia el envío cuando está activa.

📤 Outputs

Success - Booleano que indica si la acción de envío tuvo éxito.

🕹️ Controls

Send - No hay botón de envío separado; el envío se inicia proporcionando un Trigger activo al bloque. Configure los campos del mensaje a través de los inputs.

⚙️ Mecanismo de ejecución

• El bloque espera que se proporcionen los inputs y que el Trigger se vuelva activo.

• Cuando se activa, intenta autenticar la cuenta remitente proporcionada y enviar el mensaje al receptor.

• Los adjuntos se incluyen si se proporciona una ruta de archivo válida.

• El bloque devuelve Success True si el envío fue exitoso, False en caso contrario.

• Si la autenticación o la entrega fallan por un problema transitorio, el bloque intentará reconectar y reenviar automáticamente.

✨ Features

• Envía correos en texto plano vía Gmail SMTP.

• Soporta un adjunto por ruta de archivo.

• Usa una sesión en caché para evitar reautenticar en cada trigger cuando es posible.

• Reconexión y reintento automático ante problemas transitorios de sesión.

📝 Usage Instructions

1. Proporcione las credenciales del remitente y habilite el acceso SMTP/API en la cuenta Gmail.

2. Complete los inputs Subject, Content, Sender Address, Mail API Password y Receiver Address.

3. Opcionalmente, proporcione una ruta de archivo en Attachment File Path para adjuntos.

4. Active el input Trigger para enviar el mensaje.

5. Monitoree la salida Success para confirmar la entrega.

💡 Tips and Tricks

• Para capturar y adjuntar una imagen desde una cámara, combine este bloque con Camera USB o Camera IP (ONVIF) y guarde el frame usando Image Write o Image Logger. Proporcione la ruta guardada a Attachment File Path.

• Si desea enviar notificaciones solo una vez cuando ocurra un evento, use Rising Edge o Logic Input para crear un pulso de Trigger único.

• Construya el texto del mensaje dinámicamente con String Merge o prepare registros estructurados con Data to JSON antes de enviar.

• Para enviar múltiples imágenes, use Multi Image Write para almacenar las imágenes y luego adjunte desde las rutas de archivo (una a la vez según soporte).

• Para enviar snapshots de eventos como parte de pipelines de análisis, combine con bloques de análisis como Find Object o Mask Detection para decidir cuándo activar el correo.

🛠️ Troubleshooting

• Fallo de autenticación: verifique que la Sender Address esté habilitada para SMTP/API y que la Mail API Password sea correcta. Revise la configuración de seguridad de la cuenta Gmail.

• Adjunto no enviado: asegúrese de que la ruta en Attachment File Path apunte a un archivo existente y sea accesible desde el entorno de ejecución.

• Correo no entregado: verifique la ortografía de la dirección del receptor y las carpetas de spam/junk. Restricciones de red o firewalls pueden bloquear los puertos SMTP.

• Trigger ignorado: confirme que el input Trigger reciba un valor True explícito (o un flanco ascendente) en tiempo de ejecución.

• Sesión expirada: el bloque intentará reconectar automáticamente, pero si fallos persisten, vuelva a comprobar credenciales y conectividad de red.

🔒 Privacidad y seguridad

• No almacene contraseñas sensibles en proyectos compartidos. Use manejo seguro de secretos cuando sea posible.

• Limite los privilegios de la cuenta remitente y active las medidas de seguridad apropiadas en la cuenta Gmail utilizada para envíos.