Направите сопствену команду косице у Слацк-у

Слацк је алатка која омогућава тимовима да комуницирају и сарађују. Једна од његових кључних карактеристика је употреба команди косе црте. Ове команде покрећу одређене радње или интеграције унутар платформе.

Док вам Слацк пружа неколико уграђених команди косих црта, можете креирати прилагођене команде користећи Слацк АПИ. Затим можете да конфигуришете прилагођену команду да изврши одређени задатак када га корисник покрене.

Зашто креирати прилагођену команду косе црте у Слацк-у?

Слацк-ове уграђене команде косих црта можда неће задовољити специфичне потребе вашег тима или организације. Креирањем прилагођених команди косе црте можете да креирате персонализованије искуство за свој тим. Ово заузврат повећава ангажовање тима.

Подешавање Слацк апликације

Да бисте то урадили, требало би да будете задовољни са основна употреба Слацк-а. Пријавите се на свој Слацк налог у прегледачу и креирајте нови радни простор. Користићете овај радни простор да тестирате своје апликације пре него што их употребите у радном простору свог тима.

Отворите другу картицу и идите на Слацк АПИ веб локација.

Кликните на Направите апликацију дугме. На следећој страници која се појави изаберите опцију за креирање апликације Од нуле.

Именујте апликацију и изаберите радни простор у којем ће апликација радити.

Кликните Креирајте апликацију дугме. Ово ће вас преусмерити на страницу која садржи основне информације о вашој апликацији.

У одељку са функцијама идите на ОАутх и дозволе функцију, а затим померите надоле до Опсег токена за бот. Додајте а цхат: писати опсег за вашу апликацију. Овај опсег ће омогућити вашој апликацији да шаље поруке радном простору.

Померите се нагоре до ОАутх токени за ваш радни простор одељак и кликните на Инсталирај у радни простор дугме.

На следећој страници која се појави кликните на Дозволи дугме. Ово ће инсталирати апликацију у ваш радни простор.

Креирање прилагођене команде сласх помоћу Слацк АПИ-ја

Након подешавања Слацк апликације, потребно је да креирате прилагођену команду за задатак који желите да извршите. На пример, команда косе црте која враћа шалу кориснику. Идите до Сласх Цоммандс одлика. Кликните на Креирајте нову команду дугме.

Попуните Цомманд, УРЛ захтева, и Кратак опис команде коју желите да креирате. УРЛ захтева је крајња тачка којој Слацк шаље ПОСТ захтев када корисник покрене команду. Користите УРЛ локалног хоста као чувар места; касније ћете променити ову УРЛ адресу.

Кликните на сачувати. Када сачувате, Слацк аутоматски додаје опсег команди за вашу апликацију. Овај опсег омогућава вашој апликацији да додаје пречице и команде косих црта које људи у вашем радном простору могу да користе. Промена опсега захтеваће да поново инсталирате апликацију. Кликните на поново инсталирајте своју апликацију дугме.

На страници која се појављује кликните на дозволи поновно инсталирање апликације на радном простору.

Конфигурисање понашања команде косе црте

Покрените било који Питхон ИДЕ. Креирајте ново виртуелно окружење. Направите нову Питхон датотеку и нову .енв датотеку. На терминалу покрените следећу команду да бисте инсталирали потребне библиотеке.

пип инсталл питхон-дотенв захтева Фласк слацк-болт

Тхе питхон-дотенв библиотека ће вам омогућити да учитате променљиве окружења у .енв датотеку. Тхе захтева библиотека вам омогућава да правите ХТТП захтеве и Фласк рукује долазним ХТТП захтевима и повратним одговорима. Слацк-болт обрађује долазне Слацк захтеве.

Отворите .енв датотеку и креирајте две променљиве окружења. Именујте их БОТ_ТОКЕН и СИГНИНГ_СЕЦРЕТ редом. Идите на веб локацију Слацк АПИ. Испод ваше апликације Основне информације копирајте тајну потписивања и користите је за иницијализацију променљиве БОТ_ТОКЕН. Идите до функције ОАутх и дозволе и копирајте ОАутх токен корисника бота. Користите га да иницијализујете променљиву СИГНИНГ_СЕЦРЕТ.

