Kaip siųsti pritaikytus pranešimus, kad jie būtų atjungti nuo jūsų programos

„Slack“ yra populiarių pranešimų programa, kurią naudoja daugelis komandų. Jis turi daugybę paslaugų ir API programuotojams integruoti ją su savo taikomosiomis programomis. Šiandieniniame pranešime pamatysime, kaip naudoti vieną iš savo paslaugų, vadinamų „Priimamosiomis interneto naršyklėmis“, kad galėtumėte siųsti duomenis iš išorinės programos.

Tokiu būdu mes galime lengvai siųsti laiškus į „Slack“ iš bet kurios programos, kurią jau turime; galime siųsti ataskaitas, atnaujinimus, naujienas, pranešimus ir kt. Šiam įrašui pavyzdyje naudoju „JavaScript“. Norėdami pradėti, prisijunkite prie savo komandos „Slack“ paskyros.

1. Nustatykite integraciją

Pirmiausia turėsite įdiegti gaunamą žiniatinklio jungiklį. Eiti į yourteam.slack.com/apps/build/custom-integration ir spustelėkite Gaunamos žiniatinklio kontaktai, tada pasirinkite kanalą arba naudotoją, į kurį norite skelbti pranešimus (vėliau šis kodas gali būti panaikintas).

Kai tai padarysite, pamatysite savo įeinančios žiniatinklio integracijos konfigūracijos puslapį.

Slinkite žemyn ir formatu bus sukurtas „Webhook“ URL https://hooks.slack.com/services/TXXXXXXXX/BXXXXXXXX/token. Išsaugoti šį URL kažkur, mums reikės vėliau. Jūs galite toliau keisti šiame puslapyje esančio integracijos piktogramą ir pavadinimą, bet tai padarysime kodais.

2. Sukurkite pranešimą

Įsivaizduokime, kad jau sukūrėte žiniatinklio programą, kurioje ieškoma „Valentino dienos“ pardavimo populiariose svetainėse, taip pat pasiūlymo kodus, naudojamus pardavimo metu, ir dėl kokios nors priežasties norite pasidalinti rezultatu su „Slack“ komandos nariais.

Viskas, ką turime padaryti dabar, yra naudoti ankstesniame etape sukurtą „webhook“ URL ir paskelbti prašymą iš jūsų paraiškos su JSON duomenimis, kurie sukurs pardavimo pasiūlymo pranešimą.

Pirmiausia sujunkite JSON eilutę, kuri bus paversta „Slack“ žinute. JSON duomenis turintis parametras vadinamas naudinguoju kroviniu, todėl JSON eilutė turėtų atrodyti taip:

var myJSONStr = 'payload = "naudotojo vardas": "SALE BOT", "icon_url": "example.com/img/icon.jpg", "kanalas": "#general"' 

icon_url yra vaizdo įrašo URL, kuris bus rodomas kaip profilio nuotrauka, taip pat galite naudoti icon_emoji pvz., rodyti profilį kaip profilio paveikslėlį "icon_emoji": ": dovana:". „kanalas“ nurodo kanalą arba naudotojo vardą, kuris matys jūsų pranešimą. Naudotojui naudokite sintaksę "@Vartotojo vardas", kanalo „#channelname“.

Dabar už faktinį pranešimą; galite arba pridėti „tekstas“ nuosavybė ir parašykite savo žinutę kaip jos vertę ir su ja, ar naudokite skambintą turtą „priedas“ pridėti turtingai suformatuotą tekstą, ką mes darysime dabar.

The „priedas“ nuosavybė naudingoji apkrova eina taip:

"Priedai": ["atsarginis": "Priedas nepalaikomas.", "Pavadinimas": "VALENTINOS DIENOS PASIŪLYMAS", "spalva": "# 9C1A22", "pretekstas": "Šiandien išsirinktų nuostabių pasiūlymų sąrašas jums "," autoriaus vardas ":" Preethi "," author_link ":" https://www.hongkiat.com/blog/author/preethi/ "," author_icon ":" https://assets.hongkiat.com/ uploads / author / preethi.jpg "," mrkdwn_in ": [" tekstas "," laukai "]," tekstas ":" Tiesiog spustelėkite svetainės vardus ir pradėkite pirkti. Gauti * papildomą sumažinimą su pasiūlymo kodu *, jei yra. "," thumb_url ":" http://example.com/thumbnail.jpg "]

"atsitraukti" yra alternatyvus tekstas, kuris bus rodomas, kai „Slack“ pranešimas peržiūrimas programoje, kuri nepalaiko pranešimo priedo (pvz., mobiliesiems pranešimams).

„spalva“ yra kairiojo krašto spalva.

„pretekstas“ yra tekstas, rodomas prieš pagrindinį turinį.

„author_link“ yra URL, susietas su autoriaus vardu (jei yra).

"mrkdwn_in" yra nuosavybės pavadinimų masyvas, kurio vertės rodomos pranešime suformatuotos - remiantis žymėjimo sintaksė, kaip (*) paryškintu ir (_) kursyvu. Trys galimos vertės "mrkdwn_in" yra „tekstas“, „pretekstas“ ir „laukai“

„thumb_url“ yra miniatiūros vaizdo URL.

Štai kaip pranešimas atrodys iki šiol.

Dabar pridėkime laukus prie priedų masyvo, kuriame bus rodomos svetainės ir siūlomi kodai dviejose skiltyse.

"laukai": ["pavadinimas": "Sklypai", "vertė": "___ "," short ": true, " title ":" Offer Code "," value ":" UI90O22 "-" trumpas ": tiesa], 

Naudokite n pridėti eilutės pertrauką ir sintaksę pridėti hipersaitus.

Paryškinimas naudojamas teksto formatavimui kursyvu.

trumpas yra nustatytas tiesa jei vertės turi būti rodomos šalia (pvz., jei jos trumpos). Kartu „JSONString“ atrodys taip (laikykite eilutę vienoje eilutėje faktiniame darbo kode)

var myJSONStr = 'payload = "naudotojo vardas": "SALE BOT", "icon_url": "example.com/img/icon.jpg", "priedai": ["„ backback “:„ Šis priedas nepalaikomas. "," pavadinimas: "VALENTINOS DIENOS PASIŪLYMAS", "spalva": "# 9C1A22", "pretekstas": "Šiandienos išsirinktų nuostabių pasiūlymų sąrašas", "autoriaus vardas": "Preethi", "autoriaus nuoroda": "https : //www.hongkiat.com/blog/author/preethi/ "," author_icon ":" https://assets.hongkiat.com/uploads/author/preethi.jpg "," laukai ": [" pavadinimas " : "Sklypai", "vertė": "___ "," short ": true, " title ":" Offer Code "," value ":" UI90O22 n- "," short ": true]," mrkdwn_in ": [" text "," laukai "]," tekstas ":" Tiesiog spustelėkite svetainės vardus ir pradėkite pirkti. Gaukite * papildomą sumažinimą su pasiūlymo kodu *, jei yra. "," Thumb_url ":" http://example.com/thumbnail.jpg "] '; 

3. Paskelbkite užklausą

Dabar, jei norite atlikti užklausą „JavaScript“, naudokite toliau nurodytą funkciją:

funkcija postMessageToSlack () var xmlhttp = new XMLHttpRequest (), webhook_url = url-you-saved-from-before, myJSONStr = json-string-from-above; xmlhttp.open ('POST', webhook_url, false); xmlhttp.setRequestHeader („Turinio tipas“, „taikymas / x-www-form-urlencoded“); xmlhttp.send (myJSONStr);  

Pridėkite šią funkciją prie mygtuko paspaudimo arba puslapio apkrovos pamatyti, kad jis veikia.

Galutinis rezultatas atrodys panašus: