Telegram-Bot-Benachrichtigungen vs. Push-API für Entwickler-Alerts

Frag eine Runde Entwickler, wie sie Alerts aus ihren Skripten bekommen, und die Hälfte sagt: „ein Telegram-Bot". Er ist kostenlos, Telegram ist ohnehin auf dem Handy, und die erste Nachricht ist in zehn Minuten eingerichtet.
Allerdings ist es eine Chat-App, die einen Pager-Job übernimmt. Das funktioniert, bis der wichtige Alert im selben Stream landet wie Gruppenchats oder bis ein Dateiname mit Unterstrich die Nachricht kaputtmacht. Dieser Beitrag geht das Telegram-Setup ehrlich durch: wo es gut funktioniert, wo nicht, und wie derselbe Alert über eine Push-Benachrichtigung-API aussieht.
Das Telegram-Setup von Anfang bis Ende
- Bot erstellen. Schreib
@BotFather, sende/newbot, wähle einen Namen und einen Benutzernamen, der aufbotendet. Du bekommst ein Token wie110201543:AAH.... - Zuerst Hallo sagen. Bots können keine Unterhaltung beginnen, also öffne den Bot und sende ihm eine beliebige Nachricht. Für eine Gruppe füge den Bot der Gruppe hinzu.
- Chat-ID finden. Ruf
getUpdatesauf und liesmessage.chat.idaus dem Ergebnis:
curl -s "https://api.telegram.org/bot$TG_TOKEN/getUpdates" | jq '.result[].message.chat.id'
Updates werden 24 Stunden gespeichert, und getUpdates funktioniert nicht mehr, sobald für den Bot ein Webhook gesetzt ist. Gruppen-IDs sind negativ, Supergroup-IDs beginnen mit -100.
- Alert senden:
curl -s "https://api.telegram.org/bot$TG_TOKEN/sendMessage" \
-d chat_id="$TG_CHAT_ID" \
-d text="Backup failed on db-01"
Das ist die ganze Integration: zwei Geheimnisse in einer Umgebungsdatei und ein HTTP-Aufruf.
Wo Telegram gut funktioniert
- Es kostet nichts. Laut der eigenen Telegram-FAQ dürfen Bots ihre Nutzer kostenlos anschreiben.
- Es ist überall dabei. Handy, Desktop und Web-Client, alles synchron.
- Gruppen sind kostenlos. Füg den Bot einem Team-Chat hinzu, dann sehen alle den Alert und können im selben Thread darüber sprechen.
- Du hast es ohnehin offen. Keine neue App, kein neues Konto.
Für Benachrichtigungen mit geringem Gewicht, etwa „der nächtliche Report ist fertig", ist das schwer zu schlagen.
Wo es umständlich wird
Jeder Alert klingt gleich
Die Bot-API hat genau eine Zustellungsoption: disable_notification, die eine Nachricht ohne Ton sendet. Es gibt keine Priorität, keine zeitkritische Stufe, nichts, was „Nicht stören" durchbricht. Ein fehlgeschlagenes Backup um 3 Uhr morgens kommt genauso an wie ein Sticker in einer Gruppe. Und wenn du den Chat stummschaltest, um den Lärm loszuwerden, stummschaltest du die Alerts gleich mit.
Formatierung macht Ärger
Mit parse_mode=MarkdownV2 müssen die Zeichen _ * [ ] ( ) ~ > # + - = | { } . ! sowie der Backtick außerhalb von Formatierungen mit einem Backslash escaped werden. Alerts bestehen genau aus diesen Zeichen: Dateinamen, Versionsnummern, URLs, Stacktraces. Ein nicht escapter Punkt in db-01.internal und Telegram weist die Nachricht mit einem 400-Fehler ab, der Alert über den Fehler schlägt also selbst fehl. Der HTML-Modus ist sicherer, aber du musst <, > und & in allem, was du sendest, trotzdem escapen.
Das Token ist der Bot
Das Token steht im URL-Pfad jeder Anfrage, und die Telegram-Doku sagt es klar: Wer es hat, kann deinen Bot steuern. In der Praxis landet diese URL in der Shell-Historie, in CI-Logs und überall sonst, wo Request-URLs festgehalten werden. Wenn es leakt, stellt /token bei BotFather ein neues aus, und dann müssen alle Skripte aktualisiert werden.
Buttons brauchen einen laufenden Bot
Inline-Buttons können eine URL öffnen, das ist unproblematisch. Ein Button, der etwas ausführt, etwa „Dienst neu starten", nutzt callback_data, und bis dein Bot antwortet, dreht sich beim Tippen ein Ladesymbol. Dafür braucht es einen Prozess, der rund um die Uhr auf Updates lauscht, und das wünscht sich ein Cronjob nicht.
Schübe treffen Rate-Limits
Telegram bittet Bots, unter einer Nachricht pro Sekunde und Chat zu bleiben, in einer Gruppe unter 20 Nachrichten pro Minute. Richtest du einen geschwätzigen Webhook auf eine Gruppe, bekommst du 429 Too Many Requests mit einem retry_after-Wert, genau dann, wenn etwas schiefläuft und die Alerts am schnellsten eintreffen.
Dienste können nicht direkt senden
GitHub, Stripe, Grafana und Sentry schicken Webhooks mit eigenem JSON. Die Bot-API erwartet eine chat_id und einen text. Dazwischen muss etwas übersetzen: ein kleiner Server, eine Serverless-Funktion oder ein n8n- oder Zapier-Flow. Dieses Relais ist ein weiteres Ding, das laufen muss.
Alerts leben in einem Messenger
Bot-Nachrichten sind gewöhnliche Telegram-Chatnachrichten, von Telegram gespeichert und mit deinen privaten Chats vermischt. Wenn du die Vorfälle des letzten Monats durchsuchen willst, scrollst du durch einen Chat, statt eine Historie nach Quelle zu filtern.
Derselbe Alert über eine Push-API
Hier ist der Backup-Alert, gesendet an Pocket Alert, mit einer Priorität und einem Button, der das Job-Log öffnet:
curl -X POST https://api.pocketalert.app/v1/messages \
-H "Token: $PA_KEY" \
-H 'Content-Type: application/json' \
-d '{
"title": "Backup failed",
"message": "db-01.internal: pg_dump exited with code 1",
"level": "high",
"actions": [{ "type": "view", "label": "Open log", "value": "https://ci.example.com/jobs/4821" }]
}'
Was sich ändert:
- Ein Geheimnis, in einem Header. Ein API-Schlüssel im
Token-Header, statt eines Tokens in der URL plus einer Chat-ID. - Klartext rein, Klartext raus. Keine Escaping-Regeln. Punkte, Unterstriche und Klammern kommen so an, wie sie sind.
- Priorität pro Nachricht.
silent,low,default,highodercritical. Auf dem iPhone kommen high und critical über den Fokus als zeitkritische Benachrichtigungen durch, und auf Android überschreibt ein kritischer Alert „Nicht stören". Siehe kritische Alerts. - Buttons ohne Bot. Bis zu drei Aktionsbuttons: eine URL öffnen, einen HTTP-Endpunkt aufrufen oder einen Wert kopieren. Nichts muss auf Taps lauschen.
- Dienste senden direkt. Jeder Webhook hat eine eigene URL. GitHub oder Grafana schickt ihr eigenes JSON, und Platzhalter wie
%alerts.0.labels.alertname%holen Felder in die Benachrichtigung. Jeder Aufruf wird im Webhook-Verlauf festgehalten. - Ein eigener Verlauf. Alerts werden in einer separaten App und einem Dashboard gespeichert, nach Anwendung gruppiert, nicht zwischen deinen Chats.
Wann Telegram trotzdem die bessere Wahl ist
Fair bleiben:
- Viel Volumen, kleines Budget. Telegram ist kostenlos und hat über die Rate-Limits hinaus kein Tageslimit. Der kostenlose Tarif von Pocket Alert umfasst 50 Nachrichten am Tag, mehr braucht einen bezahlten Tarif ab 6 $ im Monat.
- Alerts, die eine Unterhaltung anstoßen. Wenn ein Team einen Alert dort besprechen soll, wo er ankommt, leistet das ein Gruppenchat, eine Push-Benachrichtigung nicht.
- Desktop und Web zuerst. Wenn du den Großteil des Tages am Laptop arbeitest, zeigt der Telegram-Desktop-Client Alerts dort, wo du ohnehin hinschaust. Die Apps von Pocket Alert sind für iPhone und Android gedacht, für den Verlauf gibt es ein Web-Dashboard.
Eine Aufteilung, die für viele Teams funktioniert: Behalte eine Telegram-Gruppe für Austausch und tägliche Zusammenfassungen, und schick alles, was jemanden wecken sollte, als Push-Benachrichtigung mit Stufe.
FAQ
Kann eine Telegram-Bot-Nachricht „Nicht stören" umgehen?
Nicht von der Seite des Bots aus. Die Bot-API hat keine Prioritätseinstellung, nur disable_notification, um eine Nachricht stumm zu machen. Der einzige Weg durch den Fokus auf dem iPhone ist, dass der Empfänger Telegram als App-Ausnahme erlaubt, und das lässt jede Telegram-Benachrichtigung durch, nicht nur Alerts.
Wie finde ich meine Telegram-Chat-ID?
Sende eine beliebige Nachricht an deinen Bot, dann ruf https://api.telegram.org/bot<token>/getUpdates auf und lies message.chat.id. Ist das Ergebnis leer, ist das Update womöglich älter als 24 Stunden, oder der Bot hat einen Webhook gesetzt, und dann funktioniert getUpdates nicht.
Warum schlägt mein Telegram-Alert mit einem 400-Fehler fehl?
Meist liegt ein nicht escapetes Zeichen im MarkdownV2- oder HTML-Modus vor. Entferne parse_mode, um reinen Text zu senden, oder escape jedes reservierte Zeichen, bevor du sendest.
Ist eine Push-Benachrichtigung-API schwerer einzurichten als ein Telegram-Bot?
Ungefähr gleich. Bei Pocket Alert installierst du die App, kopierst einen API-Schlüssel aus dem Dashboard und sendest einen POST. Es gibt keine Chat-ID nachzuschlagen und keinen Bot zu erstellen.
Kann ich an beides senden?
Ja. Viele Teams behalten Telegram für Diskussionen und schicken Alerts, die eine Reaktion brauchen, als Push. Ein Skript kann beide APIs aufrufen, und die meisten Dienste, die Webhooks senden, akzeptieren mehr als eine URL.
Erstelle ein kostenloses Pocket-Alert-Konto und sende den curl-Aufruf von oben, oder lies zuerst was eine Push-Benachrichtigung-API ist. Wenn du andere Optionen abwägst, behandelt der Vergleichs-Hub Pushover, ntfy, Bark, Gotify und mehr.