Slack on mugav ja populaarne tööriist, mida saate oma organisatsioonile kohandatud käskudega täiustada.

Slack on tööriist, mis võimaldab meeskondadel suhelda ja koostööd teha. Üks selle põhifunktsioone on kaldkriipsu käskude kasutamine. Need käsud käivitavad platvormisisesed konkreetsed toimingud või integratsioonid.

Kuigi Slack pakub teile mitut sisseehitatud kaldkriipsu käsku, saate Slacki API abil luua kohandatud käske. Seejärel saate kohandatud käsu konfigureerida täitma teatud toimingut, kui kasutaja selle käivitab.

Miks luua Slackis kohandatud kaldkriipsu käsk?

Slacki sisseehitatud kaldkriipsu käsud ei pruugi rahuldada teie meeskonna või organisatsiooni konkreetseid vajadusi. Kohandatud kaldkriipsuga käskude loomisega saate luua oma meeskonna jaoks isikupärasema kogemuse. See omakorda suurendab meeskonna kaasatust.

Slacki rakenduse seadistamine

Järgimiseks peaksite olema rahul Slacki põhikasutus. Logige brauseris sisse oma Slacki kontole ja looge uus tööruum. Kasutate seda tööruumi oma rakenduste testimiseks enne nende kasutamist oma meeskonna tööruumis.

instagram viewer

Avage teine ​​vahekaart ja liikuge lehele Slacki API veebisait.

Klõpsake nuppu Looge rakendus nuppu. Järgmisel kuvataval lehel valige rakenduse loomise valik Algusest.

Nimetage rakendus ja valige tööruum, kus rakendus töötab.

Klõpsake nuppu Loo rakendus nuppu. See suunab teid lehele, mis sisaldab teie rakenduse põhiteavet.

Funktsioonide jaotises navigeerige jaotisse OAuth ja load funktsioon, seejärel kerige alla kuni Bot Token Scopes. Lisa vestlus: kirjuta teie rakenduse jaoks. See ulatus võimaldab teie rakendusel saata tööruumi sõnumeid.

Kerige üles kuni OAuthi märgid teie tööruumi jaoks jaotist ja klõpsake nuppu Installige tööruumi nuppu.

Järgmisel kuvataval lehel klõpsake nuppu Lubama nuppu. See installib rakenduse teie tööruumi.

Kohandatud kaldkriipsu käsu loomine Slacki API abil

Pärast Slacki rakenduse seadistamist peate looma kohandatud käsu ülesande jaoks, mida soovite täita. Näiteks kaldkriipsuga käsk, mis tagastab kasutajale nalja. Navigeerige lehele Kaldkriipsuga käsud tunnusjoon. Klõpsake nuppu Loo uus käsk nuppu.

Täitke Käsk, Taotlege URL-i, ja Lühike kirjeldus käsust, mida soovite luua. Taotluse URL on lõpp-punkt, millele Slack saadab POST-päringu, kui kasutaja käsu käivitab. Kasutage kohatäitena kohaliku hosti URL-i; muudate seda URL-i hiljem.

Kliki Salvesta. Kui salvestate, lisab Slack teie rakendusele automaatselt käskude ulatuse. See ulatus võimaldab teie rakendusel lisada otseteid ja kaldkriipsuga käske, mida teie tööruumis olevad inimesed saavad kasutada. Ulatuste muutmiseks peate rakenduse uuesti installima. Klõpsake nuppu installige oma rakendus uuesti nuppu.

Järgmisena kuvataval lehel klõpsake käsul Luba rakenduse uuesti installimine oma tööruumi.

Kaldkriipsu käsu käitumise konfigureerimine

Käivitage mis tahes Pythoni IDE. Looge uus virtuaalne keskkond. Looge uus Pythoni fail ja uus env-fail. Käivitage terminalis vajalike teekide installimiseks järgmine käsk.

pip install python-dotenv nõuab Kolvi lõtvumist

The python-dotenv teek võimaldab teil laadida keskkonnamuutujaid .env-faili. The taotlusi teek võimaldab teha HTTP-päringuid ja Kolb käsitleb sissetulevaid HTTP päringuid ja tagastab vastuseid. Nõrk-polt käsitleb sissetulevaid Slacki päringuid.

