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 OV20i-Kamera direkt an einen Microsoft Teams-Kanal senden. Sie lernen, automatisierte Benachrichtigungen einzurichten, die Inspektionsergebnisse und anklickbare Bildlinks enthalten, damit Ihr Team sofort über den Produktionsstatus informiert ist.

Was Sie erstellen werden: Ein automatisiertes System, das OV20i-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.

Voraussetzungen​

  • OV20i-Kamera mit Ihrem Werksnetzwerk verbunden
  • Microsoft Teams-Zugriff mit Berechtigung zum Hinzufügen von Konnektoren
  • Teams-Kanal, in dem Sie Benachrichtigungen empfangen möchten
  • Netzwerkverbindung zwischen OV20i und Microsoft Teams
  • Grundkenntnisse von Node-RED Flows

Tutorial-Übersicht​

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

Erforderliche Zeit: 15-20 Minuten

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

Schritt 1: Microsoft Teams-Webhook einrichten​

1.1 Auf Ihren Teams-Kanal zugreifen​

  1. Öffnen Sie Microsoft Teams und navigieren Sie zum 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 Incoming Webhook-Konnektor hinzufügen​

  1. Klicken Sie auf "Konnektoren" im Kanal-Verwaltungsmenü
  2. Suchen Sie nach "Incoming Webhook" in der Konnektor-Liste
  3. Klicken Sie auf "Hinzufügen" neben der Incoming Webhook-Option

1.3 Webhook-Einstellungen konfigurieren​

  1. Name: Geben Sie einen aussagekräftigen Namen ein (z. B. "OV20i Inspektionsbenachrichtigungen")
  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

Prüfpunkt: Sie sollten nun eine Webhook-URL haben, die so aussieht: https://yourcompany.webhook.office.com/webhookb2/...

Schritt 2: Auf OV20i Node-RED zugreifen​

2.1 Zu Node-RED navigieren​

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

2.2 Arbeitsbereich vorbereiten​

  1. Schaffen Sie einen freien Bereich auf der Node-RED-Arbeitsfläche für Ihren Teams-Integrations-Flow
  2. Identifizieren Sie die Palette auf der linken Seite mit den verfügbaren Nodes
  3. Planen Sie Ihren Flow: Trigger → Process → An Teams senden

Schritt 3: Den Node-RED Flow erstellen​

3.1 Erforderliche Nodes hinzufügen​

Ziehen Sie diese Nodes von der Palette auf Ihre Arbeitsfläche:

  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 Die Nodes verbinden​

  1. Verbinden Sie den Inject-Ausgang mit dem Function-Eingang
  2. Verbinden Sie den Function-Ausgang mit dem HTTP request-Eingang
  3. Verbinden Sie den HTTP request-Ausgang mit dem Debug-Eingang (optional)

Flow-Struktur:

Inject → Function → HTTP Request → Debug

Schritt 4: Function Node konfigurieren​

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 OV20i"
};

return msg;

Für dynamische Prüfergebnisse 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 Prüfbenachrichtigung​

Für vollständige Prüfdetails:

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

  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: HTTP Request Node konfigurieren​

5.1 HTTP-Request einrichten​

  1. Doppelklicken Sie auf den HTTP Request Node, um ihn zu konfigurieren
  2. Method 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 Übersicht "Send to Teams" ein
  • Headers: Leer lassen (wird vom Function Node verarbeitet)
  • Payload: Auf "Ignore" belassen (wird vom Function Node verarbeitet)

5.3 HTTP-Konfiguration speichern​

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

Schritt 6: Integration testen​

6.1 Flow bereitstellen​

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

6.2 Mit Inject Node testen​

  1. Klicken Sie auf die Schaltfläche auf der linken Seite des Inject Node
  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 OV20i
  3. Testen Sie alle anklickbaren Links, um sicherzustellen, dass sie ordnungsgemäß funktionieren

Schritt 7: Integration mit dem Inspektionsflow​

7.1 Verbindung zu Prüfergebnissen herstellen​

So senden Sie nach jeder Inspektion automatische Benachrichtigungen:

  1. Suchen Sie Ihren Haupt-Inspektionsflow (beginnt normalerweise mit "All Block Outputs")
  2. Fügen Sie Ihre Teams-Benachrichtigung als Abzweigung vom Haupt-Flow hinzu
  3. Verbinden Sie sie nach der Inspektionsverarbeitung, aber vor den endgültigen Ergebnissen

7.2 Beispiel-Integrationsflow​

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

7.3 Benachrichtigungen filtern (optional)​

Um Benachrichtigungen nur für fehlgeschlagene Inspektionen zu senden:

// 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 verifizieren
HTTP-Fehler 400Bad-Request-Fehler im DebugNachrichtenformat prüfen, Content-Type-Header sicherstellen
Bildlinks funktionieren nichtNachricht erscheint, aber Bilder öffnen sich nichtSicherstellen, dass die Bild-URL aus dem Netzwerk der Teams-Benutzer erreichbar ist
Flow wird nicht ausgelöstKeine Debug-Ausgabe, wenn erwartetFlow-Verbindungen prüfen, Triggerbedingungen verifizieren

8.2 Flow debuggen​

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

8.3 Netzwerkverbindung​

  1. Sicherstellen, dass OV20i das Internet erreichen kann (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 verifizieren
  4. Aus dem Browser testen im selben Netzwerk wie die Kamera

Erfolg! Ihre Teams-Integration ist abgeschlossen​

Ihre OV20i-Kamera kann jetzt:

✅ Automatische Benachrichtigungen senden an Microsoft Teams-Kanäle

✅ Anklickbare Bildlinks einbinden zur sofortigen Inspektionsüberprüfung

✅ Benachrichtigungen filtern basierend auf Inspektionsergebnissen

✅ Umfassende Formatierung bereitstellen mit Inspektionsdetails und Zeitstempeln

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

Best Practices​

Nachrichtenverwaltung​

  • Beschreibende Kanalnamen verwenden für verschiedene Benachrichtigungstypen
  • Zeitstempel und Stationskennungen in Nachrichten einbinden
  • Nachrichten filtern, um Benachrichtigungsüberflutung zu vermeiden
  • Gründlich testen vor der Produktivbereitstellung

Sicherheitsaspekte​

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

Leistungsoptimierung​

  • 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 einzuhalten

image.png

Nächste Schritte​

Nach Einrichtung der Teams-Integration:

  1. Verschiedene Benachrichtigungskanäle erstellen für verschiedene Inspektionstypen
  2. Eskalations-Workflows einrichten für kritische Fehler
  3. Mit anderen Team-Tools integrieren (E-Mail, SMS usw.)
  4. Dashboards erstellen, die Teams mit anderen Monitoring-Tools kombinieren
  5. Team schulen im Umgang mit automatisierten Benachrichtigungen
Manuelle Einrichtung überspringen

Der Integration Builder kann vollständige Teams-Benachrichtigungs-Flows aus einer einfachen englischen Beschreibung generieren. Beschreiben Sie, was Sie möchten (z. B. „Inspektionsergebnisse mit Bildern in einen Teams-Kanal posten, wenn ein Teil fehlerhaft ist") und erhalten Sie in Sekunden einen produktionsreifen Node-RED-Flow.

🔗 Siehe auch​