Slack on kätevä ja suosittu työkalu, jota voit parantaa omilla komennoillasi, jotka on räätälöity organisaatiollesi.

Slack on työkalu, jonka avulla tiimit voivat kommunikoida ja tehdä yhteistyötä. Yksi sen tärkeimmistä ominaisuuksista on vinoviivakomentojen käyttö. Nämä komennot käynnistävät tiettyjä toimintoja tai integraatioita alustan sisällä.

Vaikka Slack tarjoaa useita sisäänrakennettuja vinoviivakomentoja, voit luoda mukautettuja komentoja Slackin API: n avulla. Voit sitten määrittää mukautetun komennon suorittamaan tietyn tehtävän, kun käyttäjä käynnistää sen.

Miksi luoda mukautettu kauttaviivakomento Slackiin?

Slackin sisäänrakennetut vinoviivakomennot eivät välttämättä vastaa tiimisi tai organisaatiosi erityistarpeita. Luomalla mukautettuja kauttaviivakomentoja voit luoda yksilöllisemmän kokemuksen tiimillesi. Tämä puolestaan ​​lisää joukkueen sitoutumista.

Slack-sovelluksen määrittäminen

Jotta voit jatkaa, sinun tulee olla tyytyväinen Slackin peruskäyttö. Kirjaudu sisään Slack-tilillesi selaimessa ja luo uusi työtila. Käytät tätä työtilaa sovellusten testaamiseen ennen kuin käytät niitä tiimisi työtilassa.

Avaa toinen välilehti ja siirry kohtaan Slack API -verkkosivusto.

Klikkaa Luo sovellus -painiketta. Valitse seuraavalla näkyviin tulevalla sivulla vaihtoehto sovelluksen luomiseen Tyhjästä.

Nimeä sovellus ja valitse työtila, jossa sovellus toimii.

Klikkaa Luo sovellus -painiketta. Tämä ohjaa sinut sivulle, joka sisältää sovelluksesi perustiedot.

Siirry ominaisuudet-osiossa kohtaan OAuth ja käyttöoikeudet ominaisuus ja vieritä sitten alas kohtaan Bot Token Scopes. Lisää chat: kirjoita laajuutta sovelluksellesi. Tämän laajuuden avulla sovelluksesi voi lähettää viestejä työtilaan.

Vieritä ylös kohtaan OAuth-tunnukset työtilallesi -osio ja napsauta Asenna työtilaan -painiketta.

Napsauta seuraavalla näkyviin tulevalla sivulla Sallia -painiketta. Tämä asentaa sovelluksen työtilaan.

Mukautetun vinoviivakomennon luominen Slack API: lla

Kun olet määrittänyt Slack-sovelluksen, sinun on luotava mukautettu komento tehtävää varten, jonka haluat suorittaa. Esimerkiksi vinoviivakomento, joka palauttaa vitsin käyttäjälle. Navigoi kohtaan Slash komennot ominaisuus. Klikkaa Luo uusi komento -painiketta.

Täytä Komento, Pyydä URL-osoite, ja Lyhyt kuvaus komennosta, jonka haluat luoda. Request URL on päätepiste, johon Slack lähettää POST-pyynnön, kun käyttäjä käynnistää komennon. Käytä localhost-URL-osoitetta paikkamerkkinä; vaihdat tämän URL-osoitteen myöhemmin.

Klikkaa Tallentaa. Kun tallennat, Slack lisää automaattisesti sovelluksellesi komentoalueen. Tämän laajuuden avulla sovelluksesi voi lisätä pikakuvakkeita ja kauttaviivakomentoja, joita työtilasi ihmiset voivat käyttää. Kattavuuden muuttaminen edellyttää, että sovellus on asennettava uudelleen. Klikkaa asenna sovelluksesi uudelleen -painiketta.

Napsauta seuraavaksi avautuvalla sivulla Salli sovelluksen uudelleenasentaminen työtilaan.

Slash-komennon toiminnan määrittäminen

Käynnistä mikä tahansa Python IDE. Luo uusi virtuaaliympäristö. Luo uusi Python-tiedosto ja uusi .env-tiedosto. Asenna tarvittavat kirjastot suorittamalla terminaalissa seuraava komento.

pip install python-dotenv pyytää Flask slack-bolt

The python-dotenv kirjaston avulla voit ladata ympäristömuuttujat .env-tiedostoon. The pyynnöt kirjaston avulla voit tehdä HTTP-pyyntöjä ja Pullo käsittelee saapuvat HTTP-pyynnöt ja palauttavat vastaukset. Löysä pultti käsittelee saapuvat Slack-pyynnöt.

