Questo blog ti guiderà attraverso i passaggi relativamente semplici per configurare un webhook che invia notifiche dal tuo account SuperSaaS a un canale Slack a tua scelta.
Questo è utile se vuoi tenere traccia dell’attività di prenotazione del tuo schedule in Slack, se vuoi essere avvisato quando un appuntamento sta per iniziare, se tu o i membri del tuo team dovete preparare una stanza prima dell’inizio dell’appuntamento, oppure se tu o i membri del tuo team dovete pulirla dopo.
Un webhook da SuperSaaS a Slack ti evita di controllare meticolosamente il tuo schedule SuperSaaS, mantiene la tua email libera da notifiche e promemoria degli appuntamenti e può aiutare a comunicare l’attività della tua azienda ad altri dipendenti direttamente in Slack.
Se vuoi una panoramica più ampia dell’integrazione, dai un’occhiata a webhooks e API.
Inizierai il processo di configurazione aggiungendo l’opzione per i webhook in ingresso in Slack e poi proseguirai in SuperSaaS per impostare il trigger del webhook e creare il tuo messaggio di notifica.
Nel messaggio di esempio, il campo name rappresenta solo il nome visualizzato del mittente.
Inizio della configurazione in Slack
- In Slack, aggiungi l’app “Incoming WebHooks”
- Seleziona il canale Slack al quale vuoi aggiungere le notifiche del webhook
- Copia l’URL fornito dall’app Incoming WebHooks e procedi con i passaggi in SuperSaaS descritti di seguito
Potresti notare che l’app “Incoming WebHooks” è un’app legacy. Ciò significa che non viene più aggiornata, ma funziona ancora per lo scopo di questo blog. Se preferisci utilizzare il metodo più recente raccomandato da Slack, ignora i passaggi precedenti. Vai alla App Directory per creare una nuova App in Slack, quindi attiva i webhook in ingresso. Consulta la documentazione dettagliata di Slack per una guida completa. Una volta attivati i webhook in ingresso, puoi generare un URL. Copia l’URL e passa ai passaggi in SuperSaaS descritti di seguito.
Configurazione continua in SuperSaaS
- In SuperSaaS, vai alla dashboard amministratore, clicca su integrazioni e poi su webhooks (o clicca semplicemente questo link per andare direttamente)
- Sotto l’intestazione “Nuovo Webhook”, seleziona un’azione per attivare il webhook, poi aggiungi il tuo URL e clicca “crea webhook”
- Ora imposta il payload su “personalizzato”
- Slack richiede che tu aggiunga il campo “text” nel payload, quindi aggiungilo con il messaggio che desideri includere nella tua notifica Slack. Se vuoi che il messaggio Slack contenga dati specifici dell’appuntamento o dell’utente, inserisci le opzioni di auto testo corrispondenti visualizzate sotto la casella di testo
- Per confermare che il tuo webhook funziona, potresti volerlo testare. Sentiti libero di usare l’esempio qui sotto
Il tuo payload personalizzato inserito in SuperSaaS:
{ “text”: “$full_name ($email) ha creato un nuovo appuntamento per $start” }
La notifica Slack risultante:
“John Smith (john@example.com) ha creato un nuovo appuntamento per 2024-08-30 14:00”
Tipi di trigger
Se hai già utilizzato i webhook, probabilmente sai che esistono diversi trigger che puoi usare. Qui sotto trovi tre trigger che potresti voler utilizzare quando colleghi il tuo account SuperSaaS al tuo workspace Slack.
1. Nuovo appuntamento
Per ricevere una notifica Slack quando viene creato un nuovo appuntamento, puoi usare il trigger “nuovo appuntamento”. Questo garantirà che la notifica venga inviata non appena l’utente ha prenotato un appuntamento con te.
2. Appuntamento modificato
Questo trigger invierà una notifica Slack non appena un appuntamento viene modificato o eliminato.
3. Promemoria e Follow-up
Se preferisci ricevere un promemoria quando un appuntamento sta per iniziare, puoi scegliere il trigger “promemoria”. Invece di inviare una notifica Slack quando un appuntamento viene creato/modificato, la notifica verrà attivata nel momento in cui desideri che il promemoria venga inviato. Puoi configurare le impostazioni del promemoria sotto Configura > Processo > “Dovremmo inviare un promemoria o follow-up di una prenotazione nuova o modificata?” per specificare quanto tempo prima il webhook deve essere attivato.
Nota importante: il webhook di promemoria sostituisce qualsiasi promemoria email o SMS che potresti aver configurato in precedenza. Ciò significa che se prima ricevevi promemoria via email o SMS direttamente dal tuo account SuperSaaS, questi verranno sostituiti dalla notifica Slack. Puoi trasformare il follow-up in un secondo promemoria aggiungendo un valore negativo, così da poterlo usare allo stesso modo.
Opzioni alternative: Pipedream/Zapier/n8n
Oltre a collegare direttamente SuperSaaS e Slack, è anche possibile utilizzare uno strumento di integrazione come Pipedream, n8n, Make o Zapier per connettere SuperSaaS a Slack. Questo richiede la creazione di un account con lo strumento di integrazione scelto e potrebbe richiedere un abbonamento a pagamento se superi il loro piano gratuito.
Il vantaggio di usare un intermediario è che ottieni un livello aggiuntivo di flessibilità, poiché puoi filtrare i tuoi webhook, ad esempio: “Avvisami via WhatsApp se un appuntamento viene modificato entro 1 ora dall’orario di inizio, altrimenti invia un’email.”
Se hai domande sul processo di configurazione in SuperSaaS, sentiti libero di contattare il nostro team di supporto.