Creare workflow che si avviano con un webhook

Chi può utilizzare questa funzione?

I workflow sono attività o processi a più passaggi automatizzati che vengono eseguiti direttamente in Slack. I workflow possono essere semplici o complessi, in base alle necessità, e nella maggior parte dei casi non è richiesto scrivere codice. Per creare un workflow che viene eseguito quando si verifica un evento in un servizio esterno, puoi usare un webhook.

Cosa è necessario per iniziare

  • Avere familiarità con l’invio di richieste HTTP tramite la riga di comando o tramite un altro strumento
  • Saper comprendere i webhook in entrata. Per ricevere istruzioni, leggi la documentazione sulla API Slack o chiedi assistenza a uno sviluppatore del tuo team

Nota: i proprietari e gli amministratori possono limitare l’accesso alla creazione dei workflow con i webhook. Se non visualizzi questa opzione in Workflow Builder, chiedi assistenza a un proprietario o a un amministratore.


Configurazione dei workflow

Nozioni base sui workflow dei webhook

Tutti i workflow in Slack si avviano in risposta a un trigger. Per attivare un workflow con un webhook, configura il webhook in modo che esegua il workflow quando un evento da te specificato si verifica in un altro servizio. Ad esempio, puoi creare un workflow che posta un messaggio in un determinato canale quando si verifica un problema con il sito web in modo che il team tecnico possa investigare.

Configurare il webhook

Il servizio esterno che utilizzi per creare e configurare il webhook deve consentirti di inviare una richiesta HTTP POST a Slack quando si verificano determinati eventi. Slack genererà un URL di richiesta univoco per il workflow dopo che lo hai pubblicato. Puoi configurare il webhook in modo che passi informazioni a Slack nel corpo della richiesta HTTP. È possibile fare riferimento a qualsiasi dato inviato dal webhook a Slack nei passaggi che aggiungi al workflow mediante la creazione di variabili.

Suggerimento: se non sai come configurare il webhook, ti consigliamo di chiedere assistenza a uno sviluppatore del tuo team o di fare riferimento alla documentazione di supporto offerta dal servizio che utilizzi, come Postman o Zapier.

Creare variabili personalizzate

Puoi aggiungere fino a 20 variabili per trasferire i dati a Slack da un altro servizio e includere informazioni specifiche per Slack (come nomi visualizzati o indirizzi e-mail) nei passaggi che aggiungi al workflow.

Per creare una variabile personalizzata, dovrai aggiungere una coppia chiave-valore in Workflow Builder come variabile basata su testo. Dopo aver aggiunto una variabile, vedrai un’anteprima del corpo HTTP e potrai così assicurarti che i valori corrispondano agli output JSON nell’altro servizio che vuoi connettere a Slack con il webhook. Al momento non è possibile utilizzare strutture nidificate JSON nelle variabili dei workflow.

Nell’esempio che segue, se utente, gravità e descrizione_incidente non venissero inviati con la richiesta webhook, il workflow avrebbe esito negativo.

Configurazione webhook in Workflow Builder che mostra l’URL webhook e le variabili personalizzate

Suggerimento: apri il workflow in Workflow Builder in qualsiasi momento per aggiungere, rimuovere o modificare le variabili. Quindi clicca sull’icona matita   accanto a Inizia con un webhook Assicurati inoltre che eventuali modifiche apportate alle variabili si riflettano nel servizio esterno da cui hai inviato la richiesta del webhook.

Ottenere l’URL di richiesta web

Quando pubblichi il workflow, Slack genera un URL di richiesta univoca che puoi aggiungere al webhook per assicurarti che questo invii il POST da te impostato al canale corretto. Gli URL di richiesta iniziano con https://hooks.slack.com/triggers e sono seguiti da una stringa di caratteri casuale.

Assicurati di tenere protetto il tuo URL di richiesta, poiché chiunque possieda il link ha la possibilità di attivare il tuo workflow.

Nota: i workflow dei webhook sono limitati a una richiesta al secondo. Scopri di più sui limiti di velocità sul sito della API Slack.


Aggiungi i passaggi per completare il workflow

Aggiungi i passaggi

Una volta configurato il webhook e create le variabili che vuoi utilizzare, puoi aggiungere passaggi al tuo workflow

  1. Apri il workflow in Workflow Builder. 
  2. Clicca su Aggiungi passaggio
  3. Scegli il tipo di passaggio che vuoi aggiungere e segui le istruzioni per personalizzarlo.


Verificare il funzionamento del workflow

Prima di pubblicare il workflow in un canale che i membri della tua area di lavoro utilizzano attivamente, puoi impostare il primo passaggio per postare in un canale di prova.

  1. Invia un POST all’URL di richiesta del tuo workflow ed esamina i passaggi per assicurarti che tutto funzioni correttamente.
  2. Torna a Workflow Builder e aggiorna il primo passaggio del workflow per postare nel canale da te specificato, poi pubblica le modifiche.