Envío de correo electrónico con Node-RED

Este tutorial muestra cómo configurar notificaciones por correo electrónico automatizadas desde su cámara OV20i usando Node-RED. Aprenderá a configurar la integración con Gmail y a crear flujos que envíen alertas de inspección, actualizaciones de estado del sistema y notificaciones de fallos directamente a su correo.

Lo que construiremos: Un sistema de correo automatizado que envía resultados de inspección de OV20i, alertas y notificaciones a destinatarios especificados usando Gmail SMTP.

Aplicación en el mundo real: Reciba alertas por correo electrónico instantáneas cuando las inspecciones fallen, envíe informes de calidad diarios a la dirección de gestión o notifique a los equipos de mantenimiento de problemas del sistema, todo automáticamente desde su sistema de inspección por visión.

Prerrequisitos

• Cámara OV20i con acceso a Node-RED
• Cuenta de Gmail para enviar correos
• Comprensión básica de flujos de Node-RED
• Acceso a la configuración de seguridad de la Cuenta de Google

Descripción general del tutorial

Lo que construiremos: Un flujo de Node-RED que envía automáticamente notificaciones por correo electrónico con resultados de inspección y alertas del sistema.

Tiempo estimado: 20-30 minutos (incluida la configuración de Gmail)

Habilidades adquiridas: Configuración de contraseña de la app de Gmail, configuración SMTP, notificaciones por correo electrónico automatizadas

Paso 1: Configurar la contraseña de la app de Gmail

1.1 Habilitar Verificación en dos pasos

1. Inicie sesión en su Cuenta de Google en accounts.google.com
2. Haga clic en "Seguridad" en el menú de navegación izquierdo
3. Busque la sección "Iniciar sesión en Google" (Signing in to Google)
4. Haga clic en "Verificación en dos pasos"
5. Siga las indicaciones para habilitar la Verificación en dos pasos si aún no está habilitada

La Verificación en dos pasos es obligatoria antes de que pueda crear contraseñas de la app.

1.2 Generar contraseña de la app

1. Regrese a la página de Seguridad después de habilitar Verificación en dos pasos
2. Haga clic en "Contraseñas de la app" (debajo de "Iniciar sesión en Google")
3. Seleccione "Mail" como tipo de aplicación
4. Seleccione "Other" como tipo de dispositivo
5. Ingrese un nombre como "OV20i Node-RED Email"
6. Haga clic en "Generar"

1.3 Guardar la contraseña de la app

1. Copie la contraseña de 16 caracteres que muestra Google
2. Guárdela de forma segura; la necesitará para la configuración de Node-RED
3. Nota: Esta contraseña solo se muestra una vez. Si la pierde, genere una nueva

Punto de control: Debe tener guardada una contraseña de la app de Gmail de 16 caracteres para uso en Node-RED.

Paso 2: Instalar nodos de correo (si es necesario)

2.1 Verificar nodos de correo

1. Abra Node-RED en su cámara OV20i
2. Busque en la paleta izquierda un nodo "email" en la sección de salidas
3. Si falta, deberá instalar el paquete de correo

2.2 Instalar paquete de correo (si es necesario)

1. Haga clic en el menú hamburguesa (≡) en Node-RED
2. Seleccione "Manage palette" (Administrar paleta)
3. Haga clic en la pestaña "Install" (Instalar)
4. Busque "node-red-node-email"
5. Haga clic en "Install" junto al paquete

Paso 3: Crear un flujo básico de correo

3.1 Agregar nodos requeridos

1. Navegue al IO Block para acceder a Node-RED
2. Arrastre estos nodos desde la paleta a su lienzo:
   • Inject node (para pruebas)
   • Email node (de la sección de salida)
3. Conecte la salida de inject a la entrada de email

3.2 Estructura básica del flujo

Inject → Email

Propósito del flujo: Envío básico de correo para pruebas y notificaciones.

Paso 4: Configurar el Contenido del Correo

4.1 Configurar el Nodo Inject

