Hoe een slappe bot te bouwen

Slack heeft de manier waarop medewerkers binnen teams, kantoren en hele organisaties met elkaar communiceren en samenwerken fundamenteel veranderd. Er zijn talloze manieren om Slack van uw bedrijf aan te passen, maar naast het gebruik van de kanalen, GIF-bestanden, app-integraties en reactie-emoji's, is het gebruik van bots de meest dynamische manier om uw Slack-ervaring te verbeteren.

Deels chatbot-interface en deels geautomatiseerde actie-engine, Slack bots hebben een heleboel potentieel gebruik. Binnen een specifiek kanaal kunnen de meer dan 100 bots die momenteel beschikbaar zijn in Slack's Bot Directory alles oproepen, van een enquête, enquête of tijdregistratieformulier tot berichtanalyses, lunchbestellingen en restaurantaanbevelingen - allemaal met een quick direct message (DM) of slash commando.

Veel zakelijke softwareleveranciers, waaronder SurveyMonkey en Zenefits, hebben al bots gebouwd die u binnen Slack kunt inschakelen. Maar u hoeft niet te wachten tot iemand anders de Slack-bot bouwt die uw organisatie nodig heeft. Door Slack's ontwikkelaarsbronnen, documentatie en tutorials te gebruiken, kunt u het bedrijf u begeleiden bij het bouwen van uw eigen Slack-bot.

PCMag sprak met Amir Shevat, hoofd van Developer Relations bij Slack, en John Agan, Senior Developer Relations Manager bij Slack, over hoe een Slack-bot helemaal opnieuw te bouwen. Het proces vereist een behoorlijke knowhow van ontwikkelaars op plekken, maar Shevat en Agan hebben ons door twee eenvoudige botscenario's geleid waarop alle bedrijven betrekking kunnen hebben: het bouwen van een basis-helpdeskbot en het inschakelen van in-channel meldingen. Lees verder voor stapsgewijze instructies voor het bouwen van uw eigen Slack-bot.

1 1. Maak een nieuwe slappe app

Om te beginnen, opent u het navigatiemenu aan de linkerkant van uw Slack-client en klikt u op "Apps en integraties". Klik rechtsboven in de app-directory op 'Build'. Hiermee gaat u naar de Slack-applicatie-programmeerinterface (API) waar u in het midden van de pagina op "Start Building" klikt. Geef uw app een naam (in dit geval Helpdesk), kies het team waarin u de app wilt implementeren en klik op 'App maken'.

Hiermee gaat u naar de pagina met basisinformatie voor uw app. Voor extra aanpassing bladert u omlaag naar het vak Informatie weergeven waarin u een beschrijving kunt toevoegen, de achtergrondkleur kunt wijzigen en een pictogram voor uw toekomstige bot kunt toevoegen. Voor de Helpdesk-bot gaf Agan de bot bijvoorbeeld de robot-emoji als pictogram.



2 2. Schrijf de berichten van je Bot

Nu je je app hebt gemaakt, biedt de Slack API je een aantal opties om aan te passen wat het kan doen. Voor onze Helpdesk-app bouwen we een bot die het gemakkelijk maakt om namens u een helpdeskticket in te dienen. Eerst zei Slack's Agan dat je de berichten moet schrijven die verschijnen wanneer een gebruiker een slash-opdracht typt.

Kies de tool Message Builder in de sectie Berichten van het menu Slack API. Dit geeft u een aantal vooraf opgemaakte JSON-code, met ruimte om in te schrijven en een voorbeeld van uw tekst te bekijken. Voor deze bot typte Agan: "Wilt u dit helpdeskticket indienen?"

Wanneer een gebruiker op "Maken" klikt om zijn helpdeskticket in te dienen, wordt dit bevestigingsbericht weergegeven. Dus, naast de tekst, voegde Agan het commando toe voor: white_check_mark: om de Slack-gebruiker een emoji met een groen vinkje te geven om de verzending van zijn ticket te bevestigen. Zo heb je de geautomatiseerde berichtcode van je bot geschreven. Houd dit handig want je hebt het een beetje nodig.



3 3. Meldingen toevoegen

Agan en Shevat gaven afzonderlijke demo's, maar Shevat legde uit dat een van de meest voorkomende botintegraties die Slack sinds de opening van de mogelijkheid heeft gezien, een bot is die meldingen van diensten van derden binnenhaalt. Dit kan bijvoorbeeld een wekelijks verkooprapport van Salesforce zijn, of in dit geval van het helpdeskplatform waarvoor uw bot tickets maakt.



4 4. Activeer inkomende webhooks

Om meldingen toe te voegen binnen uw Helpdesk-bot (Shevat demonstreerde deze stappen met een apart voorbeeld dat hij "ReportBot" noemde), moet u eerst inkomende Webhooks inschakelen. Een Webhook is een eenvoudige HTTP-callback die een bericht op een URL plaatst wanneer een specifieke actie wordt geactiveerd.

Ga hiervoor terug naar de pagina Basisinformatie van uw Slack API. In het eerste vak staat 'Functies en functionaliteit toevoegen'. Kies de optie "Inkomende webhooks". Rechts bovenaan de pagina Inkomende webhooks activeren staat een schuifknop. Klik erop om de knop van Uit naar Aan te schakelen.



5 5. Kanaalmeldingen autoriseren