Avage .env-fail ja looge kaks keskkonnamuutujat. Nimetage need BOT_TOKEN ja SIGNING_SECRET vastavalt. Liikuge Slacki API veebisaidile. Teie rakenduse all Põhiandmed kopeerige allkirjastamise saladus ja kasutage seda muutuja BOT_TOKEN lähtestamiseks. Liikuge OAuthi ja lubade funktsiooni juurde ning kopeerige Boti kasutaja OAuthi luba. Kasutage seda muutuja SIGNING_SECRET lähtestamiseks.

Boti tunnus on unikaalne identifikaator, mis autentib teie rakenduse API-kõnede tegemisel Slacki API-ga. Allkirjasaladus kinnitab, et teie rakendusse tulevad sissetulevad päringud Slackilt.

Täielik lähtekood on saadaval a GitHubi hoidla.

Importige vajalikud teegid ja moodulid.

importida os
alates pathlib importida Tee
alates dotenv importida load_dotenv
importida taotlusi
alates kolb importida Kolb, taotle, jsonify
alates slack_bolt importida Rakendus
alates slack_bolt.adapter.flask importida SlackRequestHandler

Looge Flask rakenduse uus eksemplar.

rakendus = Kolb (__name__)

Laadige keskkonnamuutujad .env-failist, kasutades load_dotenv() funktsiooni.

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

Looge Slacki rakenduse uus eksemplar, kasutades Rakendus klassi teegist slack_bolt.

slack_app = Rakendus(
 token=os.environ[„BOT_TOKEN”],
 signing_secret=os.environ['SIGNING_SECRET']
)

Looge marsruudi töötleja funktsioon, mis käsitleb sissetulevaid päringuid /slack/command lõpp-punkt. Kui lõpp-punkt saab a POSTITA päringu puhul analüüsib see päringu keha andmeid. Seejärel kontrollib, kas käsk on /joke. Kui jah, siis see kutsub saa_nalja() funktsiooni ja tagastab Slackile JSON-vastuse koos käsu tulemusega.

@app.route("/slack/command", method=["POSTITA"])
defkäsk():
# Parsi päringu kehaandmeid
 andmed = päring.vorm
# Kutsuge kaldkriipsu käsu põhjal välja sobiv funktsioon
kui andmed["käsk"] == "/nali":
 sõnum = get_joke()
muidu:
 sõnum = f"Vigane käsk: {data['käsk']}"
# Tagasta vastus Slackile
tagasi jsonify({"tekst": sõnum})

Looge funktsioon, mis saadab GET-päringu seadmele icanhazdadjoke API JSON-vormingus juhusliku nalja toomiseks. Seejärel tagastab see nalja stringina.

defsaa_nalja():
 url = " https://icanhazdadjoke.com/"
 päised = {"Nõustu": "rakendus/json"}
 vastus = requests.get (url, headers=headers, timeout=5)
 nali = vastus.json()["nali"]
tagasi nali

Looge uus eksemplar a SlackRequestHandler objekt, mis käsitleb Slacki sissetulevaid taotlusi.

käitleja = SlackRequestHandler (slack_app)

Kontrollige, kas skripti käitatakse otse, ja kui on, käivitage Flask rakendus pordis 5000.

kui __nimi__ == "__main__":
# Käivitage Flask rakendus pordis 5000
 app.run (port=5000, silumine=Tõsi)

Localhostis töötava serveri käivitamiseks käivitage programm.

Programmi Slackiga suhtlemiseks vajate URL-i, millele see Interneti kaudu juurde pääseb. Laadige alla ja käivitage ngrok. The ngrok tarkvara võimaldab teil luua turvalise avaliku URL-i mis suunab liikluse teie arvutis töötavasse veebiserverisse.

Käivitage järgmine käsk avaliku URL-i hankimiseks:

ngrok http 5000

Alloleval pildil on ngroki avalik URL, mis on valgega esile tõstetud.

Kopeerige URL ja liikuge Slacki API veebisaidile. Klõpsake nuppu Kaldkriipsuga käsud tunnusjoon. Muutke käsku /joke ja asendage päringu URL-i kohatäide oma avaliku URL-iga. Lisage URL-i lõppu /slack/events, et osutada oma lõpp-punktile.

Minge oma tööalale, tippige ja saatke käsk /joke. Vastuseks peaksite nägema nalja:

Viige end kurssi teiste Slacki funktsioonidega

Slackil on peale Slashi käskude pakkuda palju funktsioone. Nende funktsioonidega tutvumine võimaldab teil mõista nende toimimist.

Seejärel saate otsida viise, kuidas neid oma tööruumi nõuetega kohandada. See tõstab teie meeskonna tootlikkust.