Kā nosūtīt pielāgotus ziņojumus, lai tos atlaistu no lietojumprogrammas

Slack ir populāra ziņojumapmaiņas programma, ko izmanto daudzas komandas. Tas nāk ar daudziem pakalpojumiem un API izstrādātājiem, lai to integrētu ar savām lietojumprogrammām. Šodienas ziņojumā mēs redzēsim, kā izmantot vienu no saviem pakalpojumiem, ko sauc par ienākošajām Webhooks, lai nosūtītu datus uz ārēju lietojumprogrammu.

Tādā veidā mēs varam viegli nosūtīt ziņas uz Slack no jebkuras lietojumprogrammas, kas mums jau ir; mēs varam nosūtīt ziņojumus, atjauninājumus, ziņas, paziņojumus un daudz ko citu. Šim ziņojumam es, piemēram, esmu izmantojis JavaScript. Lai sāktu, pierakstieties komandas Slack kontā.

1. Izveidojiet integrāciju

Vispirms jums būs jāizveido ienākošā webhook integrācija. Iet uz yourteam.slack.com/apps/build/custom-integration un noklikšķiniet uz Ienākošie Webhooks, pēc tam atlasiet kanālu vai lietotāju, kuru vēlaties nosūtīt ziņojumus (šo izvēli var ignorēt vēlāk kodā).

Kad tas būs izdarīts, jūs redzēsiet jūsu ienākošo webhook integrācijas konfigurācijas lapu.

Ritiniet uz leju un formātā būs pieejams Webhook URL https://hooks.slack.com/services/TXXXXXXXX/BXXXXXXXX/token. Saglabājot šo URL kaut kur, tas būs nepieciešams vēlāk. Jūs varat vēl vairāk mainīt šīs lapas ikonu un nosaukumu, bet mēs to darīsim kodā.

2. Izveidojiet ziņojumu

Iedomājieties, ka esat jau izveidojis tīmekļa lietojumprogrammu, kas meklē Valentīna dienas pārdošanu populārajās vietnēs, kā arī piedāvājuma kodus izmantošanai pārdošanas laikā, un kādu iemeslu dēļ vēlaties kopīgot šo rezultātu ar Slack komandas dalībniekiem.

Viss, kas mums tagad jādara, ir izmantot iepriekšējā solī izveidoto tīmekļa pārmeklēšanas vietrādi URL un nosūtīt tai pieprasījumu no jūsu pieteikuma, izmantojot JSON datus, kas sāks pārdošanas piedāvājuma ziņojumu.

Vispirms apkoposim JSON virkni, kas tiks pārvērsta par slack ziņojumu. Parametru, kas satur JSON datus, sauc par lietderīgo slodzi, tāpēc JSON virknei vajadzētu izskatīties šādi:

var myJSONStr = 'payload = "lietotājvārds": "SALE BOT", "icon_url": "example.com/img/icon.jpg", "kanāls": "#general"' 

icon_url ir URL attēls, kas tiks parādīts kā profila attēls, varat arī izmantot icon_emoji piemēram, lai parādītu emociju kā profila attēlu "icon_emoji": ": dāvana:". "kanāls" norāda kanālu vai lietotājvārdu, kurš redzēs jūsu ziņojumu. Lietotājvārdam izmantojiet sintaksi "@ lietotājvārds", kanālam "#channelname".

Tagad par faktisko ziņojumu; jūs varat pievienot "teksts" īpašums un rakstiet savu ziņu kā tās vērtību un veiciet ar to vai izmantojiet saucamo īpašumu "pielikums" lai pievienotu bagātīgi formatētu tekstu, ko mēs darīsim tagad.

The "pielikums" īpašums lietderīgā slodze iet šādi:

"pielikumi": ["atpalicība": "pielikums netiek atbalstīts.", "nosaukums": "VALENTĪNA DIENAS PIEDĀVĀJUMS", "krāsa": "# 9C1A22", "aizbildinājums": "Šodienas atlasīto awesome piedāvājumu saraksts jums "," autora_nosaukums ":" Preethi "," autors_link ":" https://www.hongkiat.com/blog/author/preethi/ "," author_icon ":" https://assets.hongkiat.com/ uploads / author / preethi.jpg "," mrkdwn_in ": [" teksts "," lauki "]," teksts ":" Vienkārši noklikšķiniet uz vietnes nosaukumiem un sāciet iegādāties. Saņemiet * papildu samazinājumu ar piedāvājuma kodu *, ja tāds ir. "," thumb_url ":" http://example.com/thumbnail.jpg "]

"atkāpties" ir alternatīvais teksts, kas tiks parādīts, kad Slack ziņojums tiek skatīts lietojumprogrammā, kas neatbalsta ziņojumu pielikumu (piemēram, mobilajos paziņojumos).

"krāsa" ir ziņas kreisā robeža.

"aizbildinājums" ir teksts, kas parādīts pirms galvenā satura.

"author_link" ir URL, kas ir saistīts ar autora vārdu (ja tāds ir).

"mrkdwn_in" ir īpašību nosaukumu masīvs, kura vērtības tiek parādītas ziņojumā, pamatojoties uz iezīmēšanas sintaksi, piemēram, (*) treknrakstā un (_) slīprakstam. Trīs iespējamās vērtības "mrkdwn_in" ir "teksts", "aizbildinājums" un "lauki"

"thumb_url" ir sīktēlu attēla URL.

Lūk, kā ziņojums izskatīsies līdz šim.

Tagad pievienosim laukus pielikumu masīvam, kas parādīs vietnes un piedāvājuma kodus divās kolonnās.

"lauki": ["nosaukums": "vietnes", "vērtība": "___ "," īss ": true, " title ":" Piedāvājuma kods "," vērtība ":" UI90O22 n- "," īss ": taisnība], 

Izmantot n lai pievienotu rindas pārtraukumu un sintaksi lai pievienotu hipersaites.

Pamati tiek izmantoti, lai formatētu tekstu kursīvā.

īss ir iestatīts uz taisnība ja vērtības ir jānorāda blakus (piemēram, ja tas ir īss). Kopā JSONString izskatīsies šādi (saglabājiet virkni vienā rindā faktiskajā darba kodā)

var myJSONStr = 'payload = "lietotājvārds": "SALE BOT", "icon_url": "example.com/img/icon.jpg", "pielikumi": ["rezerves": šis pielikums netiek atbalstīts. "," virsraksts: "VALENTĪNA DIENAS PIEDĀVĀJUMS", "krāsa": "# 9C1A22", "aizbildinājums": "Šodienas atlasītie lieliski piedāvājumi", "autora_nosaukums": "Preethi", "autors_link": "https : //www.hongkiat.com/blog/author/preethi/ "," author_icon ":" https://assets.hongkiat.com/uploads/author/preethi.jpg "," lauki ": [" nosaukums " : "Vietnes", "vērtība": "___ "," īss ": true, " title ":" piedāvājuma kods "," vērtība ":" UI90O22 n- "," īss ": true]," mrkdwn_in ": [" teksta "," lauki " "]," teksts ":" Vienkārši noklikšķiniet uz vietņu nosaukumiem un sāciet iegādāties. Saņemiet * papildu samazinājumu ar piedāvājuma kodu *, ja tāds ir. "," Thumb_url ":" http://example.com/thumbnail.jpg "] '; 

3. Publicējiet pieprasījumu

Tagad, lai veiktu pasta pieprasījumu JavaScript, izmantojiet tālāk norādīto funkciju:

funkcija postMessageToSlack () var xmlhttp = jauns XMLHttpRequest (), webhook_url = url-you-saved-from-before, myJSONStr = json-string-from-above; xmlhttp.open ('POST', webhook_url, false); xmlhttp.setRequestHeader ('Content-Type', 'application / x-www-form-urlencoded'); xmlhttp.send (myJSONStr);  

Pievienojiet šo funkciju uz pogas klikšķa vai lapas ielādes lai to redzētu.

Galīgais rezultāts izskatīsies šādi: