Kohandatud sõnumite saatmine oma rakendusest lahti

Slack on populaarne sõnumirakendus, mida kasutavad paljud meeskonnad. Kaasas palju teenuseid ja API arendajatele, et integreerida see oma rakendustega. Tänases postituses näeme, kuidas kasutada mõnda oma teenust, mida nimetatakse sissetulevateks veebihoovadeks, et saata andmeid välisele rakendusest lahti..

Nii saame lihtsalt saata sõnumeid Slackile mis tahes rakendusest, mis meil juba on; saame saata aruandeid, uuendusi, uudiseid, teatisi ja palju muud. Selle postituse jaoks olen kasutanud näites JavaScripti. Alustamiseks logige sisse oma meeskonna Slack kontole.

1. Seadistage integratsioon

Kõigepealt peate seadistama sissetuleva veebihoova integratsiooni. Minema yourteam.slack.com/apps/build/custom-integration ja klõpsa Sissetulevad Webhooks, seejärel valige kanal või kasutaja, kellele soovite oma sõnumid postitada (seda valikut saab hiljem koodis tühistada).

Kui olete valmis, näete oma sissetuleva veebihoova integreerimise lehekülge.

Liikuge allapoole ja vormingus on veebihoov https://hooks.slack.com/services/TXXXXXXXX/BXXXXXXXX/token. Salvesta see URL kusagil, me vajame seda hiljem. Selle lehekülje enda integratsiooni ikooni ja nime saate muuta, kuid me teeme seda koodis.

2. Loo sõnum

Kujutlege, et olete juba loonud veebirakenduse, mis otsib populaarseid saite Valentine's Day'i müügitehinguid, samuti müügi ajal kasutatavad pakkumiskoodid ja mingil põhjusel soovite seda tulemust jagada oma Slack meeskonna liikmetega.

Kõik, mida me peame tegema, on kasutada eelmises sammus loodud veebikirje URL-i ja postitada oma taotlusest taotlus JSON-i andmetega, mis kujundavad müügipakkumise teate.

Tehkem kõigepealt JSON-string, mis muutub Slack-sõnumiks. JSON-andmeid sisaldavat parameetrit nimetatakse kasuliseks koormuseks, seega peaks JSON-string olema selline:

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

icon_url on pildi URL, mis kuvatakse profiilipildina, mida saate kasutada ka icon_emoji näiteks kuvada emoji kui profiilipilt "icon_emoji": ": kingitus:". "kanal" määrab kanali või kasutajanime, kes teie sõnumit näeb. Kasutajanimi kasutage süntaksit "@kasutaja", kanali jaoks "#channelname".

Nüüd tegelik sõnum; saate lisada "tekst" kinnisvara ja kirjutage sõnum selle väärtuseks ning seda tehke või kasutage kutsutud vara "manus" rikkalikult vormindatud teksti lisamiseks, mida me praegu teeme.

The "manus" vara kasulik koormus läheb niimoodi:

"manused": ["varukoopia": "manus ei ole toetatud.", "pealkiri": "VALENTINE'I PÄEVA PAKKUMINE", "värv": "# 9C1A22", "ettekäändeks": "Tänapäeva valikus olevate suurepäraste pakkumiste loend sinu jaoks "," autor_nimi ":" Preethi "," autor_link ":" https://www.hongkiat.com/blog/author/preethi/ "," author_icon ":" https://assets.hongkiat.com/ uploads / author / preethi.jpg "," mrkdwn_in ": [" tekst "," väljad "]," tekst ":" Lihtsalt klikkige saidi nimedel ja alustage ostmist. Saage * lisahüvitist pakkumise koodiga *, kui see on olemas. "," thumb_url ":" http://example.com/thumbnail.jpg "]

"tagasilöök" on alternatiivne tekst, mis kuvatakse, kui Slack-sõnumit vaadatakse rakenduses, mis ei toeta sõnumite manuseid (näiteks mobiilside teatistes).

"värv" on sõnumi vasakpoolne värv.

"ettekääne" on tekst, mis on näidatud enne põhisisu.

"author_link" on URL, mis on linkitud autori nimele (kui see on olemas).

"mrkdwn_in" on massiivi omaduste nimedest, mille väärtused on sõnumis vormindatud - tuginedes (*) märgistatud süntaksile paksus kirjas ja (_) kaldkirjas. Kolm võimalikku väärtust "mrkdwn_in" on "tekst", "ettekanne" ja "väljad"

"thumb_url" on pisipiltide URL.

Siin on, kuidas sõnum siiani näeb.

Nüüd lisame väljad manuste rühma, mis kuvab saidid ja pakkumiskoodid kahes veerus.

"väljad": ["pealkiri": "saidid", "väärtus": "___ "," lühike ": true, " title ":" Pakkumiskood "," väärtus ":" UI90O22 n- "," lühike ": tõsi], 

Kasutage n reavahetuse ja süntaksi lisamiseks hüperlinkide lisamiseks.

Alamjoonist kasutatakse kursiivis teksti vormindamiseks.

lühike on seatud tõsi kui väärtused kuvatakse kõrvuti (näiteks kui see on lühike). Kokkuvõttes näeb JSONString välja sellisena (hoidke stringit reaalses töökoodis ühes reas)

var myJSONStr = 'payload = "kasutajanimi": "SALE BOT", "icon_url": "example.com/img/icon.jpg", "manused": ["varukoopia:" See manus ei ole toetatud. "," pealkiri: "VALENTINA PÄEVA PAKKUMINE", "värv": "# 9C1A22", "ettekääne": "Täna valitud suurepäraste pakkumiste nimekiri", "autori_nimi": "Preethi", "autor_link": "https : //www.hongkiat.com/blog/author/preethi/ "," author_icon ":" https://assets.hongkiat.com/uploads/author/preethi.jpg "," väljad ": [" pealkiri " : "Saidid", "väärtus": "___ "," short ": true, " title ":" pakkumise kood "," väärtus ":" UI90O22 n- "," short ": true]," mrkdwn_in ": [" tekst "," väljad " "]," tekst ":" Klõpsake lihtsalt saidi nimedel ja alustage ostmist. Saada * lisahüvitist pakkumise koodiga *, kui see on olemas. "," Thumb_url ":" http://example.com/thumbnail.jpg "] '; 

3. Postitage taotlus

Nüüd, kui soovite postitamisnõude JavaScriptis, kasutage alltoodud funktsiooni:

funktsioon postMessageToSlack () var xmlhttp = uus XMLHttpRequest (), webhook_url = url-you-saved-from-before, myJSONStr = json-string-from-above; xmlhttp.open ('POST', webhook_url, false); xmlhttp.setRequestHeader ('Sisu-tüüp', 'Rakendus / x-www-vorm-urlencoded'); xmlhttp.send (myJSONStr);  

Lisage see funktsioon nupule või lehe laadimisele seda näha.

Lõplik väljund näeb välja selline: