Telegram

Voraussetzungen

Um Semaphore UI so zu konfigurieren, dass Warnmeldungen über Telegram gesendet werden, sind vorab einige Schritte auf Telegram-Seite erforderlich. Sie müssen einen eigenen Bot erstellen, der den Webhook empfängt, und Sie müssen die ID des Chats kennen, an den die Nachricht gesendet werden soll.

Bot einrichten

Am einfachsten richten Sie Ihren eigenen Bot über @BotFather ein.

1. Senden Sie in Ihrem Telegram-Client /start an @BotFather.
2. Folgen Sie den Anweisungen, um einen neuen Bot zu erstellen, und notieren Sie sich das im letzten Schritt angezeigte Autorisierungs-Token. Hinweis: Dieses Token ist geheim und sollte entsprechend behandelt werden.
3. Senden Sie /start an Ihren neuen Bot, um ihn zu starten, damit er Nachrichten empfangen kann.

Chat-ID

1. Senden Sie in Ihrem Telegram-Client eine beliebige Nachricht an @RawDataBot.
2. Kopieren Sie den Wert des Schlüssels id in der chat-Map.

Testen

Mit cURL können Sie die obigen Einstellungen wie folgt überprüfen:

curl -X POST https://api.telegram.org/botYOUR_BOT_TOKEN/sendMessage \
  -d chat_id=YOUR_CHAT_ID \
  -d text="Test message from curl"

Konfiguration

Mit der Chat-ID und dem Token aus den vorherigen Schritten können Sie Semaphore UI nun wie folgt für das Senden von Telegram-Warnmeldungen konfigurieren:

telegram_alert: True
telegram_chat: <chat id>
telegram_token: <token>

Beispiel für config.json:

{
    "telegram_alert": true,
    "telegram_token": "64********:AAG****_rM6obyR********************",
    "telegram_chat":  "",
}

Chat-IDs pro Projekt

Jedes Projekt kann eine eigene Chat-ID verwenden. So können Sie Benachrichtigungen nach Projekt trennen, statt sie alle an denselben Chat zu senden. Dies überschreibt die oben beschriebene globale Chat-ID. Setzen Sie sie im Tab Benachrichtigungen des Projekts, oder legen Sie eine Projektbenachrichtigung vom Typ Telegram an, um mehrere Chats oder ein Forumsthema anzusprechen.