Mandar Mensajes a Microsoft Teams con Node-RED

Esta guía explicará cómo enviar mensajes de inspección —incluyendo imágenes clicables— desde la cámara OV20i a un canal de Microsoft Teams utilizando un webhook. Al final de este proceso, la OV20i podrá publicar notificaciones con formato directamente a Teams.

Vista General

La OV20i incluye Node-RED como parte de su interfaz incorporada, lo que permite automatizar notificaciones y compartir resultados en tiempo real. Microsoft Teams admite webhooks entrantes que reciben mensajes en formato JSON. Al configurar un webhook en un canal de Teams y configurar el flujo en Node-RED desde la OV20i, se pueden enviar actualizaciones con enlaces a imágenes directamente a un espacio de trabajo compartido.

Requisitos Previos

Antes de comenzar, es necesario tener lo siguiente:

• La OV20i está conectada a la red local utilizando una IP estática o asignada por el departamento de TI.
• Microsoft Teams es accesible desde la misma red que la OV20i.
• Hay un canal de Teams donde se desea recibir las notificaciones.
• Node-RED está en ejecución en la OV20i y accesible desde un navegador.

Integración con Microsoft Teams

1. Crear un Webhook en Microsoft Teams

1. Abre Microsoft Teams y dirígete al canal donde deseas recibir los mensajes.
2. Haz clic en los tres puntos (•••) junto al nombre del canal > Administrar canal > Conectores.
3. Busca "Webhook de entrada" (Incoming Webhook) y haz clic en Agregar.
4. Elige un nombre (por ejemplo: Alertas de Inspección OV20i) y, opcionalmente, sube un ícono.
5. Haz clic en Crear y copia la URL del webhook generado. Guárdala, ya que la usarás en Node-RED.

Node-RED de OV20i

Nodos necesarios en Node-RED:

• inject
• function
• http request
• (opcional) debug

1. Nodo Inject

Se usa para pruebas manuales.

2. Nodo Función

Se usa esta función para dar formato al mensaje.

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

msg.payload = {
    text: "Tienes un nuevo mensaje de tu OV20i"
};

return msg;

También puedes usar msg.payload.image_url si la imagen proviene dinámicamente de los datos de inspección. De este modo, puedes hacer clic en el enlace y abrir la imagen en una nueva ventana.

let imageUrl = msg.payload.image_url;

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

msg.payload = {
    text: `Imagen de Inspección (${imageUrl})`
};

return msg;

3. Nodo HTTP Request

• Method: POST
• URL: Pegar aquí la URL del webhook de Teams
• Return: Cadena UTF-8

4. Nodo Debug (Optional)

Se usa para verificar si el mensaje fue enviado correctamente.

Notas sobre el formato del mensaje

• Microsoft Teams solo admite Markdown básico en mensajes enviados por webhook.
• La imagen debe ser accesible desde la máquina que ejecuta Teams. Asegúrate de que sea alcanzable a través de la red.

Pruebas y verificación

1. Haz clic en el botón al lado izquierdo del nodo inject.
2. Revisa el panel de depuración por si hay mensajes de error.
3. Verifica que el mensaje fue recibido en la dirección de destino.

Diagrama de conexión para usar Internet en tu OV20i