Microsoft Teams-Integration

Foto-Einreichungsbenachrichtigungen direkt an Ihre Microsoft Teams-Kanäle senden.

Übersicht

Verbinden Sie Visiono mit Microsoft Teams, um sofortige Benachrichtigungen zu erhalten, wenn Fotos eingereicht werden. Halten Sie Ihr Team informiert, ohne die Kollaborationsplattform zu verlassen.

Voraussetzungen

• Visiono-Konto mit API-Zugang
• Microsoft Teams-Arbeitsbereich
• Berechtigung, Connectors zu Teams-Kanälen hinzuzufügen
• API-Schlüssel von Visiono (für erweiterte Workflows)

Einrichtungsschritte

1. Eingehenden Webhook in Teams erstellen

1. Microsoft Teams öffnen
2. Zum Kanal navigieren, in dem Sie Benachrichtigungen möchten
3. Klicken Sie auf ... (weitere Optionen) neben dem Kanalnamen
4. Wählen Sie Connectors
5. Finden Sie Eingehender Webhook und klicken Sie auf Konfigurieren
6. Geben Sie Ihrem Webhook einen Namen (z.B. "Visiono Fotos")
7. Optional ein benutzerdefiniertes Symbol hochladen
8. Klicken Sie auf Erstellen
9. Kopieren Sie die Webhook-URL (speichern Sie diese für den nächsten Schritt)

2. Webhook zu Visiono hinzufügen

1. Gehen Sie zu Arbeitsbereicheinstellungen → Webhooks
2. Klicken Sie auf Webhook hinzufügen
3. Fügen Sie die Teams-Webhook-URL ein
4. Wählen Sie auszulösende Ereignisse:
   • photo_request.submitted - Wenn alle Fotos eingereicht wurden
   • photo_submission.created - Wenn eine neue Einreichung eingeht
5. Speichern Sie den Webhook

3. Verbindung testen

1. Testfoto in Visiono einreichen
2. Ihren Teams-Kanal auf Benachrichtigung prüfen
3. Einstellungen bei Bedarf anpassen

Nachrichtenformat

Teams empfängt Benachrichtigungen formatiert als Adaptive Cards:

{
  "@type": "MessageCard",
  "@context": "http://schema.org/extensions",
  "themeColor": "0076D7",
  "summary": "Neue Foto-Einreichung",
  "sections": [{
    "activityTitle": "Neue Fotos erhalten",
    "activitySubtitle": "Von: Fahrzeuginspektion",
    "facts": [{
      "name": "Fotos",
      "value": "5"
    }, {
      "name": "Eingereicht",
      "value": "2024-01-15 10:30"
    }],
    "markdown": true
  }],
  "potentialAction": [{
    "@type": "OpenUri",
    "name": "Im Dashboard anzeigen",
    "targets": [{
      "os": "default",
      "uri": "https://..."
    }]
  }]
}

Erweiterte Integration mit Power Automate

Für komplexere Workflows verwenden Sie Microsoft Power Automate:

1. Power Automate-Flow erstellen

1. Gehen Sie zu Power Automate
2. Klicken Sie auf Erstellen → Automatisierter Cloud-Flow
3. Suchen Sie nach Wenn eine HTTP-Anforderung empfangen wird
4. Konfigurieren Sie den HTTP-Trigger

2. Teams-Aktionen hinzufügen

Beliebte Aktionen:

Aktion	Anwendungsfall
Nachricht posten	An Kanal senden
Adaptive Card posten	Reichhaltige Benachrichtigung
Kanal erstellen	Nach Projekt organisieren
Mitglied hinzufügen	Stakeholder einladen

3. Beispiel: Reichhaltiger Benachrichtigungs-Flow

1. Trigger: HTTP-Anfrage (Webhook von Visiono)
2. Aktion: JSON parsen (Fotodaten extrahieren)
3. Aktion: Adaptive Card an Teams posten

Adaptive Card-Vorlage:

{
  "type": "AdaptiveCard",
  "body": [
    {
      "type": "TextBlock",
      "size": "Medium",
      "weight": "Bolder",
      "text": "Neue Foto-Einreichung"
    },
    {
      "type": "FactSet",
      "facts": [
        {"title": "Anfrage", "value": "${request_name}"},
        {"title": "Fotos", "value": "${photos_count}"},
        {"title": "Eingereicht", "value": "${submitted_at}"}
      ]
    },
    {
      "type": "Image",
      "url": "${first_photo_url}",
      "size": "Large"
    }
  ],
  "actions": [
    {
      "type": "Action.OpenUrl",
      "title": "Fotos anzeigen",
      "url": "${dashboard_url}"
    }
  ]
}

Webhook-Payload

Visiono sendet diese Daten an Ihren Teams-Webhook:

{
  "event": "submission.created",
  "timestamp": "2024-01-15T10:30:00Z",
  "data": {
    "submission_id": "sub_abc123",
    "permanent_link": {
      "id": "pl_xyz789",
      "slug": "fahrzeuginspektion",
      "name": "Fahrzeuginspektion"
    },
    "photos": [
      {
        "id": "photo_001",
        "url": "https://...",
        "slot": 1,
        "slot_name": "Vorderansicht"
      }
    ],
    "metadata": {
      "unique_field": "ABC-123",
      "full_name": "Max Mustermann",
      "submitted_at": "2024-01-15T10:30:00Z"
    }
  }
}

Kanal-Organisation

Best Practices

• Dedizierten Kanal für Foto-Benachrichtigungen erstellen
• Kanal-Tabs verwenden, um Visiono-Dashboard einzubetten
• Wichtige Anfragen für Sichtbarkeit anheften
• @Erwähnungen für dringende Einreichungen verwenden

Kanal-Benennung

Empfohlene Struktur:

• #visiono-fotos - Alle Einreichungen
• #visiono-dringend - Nur hohe Priorität
• #visiono-[projekt] - Projektspezifisch

Fehlerbehebung

Benachrichtigungen erscheinen nicht

1. Verifizieren, dass Webhook-URL in Visiono korrekt ist
2. Prüfen, ob Webhook aktiviert ist (grüner Status)
3. Sicherstellen, dass Teams-Connector noch aktiv ist
4. Mit neuer Einreichung testen

Webhook-URL ungültig

1. Neuen eingehenden Webhook in Teams erstellen
2. URL in Visiono aktualisieren
3. Verbindung testen

Nachrichtenformat-Probleme

1. Webhook-Ereignistyp auf erwartetes Format prüfen
2. JSON-Struktur in Visiono-Webhook-Einstellungen verifizieren
3. Mit Power Automate für benutzerdefinierte Formatierung testen

Sicherheitsüberlegungen

• Webhook-URLs sollten privat gehalten werden
• Webhooks regelmäßig rotieren
• Private Kanäle für sensible Daten verwenden
• Verbundene Apps regelmäßig überprüfen

Verwandte Ressourcen

• Webhooks - Ereigniskonfiguration
• API-Referenz - Direkter API-Zugriff
• Zapier-Integration - Alternative Automatisierung
• Make-Integration - Visuelle Automatisierung