Messaging
Système central de notifications multi-canaux
Le composant Messaging est le système central de notifications d'ELONIQ. Il gère tous les canaux de communication et assure la livraison fiable des notifications.
Aperçu
Le composant Messaging fournit un système de notification unifié pour tous les modules ELONIQ. Les messages peuvent être envoyés à des canaux système prédéfinis (channels d'équipe, webhooks) ou directement à des utilisateurs individuels.
Deux modes de livraison
- Canaux système — Messages vers des cibles prédéfinies (ex. channel Discord pour les alertes). Configurés via webhooks.
- Fournisseurs utilisateur — Messages directs aux utilisateurs via leur canal préféré (Discord DM, Teams chat, email, etc.).
Dead Letter Queue
Les livraisons échouées sont placées dans la Dead Letter Queue et automatiquement réessayées — avec backoff exponentiel (5 min de base, max 5 tentatives).
Fonctionnalités
- Support multi-canaux — Email, Discord, Microsoft Teams, Slack, Telegram, push navigateur et webhooks génériques.
- Canaux système — Canaux prédéfinis pour les notifications automatiques aux équipes et groupes.
- Messages directs — Notifications personnelles aux utilisateurs via leur canal préféré.
- Dead Letter Queue (DLQ) — Les livraisons webhook échouées sont automatiquement réessayées avec backoff exponentiel (max 5 tentatives).
- Formats de message — Support du texte brut, HTML, embeds Discord, cartes Teams et formatage riche Slack.
- Niveaux de sévérité — Marquer les messages comme info, avertissement, erreur ou succès.
- Mécanisme de repli — Repli automatique sur email en cas d'échec de livraison via le canal préféré.
- Test de connexion — Tester chaque fournisseur et canal avant la mise en production.
- Statistiques DLQ — Aperçu des messages en attente, échoués et livrés.
Utilisation
- Ouvrir le composant — Accéder à Composants > Messaging dans l'AdminUI.
- Configurer les canaux système — Créer des canaux pour les cibles souhaitées.
- Tester les canaux — Utiliser la fonction de test pour vérifier la livraison.
- Configurer les fournisseurs — Configurer au minimum l'email. Optionnel : bot Discord, Teams, Slack ou Telegram.
- Connecter les modules — Les modules utilisent automatiquement le messaging une fois les canaux configurés.
- Surveiller la DLQ — Vérifier régulièrement la Dead Letter Queue.
Bonnes pratiques
- Valider les URLs webhook — Testez chaque URL webhook avant la mise en production.
- Surveiller la DLQ — Vérifiez régulièrement la Dead Letter Queue.
- Canal de repli — Configurez l'email comme canal de repli.
- Un canal par usage — Créez des canaux système séparés pour les alertes, les statuts et les notifications utilisateur.
- Protéger les tokens — Les tokens des bots sont stockés chiffrés.
- Préférences utilisateur — Laissez les utilisateurs choisir leur canal préféré.
Exemples
1. Canal d'alertes Discord
Canal système : Nom : alerts-discord Type : Discord URL Webhook : https://discord.com/api/webhooks/xxx/yyy Actif : true
2. Email comme fournisseur utilisateur
Fournisseur Email : Hôte SMTP : smtp.entreprise.fr Port SMTP : 587 Expéditeur : notifications@entreprise.fr
3. Teams + Email combinés
Canaux système : - teams-status (pour les messages de statut) - email-alerts (pour les erreurs critiques) Fournisseurs : - Teams (pour les tâches workflow) - Email (en repli)