Zum Hauptinhalt springen

KI-GESTÜTZTE DOKUMENTATION

Was möchten Sie wissen?

Senden von Nachrichten an Microsoft Teams mit Node-RED

Dieses Tutorial zeigt Ihnen, wie Sie Inspektionsbenachrichtigungen von Ihrer OV10i-Kamera direkt an einen Microsoft Teams-Kanal senden. Sie lernen, automatisierte Benachrichtigungen einzurichten, die Inspektionsergebnisse und klickbare Bildlinks enthalten, damit Ihr Team sofort über den Produktionsstatus informiert ist.

Was Sie erstellen werden: Ein automatisiertes System, das OV10i-Inspektionsergebnisse einschließlich Bildern und Pass/Fail-Status direkt in einen Microsoft Teams-Kanal postet.

Praxisanwendung: Erhalten Sie sofortige Benachrichtigungen bei fehlgeschlagenen Inspektionen, teilen Sie Inspektionsbilder mit Remote-Teams oder erstellen Sie automatisierte Qualitätsberichte in Ihrem Team-Kollaborationsbereich.

Manuelle Einrichtung überspringen

Beschreiben Sie auf Englisch, welche Teams-Benachrichtigungen Sie benötigen, und der Auto-Integration Builder generiert in Sekundenschnelle einen vollständigen Node-RED-Flow für Sie.

Voraussetzungen​

  • OV10i-Kamera mit Ihrem Werksnetzwerk verbunden
  • Microsoft Teams-Zugang mit Berechtigung zum Hinzufügen von Konnektoren
  • Teams-Kanal, in dem Sie Benachrichtigungen erhalten möchten
  • Netzwerkverbindung zwischen OV10i und Microsoft Teams
  • Grundlegendes Verständnis von Node-RED-Flows

Tutorial-Übersicht​

Was wir erstellen werden: Einen Node-RED-Flow, der Inspektionsergebnisse automatisch mit klickbaren Bildlinks an Microsoft Teams sendet.

Zeitaufwand: 15-20 Minuten

Erlernte Fähigkeiten: Teams-Webhook-Integration, Node-RED HTTP-Anfragen, automatisierte Benachrichtigungssysteme

Schritt 1: Microsoft Teams Webhook einrichten​

1.1 Auf Ihren Teams-Kanal zugreifen​

  1. Öffnen Sie Microsoft Teams und navigieren Sie zu dem Kanal für Inspektionsbenachrichtigungen
  2. Klicken Sie auf die drei Punkte (•••) neben dem Kanalnamen
  3. Wählen Sie "Kanal verwalten" aus dem Dropdown-Menü

1.2 Eingehenden Webhook-Konnektor hinzufügen​

  1. Klicken Sie im Kanalverwaltungsmenü auf "Konnektoren"
  2. Suchen Sie nach "Incoming Webhook" in der Konnektorliste
  3. Klicken Sie neben der Option "Incoming Webhook" auf "Hinzufügen"

1.3 Webhook-Einstellungen konfigurieren​

  1. Name: Geben Sie einen aussagekräftigen Namen ein (z. B. "OV10i Inspection Alerts")
  2. Symbol: Laden Sie optional ein benutzerdefiniertes Symbol für Ihre Benachrichtigungen hoch
  3. Klicken Sie auf "Erstellen", um den Webhook zu generieren

1.4 Webhook-URL speichern​

  1. Kopieren Sie die generierte Webhook-URL – diese ist entscheidend für die Node-RED-Einrichtung
  2. Speichern Sie die URL an einem sicheren Ort (Sie benötigen sie in Schritt 2)
  3. Klicken Sie auf "Fertig", um die Teams-Einrichtung abzuschließen

Checkpoint: Sie sollten nun eine Webhook-URL haben, die wie folgt aussieht: https://yourcompany.webhook.office.com/webhookb2/...

Schritt 2: Zugriff auf OV10i Node-RED​

2.1 Zu Node-RED navigieren​

  1. Öffnen Sie Ihre OV10i Weboberfläche
  2. Gehen Sie zum Recipe Editor und klicken Sie auf Configure I/O oder wählen Sie "IO Block" im Breadcrumb-Menü

2.2 Arbeitsbereich vorbereiten​

  1. Räumen Sie einen Bereich im Node-RED-Canvas für Ihren Teams-Integrationsflow frei
  2. Identifizieren Sie die Palette auf der linken Seite mit den verfügbaren Nodes
  3. Planen Sie Ihren Flow: Trigger → Verarbeitung → Senden an Teams

