Meldungen

Benachrichtigungen einrichten

E-Mail, Telegram, Web Push und signierte Webhooks verbinden, testen und pausieren.

Voraussetzungen

• Bestätigte Konto-E-Mail oder ein vom Plattformadministrator aktivierter Telegram-/Web-Push-Transport
• Mindestens ein Standort
• Für Web Push: aktueller Browser über HTTPS; auf iPhone/iPad als Home-Bildschirm-App geöffnet

Schritt für Schritt

1. Öffne Meldungen → Benachrichtigungskanäle.
2. Aktiviere die bestätigte Konto-E-Mail und sende eine Testnachricht.
3. Für Mobilgerät oder Desktop: Vergib im hervorgehobenen Bereich einen Gerätenamen, wähle Auf diesem Gerät aktivieren und bestätige die Browser-Berechtigung. Werklio sendet sofort einen Test.
4. Wähle für einen privaten Telegram-Chat Telegram-Verbindung starten und öffne den persönlichen Link.
5. Tippe in Telegram auf Start, kehre zu Werklio zurück und wähle Verbindung prüfen. Werklio erkennt und verifiziert die Chat-ID automatisch.
6. Nur für Gruppen und Channels: Öffne die manuelle Einrichtung, füge den Bot mit Sendeberechtigung hinzu und hinterlege die numerische Gruppen-ID bzw. den öffentlichen @channelname.
7. Für eigene Automationen: Klappe Generischer Webhook auf, hinterlege einen öffentlichen HTTPS-Endpoint und speichere den nur einmal angezeigten HMAC-Schlüssel sicher.
8. Teste jeden eingerichteten Kanal. Pausiere nicht benötigte Kanäle direkt in der Kanalliste.
9. Öffne anschließend einen Standort und füge unter Regeln die Standardregeln hinzu oder erstelle eine eigene Entitätsregel.

Beispielkonfiguration

Empfehlung: Nur tatsächlich benötigte Kanäle aktivieren und nach jeder Änderung eine Testnachricht senden.

Testschritt

Wähle bei jedem aktiven Kanal Testen und kontrolliere den Zustellstatus im Ereignisverlauf.

Erwartetes Ergebnis

Die Testnachricht kommt im gewählten Kanal an; der Kanal wird als verifiziert angezeigt. Störungen und Entwarnungen erscheinen anschließend im Ereignisverlauf.

Fehlerbehebung

• Keine E-Mail: Konto-E-Mail bestätigen und SMTP-Betriebsstatus prüfen.
• Web Push wird nicht angeboten: Ein Plattformadministrator muss unter Administration → Globale Einstellungen VAPID-Schlüssel erzeugen und Web Push aktivieren.
• Push-Berechtigung blockiert: Benachrichtigungen in den Website-Einstellungen des Browsers erlauben; auf iPhone/iPad Werklio zuerst zum Home-Bildschirm hinzufügen.
• Webhook-Test fehlschlägt: direkte 2xx-Antwort ohne Redirect sicherstellen; private IP-Adressen und HTTP sind gesperrt.
• Telegram wird nicht angeboten: Ein Plattformadministrator muss den Bot unter Administration → Globale Einstellungen aktivieren und testen.
• Telegram-Kopplung bleibt offen: persönlichen Link erneut öffnen, den vorausgefüllten Start-Befehl unverändert senden und danach nochmals prüfen.
• Kein Channel-Versand: Bot-Berechtigung und Zielnamen prüfen.
• Zu viele Meldungen: Cooldown erhöhen und doppelte Regeln deaktivieren.

Sicherheitshinweise

• Meldungen können Standort-/Gerätenamen enthalten; Empfänger und Webhook-Ziele bewusst auswählen.
• BotFather-Token, privater VAPID-Schlüssel, Push-Subscriptions, Webhook-URL und Signaturschlüssel werden verschlüsselt gespeichert und nicht protokolliert.
• Der persönliche Telegram-Kopplungscode ist zufällig, nur 15 Minuten gültig und wird serverseitig ausschließlich als SHA-256-Hash gespeichert.
• Web-Push-Dienste erhalten die verschlüsselte Meldung sowie technisch erforderliche Metadaten; der Browser zeigt die Benachrichtigung erst nach ausdrücklicher Berechtigung.
• Webhook-Empfänger erhalten den notwendigen Meldungsinhalt. Die HMAC-Signatur und einen aktuellen Zeitstempel vor jeder Verarbeitung prüfen.