Saltar al contenido principal

DOCUMENTACIÓN CON IA

¿Qué desea saber?

Envío de mensajes a Microsoft Teams con Node-RED

Este tutorial muestra cómo enviar notificaciones de inspección desde su cámara OV10i directamente a un canal de Microsoft Teams. Aprenderá a configurar alertas automatizadas que incluyan resultados de inspección y enlaces de imágenes clicables, manteniendo a su equipo informado al instante sobre el estado de la producción.

Lo que construirá: Un sistema automatizado que publique los resultados de inspección del OV10i, incluidas las imágenes y el estado de aprobado/rechazado, directamente en un canal de Microsoft Teams.

Aplicación en el mundo real: Reciba notificaciones instantáneas cuando las inspecciones fallen, comparta imágenes de inspección con equipos remotos o cree informes de calidad automatizados en su espacio de colaboración del equipo.

Prerrequisitos​

  • Cámara OV10i conectada a la red de su planta
  • Acceso a Microsoft Teams con permiso para agregar conectores
  • Canal de Teams donde desea recibir notificaciones
  • Conectividad de red entre OV10i y Microsoft Teams
  • Conocimientos básicos de flujos de Node-RED

Resumen del tutorial​

Lo que construiremos: Un flujo de Node-RED que envía automáticamente los resultados de inspección a Microsoft Teams con enlaces de imágenes clicables.

Tiempo requerido: 15-20 minutos

Habilidades adquiridas: Integración de webhook de Teams, solicitudes HTTP de Node-RED, sistemas de notificación automatizados

Paso 1: Configurar el webhook de Microsoft Teams​

1.1 Acceda a su canal de Teams​

  1. Abra Microsoft Teams y navegue al canal de notificaciones de inspección
  2. Haga clic en los tres puntos (•••) junto al nombre del canal
  3. Seleccione "Administrar canal" del menú desplegable

1.2 Añada el conector Incoming Webhook​

  1. Haga clic en "Conectores" en el menú de gestión del canal
  2. Busque "Incoming Webhook" en la lista de conectores
  3. Haga clic en "Add" junto a la opción Incoming Webhook

1.3 Configurar los ajustes del webhook​

  1. Name: Ingrese un nombre descriptivo (p. ej., "Alertas de inspección OV10i")
  2. Icon: Opcionalmente cargue un icono personalizado para sus notificaciones
  3. Haga clic en "Create" para generar el webhook

1.4 Guarde la URL del webhook​

  1. Copie la URL del webhook generado - esto es crucial para la configuración de Node-RED
  2. Guarde la URL en un lugar seguro (la necesitará en el Paso 2)
  3. Haga clic en "Done" para completar la configuración de Teams

Punto de control: Ahora debería disponer de una URL de webhook que se vea como: https://yourcompany.webhook.office.com/webhookb2/...

Paso 2: Acceder a Node-RED de OV10i​

2.1 Acceda a Node-RED​

  1. Abra su interfaz web de OV10i
  2. Vaya a Editor de recetas y haga clic en Configurar E/S o seleccione "IO Block" desde el menú de migas de pan

2.2 Prepare su espacio de trabajo​

  1. Limpiar un área en el lienzo de Node-RED para su flujo de integración con Teams
  2. Identifique la paleta en el lado izquierdo con los nodos disponibles
  3. Planifique su flujo: Disparador → Proceso → Enviar a Teams

Paso 3: Construir el flujo de Node-RED​

3.1 Añadir nodos requeridos​

Arrastre estos nodos desde la paleta a su lienzo:

  1. Inject node (para pruebas)
  2. Function node (para formatear el mensaje)
  3. HTTP request node (para enviar a Teams)
  4. Debug node (opcional, para solución de problemas)

3.2 Conectar los Nodos​

  1. Salida de Wire inject hacia la entrada de function
  2. Salida de Wire function hacia la entrada de HTTP request
  3. Salida de Wire HTTP request hacia la entrada de debug (opcional)

Flow structure:

Inject → Function → HTTP Request → Debug

Paso 4: Configurar el Nodo Function​

4.1 Configuración básica del mensaje​

  1. Haz doble clic en el nodo function para abrir la configuración
  2. Reemplace el código predeterminado por este formato básico de mensaje:
// Basic Teams message
msg.headers = {
    "Content-Type": "application/json"
};

msg.payload = {
    text: "You got a new message from your OV20i"
};

return msg;

4.2 Mensaje avanzado con enlaces de imágenes​

Para resultados de inspección dinámicos con imágenes clicables:

// Dynamic message with inspection image
let imageUrl = msg.payload.image_url;

msg.headers = {
    "Content-Type": "application/json"
};

msg.payload = {
    text: `Inspection Complete - [View Image](${imageUrl})`
};

return msg;

4.3 Notificación completa de la inspección​

Para los detalles completos de la inspección:

// Complete inspection notification
const inspectionData = msg.payload;
const imageUrl = inspectionData.image_url;
const result = inspectionData.result ? "PASS" : "FAIL";
const timestamp = new Date().toLocaleString();

msg.headers = {
    "Content-Type": "application/json"
};

msg.payload = {
    text: `🔍 **Inspection ${result}** - ${timestamp}\n\n[View Image](${imageUrl})`
};

return msg;

4.4 Guardar la configuración del nodo​

  1. Haz clic en "Done" para guardar el nodo function
  2. Dale al nodo un nombre descriptivo como "Format Teams Message"

Paso 5: Configurar el Nodo de Solicitud HTTP​

5.1 Configuración de la solicitud HTTP​

  1. Haz doble clic en el nodo HTTP request para configurar
  2. Establecer Método: Selecciona "POST" desde el desplegable
  3. Establecer URL: Pega tu Teams webhook URL del paso 1.4
  4. Establecer Return: Selecciona "UTF-8 string"

5.2 Configuración adicional​

  • Nombre: Introduce "Send to Teams" para mayor claridad
  • Encabezados: Déjelos en blanco (manejado por el nodo function)
  • Payload: Déjele como "Ignore" (manejado por el nodo function)

5.3 Guardar la configuración HTTP​

  1. Haga clic en "Done" para guardar el nodo HTTP request
  2. Verifique que la URL del webhook sea correcta - esto es crítico para el éxito

Paso 6: Probar la integración​

6.1 Desplegar el flujo​

  1. Haga clic en el botón "Deploy" en la esquina superior derecha
  2. Espere la confirmación "Successfully deployed"
  3. Verifique si hay indicadores de error en los nodos (triángulos rojos)

6.2 Prueba con el nodo Inject​

  1. Haga clic en el botón en el lado izquierdo del nodo Inject
  2. Verifique el panel de depuración (barra lateral derecha) para mensajes de error
  3. Verifique que el mensaje aparezca en su canal de Teams

6.3 Verificar la notificación de Teams​

  1. Cambie a Microsoft Teams y verifique su canal objetivo
  2. Busque el mensaje de prueba de su OV10i
  3. Pruebe cualquier enlace clicable para asegurarse de que funcionen correctamente

Paso 7: Integración con el flujo de inspección​

7.1 Conectar con los resultados de inspección​

Para enviar notificaciones automáticas después de cada inspección:

  1. Localice su flujo de inspección principal (usualmente empieza con "All Block Outputs")
  2. Agregue su notificación de Teams como una rama desde el flujo principal
  3. Conecte después del procesamiento de la inspección pero antes de los resultados finales

7.2 Flujo de Integración de Ejemplo​

All Block Outputs → [Inspection Logic] → Final Pass/Fail
                                      ↓
                               Format Teams Message → Send to Teams

7.3 Filtrar Notificaciones (Opcional)​

Para enviar solo notificaciones para inspecciones fallidas:

// Only send notifications for failures
const inspectionResult = msg.payload.result;

if (!inspectionResult) {  // Only if inspection failed
    const imageUrl = msg.payload.image_url;

    msg.headers = {
        "Content-Type": "application/json"
    };

    msg.payload = {
        text: `⚠️ **INSPECTION FAILED** - Immediate attention required\n\n[View Failed Image](${imageUrl})`
    };

    return msg;
} else {
    return null;  // Don't send message for passing inspections
}

Paso 8: Solución de Problemas​

8.1 Problemas Comunes​

ProblemaSíntomasSolución
Sin mensaje en TeamsLa depuración muestra éxito pero no hay notificación de TeamsVerifique la URL del webhook y la conectividad de red
Error HTTP 400Error de solicitud en la depuraciónVerifique el formato del mensaje, asegúrese de la cabecera Content-Type
Los enlaces de imágenes no funcionanEl mensaje aparece pero las imágenes no se abrenVerifique que la URL de la imagen sea accesible desde la red de los usuarios de Teams
El flujo no se disparaNo hay salida de depuración cuando se esperaVerifique las conexiones del flujo, verifique las condiciones de disparo

8.2 Depurar su Flujo​

  1. Agregue nodos de depuración después de cada paso para rastrear el flujo de datos
  2. Verifique el panel de depuración para mensajes de error y la estructura de datos
  3. Pruebe con el nodo de inyección para aislar problemas de configuración
  4. Verifique la URL de webhook probando con herramientas externas si es necesario

8.3 Conectividad de Red​

  1. Asegúrese de que OV10i pueda acceder a Internet (prueba de ping desde la cámara)
  2. Verifique la configuración del firewall que podría bloquear HTTPS saliente
  3. Verifique la resolución DNS para las URL de webhook de Teams
  4. Pruebe desde un navegador en la misma red que la cámara

¡Éxito! La integración con Teams está completa​

La cámara OV10i ahora puede:

✅ Enviar notificaciones automáticas a canales de Microsoft Teams

✅ Incluir enlaces de imágenes clicables para revisión inmediata de la inspección

✅ Filtrar notificaciones según resultados de inspección

✅ Proporcionar formato enriquecido con detalles de inspección y sellos de tiempo

✅ Soporte para múltiples canales para diferentes tipos de notificaciones

Mejores Prácticas​

Gestión de Mensajes​

  • Utilice nombres de canal descriptivos para diferentes tipos de notificaciones
  • Incluya sellos de tiempo e identificadores de estación en los mensajes
  • Filtre mensajes para evitar sobrecarga de notificaciones
  • Pruebe a fondo antes del despliegue en producción

Consideraciones de Seguridad​

  • Proteja las URL de webhook: trátelas como credenciales sensibles
  • Use HTTPS para todas las comunicaciones (predeterminado con Teams)
  • Limite el acceso de red solo a los servicios necesarios
  • Rotar regularmente las URL de webhook si se ven comprometidas

Optimización del Rendimiento​

  • Notificaciones en lotes si se envían muchos mensajes
  • Utilice lógica de reintento adecuada para fallos de red
  • Monitoree la entrega de mensajes y las tasas de éxito
  • Implemente limitación de tasa para evitar límites de la API de Teams

image.png

Próximos pasos​

Después de configurar la integración de Teams:

  1. Crear diferentes canales de notificación para distintos tipos de inspección
  2. Configurar flujos de escalamiento para fallas críticas
  3. Integrar con otras herramientas del equipo (correo electrónico, SMS, etc.)
  4. Construir paneles que combinen Teams con otras herramientas de monitorización
  5. Capacitar a su equipo para responder a las notificaciones automatizadas
Saltar la configuración manual

El Integration Builder puede generar flujos completos de notificación para Teams a partir de una descripción en inglés sencillo. Describa lo que desea (p. ej., "post inspection results with images to a Teams channel when a part fails") y obtenga un flujo de Node-RED listo para producción en segundos.

🔗 Ver También​