Comment faire Administration
Notifier un système externe des événements de messagerie
Le module Social peut prévenir automatiquement un autre logiciel chaque fois qu'un événement se produit (un message reçu, une conversation créée, etc.). C'est une connexion sortante : Sphère envoie l'information vers l'adresse d'un système externe que vous indiquez. Ces réglages se trouvent dans Paramètres Social.
Cette fonction s'adresse aux organisations qui veulent relier Social à un outil interne (CRM, tableau de bord, automatisation). Sa mise en place demande une adresse de réception fournie par ce système externe.
Comment créer une connexion sortante ? #
- Ouvrez la page des connexions sortantes dans Paramètres Social.
- Créez une nouvelle connexion : donnez-lui un nom, l'adresse (URL sécurisée) du système à prévenir, et choisissez les événements qui la déclencheront (par exemple « Conversation créée », « Message reçu »).
- Enregistrez. Un secret est généré : il sert à garantir au système externe que la notification vient bien de Sphère.
⚠️ Le secret n'est affiché qu'une seule fois, à la création. Copiez-le tout de suite : il ne pourra plus être récupéré ensuite. En cas d'oubli, vous pourrez en régénérer un nouveau.
Comment activer, modifier ou supprimer une connexion ? #
Depuis la liste des connexions sortantes, chaque ligne propose :
- Activer / Désactiver : suspendre temporairement l'envoi des notifications sans supprimer la connexion.
- Modifier : changer le nom, l'adresse ou les événements suivis.
- Régénérer le secret : produire un nouveau secret (l'ancien cesse alors de fonctionner).
- Supprimer : retirer définitivement la connexion et son secret (irréversible).
Comment suivre les notifications envoyées ? #
Un historique des livraisons liste chaque tentative d'envoi vers le système externe, avec son statut :
- Réussie : le système externe a bien reçu la notification.
- En attente : envoi en cours ou programmé.
- Échouée : la tentative n'a pas abouti (une nouvelle tentative est planifiée automatiquement).
- Abandonnée : toutes les tentatives ont échoué ; la notification a été rangée dans une file des livraisons abandonnées.
Vous pouvez ouvrir le détail d'une livraison pour voir la date, le nombre de tentatives et la dernière erreur. Le contenu et le secret ne sont jamais réaffichés.
Une notification n'est jamais arrivée : que faire ? #
- Vérifiez que la connexion est bien Activée.
- Ouvrez la file des livraisons abandonnées : elle regroupe les notifications qui ont épuisé toutes leurs tentatives.
- Choisissez Relancer (ou Rejouer) sur la livraison concernée pour la renvoyer manuellement.
- Si les échecs se répètent, vérifiez avec le responsable du système externe que l'adresse de réception est bien joignable.
Mis à jour le .