Токен бота је јединствени идентификатор који потврђује аутентичност ваше апликације помоћу Слацк-овог АПИ-ја када упућује АПИ позиве. Тајна потписивања потврђује да долазни захтеви вашој апликацији долазе из Слацк-а.

Комплетан изворни код је доступан у а ГитХуб спремиште.

Увезите потребне библиотеке и модуле.

увоз ос
из патхлиб увоз Пут
из дотенв увоз лоад_дотенв
увоз захтева
из пљоска увоз Фласк, захтев, јсонифи
из слацк_болт увоз Апликација
из слацк_болт.адаптер.фласк увоз СлацкРекуестХандлер

Креирајте нову инстанцу апликације Фласк.

апп = Фласк (__наме__)

Учитајте променљиве окружења из .енв датотеке користећи лоад_дотенв() функција.

енв_патх = Путања('.') / '.енв'
лоад_дотенв (дотенв_патх=енв_патх)

Креирајте нову инстанцу Слацк апликације користећи Апликација класе из слацк_болт библиотеке.

слацк_апп = Апп(
 токен=ос.енвирон['БОТ_ТОКЕН'],
 сигнинг_сецрет=ос.енвирон['СИГНИНГ_СЕЦРЕТ']
)

Креирајте функцију руковања рутом која обрађује долазне захтеве ка /slack/command крајња тачка. Када крајња тачка прими а ПОШТА захтева, анализира податке тела захтева. Затим проверава да ли је команда /joke. Ако јесте, позива се на гет_јоке() функцију и враћа ЈСОН одговор Слацк-у са резултатом команде.

@апп.роуте("/слацк/цомманд", метходс=["ПОСТ"])
дефкоманда():
# Рашчлањује податке тела захтева
 подаци = захтев.образац
# Позовите одговарајућу функцију на основу команде косе црте
ако подаци["команда"] == "/шала":
 порука = гет_јоке()
друго:
 порука = ф"Неважећа команда: {подаци['команда']}"
# Врати одговор у Слацк
повратак јсонифи({"текст": порука})

Креирајте функцију која шаље ГЕТ захтев ицанхаздадјоке АПИ за преузимање насумичне шале у ЈСОН формату. Затим враћа шалу као низ.

дефгет_јоке():
 урл = " https://icanhazdadjoke.com/"
 заглавља = {"Прихвати": "апплицатион/јсон"}
 одговор = рекуестс.гет (урл, хеадерс=хеадерс, тимеоут=5)
 шала = респонсе.јсон()["шала"]
повратак шала

Креирајте нову инстанцу а СлацкРекуестХандлер објекат који ће обрађивати долазне захтеве из Слацк-а.

обрађивач = СлацкРекуестХандлер (слацк_апп)

Проверите да ли се скрипта покреће директно и, ако јесте, покрените апликацију Фласк на порту 5000.

ако __наме__ == "__главни__":
# Покрените апликацију Фласк на порту 5000
 апп.рун (порт=5000, дебуг=Истина)

Покрените програм да покренете сервер на локалном хосту.

Да би програм комуницирао са Слацк-ом, потребна вам је УРЛ адреса којој може да приступи преко интернета. Преузмите и покрените нгрок. Тхе нгрок софтвер вам омогућава да креирате безбедну јавну УРЛ адресу који тунелира саобраћај ка веб серверу који ради на вашем рачунару.

Покрените следећу команду да бисте добили јавни УРЛ:

нгрок хттп 5000

Слика испод приказује јавни УРЛ на нгрок-у, означен белом.

Копирајте УРЛ и идите на веб локацију Слацк АПИ-ја. Кликните на Сласх Цоммандс одлика. Уредите команду /јоке и замените чувар места за УРЛ захтева својим јавним УРЛ-ом. Додајте /слацк/евентс на крај УРЛ-а да бисте указали на вашу крајњу тачку.

Идите на свој радни простор, затим откуцајте и пошаљите команду /јоке. Требало би да видите виц као одговор:

Упознајте се са другим Слацк функцијама

Слацк има много функција које може понудити осим Сласх команди. Упознавање са овим функцијама ће вам омогућити да разумете како оне функционишу.

Затим можете потражити начине да их прилагодите захтевима вашег радног простора. Ово ће повећати продуктивност вашег тима.