Integrazione Microsoft Teams

Invia notifiche invii foto direttamente ai tuoi canali Microsoft Teams.

Panoramica

Connetti Visiono a Microsoft Teams per ricevere notifiche istantanee quando vengono inviate foto. Mantieni il tuo team informato senza lasciare la piattaforma di collaborazione.

Prerequisiti

• Account Visiono con accesso API
• Workspace Microsoft Teams
• Permesso di aggiungere connettori ai canali Teams
• Chiave API da Visiono (per workflow avanzati)

Passaggi di Setup

1. Creare Incoming Webhook in Teams

1. Apri Microsoft Teams
2. Naviga al canale dove vuoi le notifiche
3. Clicca ... (altre opzioni) accanto al nome canale
4. Seleziona Connettori
5. Trova Incoming Webhook e clicca Configura
6. Dai al webhook un nome (es. "Foto Visiono")
7. Opzionalmente carica un'icona personalizzata
8. Clicca Crea
9. Copia l'URL webhook (salvalo per il passo successivo)

2. Aggiungere Webhook a Visiono

1. Vai a Impostazioni Workspace → Webhook
2. Clicca Aggiungi Webhook
3. Incolla l'URL webhook Teams
4. Seleziona eventi da attivare:
   • photo_request.submitted - Quando tutte le foto sono inviate
   • photo_submission.created - Quando arriva un nuovo invio
5. Salva il webhook

3. Testare la Connessione

1. Invia una foto di test in Visiono
2. Controlla il canale Teams per la notifica
3. Regola impostazioni se necessario

Formato Messaggio

Teams riceverà notifiche formattate come Adaptive Card:

{
  "@type": "MessageCard",
  "@context": "http://schema.org/extensions",
  "themeColor": "0076D7",
  "summary": "Nuovo Invio Foto",
  "sections": [{
    "activityTitle": "Nuove foto ricevute",
    "activitySubtitle": "Da: Ispezione Veicolo",
    "facts": [{
      "name": "Foto",
      "value": "5"
    }, {
      "name": "Inviato",
      "value": "2024-01-15 10:30"
    }],
    "markdown": true
  }],
  "potentialAction": [{
    "@type": "OpenUri",
    "name": "Visualizza in Dashboard",
    "targets": [{
      "os": "default",
      "uri": "https://..."
    }]
  }]
}

Integrazione Avanzata con Power Automate

Per workflow più complessi, usa Microsoft Power Automate:

1. Creare un Flow Power Automate

1. Vai a Power Automate
2. Clicca Crea → Flusso cloud automatizzato
3. Cerca Quando viene ricevuta una richiesta HTTP
4. Configura il trigger HTTP

2. Aggiungere Azioni Teams

Azioni popolari:

Azione	Caso d'Uso
Post message	Invia a canale
Post adaptive card	Notifica ricca
Create channel	Organizza per progetto
Add member	Invita stakeholder

3. Esempio: Flow Notifica Ricca

1. Trigger: Richiesta HTTP (webhook da Visiono)
2. Action: Parse JSON (estrai dati foto)
3. Action: Post Adaptive Card a Teams

Template Adaptive Card:

{
  "type": "AdaptiveCard",
  "body": [
    {
      "type": "TextBlock",
      "size": "Medium",
      "weight": "Bolder",
      "text": "Nuovo Invio Foto"
    },
    {
      "type": "FactSet",
      "facts": [
        {"title": "Richiesta", "value": "${request_name}"},
        {"title": "Foto", "value": "${photos_count}"},
        {"title": "Inviato", "value": "${submitted_at}"}
      ]
    },
    {
      "type": "Image",
      "url": "${first_photo_url}",
      "size": "Large"
    }
  ],
  "actions": [
    {
      "type": "Action.OpenUrl",
      "title": "Visualizza Foto",
      "url": "${dashboard_url}"
    }
  ]
}

Payload Webhook

Visiono invia questi dati al tuo webhook Teams:

{
  "event": "submission.created",
  "timestamp": "2024-01-15T10:30:00Z",
  "data": {
    "submission_id": "sub_abc123",
    "permanent_link": {
      "id": "pl_xyz789",
      "slug": "ispezione-veicolo",
      "name": "Ispezione Veicolo"
    },
    "photos": [
      {
        "id": "photo_001",
        "url": "https://...",
        "slot": 1,
        "slot_name": "Vista Frontale"
      }
    ],
    "metadata": {
      "unique_field": "ABC-123",
      "full_name": "Mario Rossi",
      "submitted_at": "2024-01-15T10:30:00Z"
    }
  }
}

Organizzazione Canali

Best Practice

• Crea un canale dedicato per notifiche foto
• Usa schede canale per incorporare dashboard Visiono
• Fissa richieste importanti per visibilità
• Usa @menzioni per invii urgenti

Naming Canali

Struttura suggerita:

• #visiono-foto - Tutti gli invii
• #visiono-urgenti - Solo alta priorità
• #visiono-[progetto] - Specifico progetto

Risoluzione Problemi

Notifiche Non Appaiono

1. Verifica che URL webhook sia corretto in Visiono
2. Controlla che webhook sia abilitato (stato verde)
3. Assicura che connettore Teams sia ancora attivo
4. Testa con un nuovo invio

URL Webhook Non Valido

1. Crea un nuovo Incoming Webhook in Teams
2. Aggiorna l'URL in Visiono
3. Testa la connessione

Problemi Formato Messaggio

1. Controlla che tipo evento webhook corrisponda al formato atteso
2. Verifica struttura JSON nelle impostazioni webhook Visiono
3. Testa con Power Automate per formattazione personalizzata

Considerazioni Sicurezza

• Gli URL webhook devono essere mantenuti privati
• Ruota webhook periodicamente
• Usa canali privati per dati sensibili
• Rivedi app connesse regolarmente

Risorse Correlate

• Webhook - Configurazione eventi
• Riferimento API - Accesso API diretto
• Integrazione Zapier - Automazione alternativa
• Integrazione Make - Automazione visuale