Telegram Alerts
Verwaltet Telegram-Nachrichten als persistente Outbox mit Priorität, Worker-Lease, Zustellbestätigung und begrenztem Retry.
Für Betreiber und Entwickler von Python-Trading-Bots, die kritische Handels- und Schutzmeldungen neustartfest und kontrolliert an einen eigenen Telegram-Adapter übergeben möchten.
Welches Problem löst das Modul?
Wichtige Telegram-Meldungen können bei einem Netzwerkfehler verloren gehen, nach einem Bot-Neustart verschwinden oder durch unkontrollierte Wiederholungen mehrfach gesendet werden. Gerade bei Stop-, Risiko- oder Systemfehlern weiß der Betreiber dann nicht zuverlässig, was passiert ist. Telegram Alerts speichert jede vorbereitete Meldung zuerst in einer dauerhaften Warteschlange, ordnet ihr eine Priorität zu und verfolgt den Versandstatus. Fehlgeschlagene Zustellungen werden begrenzt wiederholt, ohne den Telegram-Bot mit Endlosschleifen oder unnötigem Spam zu belasten.
Für welche Börsen ist es geeignet?
- Exchange-unabhängig und ohne direkten Börsenzugriff
- Telegram-Netzwerkzugriff bleibt im kundenseitigen Adapter
- Mit jeder Bot-/Exchange-Kombination bei typisierten Quellereignissen nutzbar
- JSON-Store für einen Host oder koordinierten Single-Writer
- Mehrere Hosts benötigen einen gemeinsam transaktionalen Outbox-Store
Eine Meldung bleibt in der Outbox, bis Zustellung oder terminaler Fehlschlag bestätigt ist.
Das Modul priorisiert CRITICAL vor WARNING vor INFO, reserviert fällige Meldungen zeitlich für genau einen Worker und akzeptiert den Abschluss nur vom aktuellen Besitzer. Abgelaufene Leases können nach einem Worker-Absturz übernommen werden.
- 01Alert mit stabiler ID persistent einreihen
- 02Fällige Alerts nach Schwere priorisiert claimen
- 03Worker-Lease vor dem Netzwerkaufruf speichern
- 04Nach Versand Telegram-Message-ID bestätigen
- 05Eindeutigen Fehlschlag mit Backoff speichern
- 06Terminale Fehler alarmieren und manuell klären
Was das Modul technisch übernimmt
- Persistente PENDING-, SENDING-, FAILED- und DELIVERED-Zustände
- Stabile Alert- und Quell-Event-ID
- Kritische Priorität vor Warnung und Information
- Zeitlich begrenzte Worker-Lease
- Kontrollierte Übernahme nach Worker-Absturz
- Schutz vor Bestätigung durch veralteten Worker
- Exponentieller Backoff mit Obergrenze
- Konfigurierbare maximale Versuchsanzahl
- Idempotente Zustellbestätigung mit Telegram-Message-ID
- Atomarer JSON-State ohne gespeicherten Bot-Token
Was Sie nach dem Kauf erhalten
- Versioniertes Python-Paket 1.0.0 mit typisierter API
- Memory-Store und atomarer JSON-Outbox-Store
- 52 automatisierte Tests mit 100,00 Prozent Branch-Coverage
- Vollständige deutsche Kunden-, Sicherheits- und Betriebsanleitung
- Adapterneutrales ausführbares Integrationsbeispiel
- Wheel und Source Distribution
- Kunden-ZIP mit SHA-256-Prüfsumme
- Kontrollbericht, Release-Checkliste, Changelog und Lizenz
Technische Voraussetzungen
- Python 3.11 oder neuer
- Eigener Telegram-Adapter und sicher bereitgestellter Bot-Token
- Stabile alert_id, event_id und interne chat_reference
- Timezone-aware Zeitstempel und synchronisierte Uhr
- Dauerhafter beschreibbarer Outbox-Pfad
- Zusätzlicher Alarmkanal für kritische Ausfälle
Klare Grenzen
- Kein eingebauter Telegram-Netzwerkclient
- Transport-Timeout kann trotz Zustellung mehrdeutig bleiben
- Lokaler JSON-Store nicht für unabhängige Multi-Host-Worker
- Telegram ist kein revisionssicherer Notfallkanal
- Kundenseitiger Adapter muss Chat-Referenzen sicher auflösen
- Persönliche Integration bleibt separate Leistung
Was nicht enthalten ist
- Kein Bot-Token- oder Secret-Management
- Keine direkte Exchange-Anbindung
- Keine E-Mail-, SMS- oder Ticket-System-Anbindung
- Kein zentral gehosteter Queue-Dienst
- Keine Garantie externer Telegram-Verfügbarkeit
- Keine Handels- oder Gewinnlogik
Die vollständige Anleitung kommt mit dem Modul.
Die öffentliche Seite erklärt Funktion, Lieferumfang und Grenzen. Nach dem Kauf enthält das Paket den vollständigen Code und jeden Einbauschritt. Falls der vorhandene Bot keinen passenden Order-Adapter besitzt, kann persönliche Integration separat angefragt werden.