Messaging

Die Messaging-Komponente bietet ein einheitliches Benachrichtigungssystem für alle ELONIQ-Module. Nachrichten können an vordefinierte System-Kanäle (Team-Channels, Webhooks) oder direkt an einzelne Benutzer gesendet werden.

Zwei Zustellmodi

• System-Kanäle — Nachrichten an vordefinierte Ziele (z.B. Discord-Channel für Alerts, Teams-Channel für Statusmeldungen). Über Webhooks konfiguriert.
• Benutzer-Provider — Direktnachrichten an einzelne Benutzer über deren bevorzugten Kanal (Discord-DM, Teams-Chat, E-Mail usw.).

Dead Letter Queue

Fehlgeschlagene Zustellungen landen in der Dead Letter Queue und werden automatisch erneut versucht — mit exponentiellem Backoff (5 Min. Basis, max. 5 Versuche). Nach Erschöpfung aller Versuche können Einträge manuell erneut versucht werden.

• Multi-Kanal-Unterstützung — E-Mail, Discord, Microsoft Teams, Slack, Telegram, Browser-Push und generische Webhooks.
• System-Kanäle — Vordefinierte Kanäle für automatische Benachrichtigungen an Teams, Channels oder Gruppen.
• Benutzer-Direktnachrichten — Persönliche Benachrichtigungen an einzelne Benutzer über deren bevorzugten Kanal.
• Dead Letter Queue (DLQ) — Fehlgeschlagene Webhook-Zustellungen werden automatisch mit exponentiellem Backoff erneut versucht (max. 5 Versuche).
• Nachrichtenformate — Unterstützung für Klartext, HTML, Discord-Embeds, Teams-Cards und Slack-Rich-Formatting.
• Schweregrade — Nachrichten mit Info, Warnung, Fehler oder Erfolg markieren.
• Fallback-Mechanismus — Bei fehlgeschlagener Zustellung über den bevorzugten Kanal automatisch auf E-Mail zurückfallen.
• Verbindungstest — Jeden Provider und Kanal vor dem Produktiveinsatz testen.
• DLQ-Statistiken — Übersicht über ausstehende, fehlgeschlagene und zugestellte Nachrichten.

1. Komponente öffnen — Navigieren Sie zu Komponenten > Messaging im AdminUI.
2. System-Kanäle einrichten — Erstellen Sie Kanäle für die gewünschten Ziele (Discord-Webhook, Teams-Webhook, E-Mail-Gruppe usw.).
3. Kanäle testen — Verwenden Sie die Testfunktion, um die Zustellung für jeden Kanal zu verifizieren.
4. Benutzer-Provider konfigurieren — Richten Sie mindestens E-Mail als Provider ein. Optional: Discord-Bot, Teams-App, Slack-Bot oder Telegram-Bot.
5. Module verbinden — Die Module (ELO Base, Exporter usw.) nutzen das Messaging automatisch, sobald Kanäle konfiguriert sind.
6. DLQ überwachen — Prüfen Sie regelmäßig die Dead Letter Queue auf fehlgeschlagene Zustellungen und beheben Sie Konfigurationsprobleme.

• Webhook-URLs validieren — Testen Sie jede Webhook-URL vor dem Produktiveinsatz über die Testfunktion.
• DLQ überwachen — Prüfen Sie regelmäßig die Dead Letter Queue auf fehlgeschlagene Zustellungen.
• Fallback-Kanal — Konfigurieren Sie E-Mail als Fallback-Kanal, da er am zuverlässigsten ist.
• Ein Kanal pro Zweck — Erstellen Sie separate System-Kanäle für Alerts, Statusmeldungen und Benutzerbenachrichtigungen.
• Bot-Tokens schützen — Discord-, Slack- und Telegram-Bot-Tokens werden verschlüsselt gespeichert. Teilen Sie diese niemals in Klartext.
• Benutzer-Präferenzen — Lassen Sie Benutzer ihren bevorzugten Kanal wählen, um die Akzeptanz zu erhöhen.

1. Discord-Alert-Kanal einrichten

System-Kanal:
  Name: alerts-discord
  Typ: Discord
  Webhook-URL: https://discord.com/api/webhooks/xxx/yyy
  Aktiv: true

2. E-Mail als Benutzer-Provider

Benutzer-Provider E-Mail:
  SMTP-Host: smtp.firma.de
  SMTP-Port: 587
  Username: benachrichtigungen@firma.de
  Absender: benachrichtigungen@firma.de

3. Teams + E-Mail kombiniert

System-Kanäle:
  - teams-status (für Statusmeldungen)
  - email-alerts (für kritische Fehler)

Benutzer-Provider:
  - Teams (für Workflow-Aufgaben)
  - E-Mail (als Fallback)

4. Generischer Webhook für Drittsysteme

System-Kanal:
  Name: erp-webhook
  Typ: Webhook
  URL: https://erp.firma.de/api/notifications
  Aktiv: true