Notifiche Slack

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

Passaggio 1 - Configura l’app WebHooks in entrata nel tuo canale Slack

Nel tuo canale Slack di destinazione, fai clic sul nome del canale nella parte in alto a sinistra dello schermo per accedere ai dettagli del canale.

Passa alla scheda Integrazioni e fai clic sul pulsante Aggiungi un’app.

Nella schermata successiva, cerca un’app chiamata WebHooks in entrata e fai clic sul pulsante Installa accanto ad essa.

Verrai reindirizzato al sito web della directory delle app di Slack, dove potrai aggiungere l’app.

Fai clic sul pulsante Aggiungi a Slack.

Nella schermata successiva, in Invia a canale scegli il tuo canale dall’elenco e fai clic sul pulsante Aggiungi integrazione WebHooks in entrata.

Nella schermata finale, scorri fino a Impostazioni integrazione.

Assicurati di copiare l”URL del webhook negli appunti e salvalo per dopo. Puoi farlo con un clic tramite il link Copia URL mostrato subito sotto il campo.

Puoi anche compilare il campo Personalizza nome con un nome utente appropriato per l’integrazione dei webhook in entrata, poiché questo verrà utilizzato per tutti i messaggi di notifica nel canale.

Opzionalmente, puoi Personalizzare l’icona che verrà utilizzata come avatar.

Infine, salva la configurazione della tua app facendo clic su Salva impostazioni.

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 Slack come webhook predefinito.

Clicca Avanti.

Nella nuova finestra di dialogo, incolla l”URL del webhook dall’app Slack 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 Slack in determinate condizioni.

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

Esempio di notifica del canale Slack

D’ora in poi, ogni volta che un ticket viene escalato o ha raggiunto un avviso di escalation nel tuo sistema Zammad, una notifica appropriata verrà pubblicata nel canale Slack configurato. La notifica conterrà il link al ticket, le informazioni di escalation 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 Slack

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 la riga che inizia con il blocco "text": "... nella struttura JSON.

Scorri orizzontalmente fino alla fine della riga e seleziona la parte \n\n#{notification.body} verso la fine. Assicurati di non includere la virgola finale (",) nel resto della riga, poiché il nuovo payload deve rimanere un valore JSON valido.

Quindi, semplicemente elimina il 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.