Notifications SMS

Les SMS atteignent les personnes éloignées d’un écran. Comme chaque message coûte de l’argent, Hermetry n’envoie des SMS que lorsque vous indiquez explicitement des numéros de téléphone, et limite les répétitions.

Ce qui envoie des SMS

Expéditeur	SMS ?
Un bloc Notify de flux avec des lignes de destinataires de type `phone`	Oui
Règles d’alarme	Non : elles désignent des membres, des rôles et des adresses e-mail. Utilisez un flux pour envoyer un SMS pour une alarme (voir ci-dessous).
Prévenir les personnes de la carte de règles	Non : elle désigne des rôles (et, via l’API, des utilisateurs et des équipes).
Membres et rôles dans tout expéditeur	Non : le numéro de téléphone d’un membre n’est pas utilisé pour les notifications.

Les codes de connexion envoyés par SMS, lorsque votre organisation les utilise, sont envoyés par la connexion elle-même, et non par ces paramètres.

Configurer les SMS

Un administrateur ouvre Paramètres > SMS (« Configuration du fournisseur SMS ») :

Champ	Signification
Activer les notifications SMS	Active ou désactive les SMS pour l’organisation. Désactivé : aucun SMS n’est envoyé, pas même pour les alarmes critiques.
Fournisseur	Le fournisseur SMS, avec ses champs de compte (identifiant de compte, jeton, numéro ou nom d’expéditeur).
Fournisseurs SMS	D’autres fournisseurs, installés et configurés comme plugins depuis la place de marché.

La modification des paramètres nécessite Modifier les paramètres SMS (Admin par défaut). Si le fournisseur choisi n’a pas d’identifiants, Hermetry utilise le premier fournisseur configuré pour votre organisation.

Numéros de téléphone

Écrivez les numéros au format international, par exemple +905551112233 ou +4915112345678.
Un numéro qui ne peut pas être analysé est compté comme invalide dans le résultat du bloc et ignoré ; les autres destinataires reçoivent quand même le message.
Un numéro qui s’est désabonné (en répondant STOP lorsque votre fournisseur transmet les réponses) ne reçoit plus rien tant qu’il ne se réabonne pas (START).

Envoyer un SMS pour une alarme

Chaque modification d’alarme entre aussi dans les flux de l’hôte IoT sous forme de message de type alarm, avec l’alarme dans msg.payload. Un flux qui écoute ces messages peut conserver ceux qui vous intéressent (par exemple les nouvelles alarmes CRITICAL) et les transmettre à un bloc Notify avec une ligne phone telle que +905551112233, un titre tel que {{ msg.payload.title }} et channels défini sur ["sms"].

Voir Blocs alarme, commande et notification et Recettes de flux.

Limites et temporisations

Règle	Effet
Par numéro	Les messages suivants vers le même numéro dans les 60 secondes sont ignorés.
Délai d’attente de notification	Le bloc Notify envoie la même raison au même destinataire une fois par délai d’attente (10 minutes sauf si votre forfait en définit un autre) ; le message suivant porte « (+n) » pour ceux qui ont été retenus.
Heures calmes	Les SMS sont retenus pendant les heures calmes de l’organisation, selon le fuseau horaire du destinataire, sauf si la notification est critique. Un destinataire défini uniquement par un numéro n’a pas de fuseau horaire ; UTC est alors utilisé.
Quota mensuel	Chaque SMS compte dans le quota SMS de votre forfait (compteur d’utilisation `smsSends`).

Quota

Lorsque le quota mensuel de SMS est épuisé, ou que le forfait n’inclut pas les SMS, le bloc Notify d’un flux exclut les SMS, les inscrit sous quota dans son résultat (« le quota mensuel de SMS est épuisé » ou « le forfait n’a pas accès aux SMS ») et utilise tout de même les autres canaux. Ce n’est que lorsque chaque canal qu’il utiliserait est hors quota que le bloc se termine avec l’erreur limit. Voir Utilisation et quotas.

Contenu du message

Le corps du SMS est le texte de la notification (sa forme en texte brut pour les notifications HTML). Gardez des textes d’alarme courts : le fournisseur peut découper ou tronquer les messages longs.

Dépannage

Symptôme	Vérification
Aucun SMS du tout	Activer les notifications SMS est activé ; un fournisseur est configuré ; votre forfait inclut les SMS ; le quota n’est pas épuisé.
Un numéro ne reçoit rien	Le numéro est au format international ; il ne s’est pas désabonné ; heures calmes ; la limite de 60 secondes par numéro.
Les SMS d’alarme ne sont jamais envoyés	Les règles d’alarme n’envoient pas de SMS ; ajoutez un flux avec un destinataire `phone`.
Tous les autres messages manquent	Le délai d’attente retient les répétitions de la même raison ; définissez le paramètre `reason` du bloc pour les regrouper comme vous le souhaitez.

Le journal d’envoi enregistre chaque tentative d’envoi de SMS avec la réponse du fournisseur. Voir Le journal des notifications.