Come costruire un bot Slack

Slack ha cambiato radicalmente il modo in cui i dipendenti all'interno di team, uffici e intere organizzazioni comunicano e collaborano tra loro. Esistono una miriade di modi per personalizzare Slack della tua azienda ma, oltre all'utilizzo di canali, file GIF, integrazioni di app ed emoji di reazione, il modo più dinamico per migliorare la tua esperienza Slack è utilizzare i bot.

In parte interfaccia chatbot e in parte motore d'azione automatizzato, i bot Slack hanno un sacco di potenziali usi. All'interno di un canale specifico, gli oltre 100 bot attualmente disponibili nella directory dei bot di Slack possono evocare qualsiasi cosa, da un sondaggio, un sondaggio o un modulo di monitoraggio del tempo, all'analisi dei messaggi, agli ordini del pranzo e ai consigli sui ristoranti, il tutto con un messaggio diretto rapido (DM) o il comando barra.

Molti fornitori di software aziendali, inclusi SurveyMonkey e Zenefits (Visit Site at Zenefits) hanno già creato bot che puoi abilitare all'interno di Slack. Ma non devi aspettare che qualcun altro crei il bot Slack di cui la tua organizzazione ha bisogno. Utilizzando le risorse per gli sviluppatori, la documentazione e i tutorial di Slack, puoi lasciare che l'azienda ti guidi attraverso la creazione del tuo bot Slack.

PCMag ha parlato con Amir Shevat, Head of Developer Relations di Slack, e John Agan, Senior Developer Relations Manager di Slack (Visit Site at Zenefits), su come costruire un bot Slack da zero. Il processo richiede un notevole know-how da parte degli sviluppatori in alcuni punti, ma Shevat e Agan ci hanno guidato attraverso due semplici scenari di creazione di bot a cui tutte le aziende possono relazionarsi: la creazione di un bot di helpdesk di base e l'abilitazione delle notifiche nel canale. Continua a leggere per istruzioni dettagliate su come creare il tuo bot Slack personale.

1. 1. Crea una nuova app Slack

Per iniziare, apri il menu di navigazione a sinistra dal tuo client Slack e fai clic su "App e integrazioni". Nella parte in alto a destra della directory dell'app, fai clic su "Crea". Questo ti porta all'interfaccia di programmazione dell'applicazione (API) Slack dove fai clic su "Avvia creazione" al centro della pagina. Assegna un nome alla tua app (in questo caso, Helpdesk), scegli il team in cui desideri distribuire l'app e fai clic su "Crea app".

Questo ti porta alla pagina Informazioni di base per la tua app. Per una personalizzazione aggiuntiva, scorri verso il basso fino alla casella Visualizza informazioni in cui puoi aggiungere una descrizione, cambiare il colore di sfondo e aggiungere un'icona per il tuo futuro bot. Per il bot dell'Helpdesk, ad esempio, Agan ha dato al robot l'emoji del robot come icona.

2. 2. Scrivi i messaggi del tuo bot

Ora che hai creato la tua app, l'API Slack ti offre una serie di opzioni per iniziare a personalizzare ciò che può fare. Per la nostra app Helpdesk, stiamo creando un bot che semplifica la presentazione di un ticket di helpdesk per tuo conto. Innanzitutto, Agan di Slack ha affermato che è necessario scrivere i messaggi che verranno visualizzati quando un utente digita un comando slash.

Nella sezione Messaggi del menu Slack API, scegli lo strumento Generatore di messaggi. Questo ti dà del codice JSON preformattato, con uno spazio per scrivere e quindi visualizzare in anteprima il testo. Per questo bot, Agan ha digitato "Vuoi presentare questo ticket all'helpdesk?"

Quando un utente fa clic su "Crea" per presentare il proprio ticket di helpdesk, questo è il messaggio di conferma che verrà visualizzato. Quindi, accanto al testo, Agan ha aggiunto il comando per :white_check_mark: per dare all'utente Slack un'emoji con segno di spunta verde che conferma l'invio del biglietto. Proprio così, hai scritto il codice del messaggio automatico del tuo bot. Tienilo a portata di mano perché tra poco ti servirà.

3. 3. Aggiungi notifiche

Agan e Shevat hanno fornito demo separate, ma Shevat ha spiegato che una delle integrazioni di bot più comuni che Slack ha visto dall'apertura della funzionalità è un bot che estrae notifiche da servizi di terze parti. Potrebbe essere qualcosa come un rapporto settimanale sulle vendite di Salesforce (visita il sito su Salesforce.com) o, in questo caso, dalla piattaforma dell'helpdesk per la quale il tuo bot sta creando i biglietti.

4. 4. Attiva i webhook in entrata

Per aggiungere notifiche all'interno del tuo bot Helpdesk (Shevat ha dimostrato questi passaggi con un esempio separato chiamato "ReportBot"), devi prima abilitare i Webhook in entrata. Un Webhook è un semplice callback HTTP che invia un messaggio a un URL quando viene attivata un'azione specifica.

Per fare ciò, torna alla pagina Informazioni di base della tua API Slack. La prima casella dice "Aggiungi funzionalità e funzionalità". Scegli l'opzione "Webhook in arrivo". Nella parte in alto a destra della pagina Attiva webhook in entrata c'è un pulsante di scorrimento. Fare clic per cambiare il pulsante da Off a On.

