Microsoft Teams integracija

Šaljite obavijesti o slanjima fotografija direktno u vaše Microsoft Teams kanale.

Pregled

Povežite Visiono s Microsoft Teamsom za primanje trenutnih obavijesti kada se fotografije pošalju. Držite svoj tim informiranim bez napuštanja njihove platforme za suradnju.

Preduvjeti

• Visiono račun s pristupom API-ju
• Microsoft Teams radni prostor
• Dozvola za dodavanje konektora Teams kanalima
• API ključ iz Visiona (za napredne tijekove rada)

Koraci postavljanja

1. Kreirajte dolazni webhook u Teamsu

1. Otvorite Microsoft Teams
2. Navigirajte do kanala gdje želite obavijesti
3. Kliknite ... (više opcija) pored naziva kanala
4. Odaberite Connectors
5. Pronađite Incoming Webhook i kliknite Configure
6. Dajte webhoku naziv (npr. "Visiono fotografije")
7. Opcionalno učitajte prilagođenu ikonu
8. Kliknite Create
9. Kopirajte webhook URL (spremite ga za sljedeći korak)

2. Dodajte webhook u Visiono

1. Idite na Postavke radnog prostora → Webhooks
2. Kliknite Dodaj webhook
3. Zalijepite Teams webhook URL
4. Odaberite događaje za okidanje:
   • photo_request.submitted - Kada se sve fotografije pošalju
   • photo_submission.created - Kada stigne novo slanje
5. Spremite webhook

3. Testirajte vezu

1. Pošaljite testnu fotografiju u Visionu
2. Provjerite vaš Teams kanal za obavijest
3. Prilagodite postavke prema potrebi

Format poruke

Teams će primiti obavijesti formatirane kao Adaptive Cards:

{
  "@type": "MessageCard",
  "@context": "http://schema.org/extensions",
  "themeColor": "0076D7",
  "summary": "Novo slanje fotografija",
  "sections": [{
    "activityTitle": "Primljene nove fotografije",
    "activitySubtitle": "Od: Inspekcija vozila",
    "facts": [{
      "name": "Fotografije",
      "value": "5"
    }, {
      "name": "Poslano",
      "value": "2024-01-15 10:30"
    }],
    "markdown": true
  }],
  "potentialAction": [{
    "@type": "OpenUri",
    "name": "Pregled na nadzornoj ploči",
    "targets": [{
      "os": "default",
      "uri": "https://..."
    }]
  }]
}

Napredna integracija s Power Automate

Za složenije tijekove rada, koristite Microsoft Power Automate:

1. Kreirajte Power Automate tok

1. Idite na Power Automate
2. Kliknite Create → Automated cloud flow
3. Pretražite When a HTTP request is received
4. Konfigurirajte HTTP okidač

2. Dodajte Teams akcije

Popularne akcije:

Akcija	Slučaj korištenja
Post message	Pošalji u kanal
Post adaptive card	Bogata obavijest
Create channel	Organiziraj po projektu
Add member	Pozovi dionike

3. Primjer: Tok bogate obavijesti

1. Okidač: HTTP zahtjev (webhook iz Visiona)
2. Akcija: Parse JSON (ekstrahiraj podatke fotografija)
3. Akcija: Post Adaptive Card u Teams

Predložak Adaptive Card:

{
  "type": "AdaptiveCard",
  "body": [
    {
      "type": "TextBlock",
      "size": "Medium",
      "weight": "Bolder",
      "text": "Novo slanje fotografija"
    },
    {
      "type": "FactSet",
      "facts": [
        {"title": "Zahtjev", "value": "${request_name}"},
        {"title": "Fotografije", "value": "${photos_count}"},
        {"title": "Poslano", "value": "${submitted_at}"}
      ]
    },
    {
      "type": "Image",
      "url": "${first_photo_url}",
      "size": "Large"
    }
  ],
  "actions": [
    {
      "type": "Action.OpenUrl",
      "title": "Pregled fotografija",
      "url": "${dashboard_url}"
    }
  ]
}

Webhook payload

Visiono šalje ove 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": "inspekcija-vozila",
      "name": "Inspekcija vozila"
    },
    "photos": [
      {
        "id": "photo_001",
        "url": "https://...",
        "slot": 1,
        "slot_name": "Prednji pogled"
      }
    ],
    "metadata": {
      "unique_field": "ABC-123",
      "full_name": "Ivan Horvat",
      "submitted_at": "2024-01-15T10:30:00Z"
    }
  }
}

Organizacija kanala

Najbolje prakse

• Kreirajte namjenski kanal za obavijesti o fotografijama
• Koristite kartice kanala za ugradnju Visiono nadzorne ploče
• Prikvačite važne zahtjeve za vidljivost
• Koristite @oznake za hitna slanja

Imenovanje kanala

Predložena struktura:

• #visiono-fotografije - Sva slanja
• #visiono-hitno - Samo visoki prioritet
• #visiono-[projekt] - Specifično za projekt

Rješavanje problema

Obavijesti se ne pojavljuju

1. Provjerite je li webhook URL ispravan u Visionu
2. Provjerite je li webhook omogućen (zeleni status)
3. Osigurajte da je Teams konektor još uvijek aktivan
4. Testirajte s novim slanjem

Webhook URL nevažeći

1. Kreirajte novi Incoming Webhook u Teamsu
2. Ažurirajte URL u Visionu
3. Testirajte vezu

Problemi s formatom poruke

1. Provjerite da vrsta webhook događaja odgovara očekivanom formatu
2. Provjerite JSON strukturu u Visiono postavkama webhooka
3. Testirajte s Power Automate za prilagođeno formatiranje

Sigurnosna razmatranja

• Webhook URL-ovi trebaju ostati privatni
• Periodički rotirajte webhookove
• Koristite privatne kanale za osjetljive podatke
• Redovito pregledavajte povezane aplikacije

Povezani resursi

• Webhooks - Konfiguracija događaja
• API referenca - Direktan pristup API-ju
• Zapier integracija - Alternativna automatizacija
• Make integracija - Vizualna automatizacija