Zodra Webhooks zijn geactiveerd, scrolt u omlaag en klikt u op "Nieuwe webhook toevoegen aan team". Je wordt gevraagd om het kanaal te kiezen waarop je je bot geautomatiseerde meldingen wilt laten plaatsen. In dit voorbeeld heeft Shevat #general gekozen, maar in dit geval wilt u deze melding misschien posten op uw helpdeskteam of het kanaal van de IT-afdeling. Er wordt dus niet alleen een nieuw ticket gemaakt in uw helpdeskplatform, maar er wordt ook een automatische melding naar het Slack-kanaal van de IT-afdeling gestuurd om hen op de hoogte te stellen van het ticket. Nadat je je kanaal hebt gekozen, klik je op 'Autoriseren'.



6 6. Pas uw webhook aan

Na de autorisatie ziet u een eenvoudige Webhook-URL op de pagina en een knop om deze te kopiëren. Daarboven staat uw voorbeeldkrulverzoek, dat u naar een teksteditor kunt kopiëren om te zeggen wat u maar wilt. In dit scenario, in plaats van "Hallo wereld", wilt u misschien schrijven in "Nieuwe Helpdesk Ticket ingediend" of wat dan ook nauwkeurig de meldingen beschrijft die u uw bot wilt laten verzenden. Vanaf hier kunt u uw curlaanvraagcode en Webhooks-URL gebruiken en deze in elk script uitvoeren. U hebt deze code ook nodig in de volgende stap.



7 7. Bouw je Bot

Nu je je berichtcode hebt geschreven en je Webhooks-URL bij de hand hebt, ben je klaar om je bot te bouwen. Voor de meeste Slack-integraties is een server vereist om te reageren op verzoeken en deze te initiëren, met name als het gaat om geautomatiseerde botlogica en slash-opdrachten. Slack ondersteunt een aantal providers, maar Agan bouwde de helpdeskbot met behulp van een service genaamd Glitch.

Deze stap vereist enige coderingsexpertise. Agan creëerde een nieuw Glitch-project en begon toen wat open-source JavaScript-code toe te voegen. Als u niet alle code zelf wilt schrijven (of het wiel opnieuw wilt uitvinden), kunt u kiezen uit talloze botframes en bibliotheken om uw basisbotlogica te importeren.

Agan noemde zijn project "Index.js", voegde een zelfgemaakt pakket toe met de naam TinySpeck en plakte dit vervolgens in de Message Builder-code die we eerder schreven. Met de belangrijkste botcode nu op zijn plaats, voegde hij eenvoudig een callback-opdracht toe om een ​​nieuw ticket te activeren en het bevestigingsbericht "Er is een helpdesk-ticket gemaakt". Dat is het. Als je je Webhooks-code wilt toevoegen om een ​​melding te activeren in het kanaal dat je hebt aangewezen, kun je dat hier ook plakken. Glitch maakt een unieke URL voor je bot-server, dus kopieer die URL zodra je al je code hebt toegevoegd en we gaan door naar de volgende stap.



8 8. Interactieve berichten inschakelen

Je hebt je Helpdesk-bot al gemaakt, dus nu hoef je alleen maar terug te gaan naar de API. Klik in plaats van 'Nieuwe app maken' op 'Apps beheren' en kies de app Helpdesk. Kies op de pagina Basisinformatie "Interactieve berichten" in het vak Functies en functionaliteiten toevoegen. Klik op die pagina op "Interactieve berichten inschakelen", plak uw server-URL uit de vorige stap en sla de wijzigingen op.



9 9. Maak een Slash-opdracht

Als dat is gebeurd, ga je terug naar het vak Functies en functionaliteit toevoegen en ga je naar Slash-opdrachten. Klik op 'Nieuwe opdracht maken'. Hiermee gaat u naar een formulierpagina met enkele velden.

Voer uw slash-opdracht in het vak Command in. In dit geval heeft Agan "/ helpdesk" ingevoerd. In het veld URL aanvragen heeft hij dezelfde server-URL van Glitch geplakt. Vervolgens hoeft u alleen maar een korte beschrijving voor de opdracht in te voeren ("Een helpdeskticket maken"), een gebruikstip voor hoe de gebruiker zijn verzoek moet typen, controleer het voorbeeld eronder om er zeker van te zijn dat alles er goed uitziet en klik vervolgens op Opslaan.



10 10. Installeer uw app

De Helpdesk-bot is nu klaar om te rocken. Ga terug op de hoofd-API-pagina voor uw app naar de pagina App installeren die u kunt vinden in het menu Instellingen aan de linkerkant. Klik op 'App in uw team installeren'. Dit zal u vragen om de app te autoriseren. Zodra je dit doet, is je bot live. U ziet een groen "Succes!" meldingslint bovenop uw scherm dat bevestigt dat uw bot is geïnstalleerd.



11 11. Neem je bot mee voor een spin

Terug in de Slack-client van je team ga je naar het kanaal waarin je je nieuwe bot aan het werk hebt gezet. Voer de slash-opdracht in met een zoekopdracht, bijvoorbeeld: "/ helpdesk mijn wifi is kapot." U wordt vervolgens gevraagd met een knop om een ​​helpdeskticket te maken. Gefeliciteerd; je hebt zojuist een werkende Slack-bot gebouwd!