Collegare Microsoft Teams

Mirox può pubblicare le tue notifiche direttamente in un canale Microsoft Teams — allarmi, attività dei ticket, report — così tutto il tuo team le vede dove già lavora. Il collegamento è un normale flusso di lavoro con webhook in ingresso di Teams: Teams ti fornisce un URL e tu registri quell'URL come webhook nelle impostazioni di notifica di Mirox. Non serve alcun plugin né installazione di app.

Prima di iniziare

• Ti serve, in Microsoft Teams, il permesso di aggiungere flussi di lavoro al canale di destinazione (la maggior parte dei membri del canale lo ha; l'amministratore di Teams può limitarlo).
• Decidi quale canale deve ricevere le notifiche di Mirox — un canale dedicato come Mirox Alerts le mantiene facili da seguire.

Passo 1 — Creare il flusso di lavoro webhook in Teams

1. In Microsoft Teams, vai al canale che deve ricevere le notifiche.
2. Fai clic sui tre puntini (⋯) accanto al nome del canale e scegli Flussi di lavoro (Workflows).
3. Seleziona il modello «Pubblica in un canale quando viene ricevuta una richiesta webhook» (in inglese: "Post to a channel when a webhook request is received").
4. Accedi o conferma la connessione se richiesto, mantieni o modifica il nome del flusso e fai clic su Avanti.
5. Conferma il team e il canale, poi fai clic su Aggiungi flusso di lavoro.
6. Teams mostra ora l'URL del webhook. Copialo, poi fai clic su Fatto.

Passo 2 — Aggiungere il webhook in Mirox

1. Apri il tuo Profilo e seleziona la scheda Notifiche.
2. Nella scheda Canali, sotto Webhook, fai clic su Aggiungi webhook.
3. Assegna un nome riconoscibile, per esempio Teams — Operazioni.
4. Incolla l'URL del flusso di lavoro preso da Teams.
5. Imposta il formato su Microsoft Teams — così Mirox invia messaggi che Teams può visualizzare come schede.
6. Salva. Mirox mostra il segreto di firma una sola volta — per un collegamento con Teams puoi semplicemente chiudere, vedi Sulle intestazioni di firma qui sotto.

Passo 3 — Inviare un messaggio di prova

1. Sulla riga del nuovo webhook, fai clic su Testa.
2. In pochi istanti, un messaggio di prova di Mirox compare nel tuo canale Teams.

Se non arriva nulla, verifica che l'URL sia stato copiato per intero e che il flusso di lavoro sia abilitato in Teams, poi riprova.

Instradare le notifiche verso Teams

Aggiungere il webhook rende disponibile il canale — ora assicurati che le notifiche lo usino davvero:

• Attiva l'interruttore principale Invia notifiche al di fuori dell'app nella scheda Notifiche.
• Assicurati che il canale webhook sia abilitato e selezionato per i gruppi di notifica che ti interessano nella scheda Cosa mi notifica (per impostazione predefinita, i gruppi seguono la tua selezione globale dei canali).

Da quel momento, le notifiche corrispondenti vengono pubblicate nel tuo canale Teams man mano che si verificano.

Sulle intestazioni di firma

Ogni richiesta webhook inviata da Mirox è firmata: contiene intestazioni di firma e di marca temporale calcolate a partire dal segreto di firma del webhook, così un sistema ricevente può verificare che la richiesta provenga davvero da Mirox e non sia una ripetizione. Microsoft Teams ignora queste intestazioni — il flusso di lavoro accetta qualsiasi richiesta ben formata che conosca l'URL —, quindi per un collegamento con Teams il segreto non ti serve mai. Diventa importante quando punti un webhook Generic JSON verso un tuo sistema e vuoi autenticare le richieste in ingresso; puoi riemetterlo in qualsiasi momento con Ruota il segreto.

Risoluzione dei problemi

Guide correlate

• Notifiche — la guida completa alle impostazioni di notifica: canali, gruppi, silenziamenti e orario di lavoro
• Ticket — l'attività dei ticket che può essere pubblicata in Teams