Sofortige Benachrichtigung statt Nachfrage

Schneespur verschickt Nachweise im Kern per E-Mail. Wer zusätzlich eine sofortige Kurzmeldung aufs Telefon will, installiert dieses Modul. Telegram ist ein externer Dienst — deshalb ist es bewusst ein Modul, das Sie selbst dazunehmen, und kein Automatismus im Kern.

Was das Modul verschickt

Vier Ereignisse aus dem Einsatzbetrieb, jedes einzeln aktivierbar und einer oder mehreren Empfängergruppen zugeordnet:

Auftrag begonnen — der Fahrer ist für einen Kunden unterwegs.
Auftrag abgeschlossen — der Einsatz an einem Objekt ist fertig.
Schicht begonnen — ein Fahrer hat die Arbeit aufgenommen.
Schicht beendet — die Schicht ist vorbei.

Empfänger sind Admin, Fahrer und Kunde — einzeln oder kombiniert. Standardmäßig ist alles aus; Sie schalten nur frei, was Sie brauchen. Der Text jeder Nachricht kommt aus anpassbaren Vorlagen mit Platzhaltern wie {kunde}, {fahrer} oder {zeit}. Bei Auftrags-Ereignissen lässt sich ein Standort-Pin oder ein Einsatz-Foto mitsenden.

Empfänger verbinden — mit Einwilligung

Jeder Empfänger verknüpft sich selbst: Das Modul erzeugt einen QR-Code samt Link, die Person scannt ihn, Telegram öffnet den Bot, ein Tipp auf „Start" genügt. Damit willigt sie aktiv ein — niemand wird ohne sein Zutun eingetragen. Eine Verbindung lässt sich jederzeit wieder trennen; die Kennung wird dann gelöscht.

Datenschutz

Der Bot-Token wird verschlüsselt gespeichert (AES-256), nie im Klartext in Logs.
Jeder Empfänger verbindet sich selbst und willigt aktiv ein.
Im Protokoll stehen weder Token noch Nachrichtentext — nur, dass und wann zugestellt wurde.
Der Nachrichtentext läuft über die Server von Telegram — die Vorlagen sind bewusst knapp gehalten.

Läuft das nicht gegen die Self-Hosting-Linie?

Der Kern von Schneespur bleibt neutral und verschickt nur E-Mail über Ihren eigenen Server. Telegram ist ein bewusster Schritt nach außen — deshalb als optionales Modul, nicht im Kern. Sie entscheiden, ob und für welche Empfänger Sie es einsetzen. Wer zurückhaltend sein will, beschränkt Telegram auf interne Meldungen an Fahrer und Admin.

Braucht das einen Dauerprozess auf dem Server?

Nein. Das Modul ruft Telegram nicht im Moment des Einsatzes auf, sondern schreibt die Nachricht in eine Warteschlange in Ihrer Datenbank. Ein Cron-Job (eine Zeile in der Crontab, jede Minute) arbeitet sie ab. So läuft es auf gewöhnlichem Webhosting (Shared Hosting) ohne dauerlaufenden Hintergrundprozess.

Können andere Module darüber benachrichtigen?

Ja. Andere Schneespur-Module können über zwei Erweiterungspunkte Telegram-Nachrichten verschicken, ohne den Telegram-Code selbst zu kennen. Ist das Modul nicht installiert, passiert dabei nichts (kein Fehler). Die Einzelheiten mit Code-Beispielen liegen der Entwickler- Dokumentation des Moduls bei.

So richten Sie es ein

Bot über den offiziellen @BotFather in Telegram erstellen (/newbot). Sie erhalten einen Bot-Token.
Token im Admin-Bereich unter „Telegram" eintragen — das Modul prüft ihn und richtet die Verbindung selbst ein.
Empfänger über den QR-Code bzw. Start-Link verbinden.
Cron-Job einrichten: eine Zeile in der Crontab, die jede Minute schedule:run aufruft.

Ohne laufenden Cron-Job bleiben Nachrichten in der Warteschlange liegen — der Crontab-Eintrag ist Pflicht. Mehr zur Einrichtung: Ein ausführlicher Blog-Artikel geht den Ablauf Schritt für Schritt durch.

Integrität & Datei-Fakten

Größe: 226 KB
SHA-256: d90a0569d0d1…4b384384
Veröffentlicht: 04.06.2026
Verfügbar in: Deutsch

Installation

Direkt im Admin-Menü „Module" innerhalb der laufenden Schneespur-Installation.
Manuell: Modul herunterladen, per FTP in den Ordner modules/ der Installation kopieren.

Allgemeine Hinweise zur Schneespur-Installation: /installation/

Download

Modul herunterladen Detailinformationen

Externe Seite — der Download wird beim Entwickler-Server jenni.noschmarrn.dev bereitgestellt.