Hieronder vind je een korte tutorial over hoe je alerts moet configureren naar Slack of MS Teams.

Snel navigeren:

• Microsoft Teams Channel
• Slack

Microsoft Teams Channel

Ga naar Workflows in Teams, klik op “New flow”.

Selecteer de workflow “Post to a channel when a webhook request is received”. Klik daarna op “Next”.

Je moet een Teams team en een kanaal (channel) kiezen om je alert naartoe te sturen. In mijn voorbeeld heb ik een “Jan Personal” team en een kanaal “Alerter”.

Dan krijg je daarna normaal een bevestiging met een workflow URL (een endpoint die mijn tool dan kan aanspreken). Kopieer deze URL voor het gemak even in een tekstbestand voor later.

Ga nu naar mijn Robots.txt tool interface en plak de webhook URL in het veld. Vergeet niet op te slaan!

Slack kanaal

Ga naar https://api.slack.com/apps/ (zorg dat je admin of gelijkwaardige rechten hebt in je workspace zodat je Apps kan aanmaken.

Disclaimer: Je hebt geen betalende versie nodig maar Slack Apps opzetten kan rechten vereisen. Op mijn vorige job had ik admin rechten nodig in onze corporate Slack workspace. Maar in mijn eigen (persoonlijke) gratis Slack workspace kon ik zonder problemen alles opzetten. Check dus zeker eens intern als je problemen hebt.

Klik op “Create New App”.

Kies voor “From scratch”:

Kies een app naam (je kan kiezen hoe je dit noemt, maar best iets beschrijvends) en selecteer je workspace. Klik op “Create App”.

Je krijgt nu een scherm met heel wat configuratie opties. Ga in het linkermenu naar “OAuth & Permissions”.

Bij OAuth & Permissions scroll je door tot aan “Scopes”. Klik “Add an OAuth Scope” bij Bot Token Scopes.

Voeg “chat:write” toe.

Scroll naar boven naar OAuth Tokens en klik op “Install to [workspace]”.

Voltooi de volgende stap. Daarna krijg je dit scherm te zien.

Kopieer de OAuth token. TIP: Zet het even in een kladblok, je hebt dit een paar stappen later nodig.

Nu moet je nog één ding doen binnen Slack.

Je moet je nieuwe Slack bot nog toevoegen (inviten) in je channel. Anders kan die geen berichten sturen. De beste manier is om gewoon een berichtje te sturen in je channel en je bot te taggen. Voorbeeld:

“Random message to tag @robots.txt-alert Bot in this channel”.

Dan krijg je nu een pop-up. Klik op “Add Them”. De opzet binnen Slack zou nu klaar moeten zijn.

Ga nu terug naar mijn Robots.txt tool interface en plak de token in het “key” veld. Klik op “Alert opslaan”!

Nàdat je “Alert opslaan” hebt geklikt, klik dan op “Alert testen” onderaan.

Dit zal een testbericht versturen naar jouw Slack kanaal met een dummy alert. Als die toekomt dan werkt de configuratie. Hoera!