Saltar al contenido principal

DOCUMENTACIÓN CON IA

¿Qué desea saber?

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

Este tutorial le muestra cómo configurar notificaciones automáticas por correo electrónico desde su cámara OV10i 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 electrónico.

Lo que construiremos: Un sistema de correo automático que envía los resultados de inspección de OV10i, alertas y notificaciones a destinatarios especificados usando Gmail SMTP.

Aplicación del 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 visión.

Prerrequisitos​

  • Cámara OV10i 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 estimado: 20-30 minutos (incluida la configuración de Gmail)

Conocimientos adquiridos: Configuración de contraseña de la aplicación de Gmail, configuración SMTP, notificaciones automáticas por correo

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

1.1 Habilitar la Verificación en 2 Pasos​

  1. Inicia sesión en tu Cuenta de Google en accounts.google.com
  2. Haz clic en "Seguridad" en el menú de navegación izquierdo
  3. Localiza la sección "Iniciar sesión en Google"
  4. Haz clic en "Verificación en 2 pasos"
  5. Sigue las indicaciones para habilitar la Verificación en 2 pasos si aún no está habilitada
nota

La Verificación en 2 pasos es requerida antes de poder crear contraseñas de aplicación.

1.2 Generar Contraseña de la Aplicación​

  1. Regresa a la página de Seguridad después de habilitar la Verificación en 2 pasos
  2. Haz clic en "Contraseñas de la aplicación" (bajo "Iniciar sesión en Google")
  3. Selecciona "Mail" como tipo de aplicación
  4. Selecciona "Other" como tipo de dispositivo
  5. Ingresa un nombre como "OV10i Node-RED Email"
  6. Haz clic en "Generar"

1.3 Guardar la Contraseña de la Aplicación​

  1. Copia la contraseña de 16 caracteres que Google muestra
  2. Guárdala de forma segura - la necesitarás para la configuración de Node-RED
  3. Nota: Esta contraseña solo se muestra una vez. Si la pierdes, genera una nueva

Punto de control: Debe haber guardada una contraseña de aplicación 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. Abre Node-RED en tu cámara OV10i
  2. Busca en la paleta izquierda un nodo "email" en la sección de salida
  3. Si falta, necesitarás instalar el paquete de correo

2.2 Instalar Paquete de Correo (si es necesario)​

  1. Haz clic en el menú de hamburguesa (≡) en Node-RED
  2. Selecciona "Administrar paleta"
  3. Haz clic en la pestaña "Instalar"
  4. Busca "node-red-node-email"
  5. Haz clic en "Instalar" junto al paquete

Paso 3: Crear Flujo Básico de Email​

3.1 Añadir Nodos Requeridos​

  1. Navega hasta el Bloque IO para acceder a Node-RED
  2. Arrastra estos nodos desde la paleta a tu lienzo:
    • Inject node (para pruebas)
    • Email node (desde la sección de salida)
  3. Conecta la salida de 'Inject' a la entrada de 'Email'

3.2 Estructura básica del flujo​

Inject → Email

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

image.png

Paso 4: Configurar contenido de correo​

4.1 Configurar nodo de inyección​

  1. Haz doble clic en el nodo de inyección para abrir las propiedades
  2. Configurar el payload:
    • Payload type: "string"
    • Payload value: El texto del cuerpo del correo (p. ej., "Alerta de inspección desde OV10i")
  3. Agregar asunto de correo:

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

    • Property name: "topic"

    • Property value: El asunto del correo (p. ej., "Alerta de inspección OV10i")

      image.png

4.2 Configuración básica de ejemplo​

Payload (email body):

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

Topic (email subject):

OV20i Inspection Alert - Station 1

4.3 Guardar configuración del nodo de inyección​

  1. Asigne un nombre al nodo como "Email Trigger"
  2. Haz clic en "Done" para guardar la configuración

Paso 5: Configurar ajustes SMTP del correo​

5.1 Configurar el nodo de correo​

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

5.2 Configurar Gmail SMTP​

  1. Server: smtp.gmail.com
  2. Port: 465
  3. Check "Use secure connection"
  4. Auth type: Basic
  5. Userid: Tu dirección de Gmail completa (p. ej., alerts@company.com)
  6. Password: La contraseña de la app de Gmail de 16 caracteres obtenida en el 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. Haz clic en "Done" para guardar la configuración del nodo de correo

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

image.png

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 "Despliegue exitoso"
  3. Haz clic en el botón del nodo de inyección (cuadrado gris en el lado izquierdo)

6.2 Verificar la 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 app incorrecta: Regenerar la contraseña de la app de Gmail
  • Ajustes 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 basados en los resultados de inspección:

  1. Encuentre su flujo de inspección principal (comienza con "All Block Outputs")
  2. Agregue su flujo de correo como una rama desde el 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

image.png

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 Flujo Listo para Importar​

Puede importar este JSON de flujo 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. 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 exhaustivamente antes de la implementación en producción

Solución de problemas​

Problemas comunes​

ProblemaSíntomasSolución
Autenticación fallidaErrores de inicio de sesiónVerifique que la contraseña de la aplicación sea correcta y que la verificación en dos pasos esté habilitada
Tiempo de espera de la conexiónNo se envía correo, errores de tiempo de esperaVerifique la configuración del firewall, verifique el servidor SMTP y el puerto
Correos electrónicos en spamCorreos entregados pero en la carpeta de spamAgregue el remitente a la lista segura, mejore el contenido del correo
El flujo no se activaSin salida de depuraciónVerifique las conexiones del flujo y las condiciones de disparo

Depure su flujo de correo​

  1. Agregar nodos de depuración después de cada paso para rastrear los datos
  2. Verifique 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. Verifique la conectividad de red desde la cámara a los servidores de Gmail

¡Éxito! Su integración de correo electrónico está completa​

Su cámara OV10i 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 escalación

✅ Proporcionar informes programados y resúmenes

✅ Manejar mensajes condicionales según los resultados de la inspección

Mejores Prácticas​

Gestión del 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​

  • Proteger las contraseñas de la aplicación: almacenarlas de forma segura y rotarlas regularmente
  • Utilice cuentas de correo dedicadas para notificaciones del sistema
  • Pruebe la entrega de correo regularmente para garantizar la fiabilidad
  • Supervise las fallas de entrega y tenga métodos de notificación de respaldo

Consideraciones de Rendimiento​

  • Limitar la frecuencia de correos electrónicos para evitar que sean marcados como spam
  • Utilice listas de destinatarios adecuadas para diferentes tipos de alertas
  • Implemente rate limiting para sistemas de alto volumen
  • Tenga en cuenta el tamaño del correo electrónico al incluir adjuntos 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 diversos interesados
  3. Implementar flujos de escalamiento para problemas críticos
  4. Crear informes programados para la gerencia
  5. Integrar con otros sistemas de notificaciones (SMS, Teams, etc.)
Omitir la configuración manual

The Integration Builder can generate complete email notification flows from a plain English description. Describe what you want (p. ej., "send an email with the inspection image when a defect is found") and get a production-ready Node-RED flow in seconds.

🔗 Ver También​