Notifications par e-mail

Les e-mails transmettent les notifications d’alarme aux boîtes de l’astreinte, les notifications de flux avec pièces jointes, ainsi que les e-mails de compte et de sécurité de la plateforme. Ils ne sont jamais retenus par les heures calmes.

Qui reçoit les e-mails

Les e-mails sont envoyés aux destinataires indiqués par une adresse e-mail :

Expéditeur	Comment nommer une adresse
Une règle d’alarme	{ "kind": "email", "email": "oncall@example.com" } dans notify.recipients de la règle. Voir Notifications d’alarme en détail.
Le bloc Notify d’un flux	Une ligne de destinataire de type address, une ou plusieurs adresses séparées par des virgules. cc et bcc en ajoutent d’autres ; chacune reçoit son propre message.

Les destinataires désignés comme membres, rôles ou équipes sont joints par la cloche, par notification push et dans leurs applications de messagerie, et non par e-mail. Indiquez l’adresse explicitement si vous voulez un e-mail. Un destinataire défini uniquement par une adresse n’a pas de préférences : il ne peut pas désactiver les e-mails dans Hermetry, et les heures calmes ne s’appliquent pas.

Les e-mails de compte et de sécurité (codes de connexion, réinitialisations de mot de passe, invitations) sont adressés par la plateforme elle-même, à l’adresse e-mail de votre compte.

L’expéditeur

Par défaut, les e-mails partent de l’expéditeur de la plateforme. Un administrateur peut définir le serveur de messagerie et l’identité d’expéditeur propres à votre organisation dans Paramètres > E-mail (« Outbound email / SMTP configuration for this organization ») :

Section	Champs
SMTP Configuration	SMTP Host, Port, Username, Password, Encryption
Sender Identity	From Name, From Email
Email Providers	Autres services d’envoi de courriels, installés et configurés comme plugins depuis la marketplace.

Si le serveur configuré ne peut pas être utilisé, Hermetry bascule sur le premier fournisseur de messagerie disposant d’identifiants pour votre organisation. Un flux ne peut pas choisir un autre expéditeur (from).

La modification de ces paramètres nécessite Change email settings (Admin par défaut).

Contenu des e-mails

Notification	Objet	Corps
Alarme ouverte	« Severity alarm: title«	« Alarm « type » opened on device. »
Alarme escaladée	« Escalated to Severity: title«	« Alarm « type » on device is now severity. »
Rappel	« Still open: title«	« Alarm « type » on device is open and not acknowledged. »
Alarme résolue	« Resolved: title«	« Alarm « type » on device resolved after n min. »
Récapitulatif de tempête	« n new alarms »	« n new alarms: 12 CRITICAL, 25 MAJOR. »
Le bloc Notify d’un flux	Le subject du bloc, sinon son titre	Son texte, ou du HTML avec format: html

Pièces jointes des flux

Un bloc Notify d’un flux peut joindre des fichiers au message (les autres canaux les ignorent) :

• au maximum 10 fichiers et 1 MiB de données de fichiers par bloc ; la file d’attente des e-mails accepte au maximum 10 fichiers et 7 MiB par message,
• le contenu provient du message ou du contexte du flux, jamais récupéré depuis une URL,
• une image peut être affichée en ligne avec un inline_id et <img src="cid:…"> dans un corps HTML.

Un fichier non valide interrompt tout l’appel (invalid_attachment) plutôt que d’envoyer un autre message. Voir Blocs alarme, commande et notify.

E-mails HTML

Avec format: html, le texte du bloc est envoyé en HTML après un nettoyage strict : la mise en forme de base, les listes, les tableaux, les liens http/https/mailto et les images cid: ou https sont conservés ; les styles, scripts, formulaires et cadres sont supprimés. Tous les autres canaux reçoivent une version en texte brut de ce même HTML.

Quotas

Chaque e-mail compte dans le quota mensuel d’e-mails de votre forfait (compteur d’utilisation emailSends). Lorsque le quota est épuisé ou que votre forfait ne comprend pas d’e-mails, le bloc Notify d’un flux omet l’e-mail, l’indique dans son résultat et utilise tout de même les autres canaux. Voir Utilisation et quotas.

Adresses non envoyées

Hermetry n’envoie pas de message à une adresse supprimée pour votre organisation, par exemple après un rejet définitif ou un désabonnement, lorsque votre organisation tient une telle liste. Cela vaut aussi pour les alarmes critiques : une boîte bloquée reste bloquée. Le journal des envois enregistre chaque tentative et chaque échec. Voir Le journal des notifications.

Dépannage

Symptôme	Vérification
Le mail d’alarme n’arrive jamais	L’adresse est-elle indiquée comme destinataire email ? Les membres et les rôles ne reçoivent pas d’e-mail.
Le mail arrive en retard	Le mail est mis en file d’attente ; un fournisseur chargé ou une nouvelle tentative le retarde.
Le mail est dans les spams	Définissez From Email sur une adresse de votre propre domaine et configurez les enregistrements d’expéditeur de votre domaine auprès de votre fournisseur de messagerie.
Le mail d’un flux est absent	Vérifiez le résultat du bloc : quota liste les canaux sans quota ; invalid compte les adresses incorrectes.

Plus d’informations : Dépannage des notifications.