Saltar al contenido principal

DOCUMENTACIÓN CON IA

¿Qué desea saber?

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

Este tutorial le 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 incluyen resultados de inspección y enlaces de imágenes en los que se puede hacer clic, manteniendo a su equipo informado al instante sobre el estado de producción.

Lo Que Construirá: Un sistema automatizado que publica los resultados de inspección del OV10i, incluyendo imágenes y estado 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 reportes de calidad automatizados en su espacio de colaboración en equipo.

Omita la configuración manual

Describa qué notificaciones de Teams necesita en lenguaje sencillo en inglés y el Auto-Integration Builder generará un flujo completo de Node-RED para usted en segundos.

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 el OV10i y Microsoft Teams
  • Comprensión básica de los flujos de Node-RED

Descripción General 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 en los que se puede hacer clic.

Tiempo requerido: 15-20 minutos

Habilidades aprendidas: Integración de webhooks de Teams, solicitudes HTTP en Node-RED, sistemas de notificación automatizados

Paso 1: Configurar el Webhook de Microsoft Teams​

1.1 Acceder a su Canal de Teams​

  1. Abra Microsoft Teams y navegue al canal para las 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 Agregar el Conector de Webhook Entrante​

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

1.3 Configurar los Ajustes del Webhook​

  1. Nombre: Ingrese un nombre descriptivo (por ejemplo, "Alertas de Inspección OV10i")
  2. Ícono: Opcionalmente, cargue un ícono personalizado para sus notificaciones
  3. Haga clic en "Crear" para generar el webhook

1.4 Guardar la URL del Webhook​

  1. Copie la URL del webhook generada - esto es crucial para la configuración de Node-RED
  2. Guarde la URL en una ubicación segura (la necesitará en el Paso 2)
  3. Haga clic en "Listo" para completar la configuración de Teams

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

Paso 2: Acceder a Node-RED del OV10i​

2.1 Navegar a Node-RED​

  1. Abra su interfaz web del OV10i
  2. Vaya al editor de recetas y haga clic en Configure I/O o seleccione "Bloque IO" del menú de migas de pan

2.2 Preparar su Espacio de Trabajo​

  1. Despeje 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: Trigger → Process → Send to Teams

Paso 3: Construir el Flujo de Node-RED​

3.1 Agregar los Nodos Requeridos​

Arrastre estos nodos desde la paleta hasta su lienzo:

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

3.2 Conectar los Nodos​

  1. Conecte la salida de inject a la entrada de function
  2. Conecte la salida de function a la entrada de HTTP request
  3. Conecte la salida de HTTP request a la entrada de debug (opcional)

Estructura del flujo:

Inject → Function → HTTP Request → Debug

Paso 4: Configurar el Nodo Function​

4.1 Configuración Básica del Mensaje​

  1. Haga doble clic en el nodo function para abrir la configuración
  2. Reemplace el código predeterminado con 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 OV10i"
};

return msg;

4.2 Mensaje Avanzado con Enlaces de Imágenes​

Para resultados de inspección dinámicos con imágenes en las que se puede hacer clic:

// 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 de Inspección Completa​

Para detalles completos de 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 Function​

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

Paso 5: Configurar el Nodo HTTP Request​

5.1 Configurar HTTP Request​

  1. Haga doble clic en el nodo HTTP request para configurar
  2. Establecer Method: Seleccione "POST" del menú desplegable
  3. Establecer URL: Pegue su URL de webhook de Teams del Paso 1.4
  4. Establecer Return: Seleccione "UTF-8 string"

5.2 Configuraciones Adicionales​

  • Name: Ingrese "Send to Teams" para mayor claridad
  • Headers: Dejar vacío (manejado por el nodo function)
  • Payload: Dejar 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 fundamental para el éxito

Paso 6: Probar su 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 de "Successfully deployed"
  3. Verifique cualquier indicador de error en los nodos (triángulos rojos)

6.2 Probar con el Nodo Inject​

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

6.3 Verificar la Notificación en Teams​

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

Paso 7: Integración con el Flujo de Inspección​

7.1 Conectar a los Resultados de Inspección​

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

  1. Encuentre su flujo principal de inspección (generalmente comienza con "All Block Outputs")
  2. Agregue su notificación de Teams como una rama del flujo principal
  3. Conecte después del procesamiento de inspección pero antes de los resultados finales

7.2 Ejemplo de Flujo de Integración​

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

7.3 Filtrar Notificaciones (Opcional)​

Para enviar notificaciones solo 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
No hay mensaje en TeamsEl depurador muestra éxito pero no hay notificación en TeamsVerifique la URL del webhook, confirme la conectividad de red
Error HTTP 400Error de solicitud incorrecta en el depuradorVerifique el formato del mensaje, asegúrese de incluir el encabezado Content-Type
Los enlaces de imagen 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 activaNo hay salida de depuración cuando se esperaVerifique las conexiones del flujo, confirme las condiciones de activación

8.2 Depure su Flujo​

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

8.3 Conectividad de Red​

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

¡Éxito! Su Integración con Teams está Completa​

Su cámara OV10i ahora puede:

✅ Enviar notificaciones automáticas a los canales de Microsoft Teams

✅ Incluir enlaces de imagen clicables para revisión inmediata de la inspección

✅ Filtrar notificaciones según los resultados de la inspección

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

✅ Soportar múltiples canales para diferentes tipos de notificaciones

Mejores Prácticas​

Gestión de Mensajes​

  • Use nombres descriptivos de canales para diferentes tipos de notificaciones
  • Incluya marcas de tiempo e identificadores de estación en los mensajes
  • Filtre los mensajes para evitar la sobrecarga de notificaciones
  • Pruebe exhaustivamente antes de la implementación en producción

Consideraciones de Seguridad​

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

Optimización del Rendimiento​

  • Agrupe notificaciones si envía muchos mensajes
  • Use lógica de reintento adecuada para fallos de red
  • Monitoree las tasas de éxito de entrega de mensajes
  • Implemente limitación de tasa para evitar los límites de la API de Teams

image.png

Próximos Pasos​

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

  1. Cree diferentes canales de notificación para varios tipos de inspección
  2. Configure flujos de escalamiento para fallas críticas
  3. Integre con otras herramientas del equipo (correo electrónico, SMS, etc.)
  4. Construya paneles que combinen Teams con otras herramientas de monitoreo
  5. Capacite a su equipo sobre cómo responder a las notificaciones automatizadas
Omita la configuración manual

El Integration Builder puede generar flujos completos de notificación de Teams a partir de una descripción en inglés sencillo. Describa lo que desea (por ejemplo, "publicar resultados de inspección con imágenes en un canal de Teams cuando una pieza falle") y obtenga un flujo de Node-RED listo para producción en segundos.

🔗 Ver También​