Telegram-integraatio

Saat viestin Telegramiin, kun palautteesi vaatii huomiota. Voxtrics lähettää viestit Telegramiin hälytyksestä: säännöstä, joka seuraa saapuvia vastauksia, esimerkiksi ”vähintään 3 arviota, jotka ovat 2 tai alle, tunnin sisällä”. Viestit lähettää oma Telegram-bottisi valitsemaasi keskusteluun: ryhmään, kanavalle tai omaan keskusteluusi botin kanssa. Voxtrics tarvitsee yhden osoitteen, jossa on molemmat: botin token ja keskustelun ID.

Hälytykset vaativat maksullisen paketin (Growth ja ylemmät). Katso Ilmaiset ja maksulliset tilit.

Botin luominen

Avaa Telegramissa @BotFather ja lähetä /newbot.
Anna botille nimi, esimerkiksi Voxtrics alerts, ja käyttäjänimi, joka päättyy bot.
BotFather vastaa botin tokenilla, joka näyttää tältä: 123456789:AAHf0x.... Kopioi se.

Kuka tahansa, jolla on token, voi ohjata bottia ja lähettää viestejä sen nimissä. Älä julkaise tokenia äläkä osoitetta, jonka muodostat siitä alla. Jos token vuotaa, lähetä BotFatherille /revoke, niin saat uuden, ja vaihda se hälytyssääntöihisi.

Botin lisääminen keskusteluun

Ryhmä: lisää botti jäseneksi.
Kanava: lisää botti ylläpitäjäksi, jolla on oikeus julkaista viestejä.
Oma keskustelusi: avaa botti ja paina Start (”Aloita”). Botti ei voi kirjoittaa kenellekään, joka ei ole käynnistänyt sitä.

Lähetä sitten keskusteluun mikä tahansa viesti, jotta Telegramilla on jotain näytettävää seuraavassa vaiheessa.

Keskustelun ID:n selvittäminen

Avaa tämä osoite selaimessa niin, että YOUR_TOKEN-kohdassa on tokenisi:
```
https://api.telegram.org/botYOUR_TOKEN/getUpdates
```
Etsi vastauksesta "chat":{"id": ja kopioi sen jälkeinen luku. Ryhmän tai kanavan ID alkaa miinusmerkillä, esimerkiksi -1001234567890: säilytä miinus.

Jos vastaus on tyhjä ("result":[]), lähetä keskusteluun uusi viesti ja lataa sivu uudelleen: Telegram säilyttää nämä tiedot vain 24 tuntia.

Hälytysten lähettäminen Telegramiin

Lisää token ja keskustelun ID tähän osoitteeseen:

https://api.telegram.org/botYOUR_TOKEN/sendMessage?chat_id=YOUR_CHAT_ID

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

Osoite lähettää viestit vain siihen keskusteluun, jonka se nimeää. Jos haluat samat hälytykset myös toiseen keskusteluun, muodosta osoite sitä keskustelua varten ja lisää se sääntöön painikkeella Lisää Telegram-keskustelu. Useampi sääntö voi käyttää samaa osoitetta.

Mitä viestissä kerrotaan

Aina kun sääntö laukeaa, keskustelu saa lyhyen englanninkielisen tekstiviestin, 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 Telegramiin ja Slackiin 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ä osoite alkaa https://api.telegram.org/. Voxtrics hyväksyy vain Telegramin Bot API -osoitteen, ei t.me-linkkiä keskusteluun tai bottiin.
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 Telegramiin ei tullut mitään, tarkista, että botti on yhä keskustelussa (ja kanavalla ylläpitäjä), että keskustelun ID:ssä on yhä miinus ja ettei tokenia ole peruttu. Kun Telegram muuttaa ryhmän superryhmäksi, sen ID vaihtuu: selvitä se uudelleen ja päivitä osoite.