Како послати прилагођене поруке на Слацк из ваше апликације

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

Овако можемо лако слати поруке Слацк-у из било које апликације коју већ имамо; можемо слати извештаје, ажурирања, вести, обавештења и још много тога. За овај пост сам користио ЈаваСцрипт у примјеру. За почетак, пријавите се на рачун Слацк вашег тима.

1. Поставите интеграцију

Прво ћете морати да подесите долазну интеграцију вебхоок-а. Иди на иоуртеам.слацк.цом/аппс/буилд/цустом-интегратион и кликните на Инцоминг Вебхоокс, затим изаберите канал или корисника на који желите да пошаљете своје поруке (овај избор може бити замењен касније у коду).

Када завршите, видећете страницу конфигурације долазне вебхоок интеграције.

Померите се надоле и биће приказан УРЛ Вебхоок-а у формату хттпс://хоокс.слацк.цом/сервицес/ТКСКСКСКСКСКСКСКС/БКСКСКСКСКСКСКСКС/токен. Сачувајте тај УРЛ негде, требаће нам касније. Можете и даље да мењате икону и име интеграције на овој страници, али то ћемо урадити у коду.

2. Креирајте поруку

Претпоставимо да сте већ направили веб апликацију која тражи продају Валентинова на популарним сајтовима, као и кодове понуде за употребу током продаје, и из неког разлога желите да поделите овај резултат са члановима Слацк тима.

Све што треба да урадимо сада је да користимо УРЛ вебхоок-а креиран у претходном кораку и да му поставимо захтев из ваше апликације са ЈСОН подацима, који ће саставити поруку понуде понуде.

Прво саставимо ЈСОН стринг који ће бити претворен у Слацк поруку. Параметар који носи ЈСОН податке се зове паилоад, па ЈСОН стринг треба да изгледа овако:

вар миЈСОНСтр = 'паилоад = "усернаме": "САЛЕ БОТ", "ицон_урл": "екампле.цом/имг/ицон.јпг", "канал": "#генерал"' 

ицон_урл је УРЛ слике која ће се приказати као слика профила, коју такође можете користити ицон_емоји за приказивање емотикона као слике профила, на пример "ицон_емоји": ": дар:". "канал" наводи канал или корисничко име који ће видети вашу поруку. За корисничко име користите синтаксу "@корисничко име", за канал "#цханнелнаме".

Сада за стварну поруку; можете или додати "текст" и напишите вашу поруку као њену вриједност и извршите с њом, или користите својство које се зове "прилог" да додамо богато обликован текст, што ћемо сада и радити.

Тхе "прилог" имовина паилоад иде овако:

"аттацхментс": ["фаллбацк": "Аттацхемент није подржан.", "титле": "ВАЛЕНТИНЕ'С ДАИ ОФФЕР", "цолор": "# 9Ц1А22", "претект": "Данас је изабрана листа одличних понуда за вас "," аутхор_наме ":" Преетхи "," аутхор_линк ":" хттпс://ввв.хонгкиат.цом/блог/аутхор/преетхи/ "," аутхор_ицон ":" хттпс://ассетс.хонгкиат.цом/ уплоадс / аутхор / преетхи.јпг "," мркдвн_ин ": [" тект "," фиелдс "]," тект ":" Само кликните на називе сајта и почните да купујете. "," тхумб_урл ":" хттп://екампле.цом/тхумбнаил.јпг "]

"повући се" је алтернативни текст који ће се приказати када се Слацк порука погледа у апликацији која не подржава прилог поруке (као у мобилним обавештењима).

"боја" је боја леве ивице поруке.

"изговор" је текст који је приказан пре главног садржаја.

"аутхор_линк" је УРЛ хипервезан у име аутора (ако је обезбеђен).

"мркдвн_ин" је низ назива својстава чије су вредности приказане у поруци - на основу синтаксе одбијања као (*) за болд и (_) за курзив. Три могуће вредности за "мркдвн_ин" су "текст", "предговор" и "поља"

"тхумб_урл" је УРЛ слике минијатуре.

Ево како ће порука изгледати до сада.

Сада ћемо додати поља у поље за прилоге, који ће приказати локације и кодове понуда у две колоне.

"фиелдс": ["титле": "Ситес", "валуе": "__ \ т_ "," схорт ": труе, " титле ":" Шифра понуде "," вредност ":" УИ90О22 н- "," схорт ": труе], 

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

Подцртавање се користи за форматирање текста курзивом.

кратак је подешен на истина ако се вредности приказују једна поред друге (као да је кратка). Заједно, ЈСОНСтринг ће изгледати овако (држите стринг у једном реду у стварном радном коду)

вар миЈСОНСтр = 'паилоад = "усернаме": "САЛЕ БОТ", "ицон_урл": "екампле.цом/имг/ицон.јпг", "аттацхментс": ["фаллбацк": "Овај додатак није подржан. "," титле ":" ПОНУДА ЗА ДАН ВАЛЕНТИНА "," боја ":" # 9Ц1А22 "," претект ":" Данашњи списак одличних понуда одабраних за вас "," аутхор_наме ":" Преетхи "," аутхор_линк ":" хттпс : //ввв.хонгкиат.цом/блог/аутхор/преетхи/ "," аутхор_ицон ":" хттпс://ассетс.хонгкиат.цом/уплоадс/аутхор/преетхи.јпг "," фиелдс ": [" " : "Ситес", "валуе": "__ \ т_ "," схорт ": труе, " титле ":" Шифра понуде "," вредност ":" УИ90О22 н- "," схорт ": труе]," мркдвн_ин ": [" тект "," фиелдс "]," тект ":" Само кликните на називе сајтова и почните да купујете. * Додатно смањите са шифром понуде *, ако је достављена. "," Тхумб_урл ":" хттп://екампле.цом/тхумбнаил.јпг "] '; 

3. Пошаљите захтев

Сада да бисте поставили захтев за објављивање у ЈаваСцрипт-у, користите функцију испод:

фунцтион постМессагеТоСлацк () вар кмлхттп = нев КСМЛХттпРекуест (), вебхоок_урл = урл-иоу-савед-фром-бефоре, миЈСОНСтр = јсон-стринг-фром-абове; кмлхттп.опен ('ПОСТ', вебхоок_урл, фалсе); кмлхттп.сетРекуестХеадер ('Цонтент-Типе', 'апплицатион / к-ввв-форм-урленцодед'); кмлхттп.сенд (миЈСОНСтр);  

Додајте ову функцију клику на дугме или учитавање странице да види како ради.

Коначни излаз ће изгледати овако: