Hvordan lage en Politiloggen Bot til Mastodon?
Mange etterspør Bot’er for Politiloggen fra sitt distrikt. Jeg drifter en for Oslo Politidistrikt på Mikrobloggen.
Her har jeg laget en en guide på hvordan du kan lage en for det eller de distriktene du er interessert i på din instans.
Forutsetning: Jeg bruker IFTTT i dette eksempelet og generelt når jeg lager Bot’er for Mastodon-bruk. Dette fordi det er enkelt og stabilt, men det krever et Pro-abonnement hos IFTTT.com som koster rundt 350 kroner i året. Jeg har sett på andre alternativer, men kommet frem til at med mindre jeg skal prøve å hoste en Bot selv på en Raspberry Pi her hjemme, så er dette den rimeligste, og helt klart enkleste måten å lage bot’er for Mastodon på.
Steg 1: Lag en mastodon app
Først oppretter du en vanlig Mastodon-bruker på den instansen du vil kjøre bot’en fra (sjekk at det er lov med Bot’er på instansen først). Så under instillinger, profil og annet så huker du av for at det er en automatisert konto:
Dette gjør ingenting annet enn å vise følgere at dette er en Bot, ikke en vanlig bruker.
Jeg liker også å sette opp automatisk sletting av innlegg, ingen grunn til å fylle opp databasen med utdaterte innlegg. Her er hvordan jeg har satt det opp:
Nå må du lage en tilgangsnøkkel for IFTTT. Dette gjør du ganske enkelt ved å gå på innstillinger og «utvikling». Lag en app, du trenger ikke gjøre noe annet enn å gi den ett navn og kopiere din Acccess Token:
Steg 2: Lag en Atom URL
Politiet har vært greie og satt opp en Swagger der du kan teste ut og lage din egen RSS- eller Atom-feed for det eller de distriktene du vil at Bot’en skal hente meldinger fra. Jeg har valgt å bruke Atom fremfor RSS.
Her har jeg laget et eksempel hvor jeg filtrerer på distrikt Oslo, kommune Oslo og kategori "Ro og Orden", bare for å vise alle mulighetene:
Det er da "Request URL" du må kopiere for å bruke i IFTTT applet'en.
Steg 3: IFTTT oppsett
Det er nå det morsomme begynner, å bygge en «applet» i IFTTT. Du ønsker å bruke RSS og «New feed item» som IF og en «Webhook» som THEN.
Legg inn URL’en du lagde i steg 2 som feed URL og nøkkelen du hentet ut i steg 1 i «Additional Headers», etter «Authorization: Bearer » (du må skrive inn dette selv).
Så utformer du selve «Body» teksten akkurat sånn du vil. Dette er det som kommer som innleggstekst på Mastodon. Her kan du kun ha ren tekst og eventuelle custom emojies (som jeg har i eksempelt ved :oslo:). Pass på å ha <<
Det kjekke her, er at om du legger opp at folk kan trykke på «EntryUrl» så blir de på mobilen sendt rett til Politiloggen-appen om de har den installert og får opp hele hendelses-historikken. Har de ikke appen, blir de sendt til websiden med akkurat samme info.
Ferdig resultat
Her er eksempel på hvordan et innlegg kan bli seende ut:
Det er egentlig alt. Lek litt med Swagger, du kan filtrere på distrikter, kommuner, typer hendelser og mer.
Følg gjerne min Bot som poster statusmeldinger og nyheter (en annen RSS feed, også satt opp som en IFTTT applet på samme måte) fra Oslo Politidistrikt: @politiloggen_oslo