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

Was Sie erstellen werden: Ein automatisiertes System, das OV80i-Inspektionsergebnisse einschließlich Bildern und Pass/Fail-Status direkt in einem Microsoft Teams-Kanal veröffentlicht.

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​

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

Tutorial-Übersicht​

Was wir erstellen werden: Ein 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-Anfragen, 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 Connector hinzufügen​

  1. Klicken Sie auf „Connectoren" im Kanalverwaltungsmenü
  2. Suchen Sie nach „Incoming Webhook" in der Connector-Liste
  3. Klicken Sie auf „Hinzufügen" neben der Option Incoming Webhook

1.3 Webhook-Einstellungen konfigurieren​

  1. Name: Geben Sie einen aussagekräftigen Namen ein (z. B. „OV80i 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 für die Node-RED-Einrichtung entscheidend
  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 folgendermaßen aussieht: https://yourcompany.webhook.office.com/webhookb2/...

Schritt 2: Auf OV80i Node-RED zugreifen​

2.1 Zu Node-RED navigieren​

  1. Öffnen Sie Ihre OV80i-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 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 → Process → Send to 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 Die Nodes verbinden​

  1. Verbinden Sie den Ausgang des Inject-Nodes mit dem Eingang des Function-Nodes
  2. Verbinden Sie den Ausgang des Function-Nodes mit dem Eingang des HTTP request-Nodes
  3. Verbinden Sie den Ausgang des HTTP request-Nodes mit dem Eingang des Debug-Nodes (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 einfache Nachrichtenformat:
// Basic Teams message
msg.headers = {
    "Content-Type": "application/json"
};

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

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 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 verwaltet)
  • Payload: Auf "Ignore" belassen (wird vom Function Node verwaltet)

5.3 HTTP-Konfiguration speichern​

  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: 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. Prüfen Sie auf Fehleranzeigen an den Nodes (rote Dreiecke)

6.2 Mit Inject Node testen​

  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. Verifizieren Sie, dass die Nachricht in Ihrem Teams-Kanal erscheint

6.3 Teams-Benachrichtigung verifizieren​

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

Schritt 7: Integration mit dem Inspektionsflow​

7.1 Mit Inspektionsergebnissen verbinden​

So senden Sie automatische Benachrichtigungen nach jeder Inspektion:

  1. Suchen Sie Ihren Haupt-Inspektionsflow (beginnt üblicherweise mit "All Block Outputs")
  2. Fügen Sie Ihre Teams-Benachrichtigung als Zweig vom Haupt-Flow 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)​

Um nur Benachrichtigungen für fehlgeschlagene Prüfungen 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 lassen sich nicht öffnenSicherstellen, dass die Bild-URL aus dem Netzwerk der Teams-Benutzer erreichbar ist
Flow wird nicht ausgelöstKeine Debug-Ausgabe wie 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, falls nötig mit externen Tools testen

8.3 Netzwerkkonnektivität​

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

Erfolg! Ihre Teams-Integration ist abgeschlossen​

Ihre OV80i-Kamera kann nun:

✅ Automatische Benachrichtigungen senden an Microsoft Teams-Kanäle

✅ Anklickbare Bildlinks einbinden für sofortige Prüfungseinsicht

✅ Benachrichtigungen filtern basierend auf Prüfergebnissen

✅ Umfangreiche Formatierung bereitstellen mit Prüfdetails und Zeitstempeln

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

Best Practices​

Nachrichtenverwaltung​

  • Beschreibende Kanalnamen verwenden für unterschiedliche Benachrichtigungstypen
  • Zeitstempel und Stationskennungen in Nachrichten einbeziehen
  • Nachrichten filtern, um eine Überlastung mit Benachrichtigungen zu vermeiden
  • Gründlich testen vor dem Produktivbetrieb

Sicherheitshinweise​

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

Leistungsoptimierung​

  • Benachrichtigungen bündeln, falls viele Nachrichten gesendet werden
  • Geeignete Retry-Logik verwenden für Netzwerkausfälle
  • Erfolgsraten der Nachrichtenzustellung überwachen
  • Rate-Limiting implementieren, um Teams-API-Limits zu vermeiden

image.png

Nächste Schritte​

Nach Einrichtung der Teams-Integration:

  1. Verschiedene Benachrichtigungskanäle erstellen für unterschiedliche Prüfungstypen
  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 Überwachungstools kombinieren
  5. Ihr Team schulen im Umgang mit automatisierten Benachrichtigungen
Manuelle Einrichtung überspringen

Der Integration Builder kann vollständige Teams-Benachrichtigungs-Flows 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​