1. Doble clic en el nodo Inject para abrir las propiedades
2. Configurar la Payload:
   • Payload type: "string"
   • Payload value: Tu texto del cuerpo del correo (p. ej., "Alerta de inspección de OV20i")
3. Agregar asunto del correo:

   • Haz clic en "+ add" para agregar una propiedad

   • Nombre de la propiedad: "topic"

   • Valor de la propiedad: Asunto del correo (p. ej., "OV20i Alerta de Inspección")

     

4.2 Ejemplo de Configuración Básica

Payload (cuerpo del correo):

Inspection completed at Station 1
Status: Alert triggered
Time: Check timestamp for details

Topic (asunto del correo):

OV20i Inspection Alert - Station 1

4.3 Guardar la Configuración del Inject

1. Ponga un nombre al nodo, por ejemplo "Disparador de Correo"
2. Haga clic en "Done" para guardar la configuración

Paso 5: Configurar Ajustes SMTP de Correo

5.1 Configurar Nodo de Correo

1. Doble clic en el nodo de correo para abrir las propiedades
2. Configurar ajustes básicos:
   • Name: "Enviar correo de alerta" (o un nombre descriptivo)
   • To: Dirección de correo del destinatario (p. ej., quality@company.com)

5.2 Configurar Gmail SMTP

1. Servidor: smtp.gmail.com
2. Puerto: 465
3. Marcar "Usar conexión segura"
4. Auth type: Basic
5. Usuario: Su dirección de Gmail completa (p. ej., alerts@company.com)
6. Contraseña: La contraseña de la app de 16 caracteres de Paso 1

5.3 Configuración de Seguridad

1. Marcar "Verificar que el certificado del servidor es válido"
2. Verificar que todas las configuraciones estén ingresadas correctamente
3. Haga clic en "Done" para guardar la configuración del nodo de correo

Checkpoint: El nodo de correo no debe mostrar indicadores de error y debe mostrar la dirección del destinatario.

Paso 6: Probar tu Flujo de Correo

6.1 Desplegar y Probar

1. Haz clic en el botón 'Deploy' en la esquina superior derecha
2. Espera el mensaje 'Successfully deployed'
3. Haz clic en el botón del nodo Inject (cuadrado gris en el lado izquierdo)

6.2 Verificar la Entrega de Correo

1. Verifique la dirección de correo del destinatario para el mensaje de prueba
2. Verifique la carpeta de spam si el correo no aparece en la bandeja de entrada
3. Busque mensajes de error en el panel de depuración de Node-RED

6.3 Solución de Problemas Si es Necesario

Problemas comunes:

• Contraseña de la app incorrecta: Regenerar la contraseña de la app de Gmail
• Ajustes SMTP: Verificar que el servidor y el puerto sean correctos
• Firewall: Asegúrese de permitir el tráfico SMTP saliente

Paso 7: Integración con Resultados de Inspección

7.1 Conectar al Flujo de Inspección

Para enviar correos basados en los resultados de inspección:

1. Encuentre su flujo de inspección principal (empieza con "All Block Outputs")
2. Agregue su flujo de correo como una rama del procesamiento de inspección
3. Conecte después de la lógica de inspección, pero en paralelo a los resultados finales

7.2 Flujo de Integración de Ejemplo

All Block Outputs → [Inspection Logic] → Final Pass/Fail
                                      ↓
                              Format Email → Send Email

7.3 Contenido dinámico de correo

Reemplace el inject node con un function node para contenido dinámico:

// Dynamic email based on inspection results
const result = msg.payload.result ? "PASSED" : "FAILED";
const timestamp = new Date().toLocaleString();
const station = global.get("station_name") || "Unknown Station";

// Set email subject
msg.topic = `Inspection ${result} - ${station}`;

// Set email body
msg.payload = `Inspection Report:
Status: ${result}
Station: ${station}
Time: ${timestamp}
Image: ${msg.payload.image_url || "No image available"}

Please review and take appropriate action.`;

return msg;

Paso 8: Ejemplo de flujo completo

8.1 Importar flujo listo para usar

Puede importar este flujo JSON completo:

[
  {
    "id": "email_node_1",
    "type": "e-mail",
    "name": "Send Inspection Alert",
    "server": "smtp.gmail.com",
    "port": "465",
    "secure": true,
    "authtype": "BASIC",
    "to": "quality@company.com"
  },
  {
    "id": "format_email",
    "type": "function",
    "name": "Format Email Content",
    "func": "const result = msg.payload.result ? 'PASSED' : 'FAILED';\nmsg.topic = `Inspection ${result}`;\nmsg.payload = `Status: ${result}\\nTime: ${new Date()}`;\nreturn msg;"
  }
]

8.2 Personalizar según sus necesidades

1. Actualice las direcciones de correo para su organización
2. Modifique el contenido del correo para sus requisitos específicos
3. Ajuste la temporización y las condiciones de disparo
4. Pruebe a fondo antes de la implementación en producción

Solución de problemas

Problemas comunes

Problema	Síntomas	Solución
Autenticación fallida	"Login failed" errores	Verifique que la contraseña de la app sea correcta y que la verificación en dos pasos esté habilitada
Tiempo de espera de conexión	No se envió correo, errores de tiempo de espera	Verifique la configuración del firewall, verifique el servidor SMTP y su puerto
Correos en spam	Correos entregados pero en la carpeta de spam	Agregue el remitente a la lista segura, mejore el contenido del correo
Flujo no se dispara	Sin salida de depuración	Verifique las conexiones del flujo y las condiciones de disparo

Depure su flujo de correo

1. Agregue nodos de depuración después de cada paso para rastrear los datos
2. Verifique los logs de Node-RED para obtener mensajes de error detallados
3. Pruebe la configuración SMTP con clientes de correo externos si es necesario
4. Verifique la conectividad de red desde la cámara hasta los servidores de Gmail

¡Éxito! La integración de correo está completa

La cámara OV20i ahora puede:

✅ Enviar notificaciones por correo electrónico automáticas de los resultados de la inspección

✅ Entregar mensajes enriquecidos y formateados con los detalles de la inspección

✅ Soportar múltiples destinatarios y flujos de escalamiento

✅ Proporcionar informes programados y resúmenes

✅ Manejar mensajes condicionales en función de los resultados de la inspección

Buenas Prácticas

Gestión de correo electrónico

• Utilice asuntos descriptivos con indicadores de estado claros
• Mantenga los mensajes concisos pero informativos
• Incluya marcas de tiempo e identificadores de estación
• Proporcione información accionable en las notificaciones

Seguridad y fiabilidad

• Proteja las contraseñas de la app: guárdelas de forma segura y rotarlas regularmente
• Utilice cuentas de correo dedicadas para notificaciones del sistema
• Pruebe la entrega de correos regularmente para garantizar la fiabilidad
• Supervise las fallas de entrega y tenga métodos de notificación de respaldo

Consideraciones de Rendimiento

• Limite la frecuencia de correos electrónicos para evitar que sean detectados como spam
• Utilice listas de destinatarios adecuadas para los distintos tipos de alertas
• Implemente limitación de tasa para sistemas de alto volumen
• Considere el tamaño del correo al incluir adjuntos grandes

Próximos Pasos

Después de configurar las notificaciones por correo electrónico:

1. Crear plantillas de correo electrónico para diferentes tipos de alertas
2. Configurar listas de distribución para diversas partes interesadas
3. Implementar flujos de escalamiento para problemas críticos
4. Crear informes programados para la gerencia
5. Integrar con otros sistemas de notificación (SMS, Teams, etc.)

Saltar la configuración manual

El Integration Builder puede generar flujos completos de notificación por correo electrónico a partir de una descripción en inglés sencillo. Describa lo que desea (p. ej., "envíe un correo con la imagen de inspección cuando se detecte un defecto") y obtenga un flujo de Node-RED listo para producción en segundos.

🔗 Ver También

• Enviar mensajes a Microsoft Teams con Node-RED
• Conceptos básicos de Node-RED
• Bloques personalizados de Node-RED (Resumen)
• Configuración de Metadatos
• Configurar la Lógica de Salida Digital