Avaa .env-tiedosto ja luo kaksi ympäristömuuttujaa. Nimeä ne BOT_TOKEN ja SIGNING_SECRET vastaavasti. Siirry Slack API -sivustolle. Sovelluksesi alla Perustiedot kopioi allekirjoituksen salaisuus ja käytä sitä BOT_TOKEN-muuttujan alustamiseen. Siirry OAuth & Permissions -ominaisuuteen ja kopioi botin käyttäjän OAuth-tunnus. Käytä sitä SIGNING_SECRET-muuttujan alustamiseen.

Bottitunnus on yksilöllinen tunniste, joka todentaa sovelluksesi Slackin API: lla tehdessäsi API-kutsuja. Allekirjoitussalaisuus varmistaa, että sovellukseesi tulevat pyynnöt tulevat Slackilta.

Täysi lähdekoodi on saatavilla a GitHub-arkisto.

Tuo tarvittavat kirjastot ja moduulit.

tuonti os
alkaen pathlib tuonti Polku
alkaen dotenv tuonti load_dotenv
tuonti pyynnöt
alkaen pullo tuonti Pullo, pyydä, jsonify
alkaen slack_bolt tuonti Sovellus
alkaen slack_bolt.adapter.flask tuonti SlackRequestHandler

Luo uusi Flask-sovelluksen esiintymä.

app = Kolvi (__name__)

Lataa ympäristömuuttujat .env-tiedostosta käyttämällä load_dotenv() toiminto.

env_path = Polku('.') / ".env"
load_dotenv (dotenv_path=env_path)

Luo uusi Slack-sovelluksen esiintymä käyttämällä Sovellus luokka slack_bolt-kirjastosta.

slack_app = Sovellus(
 token=os.environ["BOT_TOKEN"],
 signing_secret=os.environ['SIGNING_SECRET']
)

Luo reittikäsittelijätoiminto, joka käsittelee saapuvat pyynnöt /slack/command päätepiste. Kun päätepiste vastaanottaa a LÄHETTÄÄ pyynnön, se jäsentää pyynnön runkotiedot. Sitten se tarkistaa, onko komento /joke. Jos näin on, se kutsuu get_joke() funktio ja palauttaa JSON-vastauksen Slackiin komennon tuloksella.

@app.route("/slack/command", method=["POST"])
defkomento():
# Jäsennä pyynnön runkotiedot
 data = request.form
# Kutsu asianmukainen funktio kauttaviiva-komennon perusteella
jos data["komento"] == "/vitsi":
 viesti = get_joke()
muu:
 viesti = f"Virheellinen komento: {data['komento']}"
# Palauta vastaus Slackiin
palata jsonify({"teksti": viesti})

Luo funktio, joka lähettää GET-pyynnön icanhazdadjoke API satunnaisen vitsin hakemiseen JSON-muodossa. Sitten se palauttaa vitsin merkkijonona.

defget_joke():
 url = " https://icanhazdadjoke.com/"
 otsikot = {"Hyväksyä": "sovellus/json"}
 vastaus = requests.get (url, headers=headers, timeout=5)
 vitsi = vastaus.json()["vitsi"]
palata vitsi

Luo uusi esiintymä a SlackRequestHandler objekti, joka käsittelee Slackin saapuvat pyynnöt.

Käsittelijä = SlackRequestHandler (slack_app)

Tarkista, suoritetaanko komentosarja suoraan, ja jos on, käynnistä Flask-sovellus portista 5000.

jos __nimi__ == "__main__":
# Käynnistä Flask-sovellus portissa 5000
 app.run (port=5000, debug=Totta)

Suorita ohjelma käynnistääksesi palvelimen, joka toimii localhostissa.

Jotta ohjelma voisi kommunikoida Slackin kanssa, tarvitset URL-osoitteen, jota se voi käyttää Internetin kautta. Lataa ja suorita ngrok. The ngrok-ohjelmiston avulla voit luoda suojatun julkisen URL-osoitteen joka tunneloi liikenteen tietokoneellasi toimivalle verkkopalvelimelle.

Suorita seuraava komento saadaksesi julkisen URL-osoitteen:

ngrok http 5000

Alla olevassa kuvassa näkyy ngrokin julkinen URL-osoite valkoisella korostettuna.

Kopioi URL-osoite ja siirry Slack API -verkkosivustolle. Klikkaa Slash komennot ominaisuus. Muokkaa /joke-komentoa ja korvaa pyynnön URL-osoitteen paikkamerkki julkisella URL-osoitteellasi. Lisää /slack/events URL-osoitteen loppuun osoittaaksesi päätepisteeseesi.

Siirry työtilaan, kirjoita ja lähetä /joke-komento. Sinun pitäisi nähdä vitsi vastauksena:

Tutustu muihin Slackin ominaisuuksiin

Slack tarjoaa paljon ominaisuuksia Slash-komentojen lisäksi. Näihin ominaisuuksiin tutustuminen auttaa sinua ymmärtämään, miten ne toimivat.

Voit sitten etsiä tapoja mukauttaa niitä työtilasi vaatimuksiin. Tämä lisää tiimisi tuottavuutta.