Microsoft Teams integracija

Pošljite obvestila o oddajah fotografij neposredno v svoje Microsoft Teams kanale.

Pregled

Povežite Visiono z Microsoft Teams za prejemanje takojšnjih obvestil, ko so fotografije oddane. Ohranite svojo ekipo obveščeno brez zapuščanja njihove platforme za sodelovanje.

Predpogoji

• Visiono račun z dostopom do API
• Microsoft Teams delovni prostor
• Dovoljenje za dodajanje konektorjev v Teams kanale
• API ključ iz Visiono (za napredne delovne tokove)

Koraki nastavitve

1. Ustvarite dohodni webhook v Teams

1. Odprite Microsoft Teams
2. Pojdite na kanal, kjer želite obvestila
3. Kliknite ... (več možnosti) poleg imena kanala
4. Izberite Connectors
5. Poiščite Incoming Webhook in kliknite Configure
6. Dajte svojemu webhooku ime (npr. "Visiono fotografije")
7. Neobvezno naložite prilagojeno ikono
8. Kliknite Create
9. Kopirajte webhook URL (shranite za naslednji korak)

2. Dodajte webhook v Visiono

1. Pojdite na Nastavitve delovnega prostora → Webhooks
2. Kliknite Dodaj webhook
3. Prilepite Teams webhook URL
4. Izberite dogodke za sprožitev:
   • photo_request.submitted - Ko so vse fotografije oddane
   • photo_submission.created - Ko prispe nova oddaja
5. Shranite webhook

3. Preizkusite povezavo

1. Oddajte testno fotografijo v Visiono
2. Preverite svoj Teams kanal za obvestilo
3. Po potrebi prilagodite nastavitve

Format sporočila

Teams bo prejel obvestila formatirana kot Adaptive Cards:

{
  "@type": "MessageCard",
  "@context": "http://schema.org/extensions",
  "themeColor": "0076D7",
  "summary": "Nova oddaja fotografij",
  "sections": [{
    "activityTitle": "Prejete nove fotografije",
    "activitySubtitle": "Od: Pregled vozila",
    "facts": [{
      "name": "Fotografije",
      "value": "5"
    }, {
      "name": "Oddano",
      "value": "2024-01-15 10:30"
    }],
    "markdown": true
  }],
  "potentialAction": [{
    "@type": "OpenUri",
    "name": "Ogled na nadzorni plošči",
    "targets": [{
      "os": "default",
      "uri": "https://..."
    }]
  }]
}

Napredna integracija s Power Automate

Za bolj kompleksne delovne tokove uporabite Microsoft Power Automate:

1. Ustvarite Power Automate Flow

1. Pojdite na Power Automate
2. Kliknite Create → Automated cloud flow
3. Poiščite When a HTTP request is received
4. Konfigurirajte HTTP sprožilec

2. Dodajte Teams akcije

Priljubljene akcije:

Akcija	Primer uporabe
Post message	Pošlji v kanal
Post adaptive card	Bogato obvestilo
Create channel	Organiziraj po projektu
Add member	Povabi deležnike

3. Primer: Tok bogatega obvestila

1. Sprožilec: HTTP zahteva (webhook iz Visiono)
2. Akcija: Parse JSON (izvleči foto podatke)
3. Akcija: Post Adaptive Card v Teams

Predloga Adaptive Card:

{
  "type": "AdaptiveCard",
  "body": [
    {
      "type": "TextBlock",
      "size": "Medium",
      "weight": "Bolder",
      "text": "Nova oddaja fotografij"
    },
    {
      "type": "FactSet",
      "facts": [
        {"title": "Zahteva", "value": "${request_name}"},
        {"title": "Fotografije", "value": "${photos_count}"},
        {"title": "Oddano", "value": "${submitted_at}"}
      ]
    },
    {
      "type": "Image",
      "url": "${first_photo_url}",
      "size": "Large"
    }
  ],
  "actions": [
    {
      "type": "Action.OpenUrl",
      "title": "Ogled fotografij",
      "url": "${dashboard_url}"
    }
  ]
}

Webhook vsebina

Visiono pošlje te podatke na vaš Teams webhook:

{
  "event": "submission.created",
  "timestamp": "2024-01-15T10:30:00Z",
  "data": {
    "submission_id": "sub_abc123",
    "permanent_link": {
      "id": "pl_xyz789",
      "slug": "pregled-vozila",
      "name": "Pregled vozila"
    },
    "photos": [
      {
        "id": "photo_001",
        "url": "https://...",
        "slot": 1,
        "slot_name": "Pogled spredaj"
      }
    ],
    "metadata": {
      "unique_field": "ABC-123",
      "full_name": "Janez Novak",
      "submitted_at": "2024-01-15T10:30:00Z"
    }
  }
}

Organizacija kanalov

Najboljše prakse

• Ustvarite namenski kanal za foto obvestila
• Uporabite zavihke kanala za vdelavo Visiono nadzorne plošče
• Pripnite pomembne zahteve za vidljivost
• Uporabite @omembe za nujne oddaje

Poimenovanje kanalov

Predlagana struktura:

• #visiono-fotografije - Vse oddaje
• #visiono-nujno - Samo visoka prioriteta
• #visiono-[projekt] - Specifično za projekt

Odpravljanje težav

Obvestila se ne pojavljajo

1. Preverite, ali je webhook URL pravilen v Visiono
2. Preverite, ali je webhook omogočen (zelen status)
3. Zagotovite, da je Teams konektor še aktiven
4. Preizkusite z novo oddajo

Webhook URL neveljaven

1. Ustvarite nov dohodni webhook v Teams
2. Posodobite URL v Visiono
3. Preizkusite povezavo

Težave s formatom sporočila

1. Preverite, ali se vrsta webhook dogodka ujema s pričakovanim formatom
2. Preverite strukturo JSON v nastavitvah Visiono webhooka
3. Preizkusite s Power Automate za prilagojeno formatiranje

Varnostni premisleki

• Webhook URL-je ohranite zasebne
• Periodično rotirajte webhooks
• Uporabite zasebne kanale za občutljive podatke
• Redno pregledujte povezane aplikacije

Povezani viri

• Webhooks - Konfiguracija dogodkov
• API referenca - Neposreden dostop do API
• Zapier integracija - Alternativna avtomatizacija
• Make integracija - Vizualna avtomatizacija