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

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

Qué construirás: Un sistema de correo electrónico automatizado que envía resultados de inspección de OV80i, 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 gerencia o notifique a los equipos de mantenimiento sobre problemas del sistema, todo automáticamente desde su sistema de inspección de visión.

Prerrequisitos

• Cámara OV80i con acceso a Node-RED
• Cuenta de Gmail para el envío de 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 requerido: 20-30 minutos (incluida la configuración de Gmail)

Habilidades aprendidas: Configuración de la contraseña de la aplicación de Gmail, configuración SMTP, notificaciones automáticas por correo electrónico

Paso 1: Configurar la Contraseña de la Aplicación de Gmail

1.1 Habilitar la 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 de la izquierda
3. Busque la sección "Iniciar sesión en 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 aplicación.

1.2 Generar Contraseña de la Aplicación

1. Regrese a la página de Seguridad después de habilitar la verificación en dos pasos
2. Haga clic en "Contraseñas de la aplicación" (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 "OV80i Node-RED Email"
6. Haga clic en "Generar"

1.3 Guardar su Contraseña de la Aplicación

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 una contraseña de la app de Gmail de 16 caracteres guardada 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 OV80i
2. Busque en la paleta izquierda un nodo de "email" en la sección de salida
3. Si falta, necesitará 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"
3. Haga clic en la pestaña "Install"
4. Busque "node-red-node-email"
5. Haga clic en "Install" junto al paquete

Paso 3: Crear 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 del inject a la entrada de correo

3.2 Estructura básica del flujo

Inject → Email

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

Paso 4: Configurar Contenido del Correo

4.1 Configurar Nodo de Inyección

1. Haga doble clic en el nodo de inyección para abrir propiedades
2. Configurar la carga útil:
   • Tipo de carga: "string"
   • Valor de la carga: El texto del cuerpo del correo (p. ej., "Alerta de inspección de OV80i")
3. Agregar asunto del correo:

   • Haga clic en "+ add" para añadir una propiedad

   • Nombre de la propiedad: "topic"

   • Valor de la propiedad: El asunto del correo (p. ej., "OV80i Inspection Alert")

     

4.2 Ejemplo de Configuración Básica

Carga útil (cuerpo del correo):

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

Asunto (asunto del correo):

OV80i Inspection Alert - Station 1

4.3 Guardar Configuración de Inyección

1. Ponga un nombre al nodo como "Disparador de correo"
2. Haga clic en 'Listo' para guardar la configuración

Paso 5: Configurar Ajustes SMTP del Correo

5.1 Configurar Nodo de Correo

1. Haga doble clic en el nodo de correo para abrir las propiedades
2. Configurar la configuración básica:
   • Nombre: "Enviar correo de alerta" (o un nombre descriptivo)
   • Para: 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. **Marque "Usar conexión segura"`
4. Tipo de autenticación: 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 del Paso 1

5.3 Configuración de Seguridad

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

Checkpoint: Su nodo de correo no debería mostrar indicadores de error y debe mostrar la dirección del destinatario.

Paso 6: Probar su Flujo de Correo

6.1 Desplegar y Probar

1. Haga clic en el botón "Desplegar" en la esquina superior derecha
2. Espere el mensaje "Despliegue realizado con éxito"
3. Haga clic en el botón del nodo de inyección (cuadrado gris en el lado izquierdo)

6.2 Verificar Entrega de Correo

1. Verifique el 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 aplicación incorrecta: Regenerar la contraseña de la app de Gmail
• Configuración SMTP: Verifique que el servidor y el puerto sean correctos
• Firewall: Asegúrese de que el tráfico SMTP saliente esté permitido

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

7.1 Conectar al Flujo de Inspección

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

1. Encuentre su flujo de inspección principal (comienza con "All Block Outputs")
2. Añada su flujo de correo electrónico como rama desde el procesamiento de la inspección
3. Conéctelo 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 electrónico

Reemplace el nodo de inyección por un nodo de función 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

You can import this complete flow JSON:

[
  {
    "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 de acuerdo con sus necesidades

1. Actualizar direcciones de correo electrónico para su organización
2. Modificar el contenido del correo electrónico para sus requisitos específicos
3. Ajustar la temporización y las condiciones de disparo
4. Probar a fondo antes del despliegue en producción

Solución de problemas

Problemas comunes

Problema	Síntomas	Solución
Autenticación fallida	Errores de inicio de sesión	Verifique que la contraseña de la aplicación sea correcta y que la verificación en dos pasos esté habilitada
Tiempo de espera de conexión	No se envió ningún correo, errores de tiempo de espera	Verifique la configuración del firewall, verifique el servidor SMTP y el puerto
Correos en spam	Correos entregados pero en la carpeta de spam	Agregar al remitente a la lista segura, mejorar el contenido del correo
El flujo no se activa	Sin salida de depuración	Verifique las conexiones del flujo y las condiciones de disparo

Depuración de su flujo de correo

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

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

Su cámara OV80i ahora puede:

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

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

✅ Soportar múltiples destinatarios y flujos de escalamiento

✅ Proporcionar informes programados y resúmenes

✅ Manejar mensajería condicional basada en los resultados de la inspección

Mejores prácticas

Gestión de correo electrónico

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

Seguridad y confiabilidad

• Proteger las contraseñas de la aplicación; guárdelas de forma segura y rotarlas regularmente
• Usar cuentas de correo dedicadas para notificaciones del sistema
• Probar la entrega de correo regularmente para garantizar la confiabilidad
• Monitorear fallos de entrega y disponer de métodos de notificación de respaldo

Consideraciones de rendimiento

• Limite la frecuencia de correos electrónicos para evitar la detección de spam
• Utilice listas de destinatarios adecuadas para diferentes tipos de alertas
• Implemente limitación de tasa para sistemas de alto volumen
• Considere el tamaño del correo al adjuntar archivos grandes

Próximos pasos

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

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

Omitir 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 lenguaje natural. Describa lo que desea (p. ej., "enviar un correo con la imagen de la inspección cuando se detecta un defecto") y obtenga un flujo de Node-RED listo para producción en segundos.

🔗 See Also

• Envío de mensajes a Microsoft Teams con Node-RED
• Conceptos básicos de Node-RED
• Resumen de Bloques Personalizados de Node-RED
• Configuración de metadatos
• Configurar la Lógica de Salida Digital