Slack-integraatio

Saat viestin Slack-kanavalle, kun palautteesi vaatii huomiota. Voxtrics lähettää viestit Slackiin hälytyksestä: säännöstä, joka seuraa saapuvia vastauksia, esimerkiksi ”vähintään 3 arviota, jotka ovat 2 tai alle, tunnin sisällä”. Slack yhdistetään saapuvalla webhookilla (incoming webhook), verkko-osoitteella, jonka Slack antaa sinulle yhtä kanavaa varten, joten Voxtricsin puolelle ei tarvitse asentaa mitään.

Webhookin luominen Slackissa

Tarvitset oikeuden lisätä sovelluksia Slack-työtilaasi. Jos työtilassasi vain ylläpitäjät hyväksyvät sovellukset, Slack kysyy ensin joltakulta heistä.

  1. Avaa Slack-sovelluksesi, napsauta Create New App ja valitse From scratch.
  2. Nimeä sovellus, esimerkiksi Voxtrics, valitse työtilasi ja napsauta Create App.
  3. Avaa sovelluksen asetuksista Incoming Webhooks ja ota käyttöön Activate Incoming Webhooks.
  4. Napsauta Add New Webhook to Workspace, valitse kanava, jolle hälytykset lähetetään, ja salli pääsy. Jos kanava on yksityinen, liity siihen ensin.
  5. Kopioi uusi URL-osoite kohdasta Webhook URLs for Your Workspace. Se näyttää tältä: https://hooks.slack.com/services/T0000/B0000/XXXXXXXX.

Slackin oma ohje saapuvista webhookeista: Sending messages using incoming webhooks.

Hälytysten lähettäminen Slackiin

  1. Siirry sivulle Hälytykset ja napsauta Uusi hälytys tai olemassa olevan säännön kynäkuvaketta (Muokkaa).
  2. Aseta säännön nimi, laajuus, aikaikkuna ja ehto sivun Hälytykset ohjeiden mukaan.
  3. Valitse kohdassa Ilmoita kanavan kautta Slack ja liitä URL-osoite kenttään Slack-webhook-URL.
  4. Napsauta Luo hälytys tai olemassa olevan säännön kohdalla Tallenna muutokset.

Webhook lähettää viestit vain sille kanavalle, jota varten se luotiin. Jos haluat hälytykset myös toiselle kanavalle, luo webhook sitä kanavaa varten ja sille oma sääntö. Useampi sääntö voi käyttää samaa webhookia.

Mitä viestissä kerrotaan

Aina kun sääntö laukeaa, kanava saa lyhyen tekstimuotoisen viestin, jossa on säännön nimi, verkkotunnus, aikaikkunan ehtoon sopineiden vastausten määrä ja syy säännön laukeamiseen. Itse vastaukset eivät ole viestissä: avaa laukeaminen sivulla Hälytykset nähdäksesi ne.

Sääntö laukeaa enintään kerran 30 minuutissa tai harvemmin, jos asetat rajoitusvälin. Työtilan hälytykset lähettävät Slackiin ja Telegramiin yhteensä enintään 200 viestiä päivässä. Sen jälkeen sääntö laukeaa edelleen ja laukeaminen näkyy Hälytykset-sivulla, mutta viestiä ei lähetetä.

Jos viestejä ei tule

  • Jos hälytys ei tallennu, tarkista, että URL-osoite alkaa https://hooks.slack.com/. Voxtrics hyväksyy vain Slackin webhook-osoitteet, ei linkkiä kanavaan tai viestiin.
  • Tarkista, että sääntö on käytössä ja että se on lauennut: jokainen laukeaminen näkyy sivulla Hälytykset.
  • Jos sääntö laukesi, mutta Slackiin ei tullut mitään, webhook ei enää toimi: sovellus on poistettu, kanava on arkistoitu tai poistettu, tai Slack on poistanut URL-osoitteen käytöstä. Luo uusi webhook ja liitä se sääntöön.