Notifiche di Microsoft Teams

Avvertimento

Microsoft ha deciso di ritirare i propri connettori Office 365. Il nuovo modo di connettere Microsoft Teams con strumenti di terze parti è tramite Flussi di lavoro in Teams.

Nel periodo di transizione, abbiamo deciso di mantenere questa guida così com’è. Assicurati di seguire la guida di Microsoft come sostituzione per il passaggio 1 qui sotto, per connettere Teams e Zammad tramite Flussi di lavoro.

Se utilizzi già questo webhook e non hai personalizzato il payload, il nuovo webhook viene utilizzato automaticamente dopo l’aggiornamento di Zammad. In questo caso, devi solo creare il flusso di lavoro per il tuo canale in Microsoft Teams. Altrimenti, dovrai anche regolare manualmente il payload in Zammad. Vedi Payload di Microsoft Teams dove puoi trovare i valori predefiniti vecchi e nuovi nel caso ne avessi bisogno.

Per gestire la connessione in Zammad, puoi proseguire con il passaggio 2 in questa pagina.

Segui i passaggi qui sotto per configurare un webhook per ricevere le notifiche di Zammad in un canale Microsoft Teams.

Passaggio 1 - Configura il connettore webhook in entrata nel tuo canale Teams

Nel tuo canale Teams di destinazione, fai clic sul menu overflow nell’angolo in alto a destra e scegli Connettori.

Trova un connettore chiamato Webhook in entrata nell’elenco e fai clic sul pulsante Configura accanto ad esso.

Fornisci un nome appropriato per il connettore webhook in entrata, tenendo a mente che questo verrà utilizzato come nome per tutti i messaggi di notifica nel canale.

Opzionalmente, fornisci un’immagine personalizzata che verrà utilizzata come avatar.

Fai clic su Crea e sii paziente.

Una volta creato, assicurati di copiare l’URL dell’endpoint del webhook negli appunti e salvalo per dopo. Puoi farlo con un clic tramite il pulsante mostrato accanto al campo.

Infine, chiudi la configurazione del connettore facendo clic su Fatto.

Passaggio 2 - Aggiungi un Webhook Predefinito in Zammad

Vai alla schermata di gestione Webhook nella tua istanza Zammad e clicca sulla freccia accanto al pulsante verde nell’angolo in alto a destra. Scegli Webhook Predefinito dal menu a discesa.

Nella finestra di dialogo modale successiva, seleziona Notifiche di Microsoft Teams come webhook predefinito.

Clicca Avanti.

Nella nuova finestra di dialogo, incolla l’URL dell’endpoint del webhook da Microsoft Teams nel campo Endpoint.

Infine, clicca su Invia.

Passaggio 3 - Configurazione di un Trigger per l’attivazione del Webhook

Come ultimo passaggio, devi creare un Trigger per inviare una notifica al canale Microsoft Teams in determinate condizioni.

Una volta che il trigger è attivo, il tuo webhook è pronto per l’uso!

Esempio di notifica del canale Teams

D’ora in poi, ogni volta che un ticket viene creato o aggiornato nel tuo sistema Zammad, una notifica appropriata verrà pubblicata nel canale Teams configurato. La notifica conterrà il link al ticket, i dati aggiornati e il contenuto dell’ultimo articolo. Sarà anche codificata a colori in base al suo ultimo stato.

Rimozione del contenuto dell’articolo dalla notifica di Teams

Se sei preoccupato di divulgare contenuti sensibili degli articoli tramite notifiche, c’è un modo per rimuoverli personalizzando ulteriormente il payload del webhook.

Trova il tuo webhook nell’elenco nella schermata di gestione e cliccaci sopra per modificarlo.

Attiva Payload Personalizzato e l’editor di codice sottostante verrà mostrato, precompilato con il payload predefinito.

Successivamente, identifica il blocco { "text": "#{notification.body}" } nella struttura JSON e selezionalo. Assicurati di includere la virgola (,) nella riga precedente, poiché il nuovo payload deve rimanere un valore JSON valido.

Quindi, semplicemente elimina il blocco di codice selezionato.

Infine, clicca su Invia per salvare le modifiche al tuo webhook.

Alla prossima invocazione del webhook, la notifica non includerà il contenuto dell’ultimo articolo.