Schritt 3: Den Node-RED-Flow erstellen​

3.1 Erforderliche Nodes hinzufügen​

Ziehen Sie diese Nodes aus der Palette auf Ihren Canvas:

  1. Inject Node (zum Testen)
  2. Function Node (zum Formatieren der Nachricht)
  3. HTTP Request Node (zum Senden an Teams)
  4. Debug Node (optional, zur Fehlerbehebung)

3.2 Verbinden der Nodes​

  1. Verbinden Sie den Ausgang von inject mit dem Eingang von function
  2. Verbinden Sie den Ausgang von function mit dem Eingang von HTTP request
  3. Verbinden Sie den Ausgang von HTTP request mit dem Eingang von debug (optional)

Flow-Struktur:

Inject → Function → HTTP Request → Debug

Schritt 4: Konfigurieren des Function Nodes​

4.1 Grundlegende Nachrichtenkonfiguration​

  1. Doppelklicken Sie auf den Function Node, um die Konfiguration zu öffnen
  2. Ersetzen Sie den Standardcode durch dieses grundlegende Nachrichtenformat:
// Basic Teams message
msg.headers = {
    "Content-Type": "application/json"
};

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

return msg;

Für dynamische Inspektionsergebnisse mit anklickbaren Bildern:

// 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 Vollständige Inspektionsbenachrichtigung​

Für vollständige Inspektionsdetails:

// 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 Speichern der Function-Konfiguration​

  1. Klicken Sie auf „Done", um den Function Node zu speichern
  2. Geben Sie dem Node einen aussagekräftigen Namen wie „Format Teams Message"

Schritt 5: Konfigurieren des HTTP Request Nodes​

5.1 HTTP Request einrichten​

  1. Doppelklicken Sie auf den HTTP Request Node, um ihn zu konfigurieren
  2. Methode festlegen: Wählen Sie „POST" aus dem Dropdown-Menü
  3. URL festlegen: Fügen Sie Ihre Teams-Webhook-URL aus Schritt 1.4 ein
  4. Return festlegen: Wählen Sie „UTF-8 string"

5.2 Zusätzliche Einstellungen​

  • Name: Geben Sie zur Klarheit „Send to Teams" ein
  • Headers: Leer lassen (wird vom Function Node verarbeitet)
  • Payload: Auf „Ignore" belassen (wird vom Function Node verarbeitet)

5.3 Speichern der HTTP-Konfiguration​

  1. Klicken Sie auf „Done", um den HTTP Request Node zu speichern
  2. Überprüfen Sie die Webhook-URL auf Korrektheit – dies ist entscheidend für den Erfolg

Schritt 6: Testen Ihrer Integration​

6.1 Bereitstellen des Flows​

  1. Klicken Sie auf die Schaltfläche „Deploy" in der oberen rechten Ecke
  2. Warten Sie auf die Bestätigung „Successfully deployed"
  3. Prüfen Sie auf Fehleranzeigen an den Nodes (rote Dreiecke)

6.2 Test mit dem Inject Node​

  1. Klicken Sie auf die Schaltfläche auf der linken Seite des Inject Nodes
  2. Überprüfen Sie das Debug-Panel (rechte Seitenleiste) auf Fehlermeldungen
  3. Vergewissern Sie sich, dass die Nachricht in Ihrem Teams-Kanal erscheint

6.3 Teams-Benachrichtigung überprüfen​

  1. Wechseln Sie zu Microsoft Teams und überprüfen Sie Ihren Zielkanal
  2. Suchen Sie nach der Testnachricht von Ihrem OV10i
  3. Testen Sie alle anklickbaren Links, um sicherzustellen, dass sie ordnungsgemäß funktionieren

Schritt 7: Integration mit dem Inspektions-Flow​

7.1 Verbindung mit Inspektionsergebnissen​

So senden Sie automatische Benachrichtigungen nach jeder Inspektion:

  1. Suchen Sie Ihren Haupt-Inspektions-Flow (beginnt üblicherweise mit „All Block Outputs")
  2. Fügen Sie Ihre Teams-Benachrichtigung als Verzweigung des Haupt-Flows hinzu
  3. Verbinden Sie sie nach der Inspektionsverarbeitung, aber vor den Endergebnissen

7.2 Beispiel für einen Integrations-Flow​

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

7.3 Benachrichtigungen filtern (Optional)​

So senden Sie nur Benachrichtigungen für fehlgeschlagene Inspektionen:

// 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
}