5. 5. Autorizzare le notifiche di canale

Una volta che i webhook sono attivati, scorri verso il basso e fai clic su "Aggiungi nuovo webhook al team". Ti verrà chiesto di scegliere il canale su cui desideri che il tuo bot pubblichi notifiche automatiche. In questo esempio, Shevat ha scelto #general, ma in questo caso potresti voler inviare questa notifica al tuo team di helpdesk o al canale del dipartimento IT. Quindi, non solo verrà creato un nuovo ticket nella tua piattaforma di helpdesk, ma verrà inviata una notifica automatica al canale Slack del dipartimento IT per notificare loro il ticket. Una volta scelto il tuo canale, fai clic su "Autorizza".

6. 6. Personalizza il tuo webhook

Una volta autorizzato, vedrai un URL Webhook di base sulla pagina e un pulsante per copiarlo. Sopra c'è la tua richiesta di arricciatura di esempio, che puoi copiare in un editor di testo per dire tutto ciò che vuoi. In questo scenario, invece di "Hello, World", potresti voler scrivere in "New Helpdesk Ticket Submitted" o qualsiasi altra cosa che descriva accuratamente le notifiche che vorresti che il tuo bot inviasse. Da qui, puoi prendere il tuo codice di richiesta curl e l'URL di Webhook ed eseguirlo in qualsiasi script. Avrai bisogno di questo codice anche nel passaggio successivo.

7. 7. Costruisci il tuo bot

Ora che hai scritto il codice del messaggio e l'URL di Webhook a portata di mano, sei pronto per creare il tuo bot. La maggior parte delle integrazioni Slack richiede un server per rispondere e avviare le richieste, in particolare quando sono coinvolti logica bot automatizzata e comandi slash. Slack supporta numerosi provider, ma Agan ha creato il bot dell'helpdesk utilizzando un servizio chiamato Glitch.

Questo passaggio richiede una certa esperienza di codifica. Agan ha creato un nuovo progetto Glitch e poi ha iniziato ad aggiungere del codice JavaScript open source. Se non vuoi scrivere tutto il codice da solo (o reinventare la ruota), puoi scegliere tra innumerevoli framework e librerie di bot per importare la tua logica bot di base.

Agan ha chiamato il suo progetto "Index.js", ha aggiunto un pacchetto che ha creato lui stesso chiamato TinySpeck e quindi incollato nel codice di Message Builder che abbiamo scritto in precedenza. Con il codice del bot principale ora attivo, ha semplicemente aggiunto un comando di richiamata per attivare un nuovo ticket e il messaggio di conferma "È stato creato un ticket dell'helpdesk". Questo è tutto. Se desideri aggiungere il codice Webhooks per attivare una notifica nel canale che hai designato, puoi incollarlo anche qui. Glitch crea un URL univoco per il tuo server bot, quindi copia quell'URL dopo aver aggiunto tutto il codice e siamo passati al passaggio successivo.

8. 8. Abilita i messaggi interattivi

Hai già creato il tuo bot Helpdesk, quindi ora tutto ciò che devi fare è tornare all'API. Invece di scegliere "Crea nuova app", fai semplicemente clic su "Gestisci app" e scegli l'app Helpdesk. Nella pagina Informazioni di base, scegli "Messaggi interattivi" nella casella Aggiungi funzionalità e funzionalità. Una volta su quella pagina, fai clic su "Abilita messaggi interattivi", incolla l'URL del tuo server dal passaggio precedente e salva le modifiche.

9. 9. Creare un comando barra

Una volta fatto, torna alla casella Aggiungi funzionalità e funzionalità e vai in Slash Commands. Fai clic su "Crea nuovo comando". Questo ti porta a una pagina del modulo con alcuni campi.

Nella casella Comando, inserisci il comando barra. In questo caso, Agan ha digitato "/helpdesk". Nel campo URL della richiesta, ha incollato lo stesso URL del server da Glitch. Quindi tutto ciò che devi fare è inserire una breve descrizione per il comando ("Crea un ticket di helpdesk"), un suggerimento per l'utilizzo su come l'utente dovrebbe digitare la propria richiesta, controllare l'anteprima sotto di essa per assicurarti che tutto appaia a posto, quindi fare clic su Salva .

10. 10. Installa la tua app

Il bot dell'Helpdesk è ora pronto per il rock. Tornando alla pagina principale dell'API per la tua app, vai alla pagina Installa app che si trova nel menu Impostazioni a sinistra. Fai clic su "Installa app nel tuo team". Questo ti chiederà di autorizzare l'app. Una volta che lo fai, il tuo bot è attivo. Vedrai un "Successo!" verde barra di notifica nella parte superiore dello schermo che conferma l'installazione del bot.

11. 11. Porta il tuo bot a fare un giro

Di nuovo nel client Slack del tuo team, vai al canale in cui hai designato per far funzionare il tuo nuovo bot. Immettere il comando slash con una query, ad esempio: "/helpdesk il mio Wi-Fi è rotto". Ti verrà quindi richiesto con un pulsante di creare un ticket di helpdesk. Congratulazioni; hai appena creato un bot Slack funzionante!