Kako poslati po meri prilagojena sporočila, da ne upoštevajo vaše aplikacije

Slack je priljubljena aplikacija za sporočila, ki jo uporabljajo številne ekipe. Na voljo je veliko storitev in API za razvijalce, da ga integrirajo s svojimi aplikacijami. V današnji objavi bomo videli, kako uporabiti eno od svojih storitev, imenovano Incoming Webhooks, za pošiljanje podatkov, da se ohladi iz zunanje aplikacije.

Tako lahko preprosto pošiljanje sporočil Slack iz katere koli aplikacije, ki jo že imamo; pošiljamo poročila, posodobitve, novice, obvestila in drugo. Za to objavo sem v primeru uporabil JavaScript. Za začetek se prijavite v račun Slack vaše ekipe.

1. Nastavite integracijo

Najprej morate nastaviti vhodno spletno integracijo. Pojdi do yourteam.slack.com/apps/build/custom-integration in kliknite Dohodni spletni trgi, nato izberite kanal ali uporabnika, v katerega želite objaviti svoja sporočila (to izbiro je mogoče pozneje preglasiti v kodi).

Ko končate, boste videli konfiguracijsko stran za vhodno spletno zaklepanje.

Pomaknite se navzdol in v obliki zapisa boste našli spletni naslov Webhook https://hooks.slack.com/services/TXXXXXXXX/BXXXXXXXX/token. Če želite shraniti ta naslov nekje, ga bomo potrebovali pozneje. Nadalje lahko spremenite ikono in ime integracije na tej strani, vendar bomo to naredili v kodi.

2. Ustvarite sporočilo

Predstavljajmo si, da ste že ustvarili spletno aplikacijo, ki išče prodajo Valentinovo na priljubljenih spletnih mestih, kot tudi kode ponudb za uporabo med prodajo in iz tega razloga želite ta rezultat deliti s člani ekipe Slack.

Zdaj moramo storiti le, da uporabimo URL spletnega huka, ustvarjen v prejšnjem koraku, in ga objavimo iz vaše aplikacije z JSON podatki, ki bodo sestavili sporočilo o ponudbi za prodajo.

Najprej sestavimo niz JSON, ki ga bomo pretvorili v sporočilo Slack. Parameter, ki nosi podatke JSON, se imenuje koristni tovor, zato mora biti niz JSON videti takole:

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

icon_url je URL slike, ki bo prikazana kot slika profila, ki jo lahko uporabite tudi icon_emoji namesto tega prikažete čustveni simbol kot sliko profila "icon_emoji": ": darilo:". »kanal« določa kanal ali uporabniško ime, ki bo videlo vaše sporočilo. Za uporabniško ime uporabite skladnjo "@ uporabniško ime", za kanal "#channelname".

Zdaj za dejansko sporočilo; lahko dodate ali "besedilo" lastnost in napišite sporočilo kot svojo vrednost in ga naredite z njim ali pa uporabite imenovano lastnost "Priponka" za dodajanje bogato oblikovanega besedila, kar bomo počeli zdaj.

The "Priponka" lastnina tovor je takole:

"priloge": ["nadomestni": "priloga ni podprta.", "naslov": "PONUDBA DANA VALENTINA", "barva": "# 9C1A22", "pretext": "Seznam izbranih odličnih ponudb za vas "," author_name ":" Preethi "," author_link ":" https://www.hongkiat.com/blog/author/preethi/ "," author_icon ":" https://assets.hongkiat.com/ uploads / author / preethi.jpg "," mrkdwn_in ": [" text "," fields "]," text ":" Samo kliknite imena strani in začnite nakupovati. "," thumb_url ":" http://example.com/thumbnail.jpg "]

"pasti nazaj" je alternativno besedilo, ki se prikaže, ko je prikazano sporočilo Slack v aplikaciji, ki ne podpira priloge sporočil (na primer v mobilnih obvestilih).

"barva" je leva barva sporočila.

"izgovor" je besedilo, ki je prikazano pred glavno vsebino.

"author_link" je hiperpovezan URL v imenu avtorja (če je na voljo).

"mrkdwn_in" je niz imen lastnosti, katerih vrednosti so prikazane v sporočilu - na podlagi sintakse za označevanje, kot je (*) za krepko in (_) za ležeče. Tri možne vrednosti za "mrkdwn_in" so "besedilo", "izgovor" in "polja"

"thumb_url" je URL sličice.

Tako bo sporočilo izgledalo doslej.

Sedaj dodamo polja v polje priponk, ki bo prikazalo mesta in kode ponudb v dveh stolpcih.

"fields": ["title": "Sites", "value": "___ "," short ": true, " title ":" koda ponudbe "," vrednost ":" UI90O22 n- "," short ": true], 

Uporaba n za dodajanje preloma vrstic in skladnje za dodajanje hiperpovezav.

Podčrtaj se uporablja za oblikovanje besedila v poševnem tisku.

kratek je nastavljeno na prav če naj bodo vrednosti prikazane ena ob drugi (na primer, če je kratka). JSONString bo videti skupaj (niz v eni vrstici v dejansko delovno kodo)

var myJSONStr = 'payload = "username": "SALE BOT", "icon_url": "example.com/img/icon.jpg", "attachments": ["nadomestni": "Ta priloga ni podprta. "," title ":" PONUDBA DAN VALENTINA "," barva ":" # 9C1A22 "," pretext ":" Današnji seznam odličnih ponudb, izbranih za vas "," author_name ":" Preethi "," author_link ":" https : //www.hongkiat.com/blog/author/preethi/ "," author_icon ":" https://assets.hongkiat.com/uploads/author/preethi.jpg "," fields ": [" "naslov" : »Spletna mesta«, »vrednost«: »___ "," short ": true, " title ":" koda ponudbe "," vrednost ":" UI90O22 n- "," short ": true]," mrkdwn_in ": [" text "," fields "]," text ":" Samo kliknite imena mest in začnite nakupovati. Dobite * dodatno znižanje s kodo ponudbe *, če je na voljo. "," Thumb_url ":" http://example.com/thumbnail.jpg " '; 

3. Objavi zahtevo

Zdaj, če želite objaviti zahtevo za objavo v JavaScriptu, uporabite spodnjo funkcijo:

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

Dodajte to funkcijo v klik gumba ali nalaganje strani da vidim, kako deluje.

Končni rezultat bo videti takole: