Canaux et notifications
Le portail reste le poste de pilotage principal. Un canal connecté permet aussi d’échanger avec l’agent et de recevoir ses résultats depuis votre téléphone.
Connecter Telegram
Section intitulée « Connecter Telegram »- Ouvrez l’agent puis l’onglet Canaux.
- Ouvrez Telegram et choisissez Générer le QR Telegram.
- Scannez le QR avec votre téléphone, ou choisissez Ouvrir dans Telegram, puis appuyez sur Start dans Telegram.
- Gardez la page ouverte : le portail vérifie l’association pendant dix minutes et affiche Connecté à Telegram dès qu’elle aboutit.
Telegram crée un bot dédié, au nom de votre agent. L’état Connecté à Telegram, suivi du nom du bot, confirme que ses messages arrivent au bon agent. L’agent redémarre alors brièvement pour rejoindre Telegram. Si rien ne se passe, choisissez ↻ régénérer pour obtenir un nouveau QR.
Ne transmettez ni le QR ni le lien à une autre personne : le compte Telegram qui termine l’association est celui que l’agent autorise à lui écrire.
Connecter une autre messagerie
Section intitulée « Connecter une autre messagerie »Dans Canaux → Autres connexions, recherchez une application puis ouvrez sa fiche. Un propriétaire ou un administrateur peut renseigner les identifiants et choisir Configurer la connexion. Chaque fiche précise comment préparer le compte ou le bot et quels identifiants d’utilisateurs sont nécessaires.
Les formulaires couvrent Discord, Slack, Mattermost, Matrix, Signal, DingTalk, Feishu/Lark, WeCom, QQ Bot, Yuanbao, Weixin, ntfy, SimpleX, IRC, Home Assistant et Photon/iMessage. Certains nécessitent un service externe déjà installé ou un compte déjà appairé : le formulaire ne crée pas ces comptes. Les adresses de serveurs doivent être accessibles publiquement et utiliser un transport sécurisé ; un serveur uniquement accessible sur votre réseau local ne peut pas être joint par la capsule.
L’enregistrement relance la messagerie et peut interrompre un échange en cours. Un agent arrêté reste arrêté. Les champs déjà enregistrés restent vides : les laisser vides conserve leur valeur. Les identifiants restent dans la capsule de l’agent et ne sont jamais réaffichés.
L’état Application en cours indique que les nouveaux réglages sont en cours de chargement. Configuré confirme que la messagerie a redémarré avec ces réglages ; envoyez un message depuis votre application pour vérifier la connexion. En cas d’échec, actualisez la fiche, vérifiez les accès puis choisissez Enregistrer et appliquer. Si le formulaire a été modifié dans une autre fenêtre, actualisez avant de reprendre.
Le filtre Toutes les intégrations Hermes montre aussi les canaux qui nécessitent un composant supplémentaire. WhatsApp (par QR code), Teams, LINE, SMS/Twilio, BlueBubbles, WeCom Callback, Google Chat, Microsoft Graph, Buzz, Raft, Hermes Relay et A2A ne sont pas encore connectables depuis ce portail ; leur fiche indique le prérequis manquant. Les raccourcis E-mail, Webhooks et Chat du portail ouvrent leurs réglages habituels.
Les étapes détaillées de création des applications sont disponibles dans le guide officiel des messageries Hermes.
WhatsApp Business : l’API officielle de Meta
Section intitulée « WhatsApp Business : l’API officielle de Meta »WhatsApp Business relie l’agent à un numéro professionnel par l’API officielle de Meta. Il vous faut un compte Meta Business, une application Meta avec le produit WhatsApp et un numéro dédié à l’agent. Le formulaire demande trois valeurs : l’identifiant du numéro (Phone Number ID, un nombre de 15 à 17 chiffres affiché dans WhatsApp → API Setup, différent du numéro de téléphone), un jeton d’accès permanent créé pour un utilisateur système Meta, et la clé secrète de l’application (Paramètres → Général).
Choisissez ensuite qui l’agent sert : les numéros autorisés, au format international (par exemple +33 6 12 34 56 78), ou Répondre à tous les numéros pour qu’il réponde à vos clients. Les autres messages sont ignorés.
La fiche affiche aussi l’URL de rappel et le jeton de vérification propres à l’agent. Après avoir enregistré la connexion, ouvrez WhatsApp → Configuration dans votre application Meta, collez ces deux valeurs dans la partie Webhook, cliquez sur Vérifier et enregistrer, puis abonnez le champ messages. Écrivez ensuite au numéro pour vérifier la réponse.
Meta n’autorise une réponse libre que dans les 24 heures qui suivent le dernier message du contact : un résultat de tâche planifiée envoyé plus tard peut être refusé par Meta. Seules les conversations privées sont prises en charge.
Discord : les étapes à préparer
Section intitulée « Discord : les étapes à préparer »Chaque membre peut enregistrer son identifiant Discord dans Mon compte → Mes messageries. Dans le formulaire Discord de l’agent, Choisir un membre ajoute cet identifiant au brouillon de la liste autorisée. Vous pouvez aussi coller des IDs : le formulaire affiche les noms correspondants dans votre équipe, les IDs inconnus et les déclarations ambiguës. Après une modification de profil, Actualiser les identités recharge les noms sans effacer le brouillon.
Cette correspondance est déclarée par le membre, sans vérification Discord. Elle n’accorde aucun droit dans le portail et ne rattache pas automatiquement ses conversations privées. L’autorisation de parler au bot reste définie par la liste enregistrée sur l’agent. Modifier ou retirer son ID dans Mon compte ne change pas cette liste. Les personnes extérieures peuvent être autorisées en saisissant leur ID, même sans compte Diadems.
Deux valeurs sont obligatoires : le jeton du bot et les identifiants des utilisateurs autorisés, dont le vôtre. Le salon par défaut pour les envois est facultatif. L’invitation du bot détermine son serveur ; vous n’avez pas à renseigner de Client Secret, d’identifiant de serveur ou d’URL de webhook dans Diadems.
- Ouvrez le portail développeur Discord, créez une application, puis ouvrez Bot. Copiez le jeton dans le champ Jeton du bot. Reset Token en crée un nouveau et invalide l’ancien.
- Dans Bot → Privileged Gateway Intents, activez Message Content Intent et enregistrez. La connexion Diadems utilise des identifiants numériques : Server Members Intent n’est pas nécessaire pour cette configuration. Laissez Require OAuth2 Code Grant désactivé.
- Dans OAuth2 → URL Generator, choisissez les scopes bot et applications.commands. Accordez View Channels, Send Messages, Read Message History, Embed Links et Attach Files. Pour les fils et les accusés de réception, ajoutez Create Public Threads, Send Messages in Threads et Add Reactions. Inutile d’accorder Administrator.
- Ouvrez le lien généré pour inviter le bot sur votre serveur. Il faut pouvoir gérer ce serveur. Vérifiez aussi les permissions du bot dans les salons souhaités.
- Dans l’application Discord, activez Paramètres utilisateur → Avancés → Mode développeur. Faites un clic droit sur votre profil puis Copier l’identifiant de l’utilisateur. Collez-le dans Utilisateurs autorisés ; séparez plusieurs identifiants par des virgules. Les pseudonymes et les mentions ne conviennent pas.
- Si vous souhaitez une destination par défaut pour les envois Hermes, faites un clic droit sur le salon puis Copier l’identifiant du salon. Ce champ ne restreint pas les salons où le bot répond et n’abonne pas aux notifications du portail.
Enregistrez, attendez l’application des réglages, puis envoyez @votre-bot Bonjour dans un salon ou un message privé au bot depuis un compte autorisé. Par défaut, il faut le mentionner dans les salons ; une réponse peut ouvrir un fil. Si le bot reste silencieux, vérifiez le jeton, l’intent, votre identifiant utilisateur et les permissions du salon. Configuré ne remplace pas ce test d’échange.
Dans Canaux → Discord → Réponses dans les salons, le réglage Créer automatiquement un fil est activé par défaut. Désactivez-le pour que l’agent réponde directement dans le salon où vous le mentionnez, puis choisissez Enregistrer et appliquer. Les fils existants et les messages privés ne sont pas modifiés. Ce choix ne change ni les personnes autorisées ni les permissions Discord ; la messagerie redémarre pour l’appliquer.
Un message n’est pas une session : les échanges dans un même fil partagent leur contexte. Un autre fil possède sa propre conversation. Sans création automatique de fil, Hermes regroupe par défaut les échanges par salon et utilisateur. Les réinitialisations de conversation peuvent ouvrir une nouvelle session. Dans le portail, les conversations Discord sans propriétaire Diadems sont dans Sessions → Membres → Sans propriétaire, avec le filtre Discord, pour les gestionnaires. La liste des utilisateurs Discord autorisés ne lie pas automatiquement leur identité à un compte Diadems.
Slack : les deux jetons ne suffisent pas seuls
Section intitulée « Slack : les deux jetons ne suffisent pas seuls »Le jeton xoxb- identifie le bot. Le jeton xapp-, doté du scope connections:write, permet la connexion Socket Mode. Il faut aussi :
- accorder les droits de messagerie du guide Slack Hermes ;
- souscrire aux événements app_mention, message.im, message.mpim, message.channels et message.groups pour les salons privés ;
- activer App Home → Messages Tab et autoriser les messages ;
- installer l’application dans l’espace, puis inviter le bot dans les salons ;
- copier les identifiants de membre Slack (par exemple
U01ABC2DEF3) des personnes autorisées.
Après un changement de droits, réinstallez l’application Slack. Après l’application des réglages Diadems, vérifiez un échange en message privé puis dans un salon.
Échanger avec l’agent
Section intitulée « Échanger avec l’agent »Une fois connecté, vous pouvez parler à l’agent depuis Telegram. Les échanges restent organisés en sessions, comme dans le portail.
Pour une tâche planifiée ou un déclencheur web, choisissez :
- Dans Diadems pour retrouver le résultat dans Sessions ;
- Sur Telegram (Telegram pour un webhook) pour le recevoir directement sur votre téléphone.
Notifications de l’application
Section intitulée « Notifications de l’application »Le portail ou l’application peut vous prévenir lorsqu’une réponse se termine alors que vous ne la consultez pas. Si la bonne session n’est toujours pas visible après une minute, la notification contient un aperçu ; un appui ouvre directement cette session.
L’activation peut demander l’autorisation du navigateur ou de l’appareil. Si rien ne s’affiche, vérifiez les autorisations de notifications dans les réglages du système et du navigateur.
Pendant que le portail est ouvert
Section intitulée « Pendant que le portail est ouvert »Une nouvelle notification apparaît aussi dans une petite carte en bas à droite de l’écran (en haut sur téléphone) : l’agent concerné, un aperçu de deux lignes et, si vous appartenez à plusieurs organisations, celle dont elle provient.
- Ouvrir mène directement à la session, la mission ou la page concernée et la marque comme lue, comme depuis la cloche.
- La croix ferme la carte sans la marquer comme lue : elle reste dans la cloche.
- La carte disparaît après quelques secondes ; elle reste affichée tant que vous la survolez ou la parcourez au clavier : Alt + N (Option + N sur Mac) l’atteint, Échap la ferme.
- Au-delà de trois cartes, +N autres ouvre la cloche.
Aucune carte n’apparaît pour la conversation que vous avez déjà sous les yeux, ni pour les notifications déjà présentes à l’ouverture ou lues sur un autre appareil. Dans Chrome ou Edge sur ordinateur, quand la page est au premier plan, la carte remplace la notification du système ; Firefox, Safari et les navigateurs mobiles peuvent encore afficher les deux.
Dans Mon compte → Application & appareils, vous pouvez masquer le contenu des aperçus, activer une plage silencieuse ou retirer les notifications d’un ancien appareil. Dans l’application Android, ce même bloc permet aussi d’activer le verrou par biométrie ou code du téléphone, de masquer l’aperçu dans les applications récentes et d’installer une mise à jour vérifiée.
Déconnecter un canal
Section intitulée « Déconnecter un canal »Pour une intégration de Canaux → Autres connexions, ouvrez sa fiche, choisissez Déconnecter, puis confirmez. Ses identifiants sont supprimés et le canal est désactivé pour cet agent. Vous pourrez renseigner une nouvelle connexion plus tard.
Se faire accompagner
Section intitulée « Se faire accompagner »Le bouton Demander à [nom de l’agent] ouvre une nouvelle conversation avec « Je voudrais en savoir plus sur Canaux » et le lien de ce guide. La demande est envoyée une fois. L’agent explique les prérequis, aide à préparer les réglages et utilise les outils disponibles dans sa capsule. Un consentement de compte, un appairage ou une connexion gérée par le portail nécessite votre intervention. Il ne peut pas rendre disponible un adaptateur dont le prérequis manque.
Ne transmettez jamais les jetons dans le chat. Renseignez-les uniquement dans la fiche de connexion ou le Coffre. Chaque fiche ouvre une page dédiée ; le fil d’Ariane revient au catalogue. Les filtres ouvrent une page de choix. Les confirmations de déconnexion restent affichées avant toute suppression.