Schritt 8: Fehlerbehebung​

8.1 Häufige Probleme​

ProblemSymptomeLösung
Keine Nachricht in TeamsDebug zeigt Erfolg, aber keine Teams-BenachrichtigungWebhook-URL prüfen, Netzwerkverbindung überprüfen
HTTP-Fehler 400Bad-Request-Fehler im DebugNachrichtenformat prüfen, Content-Type-Header sicherstellen
Bildlinks funktionieren nichtNachricht erscheint, aber Bilder lassen sich nicht öffnenSicherstellen, dass die Bild-URL aus dem Netzwerk der Teams-Nutzer erreichbar ist
Flow wird nicht ausgelöstKeine Debug-Ausgabe trotz ErwartungFlow-Verbindungen prüfen, Auslösebedingungen überprüfen

8.2 Debuggen Ihres Flows​

  1. Debug-Nodes hinzufügen nach jedem Schritt, um den Datenfluss zu verfolgen
  2. Debug-Panel prüfen auf Fehlermeldungen und Datenstrukturen
  3. Mit Inject-Node testen, um Konfigurationsprobleme zu isolieren
  4. Webhook-URL verifizieren bei Bedarf mit externen Tools

8.3 Netzwerkkonnektivität​

  1. Sicherstellen, dass OV10i das Internet erreicht (Ping-Test von der Kamera)
  2. Firewall-Einstellungen prüfen, die ausgehendes HTTPS blockieren könnten
  3. DNS-Auflösung für Teams-Webhook-URLs überprüfen
  4. Aus dem Browser testen im selben Netzwerk wie die Kamera

Erfolg! Ihre Teams-Integration ist abgeschlossen​

Ihre OV10i-Kamera kann nun:

✅ Automatische Benachrichtigungen senden an Microsoft Teams-Kanäle

✅ Klickbare Bildlinks einbinden für die sofortige Inspektionsüberprüfung

✅ Benachrichtigungen filtern basierend auf Inspektionsergebnissen

✅ Umfangreiche Formatierung bereitstellen mit Inspektionsdetails und Zeitstempeln

✅ Mehrere Kanäle unterstützen für verschiedene Benachrichtigungstypen

Best Practices​

Nachrichtenverwaltung​

  • Aussagekräftige Kanalnamen verwenden für verschiedene Benachrichtigungstypen
  • Zeitstempel und Stationskennungen einbinden in Nachrichten
  • Nachrichten filtern, um Benachrichtigungsüberlastung zu vermeiden
  • Gründlich testen vor dem Produktiveinsatz

Sicherheitsaspekte​

  • Webhook-URLs schützen – behandeln Sie sie wie sensible Zugangsdaten
  • HTTPS verwenden für alle Kommunikationen (Standard bei Teams)
  • Netzwerkzugriff beschränken auf erforderliche Dienste
  • Webhook-URLs regelmäßig rotieren, falls kompromittiert

Performance-Optimierung​

  • Benachrichtigungen bündeln, wenn viele Nachrichten gesendet werden
  • Geeignete Retry-Logik verwenden bei Netzwerkfehlern
  • Erfolgsraten der Nachrichtenzustellung überwachen
  • Rate Limiting implementieren, um Teams-API-Limits zu vermeiden

image.png

Nächste Schritte​

Nach der Einrichtung der Teams-Integration:

  1. Erstellen Sie verschiedene Benachrichtigungskanäle für unterschiedliche Inspektionstypen
  2. Richten Sie Eskalations-Workflows für kritische Fehler ein
  3. Integrieren Sie weitere Team-Tools (E-Mail, SMS usw.)
  4. Erstellen Sie Dashboards, die Teams mit anderen Monitoring-Tools kombinieren
  5. Schulen Sie Ihr Team im Umgang mit automatisierten Benachrichtigungen
Manuelle Einrichtung überspringen

Der Integration Builder kann komplette Teams-Benachrichtigungsflows aus einer einfachen Beschreibung in englischer Sprache generieren. Beschreiben Sie, was Sie möchten (z. B. „post inspection results with images to a Teams channel when a part fails") und erhalten Sie in Sekunden einen produktionsreifen Node-RED-Flow.

🔗 Siehe auch​