Notifiche Rocket Chat

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

Passaggio 1 - Configura l’integrazione webhook in entrata per il tuo canale Rocket Chat

Nel menu di amministrazione overflow di Rocket Chat, scegli Workspace.

Nella barra laterale sinistra scegli Integrazioni e poi fai clic sul pulsante Nuovo nell’angolo in alto a destra.

Innanzitutto, attiva l’interruttore Abilitato in alto.

Fornisci un Nome appropriato per l’integrazione in entrata e inserisci il canale di destinazione nel campo Invia a canale, in formato #nome-canale.

Inserisci il nome utente di Rocket Chat nel campo Invia come, senza il prefisso @. Nota che il nome utente deve già esistere.

Scorri fino alla fine del modulo e fai clic sul pulsante Salva.

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

Infine, chiudi il pannello di amministrazione facendo clic su X sul lato sinistro.

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

Clicca Avanti.

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

Opzionalmente, puoi impostare Nome utente messaggio che verrà utilizzato per inviare le notifiche di Zammad.

Opzionalmente, puoi anche impostare Canale messaggio, se desideri inviare a un canale di destinazione diverso da quello configurato nell’integrazione in entrata di Rocket Chat.

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 Rocket Chat in determinate condizioni.

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

Esempio di notifica del canale Rocket Chat

D’ora in poi, ogni volta che un ticket viene creato o aggiornato nel tuo sistema Zammad, una notifica appropriata verrà pubblicata nel canale Rocket Chat 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 Rocket Chat

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.