Telegram

Stuur een bericht naar een Telegram-chat, -groep of -kanaal wanneer een waarschuwing afgaat of een incident wordt geopend. De workflowstap Send Message to Telegram van Status200 stuurt het als een bot die je zelf maakt, en een kant-en-klaar sjabloon bouwt de workflow voor waarschuwingen. Deze integratie is uitgaand: de bot stuurt berichten en leest niet wat er in de chat wordt gezegd.

Hoe het werkt#

De stap stuurt de Message Text naar de chat, als je bot, via de Bot API van Telegram. Hij neemt zijn uitgang Success wanneer Telegram het bericht aanneemt, en zijn uitgang Error, met de reden van Telegram, wanneer Telegram het weigert. Het sjabloon verbindt een stap Log met Error, zodat een run die niet kon versturen zegt waarom.

Voordat je begint#

• Een Telegram-account, om de bot te maken en aan de chat toe te voegen.
• In Status200 het recht om workflows en variabelen te maken. Op Status200 Cloud hebben workflows het abonnement Growth of hoger nodig.

De integratie instellen#

1. Een bot maken#

   Stuur in Telegram /newbot naar @BotFather en beantwoord zijn vragen. Hij geeft je het token van de bot, zoals 123456789:ABCdefGhIJKlmnoPQRstuVWxyz. Iedereen die het token heeft, kan als je bot berichten sturen, dus bewaar het zo veilig als een wachtwoord.

2. De ID van de chat vinden#

   1. Voeg de bot toe aan de groep, of maak hem beheerder van het kanaal. Om een persoon te berichten, begint die eerst een chat met de bot.
   2. Stuur in de groep een bericht dat de bot noemt, zoals /start@your_bot, zodat de bot het ziet.
   3. Open https://api.telegram.org/bot<token>/getUpdates in een browser, met het token van de bot in plaats van <token>.
   4. Zoek "chat":{"id": in het antwoord. Het getal erna is de ID van de chat. De ID van een groep begint met -, die van een grote groep met -100.

   Een openbaar kanaal kun je in plaats van met een ID met zijn @username aangeven.

3. De workflow bouwen#

   Begin vanuit het sjabloon, dat de hele workflow voor waarschuwingen bouwt, of vanaf nul.

   Vanuit het sjabloonVanaf nul

   Vanuit het sjabloon

   1. Open Workflows en klik op Workflow maken.
   2. Typ Telegram in Sjablonen zoeken…, klik op Tell Telegram when an alert fires en dan op Dit sjabloon gebruiken.
   3. Houd de naam Notify Telegram on new alert of wijzig hem, en klik op Volgende.
   4. Plak het token in Telegram Bot Token en de ID in Telegram Chat ID, en klik op Workflow maken.

   De workflow opent in de Bouwer met drie stappen: On Create Alert; Send Message to Telegram, die het nummer, de titel, de ernst en de status van de waarschuwing stuurt; en een stap Log op zijn uitgang Error. Het token wordt opgeslagen als geheime variabele telegramBotToken van de workflow, en de ID als telegramChatId.

   Vanaf nul

   1. Sla het token op als geheime globale variabele: ga naar Workflows → Globale variabelen, klik op Workflow Variabele aanmaken, noem hem TELEGRAM_BOT_TOKEN en klik op Volgende. Plak het token in Inhoud, zet Geheim aan en klik op Workflow Variabele aanmaken.
   2. Ga naar Workflows, klik op Workflow maken, kies Vanaf nul beginnen, geef de workflow een naam en klik op Workflow maken.
   3. Klik in de Bouwer op Choose what starts this workflow en kies On Create Alert onder Popular. Klik op de trigger: de Fields to pass on ervan beginnen met Titel, dus klik op Veld toevoegen en kies de andere velden die je bericht toont, zoals Alert Number With Prefix.
   4. Klik op Component toevoegen, zoek naar telegram en klik op Send Message to Telegram. Verbind de uitgang Success van de trigger met deze stap.
   5. Klik op de nieuwe stap. Klik in Telegram Bot Token op { } en kies TELEGRAM_BOT_TOKEN onder Global variables. Vul de ID van de chat in bij Chat ID, schrijf het bericht in Message Text en voeg de velden van de waarschuwing in met { }.

   Een bericht vanaf nul leest de velden van de waarschuwing met verwijzingen zoals deze:

   🚨 Alert {{local.components.alert-on-create-1.returnValues.model.alertNumberWithPrefix}} fired
   Title: {{local.components.alert-on-create-1.returnValues.model.title}}

4. Aanzetten en testen#

   Zet Ingeschakeld aan bovenaan de Bouwer. Vanaf nu wordt elke nieuwe waarschuwing naar de chat gestuurd.

   Om te testen zonder een waarschuwing te laten afgaan, klik je op Workflow uitvoeren en kies je onder Waarschuwing een waarschuwing die je al hebt: de meest recente staan in de lijst, en door het nummer of een deel van de titel te typen vind je een andere. Klik op Workflow handmatig uitvoeren en bevestig met Uitvoeren. Het paneel Workflow-uitvoering volgt de run, en het bericht verschijnt in de chat. Neemt de stap in plaats daarvan Error, dan zegt de regel van de stap Log waarom: zie Problemen oplossen.

Tips#

• Platte tekst. De stap stuurt de tekst zoals hij is getypt, zonder de opmaak van Telegram, dus * en _ verschijnen zoals ze zijn.
• Let op de limiet van 4.096 tekens. Telegram neemt berichten tot 4.096 tekens aan. Een langer bericht wordt ingekort en eindigt op "… (обрезано — полный текст в Status200)", in plaats van te worden geweigerd.
• Ook incidenten. Bouw dezelfde workflow op On Create Incident, of op On Update Incident voor statuswijzigingen. Om alleen sommige waarschuwingen te sturen, zet je een blok If / Else voor de stap.
• De vorm van het token wordt gecontroleerd. Een token dat niet de vorm 123456789:ABCdef… heeft, stopt de run voordat er iets wordt verstuurd, en het token wordt nooit naar het log geschreven.

Problemen oplossen#

Wanneer de stap Error neemt, zegt de run waarom: de stap Log van het sjabloon schrijft ❌ Telegram could not deliver the alert notification:, de reden van Telegram en een herinnering dat de bot in de chat moet zitten.

Volgende stappen#