Räätälöityjen viestien lähettäminen hidastumaan sovelluksesta

Slack on suosittu viestintäsovellus, jota monet joukkueet käyttävät. Siinä on paljon palveluita ja sovellusliittymä kehittäjille integroida se sovelluksiinsa. Tämän päivän postissa näytämme, miten voit käyttää jotakin sen Saapuvien verkkokokojen palveluista, jos haluat lähettää tietoja ulkoiseen sovellukseen..

Näin voimme lähettää viestejä Slackille helposti jo käytössä olevista sovelluksista; voimme lähettää raportteja, päivityksiä, uutisia, ilmoituksia ja paljon muuta. Tätä viestiä varten olen käyttänyt esimerkissä JavaScriptiä. Voit aloittaa kirjautumalla joukkueen Slack-tiliin.

1. Määritä integraatio

Sinun täytyy ensin määrittää saapuva webhook-integrointi. Mene yourteam.slack.com/apps/build/custom-integration ja napsauta Saapuvat webhookit, valitse sitten kanava tai käyttäjä, johon haluat lähettää viestisi (tämä valinta voidaan ohittaa myöhemmin koodissa).

Kun olet valmis, näet saapuvan webhook-integraation asetussivun.

Selaa alaspäin ja Webhook-URL-osoite on muodossa https://hooks.slack.com/services/TXXXXXXXX/BXXXXXXXX/token. Tallenna URL-osoite jonnekin, tarvitsemme sitä myöhemmin. Voit myös muuttaa tämän sivun integraation kuvaketta ja nimeä, mutta teemme sen koodissa.

2. Luo viesti

Oletetaan, että olet jo luonut web-sovelluksen, joka etsii Ystävänpäivä-myyntiä suosituissa sivustoissa sekä tarjouskoodeja, joita käytetään myynnin aikana, ja jostain syystä haluat jakaa tämän tuloksen Slack-tiimin jäsenille.

Nyt meidän on nyt käytettävä edellisessä vaiheessa luotua webhook-URL-osoitetta ja lähetettävä sille pyyntö JSON-tietojen avulla, joka valmistaa myyntitarjouksen viestin.

Let's ensin koota JSON-merkkijono, joka muuttuu Slack-viestiksi. JSON-dataa sisältävää parametria kutsutaan hyötykuormaksi, joten JSON-merkkijonon pitäisi näyttää tältä:

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

icon_url on sen kuvan URL-osoite, joka näkyy profiilikuvana, voit myös käyttää icon_emoji näyttää emoji-koodin esimerkiksi profiilikuvana "icon_emoji": ": lahja:". "Kanava" määrittää kanavan tai käyttäjänimen, joka näkee viestisi. Käyttäjänimi käyttää syntaksia "@ Käyttäjänimi", kanavalle "#Kanavannimi".

Nyt todellinen viesti; voit joko lisätä "teksti" omaisuutta ja kirjoita viestisi sen arvoksi ja tehdä sen kanssa tai käytä kutsutun ominaisuuden käyttöä "Liite" Voit lisätä rikkaasti muotoiltua tekstiä, mitä me nyt teemme.

"Liite" Omaisuutta hyötykuorma menee näin:

"liitetiedostot": ["varmuuskopio": "Liite ei tue.", "otsikko": "VALENTININ PÄIVÄN TARJOUS", "väri": "# 9C1A22", "tekosyynä": "Päivän lista valituista upeista tarjouksista sinulle "," author_name ":" Preethi "," author_link ":" https://www.hongkiat.com/blog/author/preethi/ "," author_icon ":" https://assets.hongkiat.com/ uploads / author / preethi.jpg "," mrkdwn_in ": [" teksti "," kentät "]," teksti ":" Napsauta vain sivustojen nimiä ja aloita ostaminen. "," thumb_url ":" http://example.com/thumbnail.jpg "]

"perääntyä" on vaihtoehtoinen teksti, joka tulee näkyviin, kun Slack-viesti katsotaan sovelluksessa, joka ei tue viestien liitetiedostoa (kuten mobiiliasiakirjoissa).

"väri" on viestin vasemman reunan väri.

"Verukkeella" on teksti, joka näkyy ennen pääsisältöä.

"Author_link" on URL-osoite, joka on linkitetty tekijän nimessä (jos se on toimitettu).

"Mrkdwn_in" on joukko ominaisuuden nimiä, joiden arvot on esitetty alustettuna sanomassa - perustuen merkintäsyntaksiin, kuten (*) lihavoituna ja (_) kursivointiin. Kolme mahdollista arvoa "Mrkdwn_in" ovat "teksti", "tekosyy" ja "kentät"

"Thumb_url" on pienoiskuvan kuvan URL-osoite.

Näin viesti näyttää toistaiseksi.

Lisää nyt kentät liitetiedostoon, joka näyttää sivustot ja tarjouskoodit kahdessa sarakkeessa.

"kentät": ["otsikko": "Sivustot", "arvo": "__ \ N__ "," lyhyt ": true, " title ":" Tarjouskoodi "," arvo ":" UI90O22 n- "," lyhyt ": totta], 

Käyttää \ n lisätä rivinvaihtoa ja syntaksia lisätä hyperlinkkejä.

Taustaa käytetään tekstin muotoilemiseen kursiivilla.

lyhyt on asetettu totta jos arvot näytetään vierekkäin (jos se on lyhyt). Yhdessä JSONString näyttää tältä (pitää merkkijono yhdessä rivissä todellisessa työkoodissa)

var myJSONStr = 'payload = "username": "SALE BOT", "icon_url": "example.com/img/icon.jpg", "liitetiedostot": ["varmuuskopio": Tätä liitettä ei tueta. "," otsikko: "VALENTININ PÄIVÄN TARJOUS", "väri": "# 9C1A22", "tekosyynä": "Tänään valittujen mahtavien tarjousten luettelo", "tekijänimi": "Preethi", "author_link": "https : //www.hongkiat.com/blog/author/preethi/ "," author_icon ":" https://assets.hongkiat.com/uploads/author/preethi.jpg "," kentät ": [" otsikko " : "Sivustot", "arvo": "__ \ N__ "," lyhyt ": true, " title ":" Tarjouskoodi "," arvo ":" UI90O22 n- "," lyhyt ": totta]," mrkdwn_in ": [" teksti "," kentät "]," teksti ":" Napsauta vain sivuston nimiä ja aloita ostaminen. Saat * ylimääräisen alennuksen tarjouskoodilla *, jos sellainen on. "," Thumb_url ":" http://example.com/thumbnail.jpg "] '; 

3. Lähetä pyyntö

Nyt voit tehdä postituspyynnön JavaScriptissä seuraavasti:

toiminto postMessageToSlack () var xmlhttp = uusi 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);  

Lisää tämä toiminto painikkeen tai sivun lataukseen nähdä sen toimivan.

Lopullinen tulos näyttää tältä: