Saltar al contenido principal

DOCUMENTACIÓN CON IA

¿Qué desea saber?

Enviando Mensajes a Microsoft Teams con Node-RED

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

Lo que construirá: Un sistema automatizado que publica los resultados de inspección de OV80i, incluyendo imágenes y estado de aprobado/reprobado, 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 de equipo.

Prerrequisitos​

  • Cámara OV80i 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 OV80i y Microsoft Teams
  • Comprensión básica 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 imagen clicables.

Tiempo requerido: 15-20 minutos

Habilidades aprendidas: 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 Acceder a Su Canal de Teams​

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

1.2 Agregar 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 de Incoming Webhook

1.3 Configurar la Configuración del Webhook​

  1. Nombre: Ingrese un nombre descriptivo (por ejemplo, "Alertas de Inspección OV80i")
  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 un lugar seguro (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://suempresa.webhook.office.com/webhookb2/...

Paso 2: Acceder a OV80i Node-RED​

2.1 Navegar a Node-RED​

  1. Abra su interfaz web de OV80i
  2. Vaya a Editor de Recetas y haga clic en Configurar I/O o seleccione "Bloque de I/O" en el menú de migas de pan

2.2 Preparar Su Espacio de Trabajo​

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

Paso 3: Construir el Flujo de Node-RED​

3.1 Agregar Nodos Requeridos​

Arrastre estos nodos de la paleta a su lienzo:

  1. Nodo de inyección (para pruebas)
  2. Nodo de función (para formatear el mensaje)
  3. Nodo de solicitud HTTP (para enviar a Teams)
  4. Nodo de depuración (opcional, para solucionar problemas)

3.2 Conectar los Nodos​

  1. Conecte la salida de inyección a la entrada de función
  2. Conecte la salida de función a la entrada de solicitud HTTP
  3. Conecte la salida de solicitud HTTP a la entrada de depuración (opcional)

Estructura del flujo:

Inject → Function → HTTP Request → Debug

Paso 4: Configurar el Nodo de Función​

4.1 Configuración Básica del Mensaje​

  1. Haga doble clic en el nodo de función 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 OV80i"
};

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

Para 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 Configuración de la Función​

  1. Haga clic en "Listo" para guardar el nodo de función
  2. Asigne un nombre descriptivo al nodo como "Formato de Mensaje de Teams"

Paso 5: Configurar el Nodo de Solicitud HTTP​

5.1 Configurar Solicitud HTTP​

  1. Haga doble clic en el nodo de solicitud HTTP para configurar
  2. Establecer Método: Seleccione "POST" del menú desplegable
  3. Establecer URL: Pegue su URL de webhook de Teams del Paso 1.4
  4. Establecer Retorno: Seleccione "cadena UTF-8"

5.2 Configuraciones Adicionales​

  • Nombre: Ingrese "Enviar a Teams" para mayor claridad
  • Encabezados: Deje vacío (manejado por el nodo de función)
  • Carga Útil: Deje como "Ignorar" (manejado por el nodo de función)

5.3 Guardar Configuración HTTP​

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

Paso 6: Pruebe Su Integración​

6.1 Desplegar el Flujo​

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

6.2 Probar con el Nodo de Inyección​

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

6.3 Verificar Notificación de Teams​

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

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

7.1 Conectar a Resultados de Inspección​

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

  1. Encuentre su flujo de inspección principal (generalmente comienza con "Todas las Salidas de Bloque")
  2. Agregue su notificación de Teams como una rama del flujo principal
  3. Conéctese 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 notificaciones solo por 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 TeamsEl depurador muestra éxito pero no hay notificación en TeamsVerifique la URL del webhook, verifique la conectividad de red
Error HTTP 400Error de solicitud incorrecta en el depuradorVerifique el formato del mensaje, asegúrese de que el encabezado Content-Type esté presente
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 activaSin salida de depuración cuando se esperabaVerifique las conexiones del flujo, confirme las condiciones de activación

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 en busca de mensajes de error y estructura de datos
  3. Pruebe con el nodo de inyección 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 el OV80i 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 URLs del 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 OV80i ahora puede:

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

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

✅ Filtrar notificaciones basadas en los resultados de 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​

  • Utilice nombres de canal descriptivos para diferentes tipos de notificaciones
  • Incluya marcas 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 URLs de webhook - trátelas como credenciales sensibles
  • Utilice HTTPS para todas las comunicaciones (predeterminado con Teams)
  • Limite el acceso a la red solo a los servicios necesarios
  • Gire regularmente las URLs de webhook si se ven comprometidas

Optimización del Rendimiento​

  • Agrupe notificaciones si envía muchos mensajes
  • Utilice lógica de reintento apropiada para fallos de red
  • Monitoree las tasas de éxito de entrega de mensajes
  • 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 con Teams:

  1. Cree diferentes canales de notificación para varios tipos de inspección
  2. Configure flujos de escalación para fallos críticos
  3. Integre con otras herramientas del equipo (correo electrónico, SMS, etc.)
  4. Construya paneles combinando Teams con otras herramientas de monitoreo
  5. Entrene a su equipo sobre cómo responder a notificaciones automáticas
Salte la configuración manual

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

🔗 Ver También​