Betrieb & Installation

Telegram-Grundlagen

Das ETB kann jede neue Alarm-Mail automatisch als formatierten Telegram-Push in einen oder mehrere Chats schicken. Zusätzlich verarbeitet es Antworten aus dem Chat als Kommentare im Einsatz.

Dieses Thema erklärt die Einrichtung des Bots — vom Token bis zum Webhook. Wie Du die Nachrichten-Texte selbst gestaltest, steht auf der eigenen Admin-Seite Telegram-Templates (/admin/telegram-templates.php).

Was Du brauchst

  1. Bot-Token vom Telegram-BotFather
  2. Drei Chat-IDs (alle drei können theoretisch derselbe Chat sein):
    • Alarm — bekommt die Einsatz-Pushes
    • Debug — bekommt Fehler-Meldungen und Template-Test-Versände
    • Status — bekommt Heartbeat, Selbsttest und ETB-Reset-Meldungen
  3. HTTPS-erreichbare URL Deiner ETB-Instanz für den Webhook

Bot anlegen

  1. In Telegram @BotFather öffnen, /newbot schreiben.
  2. Name und Username vergeben — Username muss auf bot enden.
  3. Token kopieren — landet später in telegram_token.

Chat-IDs herausfinden

  1. Den Bot in die Ziel-Chats einladen und einmal /start schreiben (sonst darf er nichts schicken).
  2. @RawDataBot in den Chat einladen, der antwortet mit Chat-ID, User-ID etc. — Chat-ID rauskopieren (Gruppen-IDs sind negativ).
  3. @RawDataBot wieder rauswerfen.

Konfiguration im ETB

Unter /admin/config.php → Sektion „Telegram":

telegram_token              = 1234567890:AAH…
telegram_chat_id_alarm      = -1001234567890
telegram_chat_id_debug      = -1009876543210
telegram_chat_id_status     = -1009876543210
telegram_webhook_secret     = (auto-generiert)
feature_telegram_enabled    = ja

Webhook registrieren

Damit der Bot Antworten zurück ans ETB schickt, muss er den Webhook kennen. Das machst Du einmal unter /admin/webhook-status.php:

  1. Aktuellen Webhook prüfen (sollte erst leer sein).
  2. „Webhook setzen" klicken — das ETB sendet die URL inklusive webhook_secret an Telegram.
  3. Status-Test: Eine Nachricht in den Alarm-Chat schreiben, dann /admin/log-dashboard.php öffnen — Du solltest den Webhook-Eingang sehen.

⚠️ Achtung: Telegram verlangt HTTPS mit gültigem Zertifikat für Webhooks. Selbst-signierte Zertifikate werden zurückgewiesen.

Nachrichten-Texte (Templates)

Die eigentlichen Nachrichten-Vorlagen — Alarm-Push, Alarmierungsliste, Fehler-, Heartbeat-, Reset- und Selbsttest-Meldung — bearbeitest Du auf der eigenen Seite Telegram-Templates (/admin/telegram-templates.php). Dort gibt es je Template einen eigenen Tab, ein klickbares Platzhalter-Cheat-Sheet, eine Live-Vorschau und einen Test-Versand an den Debug-Chat. Für die Ersteinrichtung musst Du dort nichts anfassen: Ist ein Template nicht aktiviert, verwendet das ETB einen hartkodierten Standard-Text.

Selbsttest

Unter /admin/telegram-selftest.php prüft das ETB:

  • Token-Format
  • Bot-Erreichbarkeit (getMe)
  • Alle drei Chat-IDs (Test-Nachricht mit Echo)
  • UTF-8-Integrität (Umlaute, Sonderzeichen)

Bei Fehlern bekommst Du detailliertes Output, was schiefging.

Was als nächstes?