Vous trouverez ci-dessous une description détaillée de toutes les fonctionnalités offertes par le logiciel SMSEagle. L’ordre des descriptions correspond à celui de l’interface web SMSEagle.

Composer un SMS

Nous présentons ici les différentes façons d’envoyer un SMS depuis votre appareil.

Capture d’écran de la vue par défaut de Compose SMS

Dans Compose SMS, les utilisateurs peuvent :

• Envoyer un SMS à un contact du répertoire téléphonique, saisi manuellement ou importé depuis un fichier

• Lors de l’importation depuis un fichier, chaque colonne peut être utilisée comme espace réservé dans le message. Lors de l’envoi, l’espace réservé sera remplacé par une valeur unique pour chaque ligne importée du fichier CSV. Cela permet d’envoyer un message personnalisé à chaque destinataire.

• Définir la date d’envoi à maintenant, à une date et une heure précises, après un délai, entre des heures sélectionnées ou avec une priorité élevée.

• Définir la durée de validité du SMS

• Sélectionner un type de message : SMS normal, SMS flash, MMS, code USSD, Email, Signal ou WhatsApp

• Définir un modèle de message à enregistrer et à utiliser ultérieurement

• Envoyer en Unicode (pour l’utilisation de caractères spéciaux)

• Envoyer le message ou Envoyer et répéter (la fenêtre reste ouverte, permettant des modifications pour le message suivant)

Importer des SMS depuis un fichier CSV et utiliser des espaces réservés

Le logiciel SMSEagle vous permet d’importer le texte d’un SMS depuis un fichier CSV et (en option) d’utiliser des espaces réservés spéciaux dans le corps du message. Les espaces réservés sont des champs spéciaux qui sont remplacés par des valeurs uniques pour chaque message.

Il faut tout d’abord un fichier .csv comme dans l’exemple ci-dessous. Des colonnes peuvent être ajoutées et nommées selon les besoins.

Lors de la composition d’un SMS à partir d’un fichier .csv comme source, chaque colonne du fichier .csv téléchargé devient un espace réservé qui sera rempli avec les informations de votre fichier. Les espaces réservés peuvent être ajoutés au corps du message en cliquant sur le nom de la colonne dans « Select field », comme illustré ci-dessous.

Capture d’écran de « Compose SMS » avec un fichier .csv importé.

Appels (fonctionnalité Voice)

Disponible uniquement pour les utilisateurs ayant acheté l’add-on VOICE pour leur appareil SMSEagle.

La fonctionnalité Calls permet d’effectuer des appels de réveil (sonnerie uniquement), des appels de synthèse vocale (text-to-speech) et des appels avec fichier audio vers un seul numéro de téléphone ou un groupe de destinataires. Cette fonctionnalité est idéale pour transmettre des messages urgents ou des annonces, tels que des alertes, des notifications d’urgence ou d’autres informations sensibles au temps. Une demande d’appel peut être créée via l’interface web SMSEagle ou l’API.

Appels de réveil (sonnerie uniquement)

L’appel de réveil est un appel avec sonnerie uniquement qui peut être utilisé pour attirer l’attention d’un destinataire. Cette fonctionnalité permet par exemple de réveiller quelqu’un pendant la nuit pour attirer son attention sur un SMS contenant une alerte critique. Lorsqu’un appel de réveil est effectué, l’appareil SMSEagle sonnera vers un numéro de téléphone ou une entrée du répertoire téléphonique spécifiée pendant un nombre de secondes déterminé.

Appels de synthèse vocale (Text-To-Speech, TTS)

Disponible uniquement sur le matériel NXS Rev.4 et les appareils MHD-8100-4G, en raison de limitations techniques.

L’appel Text-To-Speech permet de convertir un message texte en appel vocal. Cette fonctionnalité est particulièrement utile pour les entreprises ou organisations qui doivent transmettre des messages importants par voie vocale. Lorsqu’un appel TTS est effectué, l’appareil SMSEagle appelle un numéro de téléphone spécifié ou un contact/groupe du répertoire. Le message texte sera lu par un synthétiseur vocal intégré.

Il existe 3 modes de fonction texte-vers-parole :

• Text to Speech Simple : méthode plus rapide, mais ne prend en charge que la langue anglaise.

• Text to Speech Advanced : prend en charge plusieurs langues, offre une meilleure qualité vocale, mais est plus lent pour les textes longs. Fonctionne hors ligne. La vitesse de lecture peut être ajustée pour contrôler la vitesse à laquelle le message est lu.

• Elevenlabs TTS : plusieurs langues, voix excellentes et naturelles. Nécessite un compte Elevenlabs et un accès internet pour la conversion texte-vers-parole.

Appels avec fichier audio

La fonctionnalité d’appel par fichier audio vous permet d’effectuer des appels vocaux en utilisant des fichiers audio (wave) enregistrés. Cette fonctionnalité est idéale pour ceux qui préfèrent une touche personnelle pour des annonces personnalisées ou des alertes spécifiques. Vous pouvez téléverser un fichier prédéfini dans le menu Calls > Audio files. Le fichier doit répondre aux exigences suivantes : format de fichier Wave, 8 kHz ou 16 kHz, mono, PCM 16 bits.

Capture d’écran avec des exemples du menu « Calls »

Capture d’écran de la fenêtre New Call

Dans la fenêtre New call, vous pouvez définir :

• Un contact ou un groupe du répertoire ou une saisie manuelle

• Sélectionner si un appel doit être effectué immédiatement, à une date/heure spécifiée, ou entre certaines heures

• Depuis quel modem appeler (lorsque vous utilisez un appareil multi-modem)

• Définir la priorité de l’appel de 0 à 5

• Sélectionner le type d’appel : Ring only, Text to Speech Simple, Text to Speech Advanced, Audio File, ElevenLabs TTS

• Pour Text to Speech Advanced, vous pouvez sélectionner la langue et le modèle de voix

• Pour Audio File, vous pouvez sélectionner un fichier existant ou téléverser un fichier depuis votre ordinateur

• Saisir le message lorsque le type d’appel Text to speech est sélectionné. La longueur du message texte est limitée à 950 caractères.

Appels entrants

SMSEagle prend en charge la gestion des appels vocaux entrants. Les appels entrants peuvent être :

• Enregistrés dans l’historique des appels de l’appareil

• Utilisés comme déclencheur pour les Webhooks

• Configurés globalement via le menu Settings > Maintenance, où vous pouvez définir le comportement par défaut de l’appareil : toujours rejeter, accepter ou ignorer les appels entrants.

Tentatives de renouvellement

Si une tentative d’appel échoue, elle sera automatiquement retentée jusqu’à 2 fois supplémentaires.

Modèles de voix TTS hors ligne

La fonctionnalité Text to Speech Advanced dispose de 2 modèles de langue préchargés : anglais, allemand. Vous pouvez charger des modèles vocaux supplémentaires via le menu Calls > TTS voice models. La bibliothèque de modèles vocaux contient actuellement 36 langues et plusieurs voix pour certaines langues. Consultez la page Voice Models pour comparer les différents modèles vocaux et écouter des échantillons de voix.

De nouveaux modèles vocaux peuvent être ajoutés automatiquement (l’appareil télécharge les fichiers depuis le dépôt sur github.com) ou manuellement (les fichiers doivent être téléchargés sur l’ordinateur puis chargés via la fenêtre de dialogue). Une fois le modèle vocal chargé, la conversion TTS fonctionne hors ligne.

Capture d’écran du menu Calls>TTS Voice models

Modèles vocaux TTS en ligne

Les modèles vocaux en ligne utilisent l’API ElevenLabs pour la conversion texte-parole afin de fournir des voix excellentes et naturelles. Cependant, vous aurez besoin d’un compte ElevenLabs pour utiliser cette fonctionnalité. Votre appareil SMSEagle doit également être connecté à internet pour que cette fonctionnalité fonctionne.

Capture d’écran du menu Calls>TTS Online Voice models

Pour utiliser les appels vocaux ElevenLabs dans SMSEagle, vous devez générer une clé API ElevenLabs (sous l’onglet Developers > API Keys). Les autorisations API ElevenLabs suivantes sont requises : Text to Speech: Access Voices: Read.

Après les avoir sélectionnées, enregistrez les paramètres et saisissez la clé API ElevenLabs dans l’interface web SMSEagle (menu Calls > TTS Online voice models, champ ElevenLabs API key).

Nettoyage des fichiers temporaires

La fonctionnalité de nettoyage des fichiers vocaux temporaires permet d’économiser de l’espace de stockage sur l’appareil SMSEagle en supprimant automatiquement les fichiers temporaires inutilisés créés lors du traitement Text‑to‑Speech (TTS).

Dans la configuration par défaut, le processus s’exécute chaque lundi à 02:00. Pour les systèmes générant un grand nombre d’appels, il est recommandé d’augmenter la fréquence de nettoyage afin d’éviter une utilisation excessive du disque et d’assurer un fonctionnement stable de l’appareil. Les fichiers encore nécessaires pour des appels planifiés ou en attente ne sont pas supprimés et restent entièrement protégés.

Capture d’écran du menu Calls>Temporary files cleanup

Dossiers

Les dossiers contiennent vos messages SMS/MMS. Les dossiers sont commodément regroupés en 5 catégories :

• Inbox

• Outbox

• Sent Items

• Inbox rules

• Trash

La vue des conversations peut être de type « Balloons » (conversation façon smartphone) ou « Table » (vue tabulaire). Le type de vue peut être modifié dans le menu Settings > Application.

Type de vue Balloons :

Type de vue Table :

MMS

Pour afficher une pièce jointe MMS, vous devez cliquer sur « show MMS attachment » dans le message de la boîte de réception.

Statut des éléments envoyés

Le statut d’un message envoyé peut être consulté dans Folders>Sent Items>dans le message sélectionné. Il y a 2 endroits où le statut d’envoi est affiché : l’icône de statut dans le coin inférieur droit de chaque message et le texte de statut dans les détails du message (bouton « Show Details »).

Capture d’écran avec des exemples de Folders>Sent Items>exemple de message

Il existe 3 icônes différentes indiquant le statut d’envoi :

• Erreur d’envoi

• Message envoyé

• Message livré (disponible uniquement lorsque les rapports de livraison sont activés)

Inbox rules

Vous pouvez créer des règles pour déplacer automatiquement les messages entrants vers vos dossiers personnalisés (My Folders). Vous pouvez ajuster l’ordre d’activation des règles en les faisant glisser vers le haut ou vers le bas. Pour déplacer une règle, utilisez les points noirs situés près de son ID. Les règles placées plus haut dans la liste ont une priorité plus élevée et seront vérifiées en premier.

*Capture d’écran de « Inbox rules » *

*Capture d’écran de « Add new inbox rule » *

Lors de l’ajout d’une nouvelle règle, vous pouvez définir :

• Nom de la règle

• Ce que le message contient

• Ce que le numéro de l’expéditeur contient

• De quel modem le message est reçu

• Vers quel dossier personnalisé le message doit être déplacé

Cleanup Folders

Cette fonction vous permet d’ajouter des règles indiquant quand nettoyer automatiquement les messages et les journaux dans les dossiers sélectionnés.

Capture d’écran avec un exemple de l’écran Cleanup folders

Capture d’écran de Add or edit purging rule

Lors de l’ajout ou de la modification d’une règle de nettoyage, vous pouvez définir :

• Nom de la règle

• Intervalle de purge (quotidien, hebdomadaire, mensuel ou annuel)

• Définir l’heure

• Sélectionner le dossier (Inbox, Outbox, Sent Items, Calls done, Calls queued, Signal inbox, Signal outbox, Signal sent, WhatsApp inbox, WhatsApp outbox, WhatsApp sent et Emails)

• Définir la période des messages

• Sélectionner pour supprimer les fichiers de journal du modem

Répertoire téléphonique

L’interface Web-GUI de l’appareil SMSEagle est équipée d’un répertoire téléphonique permettant de gérer les contacts, les groupes et les équipes de travail (shifts). Chaque utilisateur peut créer des contacts privés et publics, et regrouper les contacts en groupes privés et publics. Les contacts peuvent également être affectés, de manière optionnelle, à des équipes de travail. Les contacts et les groupes du répertoire téléphonique permettent aux utilisateurs d’envoyer des messages efficacement.

Contacts du répertoire téléphonique

Nous présentons ci-dessous la vue principale du répertoire téléphonique, où l’utilisateur gère ses contacts.

Capture d’écran de la vue par défaut du répertoire téléphonique

Dans la gestion des contacts du répertoire téléphonique, les utilisateurs peuvent :

• Ajouter/modifier/supprimer des contacts via l’interface Web-GUI

• Importer des contacts depuis un fichier CSV

• Définir la visibilité d’un contact comme publique ou privée

• Ajouter des contacts à des groupes

• Ajouter des contacts à des équipes de travail

• Définir le mode vacances (plage horaire ou permanent)

• Envoyer un message à un contact

• Exporter un contact sélectionné ou tous les contacts

• Afficher la conversation de messages d’un contact

Capture d’écran de la fenêtre Modifier/Ajouter un contact

Dans la fenêtre Modifier/Ajouter un contact du répertoire téléphonique, les utilisateurs peuvent :

• Définir le nom du contact et le numéro de téléphone

• Choisir si le contact est Privé/Public

• Attribuer un modem sélectionné au contact ou laisser le choix du modem par défaut (selon les paramètres globaux)

• Ajouter le contact à un groupe

• Ajouter le contact à une équipe de travail

• Activer/désactiver le mode vacances (les messages ne sont pas envoyés lorsque le mode vacances est activé)

Capture d’écran de l’import de fichier CSV

Dans la fenêtre d’import de fichier CSV, les utilisateurs peuvent :

• Choisir un fichier CSV à téléverser

• Définir les contacts téléchargés comme Contact public

• Définir les contacts téléchargés comme Groupe public

• Sélectionner le groupe auquel ajouter les contacts téléchargés

• Choisir d’ignorer les numéros de téléphone déjà existants dans le répertoire

Groupes du répertoire

Capture d’écran des groupes du répertoire

Dans la vue Gestion des groupes du répertoire, les utilisateurs peuvent :

• Ajouter/modifier/supprimer des groupes

• Définir la visibilité des groupes en public ou privé

• Afficher le contenu du groupe (contacts appartenant au groupe)

• Exporter le groupe sélectionné ou tous les groupes

• Envoyer un message à un groupe

• Ajouter ou supprimer des contacts directement dans la vue du groupe (sans naviguer vers les paramètres individuels des contacts)

• Supprimer des contacts des résultats de recherche

Contacts/Groupes publics et privés Les contacts/groupes publics sont visibles par tous les utilisateurs de l’appareil. Un contact/groupe public ne peut être modifié que par son propriétaire (l’utilisateur qui a créé le contact/groupe). Les contacts/groupes privés sont visibles par un seul utilisateur (le propriétaire).

Groupes d’escalade du répertoire

Un groupe d’escalade est une version spéciale d’un groupe du répertoire. Lorsqu’un groupe est défini comme « Groupe d’escalade », un seul message envoyé au groupe sera escaladé aux membres du groupe. Le message sera escaladé à intervalle de temps défini jusqu’à réception d’un mot d’ARRÊT défini.

Capture d’écran de la vue Gérer le groupe

Vous pouvez modifier l’ordre d’escalade en faisant glisser les contacts vers le haut ou le bas. Capture d’écran de Gérer les groupes avec escalade définie

La file d’escalade actuelle peut être consultée et gérée via le menu Folders>Outbox>Escalation queues

Capture d’écran avec exemple de la fenêtre Folders>Outbox>Escalation queues

Horaires de travail du répertoire

La fonctionnalité de gestion des horaires permet d’affecter les contacts du répertoire à des horaires de travail. Si un contact est affecté à un horaire de travail, l’appareil vérifiera, avant l’envoi d’un message, si le contact est en horaire de travail. Si le contact n’est pas en horaire, le message sera ignoré ou déplacé au début de l’horaire suivant. Pour commencer à utiliser les horaires de travail, définissez-les ici et ajoutez le contact à un horaire dans les détails du contact.

Capture d’écran de la gestion des horaires dans le répertoire

Utilisateurs

La fonction Utilisateurs vous permet de gérer l’accès à votre appareil. Elle permet d’ajouter, de modifier et de supprimer des utilisateurs et de définir leurs autorisations. Il existe deux niveaux d’accès pour un utilisateur :

• Rôle utilisateur « Administrator » :

Permet un accès complet et un contrôle total de l’appareil, y compris les paramètres et la gestion des utilisateurs.

• Rôle utilisateur « User » :

Limite l’accès en n’autorisant que les modules Compose, Folders, Phonebook et Reporting.

Capture d’écran de la fenêtre Edit/Add User

Fonctionnalités multi-utilisateurs

Comme décrit dans le chapitre « Users », le logiciel SMSEagle permet de créer plusieurs utilisateurs avec différents niveaux d’accès (Administrator ou User). Ces utilisateurs peuvent accéder à l’appareil simultanément via l’interface web ou l’API. L’ensemble de fonctionnalités suivant est disponible dans un scénario de travail multi-utilisateurs :

• Plusieurs utilisateurs peuvent accéder à l’appareil simultanément via l’interface web ou l’API

• Chaque utilisateur peut créer des contacts et des groupes privés ou publics (partagés) dans le Phonebook (voir les détails dans le chapitre « Phonebook »)

• L’administrateur peut restreindre un utilisateur ayant le rôle « User » à n’utiliser que certains modems sélectionnés pour envoyer des messages (voir les détails dans le chapitre « Users »)

• Les utilisateurs ayant le rôle « User » disposent de leur propre dossier privé d’éléments envoyés (ils ne peuvent pas voir les messages envoyés par d’autres utilisateurs). Les utilisateurs ayant le rôle « Administrator » peuvent voir les messages envoyés par tous les utilisateurs.

• le contenu du dossier de réception (messages entrants) peut être visible : pour tout le monde/uniquement pour le rôle « Administrator »/uniquement pour les modems assignés à un utilisateur (voir les détails dans le chapitre « Application settings »)

Paramètres utilisateur

Le menu User Settings permet à chaque utilisateur de gérer ses préférences personnelles, ses options d’authentification et le comportement de l’interface au sein de l’interface web SMSEagle. Ces paramètres s’appliquent uniquement à l’utilisateur actuellement connecté et n’affectent pas les autres comptes.

Le menu est divisé en trois onglets :

• Personal data

• Password

• MFA

Personal Data

L’onglet Personal data est utilisé pour configurer les détails d’identité de l’utilisateur, les préférences de message et le comportement de l’interface. Paramètres disponibles :

• Language : sélectionne la langue d’affichage de l’interface web SMSEagle pour l’utilisateur actuel.

• Name : définit le nom d’affichage de l’utilisateur. Ce nom peut être utilisé dans les vues internes et les contextes liés aux messages.

• Login : affiche le nom de connexion de l’utilisateur. Ce champ est informatif et ne peut pas être modifié.

• Telephone Number : spécifie le numéro de téléphone de l’utilisateur. Ce numéro est utilisé pour le rappel de mot de passe.

• Signature : permet à l’utilisateur de définir une signature de message personnelle :

  • Signature Off : aucune signature n’est ajoutée

  • Signature On : le texte saisi est ajouté aux messages envoyés depuis le menu Compose.

• Default e‑mail subject in Compose menu : définit une ligne de sujet par défaut qui est automatiquement préremplie lors de l’envoi de messages via le menu Compose.

• Default SMS encoding in Compose menu : spécifie la méthode d’encodage SMS préférée qui sera définie dans le menu Compose. Options disponibles : Standard, Unicode ou Automatic.

• Émettre un son de notification à la réception d’un SMS : active ou désactive une notification sonore lorsqu’un nouveau SMS est reçu dans l’interface web.

• Tri des conversations : détermine l’ordre dans lequel les conversations sont affichées

• Type d’affichage des conversations : définit la manière dont les fils de messages sont présentés visuellement (par exemple, vue en style bulle/chat).

• Données par page : définit le nombre d’éléments affichés par page dans les listes de messages et le répertoire téléphonique. Cela affecte la pagination dans toute l’interface.

Password

L’onglet Password permet à l’utilisateur de modifier le mot de passe de son compte.

Authentification multifacteur (MFA)

L’authentification multifacteur ajoute une couche de protection au processus de connexion. Lors de l’accès aux comptes de l’interface web, les utilisateurs fournissent un nom d’utilisateur et un mot de passe, ainsi qu’une vérification d’identité supplémentaire, comme un code reçu par SMS ou un jeton provenant d’une application d’authentification.

Activer la MFA depuis les paramètres utilisateur

La MFA peut être activée par chaque utilisateur dans le menu User Settings > onglet MFA.

Capture d’écran de User Settings > MFA.

Vous pouvez choisir la méthode d’authentification parmi : SMS ou application d’authentification (comme Google Authenticator, MS Authenticator, Authy, FreeOTP, Aegis, etc.).

Lorsque SMS est sélectionné comme méthode d’authentification, un code de vérification est envoyé par SMS (texte) au numéro spécifié dans l’onglet Personal data. Le code OTP par SMS doit être saisi pour terminer le processus.

Lorsque Authenticator app est sélectionné, un mot de passe utilisateur doit être saisi pour afficher un code QR destiné à l’application d’authentification. Le code QR doit être scanné dans l’application, puis l’OTP fourni par l’application doit être saisi dans l’interface web pour terminer le processus.

Capture d’écran de User Settings > MFA. Demande de code de vérification.

Connexion utilisateur avec MFA

Une fois la MFA activée, l’utilisateur doit fournir une authentification à deux facteurs (utilisateur et mot de passe + jeton SMS à usage unique) à chaque connexion à l’interface web. Le jeton SMS à usage unique est valable 10 minutes.

Capture d’écran du processus de connexion avec la MFA activée.

Code de récupération

Si, pour une raison quelconque, un utilisateur ne peut pas recevoir de SMS ou n’a pas accès à son téléphone, un code de récupération peut être utilisé. Le code de récupération se trouve dans l’onglet User Settings > MFA. N’oubliez pas de conserver le code de récupération à usage unique dans un endroit sûr. Le code de récupération est régénéré après utilisation.

Capture d’écran de User Settings > MFA. Le code de récupération est révélé après avoir saisi le mot de passe

Activation de la MFA par l’administrateur

La MFA peut également être activée par un rôle administrateur pour des utilisateurs sélectionnés. Cela se fait dans le menu Users > Edit User.

Capture d’écran de Edit/Add User

Module de reporting

Le module de rapports est une extension de la fonction de recherche de base. Ce module permet aux utilisateurs de filtrer les messages des dossiers Boîte de réception/Éléments envoyés selon des critères personnalisés et d’afficher les messages filtrés. La liste filtrée des messages peut être exportée vers un fichier PDF ou CSV.

Capture d’écran du module de rapports

Vue des statistiques

Le module de rapports permet également d’afficher les statistiques quotidiennes des messages envoyés/reçus. La vue des statistiques affiche le nombre de messages par jour ainsi que le numéro de l’expéditeur/destinataire.

Capture d’écran de la vue des statistiques dans le module de rapports

Rapports/statistiques périodiques

Vous pouvez choisir d’envoyer des rapports automatiques quotidiens, hebdomadaires ou mensuels. Les e-mails seront envoyés exactement à la fin de l’intervalle choisi et incluront toutes les données de cette période (de 00h00 du premier jour à 23h59 du dernier, ou pendant une journée pour l’option quotidienne).

Important Pour les rapports/statistiques périodiques, n’oubliez pas que vous devez configurer les paramètres SMTP pour l’envoi d’e-mails dans le menu “Emails” > “SMTP Configuration” et les assigner au “Reporting module”.

Capture d’écran des rapports périodiques dans le module de rapports

Surveillance réseau

SMSEagle est équipé de fonctionnalités de surveillance réseau. Grâce à ces fonctionnalités, vous pouvez surveiller tout appareil ou service qui utilise le protocole ICMP, TCP, UDP ou SNMP. Le plugin de surveillance réseau SMSEagle contrôle séquentiellement la disponibilité des hôtes/services définis dans la fonction de surveillance réseau et envoie une alerte SMS définie lorsqu’un hôte/service devient indisponible/redevient disponible, ou lorsqu’une valeur de retour SNMP atteint le critère requis. Vous trouverez ci-dessous un bref aperçu des capacités du plugin.

Contrôler l’état de toutes vos tâches définies

• consulter un aperçu des paramètres pour toutes vos tâches

• vérifier quel serveur/service est actuellement indisponible

• voir quand un serveur/service spécifique était indisponible pour la dernière fois (dernière interruption)

• vérifier ce qui s’est passé lors de la dernière interruption (voir la réponse du serveur/service)

• modifier/supprimer vos tâches

• désactiver les tâches en cas de besoin (par exemple lors de mises à niveau de machines)

Définir ce que vous souhaitez surveiller dans chaque tâche

• choisir un nom pour la tâche

• définir une tâche parente. Si une tâche parente est définie, le moniteur réseau surveillera l’état de la tâche enfant uniquement si la tâche parente est en bonne santé

• saisir un hôte (adresse IP ou nom d’hôte)

• choisir ICMP (ping) pour surveiller un serveur avec le protocole ICMP

• ou PORT (TCP/UDP) pour surveiller votre service sur un port sélectionné (SMSEagle vérifiera si le port est ouvert)

• ou SNMP pour surveiller des objets via le protocole SNMP (types de retour pris en charge : numérique, chaîne de caractères)

• ou Modbus TCP pour surveiller des objets et des valeurs de registres via le protocole Modbus (avec code de fonction 1-4)

• augmenter la valeur de délai d’attente par défaut pour les serveurs occupés (par défaut, elle est fixée à 30 secondes)

• tester la connexion du serveur

Définir un planning

• choisissez si la tâche doit être toujours activée…

• …ou la désactiver à des moments choisis (pendant la nuit, lors de redémarrages planifiés d’une machine, pendant des sauvegardes gourmandes en ressources, etc.)

• saisissez un numéro de téléphone ou choisissez un groupe d’utilisateurs auquel envoyer votre alerte SMS

• sélectionnez quand envoyer l’alerte SMS (lorsque l’hôte/le service tombe en panne, lorsque l’hôte/le service revient en ligne après une panne)

• choisissez si l’alerte SMS doit être envoyée une seule fois ou répétée toutes les X minutes

Définir un message d’alerte SMS

Définissez vos messages SMS lorsque l’hôte ou le service devient indisponible/revient à la normale. Choisissez des espaces réservés pour votre texte SMS :

• {TASKNAME} – insère le nom de la tâche dans le texte du SMS

• {HOST} – nom d’hôte ou adresse IP

• {RESPONSE} – message reçu (en cas d’absence de réponse du serveur/service)

• {TIMESTAMP} – horodatage de l’erreur

Recevoir des alertes SMS

• être alerté lorsque vos services/serveurs tombent en panne (ou reviennent en ligne après une panne)

• donnez-vous la possibilité de réagir rapidement

Appel Vocal

Un message SMS peut être éventuellement suivi d’un appel de réveil ou d’un appel de synthèse vocale (text-to-speech). Cette option peut être activée dans la définition de la règle. Cette fonctionnalité nécessite un appareil disposant d’un module complémentaire Voice-Call actif.

Sondes de surveillance réseau

La fonctionnalité de surveillance réseau des appareils SMSEagle vous permet de superviser en continu la disponibilité et l’état des appareils réseau, des services et des systèmes industriels. Chaque tâche de surveillance repose sur un type de test, qui définit la manière dont la cible est vérifiée. Lorsqu’un problème est détecté, SMSEagle peut immédiatement envoyer des alertes SMS (et éventuellement des appels vocaux), garantissant ainsi une réaction rapide aux incidents.

ICMP (Ping)

L’ICMP (Ping) vérifie l’accessibilité réseau de base d’un hôte en envoyant des requêtes ICMP echo.

Paramètres disponibles :

• Hôte (IP ou nom d’hôte)

• Nombre de requêtes

• Délai de connexion

Cas d’utilisation typiques :

• Vérifier si un serveur, un routeur, un pare-feu ou un périphérique réseau est en ligne

• Détecter une perte totale de connectivité ou des pannes de périphériques

Port TCP

La sonde Port TCP vérifie si un service TCP spécifique est accessible en tentant d’établir une connexion TCP vers un port défini.

Paramètres disponibles :

• Hôte : adresse IP ou nom d’hôte

• Numéro de port

• Délai de connexion

Cas d’utilisation typiques :

• Surveillance de services tels que HTTP/HTTPS, SMTP, SSH, FTP, bases de données ou serveurs d’applications

• Vérifier non seulement qu’un hôte est en ligne, mais qu’un service est réellement en cours d’exécution

Port UDP

La sonde Port UDP surveille la disponibilité des services qui s’appuient sur le protocole UDP.

Paramètres disponibles :

• Hôte : adresse IP ou nom d’hôte

• Numéro de port

• Délai de connexion

Cas d’utilisation typiques :

• Services DNS

• Applications UDP personnalisées ou propriétaires

Sonde SNMP

La sonde SNMP (Simple Network Management Protocol) permet à SMSEagle de surveiller des paramètres spécifiques exposés par des périphériques compatibles SNMP.

Paramètres disponibles :

• Hôte : adresse IP ou nom d’hôte

• Version du protocole : v1/v2

• Object ID

• Community

• Type de valeur retournée (numérique/chaîne)

• Délai de connexion

• SMS envoyé quand : définit une condition selon laquelle une alerte SMS doit être déclenchée (par ex. valeur égale à / différente de / supérieure à / inférieure à un seuil défini)

Cas d’utilisation typiques :

• Surveillance des routeurs, commutateurs, systèmes UPS, serveurs et équipements réseau

• Suivi de métriques telles que la température, la charge CPU, l’utilisation mémoire, l’état des liaisons ou les conditions d’alimentation

Modbus TCP

La sonde Modbus TCP est conçue pour la surveillance des environnements industriels et OT. Elle permet de lire directement des valeurs depuis des automates (PLC), capteurs, contrôleurs et autres équipements industriels prenant en charge la communication Modbus TCP/IP, et de déclencher des alertes SMS lorsque la valeur d’un registre répond à des critères définis.

Paramètres disponibles :

• Hôte : adresse IP ou nom d’hôte du périphérique Modbus

• Port : port TCP du serveur Modbus (par défaut : 502)

• ID d’unité : identifiant d’unité Modbus

• Code de fonction : type de registre à lire : Read Coils (1), Read Discrete Inputs (2), Read Holding Registers (3) ou Read Input Registers (4)

• Registre : adresse du registre à surveiller

• SMS envoyé quand : définit une condition selon laquelle une alerte SMS doit être déclenchée (par ex. valeur égale à / différente de / supérieure à / inférieure à un seuil défini)

Cas d’utilisation typiques :

• Automates programmables (PLC),

• Systèmes SCADA

• Capteurs industriels et équipements d’automatisation

Fréquence de surveillance

Les tâches de surveillance sont exécutées en mode parallèle. Le logiciel optimise automatiquement le nombre de tâches parallèles et la fréquence des tâches en tenant compte des performances de l’appareil, et ajuste la période de surveillance si nécessaire.

Vous pouvez augmenter/diminuer manuellement la période de surveillance dans les paramètres de Network Monitor :

Si la valeur de la période de surveillance est trop faible (il y a trop de tâches de surveillance à exécuter en parallèle), le logiciel ajustera la valeur pour garantir une charge de travail et des performances optimales de votre appareil.

Reports

Cet onglet vous permet de consulter les rapports d’erreurs de tâches dans Network Monitor pour une période sélectionnée.

Capture d’écran de la fenêtre Network Monitor > Reports.

SNMP Traps

Le SNMP trap est un mécanisme populaire utilisé pour gérer et surveiller les activités des appareils via le protocole SNMP. Ce qui rend le Trap unique, c’est qu’il est déclenché instantanément par un agent, plutôt que d’attendre une demande de statut provenant d’une requête SNMP get.

Capture d’écran de la fenêtre Network Monitor > SNMP TRAPS.

Capture d’écran de la fenêtre Network Monitor > SNMP TRAPS Add or Edit.

SMSEagle peut agir comme récepteur de trap SNMP. Pour chaque trap entrant, vous pouvez définir une règle qui déclenche un message SMS.

• Options de correspondance du contenu du trap :

  • Match all OIDs in the trap — l’alerte est déclenchée chaque fois qu’un trap provenant d’une source définie arrive

  • Match a specific OID value — l’alerte n’est déclenchée que lorsqu’un trap contient un OID spécifique correspondant à une valeur définie (égal/différent/supérieur/inférieur)

La correspondance sur une valeur d’OID unique est utile lorsqu’un appareil envoie plusieurs OID dans un même trap et que vous ne souhaitez réagir qu’à un OID spécifique.

SMSEagle prend également en charge l’affichage de la valeur d’un OID spécifique provenant d’un trap SNMP entrant directement dans les messages d’alerte. Vous pouvez utiliser un espace réservé dédié pour référencer la valeur d’un OID unique dans le contenu du message, par exemple : {TRAP:OID_IDENTIFIER}. À l’exécution, l’espace réservé est remplacé par la valeur réelle reçue dans le trap SNMP.

Cela est particulièrement utile lorsqu’un seul trap contient plusieurs OID, mais qu’une seule valeur spécifique est pertinente pour le destinataire de l’alerte.

Emails

Email to SMS

La fonctionnalité Email to SMS vous permet de convertir un e-mail en message SMS.

Utilisation de base

Si le plugin est activé, l’email envoyé à l’adresse e-mail :

PHONE_NUMBER@IP_ADDRESS_OF_SMSEAGLE sera converti en message SMS.

Où :

PHONE_NUMBER - est un numéro de téléphone de destination

IP_ADDRESS_OF_SMSEAGLE - est l’adresse IP de votre appareil.

Le texte de l’email est le texte du message SMS (vous pouvez éventuellement ajouter le sujet de l’email au début du message SMS).

Exemple : un message email envoyé à l’adresse : 123456789@192.168.0.101 sera converti en message SMS et livré au numéro de téléphone 123456789.

Envoyer à un nom d’utilisateur/groupe

Email envoyé à l’adresse e-mail :

NAME_IN_PHONEBOOK@IP_ADDRESS_OF_SMSEAGLE sera converti en message SMS et sera envoyé à un utilisateur ou à un groupe d’utilisateurs du répertoire de SMSEagle.

Où :

NAME_IN_PHONEBOOK - est un nom d’utilisateur ou un nom de groupe (doit être un groupe public) du répertoire de SMSEagle

IP_ADDRESS_OF_SMSEAGLE - est l’adresse IP de votre appareil.

Le texte de l’email est le texte du message SMS (vous pouvez éventuellement ajouter le sujet de l’email au début du message SMS).

Exemple : un message email envoyé à l’adresse : db-admins@192.168.0.101 sera converti en message SMS et livré à tous les membres du groupe db-admin. Le groupe db-admin doit être défini dans le répertoire de votre SMSEagle.

Envoyer aux contacts/groupes Ldap

Si votre entreprise utilise LDAP (Active Directory ou OpenLDAP) pour la gestion des contacts, vous pouvez utiliser les Contacts ou Groupes LDAP pour envoyer un email en tant que message SMS.

Exemple : un message email envoyé à l’adresse : myldap-admins1@192.168.0.101 sera converti en message SMS et livré à tous les membres du groupe myldap-admins1. Le groupe myldap-admins1 doit être défini dans votre annuaire LDAP et le plugin LDAP doit être configuré sur votre appareil SMSEagle.

Appel Vocal

Un message SMS converti à partir d’un email peut être éventuellement suivi d’un appel de réveil ou d’un appel de synthèse vocale. Cela peut être activé dans la définition de la règle. Cette fonctionnalité nécessite un appareil avec un module complémentaire Voice-Call actif.

Utilisation d’un FQDN dans l’adresse e-mail

Il est également possible d’utiliser un nom de domaine entièrement qualifié dans une adresse e-mail envoyée à l’appareil SMSEagle (par ex. : 123456789@mydomain.com). Veuillez consulter notre article FAQ : How do I configure Email2SMS plugin to accept FQDN email addresses pour plus de détails.

Sujet de l’email - paramètres additionnels (optionnel)

Il est possible de définir des indicateurs supplémentaires pour un message converti unique en utilisant le sujet de l’email. Actuellement, les indicateurs suivants sont disponibles :

• date - date et heure au format AAAAmmJJHHMM (AAAA – année, mm – mois, JJ – jour, HH – heure, MM – minute). Si ce paramètre n’est pas nul, le SMS sera programmé pour être envoyé à la date et à l’heure indiquées

• modemno - définit le numéro du modem d’envoi (disponible uniquement pour les appareils multimodem)

Si vous envoyez un email dont le sujet contient FLAG=VALUE, l’indicateur sera défini pour ce message email2SMS particulier. Exemple 1 : un message email dont le sujet contient modemno=2 sera converti en message SMS et envoyé via le modem numéro 2. Exemple 2 : un message email dont le sujet contient date=201801010005&modemno=2 sera converti en message SMS et envoyé le 2018-01-01 00:05 via le modem numéro 2.

Configuration de la fonctionnalité

La fonctionnalité « Email To SMS » permet d’ajouter de nombreuses règles de transfert. Chaque règle peut être activée ou désactivée par l’utilisateur.

Capture d’écran de la fenêtre Email To SMS > Rules

Capture d’écran de Email to SMS > Add new rule

• Vous pouvez nommer votre règle

• Vous pouvez définir le transfert sur Always ou For specified senders / when email contains

• Vous pouvez définir when subject contains et message content (choisir sensible ou non à la casse)

• Vous pouvez définir une « Stop phrase ». Le texte commençant à partir de la stop phrase sera supprimé (sensible à la casse) du message

• Vous pouvez sélectionner s’il faut appeler après l’envoi du SMS (No/Ring only/TTS ou TTS advanced)*

• Vous pouvez choisir le modèle de voix (anglais ou allemand)*

• Vous pouvez définir la priorité du message (0–9). Les messages avec une priorité plus élevée seront traités en premier dans la file d’attente sortante

*Les options d’appel ne sont disponibles que lors de l’achat de la fonctionnalité Voice (Calls) pour votre appareil

Capture d’écran des paramètres Email to SMS

• si vous souhaitez utiliser le plugin, réglez « Email2SMS active » sur « Yes »

• si vous souhaitez inclure l’objet d’un email dans le message SMS, réglez le paramètre « What to do with email subject » sur « Include in SMS ». L’objet de l’email sera ajouté au début du message SMS

• si vous souhaitez utiliser l’authentification utilisateur, réglez le paramètre « What to do with email subject » sur « Use for authentication ». Si l’authentification utilisateur est activée, indiquez dans l’objet d’un email votre identifiant et mot de passe sous la forme suivante : login=john&pass=doe OU fournissez un jeton d’accès API sous la forme suivante : access_token=token

• si vous souhaitez inclure uniquement l’objet d’un email dans le message SMS, réglez le paramètre « What to do with email subject » sur « Send only subject without email body ». Seul l’objet de l’email sera inséré dans le message SMS

• le texte d’un email sera tronqué à la valeur « Maximum number of characters ». La longueur maximale autorisée d’un message SMS est de 1300 caractères

• si vous souhaitez inclure dans le message SMS des caractères nationaux spéciaux (comme ąäàöß我), réglez « Unicode encoding of SMS text » sur « Yes »

• si vous souhaitez envoyer en MMS, vous pouvez le régler sur always ou uniquement lorsque un email contient une pièce jointe

• Choisissez si vous souhaitez utiliser les contacts de l’annuaire LDAP (Yes/No). Le plugin LDAP doit d’abord être configuré pour utiliser cette fonctionnalité.

• Si vous avez activé les contacts LDAP, définissez le numéro de téléphone pour les erreurs LDAP. Des alertes concernant les erreurs de connexion LDAP seront envoyées à ce numéro de téléphone après 3 tentatives de connexion LDAP infructueuses. Laissez ce champ vide pour ne recevoir aucune alerte.

• FQDN : le plugin Email2SMS peut être configuré pour utiliser une adresse FQDN alternative au lieu de fonctionner uniquement avec l’IP de l’appareil dans l’adresse email. Cela nécessite de configurer un domaine approprié et des entrées DNS sur votre serveur DNS - à la fois des entrées A et MX, pointant vers l’IP du SMSEagle. Une fois cela configuré, les emails envoyés au nouveau domaine configuré atteindront le SMSEagle et seront correctement traités par le plugin.

• NAT : si votre appareil fonctionne dans un réseau local derrière un NAT, et que vous souhaitez pouvoir lui envoyer des emails depuis internet public, vous devez configurer ici l’IP publique où il serait accessible. Notez que cela nécessitera une configuration supplémentaire de votre réseau local/pare-feu, afin de transférer le trafic vers le SMSEagle (au moins transférer le port TCP 25).

Email to SMS Poller

Email2SMS Poller est une alternative à la fonctionnalité Email2SMS pour convertir les emails en messages SMS. Ce plugin doit être utilisé lorsque vous devez récupérer des emails depuis une boîte de messagerie existante sur votre serveur de messagerie. La fonctionnalité Email2SMS Poller se connecte à un compte email configuré et l’interroge à des intervalles de temps spécifiés pour détecter de nouveaux emails. Une fois qu’un nouvel email est reçu, il est automatiquement converti en message SMS.

Cette fonctionnalité prend en charge les comptes POP3 et IMAP. Le plugin prend en charge l’authentification de base pour toutes les boîtes de messagerie et Oauth2 pour les boîtes de messagerie Office365.

Pour envoyer un SMS à l’aide d’Email2SMS Poller, vous devez envoyer un email à un compte de messagerie spécifié, avec l’objet de l’email contenant un numéro de mobile (ou plusieurs numéros de téléphone séparés par une virgule) ou un nom de contact/groupe du répertoire téléphonique.

Exemple de base

Par exemple, un message email tel que :

TO : smseagle@mycompany.com FROM : john.doe@mycompany.com SUBJECT : +48333444555 BODY : Hello world!

Dans ce cas, la passerelle SMSEagle récupérera un email entrant depuis le compte smseagle@mycompany.com et enverra son corps sous forme de message SMS au numéro de mobile +48333444555.

Envoyer à un nom d’utilisateur/groupe

Si vous souhaitez envoyer un SMS à un contact ou un groupe depuis le répertoire téléphonique SMSEagle, indiquez le nom du contact/groupe dans le champ SUBJECT.

Envoyer aux contacts/groupes Ldap

Si votre entreprise utilise LDAP (Active Directory ou OpenLDAP) pour la gestion des contacts, vous pouvez utiliser les Contacts ou Groupes LDAP pour envoyer un email en tant que message SMS.

Exemple : un email envoyé avec le sujet myldap-admins sera converti en message SMS et livré à tous les membres du groupe myldap-admins1. Le groupe myldap-admins1 doit être défini dans votre annuaire LDAP et le plugin LDAP doit être configuré sur votre appareil SMSEagle.

Appel Vocal

Un message SMS converti à partir d’un email peut être éventuellement suivi d’un appel de réveil ou d’un appel de synthèse vocale. Cela peut être activé dans la définition de la règle. Cette fonctionnalité nécessite un appareil avec un module complémentaire Voice-Call actif.

Avis important : Les messages traités par Email2SMS Poller (mais non supprimés) sont marqués comme lus dans la boîte de messagerie. Le logiciel se base sur le marquage des messages - Lu/Non lu. Marquer un message lu comme non lu dans la boîte de messagerie entraînera son traitement à nouveau par Email2SMS Poller. Nous recommandons d’utiliser un compte email dédié pour éviter le renvoi du même message (marquage comme non lu d’un message déjà traité et lu).

Configuration de la fonctionnalité

La fonctionnalité « Email To SMS Poller » permet d’ajouter de nombreuses règles de transfert. Chaque règle peut être activée ou désactivée par l’utilisateur.

Capture d’écran des règles Email to SMS Poller

Capture d’écran de Email to SMS Poller > Add new rule

• Vous pouvez nommer votre règle

• Vous pouvez définir le transfert sur Always ou For specified senders / when email contains

• Vous pouvez choisir le numéro du modem d’envoi

• Vous pouvez définir une « Stop phrase ». Le texte commençant à partir de la stop phrase sera supprimé (sensible à la casse) du message

• Vous pouvez définir la priorité du message (0–9). Les messages avec une priorité plus élevée seront traités en premier dans la file d’attente sortante

Capture d’écran des paramètres Email to SMS Poller

• si vous souhaitez utiliser le plugin, réglez “Enable Email2SMS Poller” sur “Yes”

• Définissez l’intervalle de récupération des emails (en secondes)

• le texte d’un email sera tronqué à la valeur du paramètre “Maximum number of characters”. La longueur maximale autorisée pour un message SMS est de 1300 caractères.

• Si vous souhaitez inclure des caractères nationaux spéciaux, activez « Unicode encoding of SMS text »

• Choisissez le protocole entre IMAP ou POP3

• Renseignez la configuration de la boîte de messagerie (hôte, port, utilisateur, mot de passe, paramètres de chiffrement)

• Si vous souhaitez supprimer les emails de la boîte de messagerie après leur récupération par Email2SMS Poller, veuillez cocher « Delete emails from server after processing »

• Si vous souhaitez envoyer en MMS, sélectionnez toujours ou uniquement lorsque l’email contient une pièce jointe

Configuration de la fonctionnalité pour Office 365 OAuth2

• dans l’onglet Settings > paramètre « Protocol » choisissez « IMAP + Oauth2 (Office 365) »

• Host : indiquez le serveur IMAP pour Office365 (par défaut : outlook.office365.com)

• Username : indiquez l’adresse email de la boîte de messagerie qui sera utilisée pour Email2SMS Poller

• suivez les instructions de l’article de la base de connaissances : How to setup Office365 for Oauth2? pour obtenir les valeurs Client ID, Tenant ID, Client Secret depuis le portail Microsoft Azure

• Saisissez les valeurs Client ID, Tenant ID, Client Secret dans les paramètres du plugin

• appuyez sur le bouton « Save » pour enregistrer les paramètres

• appuyez sur le bouton « Authenticate via Oauth » et connectez-vous avec l’email et le mot de passe de la boîte de messagerie qui sera utilisée pour Email2SMS Poller

• Si le processus se termine avec succès, vous devriez voir le message « Oauth authentication success » dans l’interface web SMSEagle

SMS vers Email

La fonctionnalité SMS vers Email vous permet de transférer les messages SMS/MMS entrants vers une adresse email.

Cette fonctionnalité peut être utilisée selon deux modes :

1. transfert du SMS entrant vers l’email du dernier expéditeur (appelé Two-way Email2SMS & SMS2Email) Dans ce mode, lorsque SMSEagle reçoit un SMS entrant, il vérifie si quelqu’un a déjà envoyé un SMS vers le numéro du SMS entrant en utilisant Email2SMS. Si un dernier expéditeur est trouvé, le SMS entrant est transféré vers l’adresse email de ce dernier expéditeur. Si aucun dernier expéditeur n’est trouvé, le message entrant est alors transféré vers une adresse email par défaut indiquée dans les paramètres du plugin.

2. Il transfère tous les messages entrants vers une seule adresse email fixe. Dans ce mode, les messages SMS entrants sont toujours transférés vers la même adresse email.

Configuration de la fonctionnalité

Cette fonctionnalité utilise un serveur email SMTP externe pour l’envoi des emails. Vous pouvez configurer le serveur email via le menu Emails > SMTP Configuration. Veuillez ajouter au moins une configuration et sélectionner la configuration dans le paramètre déroulant « SMS To Email » ci-dessous.

« SMS To Email » permet d’ajouter plusieurs règles de transfert. Chaque règle peut être activée ou désactivée par un utilisateur.

Capture d’écran de SMS to Email > Rules

Capture d’écran de SMS to Email > Rules> Add or Edit rule

Dans la définition de la règle, vous pouvez choisir de transférer tous les messages entrants ou uniquement les messages provenant d’expéditeurs spécifiés/avec un texte spécifique. L’objet de l’email peut être un texte fixe ou vous pouvez utiliser des variables : {SENDER} - Numéro de l’expéditeur, {WORDS,X} - Les X premiers mots du message, {CHARS,X} - Les X premiers caractères du message.

Texte de l’e-mail envoyé par cette fonction

Le corps de l’email de la fonctionnalité SMS To Email contient :

• le numéro de téléphone du SMS entrant (et le nom du contact du répertoire téléphonique si trouvé)

• La date et l’heure de réception du SMS

• Le message SMS

Exemple de texte d’email envoyé par SMSEagle : De : +483334455 (John Doe) Reçu : 2017-06-01 14:38:12 Message : My SMS message

Alertes par Email

La fonctionnalité Alertes par Email permet d’envoyer un message d’alerte par email à une adresse email sélectionnée lorsque des erreurs d’envoi de SMS se produisent. Lorsqu’un seuil de compteur d’erreurs défini est atteint, un email d’alerte est déclenché.

Cette fonctionnalité est accessible sous l’onglet Settings > Email Alerts

• Vous pouvez activer/désactiver l’envoi d’une alerte par email lorsqu’un envoi de message se produit

• Vous pouvez définir le nombre d’erreurs avant qu’une alerte soit envoyée

• Vous pouvez définir l’email/les emails des destinataires

• Vous pouvez définir l’objet de l’email et le contenu du message, y compris les variables.

• Vous pouvez saisir les paramètres de votre serveur SMTP pour l’envoi des emails

• Vous pouvez enregistrer les informations de débogage dans le journal système (n’activez ceci que pour le dépannage)

Le serveur email utilisé pour SMS to Email est configuré via le menu Emails > SMTP Configuration. Veuillez ajouter au moins une configuration et la sélectionner dans le paramètre déroulant ci-dessous.

Remarque : Pour éviter les fausses alarmes, nous recommandons de définir le paramètre « Send alert when error counter exceeds » sur une valeur > 2.

Conversations par email

Le module Emails comprend une page Conversations dédiée, qui affiche les emails entrants et sortants sous forme de fils de discussion regroupés par expéditeur/destinataire. Cela permet de suivre facilement l’historique complet des communications par email directement depuis l’interface web SMSEagle.

Les emails entrants et sortants sont automatiquement enregistrés sur l’appareil et accessibles depuis la page Conversations.

Capture d’écran du menu Emails>Conversations

Configuration SMTP

Le menu SMTP Configuration est un point unique pour la configuration des paramètres SMTP. Ces paramètres sont nécessaires si vous souhaitez envoyer des emails depuis l’appareil SMSEagle via diverses fonctionnalités telles que SMS vers Email, API, menu Compose, Email Alerts.

Vous pouvez disposer d’une configuration unique pour toutes les fonctionnalités ou de plusieurs configurations, une pour chaque fonctionnalité.

capture d’écran du menu SMTP Configuration

Pour commencer à utiliser les fonctionnalités Email sur votre SMSEagle :

1. Créez au moins une configuration

capture d’écran de l’ajout de configuration SMTP

• Définissez un nom de configuration

• Définissez l’hôte SMTP

• Définissez le port SMTP

• Sélectionnez le chiffrement de connexion SMTP (aucun, SSL, TLS)

2. Attribuez la configuration à une fonctionnalité sélectionnée

Une fois qu’une configuration est créée, attribuez-la à une fonctionnalité sélectionnée.

Workflows

La fonctionnalité Workflows permet une gestion avancée des communications entrantes et sortantes en définissant des règles et des actions basées sur le contenu et la source des messages. Elle permet de créer des règles d’automatisation très flexibles, chacune composée de trois éléments :

• Déclencheur (Trigger) - L’événement qui déclenche la règle, comme un SMS, MMS, email, message WhatsApp ou Signal entrant.

• Condition - Logique optionnelle définissant quand la règle doit s’exécuter.

• Action - Le résultat exécuté lorsque la règle se déclenche, comme l’envoi de SMS, MMS, messages WhatsApp, Signal, ou le lancement d’appels ring, d’appels Text-To-Speech, et d’appels avec fichier wave.

La fonctionnalité Workflows vous permet d’ajouter plusieurs règles de traitement. Chaque règle peut être activée ou désactivée par un utilisateur.

Générateur de workflow

Pour créer une règle de Workflow unique, vous utilisez le Workflow Builder. Cet outil vous permet d’automatiser le traitement des messages entrants (ou d’autres événements) à l’aide de règles point-and-click.

Capture d’écran du Workflow Builder

Dans chaque workflow, vous pouvez configurer :

Name Saisissez un nom descriptif pour votre règle.

Trigger Le trigger est un événement qui déclenche la règle. Vous pouvez choisir parmi les triggers :

• Modem (SMS/MMS)

• Email

• WhatsApp

• Signal

• On Sent (SMS/MMS) : déclenché lorsqu’un message sortant a été envoyé

• On Error (SMS/MMS) : déclenché lorsqu’une erreur d’envoi de message se produit

• On Delivery Report (SMS/MMS) : déclenché lorsqu’un rapport de livraison est reçu

Condition Groups Construisez une logique avec des groupes de conditions. Chaque condition comporte :

• Propriété (Sender ou Content)

• Opérateur (Contains, Equals, Not Equals, Ends With, Not Contains, Regex Match, Starts With, In Group ou In Contact)

• Valeur (texte libre)

Vous pouvez ajouter plusieurs conditions à l’intérieur d’un groupe reliées par une logique AND. Vous pouvez ajouter plusieurs groupes de conditions reliés par une logique OR.

Actions Une action définit ce qui se passera lorsque les conditions sont remplies. Les actions suivantes sont disponibles :

• SMS

• TTS Call

• TTS Advanced Call

• Ring Call

• Wave Call

• Email

• WhatsApp

• Signal

Capture d’écran du menu > Workflows > +Add new workflow > Email Action

La capture d’écran ci-dessus montre un Email Action Example :

• Email addresses : Saisissez un ou plusieurs destinataires et cliquez sur Add.

• Phonebook contacts / groups : Ciblez des contacts publics ou groupes publics enregistrés (seules les entrées publiques sont acceptées).

• Subject template et Message template : Composez l’email sortant en utilisant des placeholders :

  • Placeholders disponibles (comme indiqué) : {{sender}}, {{content}}

• Inclure les pièces jointes : case à cocher facultative pour transférer les pièces jointes.

Vous pouvez ajouter plusieurs actions au sein d’un même workflow, par exemple : envoyer un SMS et effectuer un appel.

Espaces réservés dynamiques pour les destinataires

Lorsque le déclencheur est défini sur Email, des espaces réservés dynamiques pour les destinataires sont disponibles, permettant au workflow d’acheminer automatiquement le message vers un destinataire déduit du contenu du message entrant. Le destinataire peut être déduit à partir de :

• identifiant email : numéro de téléphone extrait de l’adresse de destination (par ex. à partir de +48123456789@domain.com, il prend +48123456789).

• objet : utilise l’objet d’un email pour extraire un numéro de téléphone du destinataire, un identifiant de contact du répertoire, ou un identifiant de groupe du répertoire

Transfert de SMS

La fonctionnalité « SMS forward » permet de transférer les SMS entrants vers un ou plusieurs destinataires selon des règles définies.

Configuration de la fonctionnalité

La fonctionnalité « SMS Forward » permet d’ajouter de nombreuses règles de transfert. Chaque règle peut être activée ou désactivée par l’utilisateur.

Capture d’écran de la fenêtre principale du plugin

Pour chaque règle, l’utilisateur peut définir :

• Quand le SMS entrant doit être transféré (Rule type) et vers quel(s) numéro(s) le message doit être transféré (SMS Recipient).

• S’il faut inclure ou non dans le SMS un numéro d’expéditeur d’où provient le SMS original.

• Lors de la définition d’une règle, l’utilisateur peut choisir le destinataire du SMS (qui reçoit le SMS transféré). Il peut s’agir soit d’un numéro de téléphone, soit du nom d’un groupe issu du répertoire.

• L’utilisateur peut définir de nombreuses règles de transfert dans le plugin.

• Chaque règle est traitée indépendamment.

• Une priorité peut être définie (0-9), un message avec une priorité plus élevée sera mis en file d’attente plus tôt.

• L’utilisateur peut choisir d’inclure un texte personnalisé accompagné d’espaces réservés :

• {SENDER} - Numéro de l’expéditeur {MESSAGE} - Message original

• Il est possible d’activer/désactiver chaque règle.

Capture d’écran du formulaire « Add/edit forwarding rule »

Appel Vocal

Un message SMS peut être optionnellement suivi d’un appel de réveil ou d’un appel de synthèse vocale (text-to-speech). Cela peut être activé dans la définition de la règle. Cette fonctionnalité nécessite un appareil disposant d’un add-on Voice-Call actif.

MQTT

MQTT est un protocole de messagerie pour l’Internet des objets (IoT). Il est conçu comme un transport de messagerie publish/subscribe extrêmement léger, idéal pour connecter des appareils distants avec une bande passante réseau minimale. MQTT est aujourd’hui utilisé dans une grande variété de secteurs, tels que l’automobile, l’industrie manufacturière, les télécommunications, le pétrole et le gaz, etc.

La fonctionnalité MQTT sur SMSEagle vous permet de créer plusieurs règles de conversion :

• lorsqu’un SMS arrive sur la passerelle SMSEagle avec un contenu prédéfini, il est transféré vers MQTT

• lorsqu’un message avec un contenu défini arrive sur MQTT, la passerelle SMSEagle peut l’envoyer sous forme de SMS à un ou plusieurs destinataires

Configuration de la fonctionnalité

La fonctionnalité « MQTT » vous permet de définir plusieurs règles de traitement, à la fois pour les scénarios Subscribe et Publish.

Capture d’écran de l’ajout de règle MQTT

Règles d’abonnement

Capture d’écran de la fenêtre d’abonnement MQTT

Pour chaque règle de traitement, l’utilisateur peut définir :

1. si le transfert doit toujours être envoyé ou uniquement à partir d’un topic spécifié/lorsque le message MQTT contient

2. le texte du message SMS sortant

3. le destinataire du message (individuel ou groupe)

4. pour les appareils multi-modem, les utilisateurs peuvent également définir depuis quel modem le SMS est envoyé

Règles de publication

Capture d’écran de la fenêtre de publication MQTT.

Pour chaque règle de traitement, l’utilisateur peut définir :

1. si le transfert de SMS doit toujours être envoyé ou uniquement pour un expéditeur/texte de message spécifié

2. hôte, port et topic de l’abonné MQTT

3. pour les appareils multi-modem, les utilisateurs peuvent également définir depuis quel modem le SMS est reçu

WhatsApp

La fonctionnalité WhatsApp sur l’appareil SMSEagle vous permet d’envoyer et de recevoir des messages WhatsApp via l’interface web ou l’APIv2, ou par conversion automatique de messages. Une fois que vous avez connecté un compte WhatsApp dans le menu “Settings”, vous pouvez envoyer des messages WhatsApp via le menu “Compose”. Vous pouvez également configurer des workflows d’automatisation en combinaison avec d’autres sources, telles que des e-mails, des messages SMS ou des messages Signal. Cette extension sécurisée, sur site, de votre pile de messagerie permet une gestion des incidents en temps réel et une communication client via le canal populaire WhatsApp. La messagerie repose sur les données, votre appareil doit donc être connecté à Internet via Ethernet ou données mobiles.

La fonctionnalité WhatsApp permet aux utilisateurs d’envoyer des messages incluant à la fois du texte et des images. Les formats d’image pris en charge incluent JPEG, GIF, PNG et BMP, permettant une communication flexible et riche.

AVERTISSEMENT

• Cette intégration fonctionne via une session légitime et authentifiée par l’utilisateur de WhatsApp Web. Elle n’utilise aucune API non officielle ni protocole obtenu par rétro-ingénierie.

• WhatsApp Inc. ne prend pas officiellement en charge ni n’approuve l’utilisation de systèmes automatisés, de robots ou de clients non officiels pour accéder à sa plateforme.

• Les utilisateurs sont responsables du respect des Conditions d’utilisation de WhatsApp, y compris les restrictions relatives à l’automatisation et aux intégrations tierces.

• SMSEagle fournit cette fonctionnalité en l’état, et ne peut garantir un fonctionnement ininterrompu en raison de changements potentiels dans la plateforme, les politiques ou l’infrastructure technique de WhatsApp.

• L’utilisation de cette fonctionnalité peut être soumise à des limitations ou restrictions de compte imposées par WhatsApp.

En activant et en utilisant cette fonctionnalité, l’utilisateur reconnaît et accepte les conditions ci-dessus.

WhatsApp est une marque déposée de Meta Platforms, Inc. Ce produit n’est pas affilié à, approuvé par, ou sponsorisé par WhatsApp ou Meta Platforms.

Configuration

Capture d’écran du menu > paramètres WhatsApp

1. Dans l’interface web SMSEagle > menu WhatsApp > sélectionnez l’onglet Settings et cliquez sur Show QR code

2. Ouvrez l”application WhatsApp sur votre téléphone mobile (elle doit déjà être enregistrée avec un compte WhatsApp), ouvrez le menu contextuel (trois points) et allez dans « Appareils liés ».

3. *Sélectionnez Lier un appareil et scannez le code QR affiché dans le web-GUI de SMSEagle. *

4. Une fois l’application appairée, vous êtes prêt à envoyer/recevoir des messages WhatsApp via SMSEagle.

Capture d’écran du menu > paramètres WhatsApp

* *

Capture d’écran du menu > paramètres WhatsApp

Envoyer un message WhatsApp avec repli SMS/MMS

Dans l’onglet WhatsApp Settings, vous pouvez configurer un repli vers SMS/MMS. Si le numéro du destinataire n’est pas enregistré sur WhatsApp, SMSEagle enverra le message en tant que SMS ou MMS (si le message contient des pièces jointes).

Mises à jour de la bibliothèque SMSEagle intègre un mécanisme intégré de mise à jour de la bibliothèque d’intégration WhatsApp. Étant donné que WhatsApp met régulièrement à jour sa plateforme, maintenir la bibliothèque à jour garantit une compatibilité continue et un fonctionnement sans interruption. Les mises à jour disponibles peuvent être vérifiées et appliquées depuis l’onglet WhatsApp Settings.

Signal (bêta)

(disponible sur les appareils NXS Rev. 4)

Signal est une application de messagerie sécurisée. Elle propose des messages chiffrés, ainsi que des appels vocaux et vidéo. Les experts en sécurité recommandent Signal car elle est chiffrée de bout en bout. Cela garantit que seuls votre appareil et celui du destinataire peuvent lire les messages que vous envoyez. L’équipe derrière le logiciel fonctionne comme une organisation à but non lucratif, soutenue par des subventions et des dons. Signal est open source, ce qui signifie que son code est accessible publiquement.

Les appareils SMSEagle prennent en charge la messagerie Signal lors de l’envoi de messages depuis le web-GUI ou l’APIv2. Vous pouvez également configurer des workflows d’automatisation en combinaison avec d’autres sources, telles que les e-mails, les messages SMS, etc.

Pour commencer à utiliser Signal, allez dans le menu Signal > Settings et enregistrez un numéro de téléphone utilisé dans votre appareil SMSEagle comme décrit dans l’article de la base de connaissances : How to setup Signal on SMSEagle device. La messagerie repose sur les données, votre appareil doit donc être connecté à Internet via Ethernet ou données mobiles.

Les messages Signal envoyés/reçus se trouvent dans le menu Signal > Conversations

Capture d’écran du menu Signal > Conversations

Webhooks (également appelés Callback URL)

La fonctionnalité Webhooks URL vous permet de :

• transférer un message entrant vers une adresse URL définie

• appeler une adresse URL définie si le statut d’un message sortant a changé (le message a été envoyé/délivré ou une erreur d’envoi s’est produite)

Si la fonctionnalité est activée, chaque règle définie déclenchera une requête HTTP(S) vers une URL définie. La requête HTTP(S) peut être de type GET ou POST.

Configuration de la fonctionnalité

La fonctionnalité Webhooks permet d’ajouter un nombre illimité de règles. Chaque règle peut être activée ou désactivée par l’utilisateur.

Capture d’écran des paramètres Webhooks

Pour chaque nouvelle règle, l’utilisateur doit remplir les champs demandés :

• Nom de la règle

• le champ “URL” définit l’adresse distante de votre script de rappel

• le bouton “Test URL” permet de tester si votre configuration Webhooks est correcte. SMSEagle effectuera une requête de rappel avec des paramètres de test et vérifiera la réponse du serveur distant

• “URL method” permet de choisir si le rappel vers votre URL se fait avec la méthode HTTP(S) GET ou POST

• sélectionnez les déclencheurs : sur message entrant, sur appel entrant, sur message envoyé, sur livraison du message, sur erreur d’envoi

• pour changer les noms des variables en GET/POST

• choisissez le format du payload pour POST (form-data ou json)

• « Send request when » définit si la requête est toujours envoyée, envoyée uniquement lorsque l’expéditeur du SMS appartient à un contact/groupe donné ou uniquement lorsque le message entrant contient une chaîne de caractères donnée

• Vous pouvez éventuellement définir la valeur « API key of your service ». Celle-ci sera transmise à votre URL de callback dans le paramètre “apikey”. Si vous laissez le champ vide, le paramètre “apikey” ne sera pas transmis à votre URL de callback

• Expected HTTP Status Code(s) : Définit les codes de réponse HTTP considérés comme une livraison réussie du webhook. Le webhook est considéré comme OK uniquement si le statut de la réponse HTTP correspond à l’un des codes spécifiés. Plusieurs codes de statut peuvent être fournis. Par défaut : 200

• L’utilisateur peut également choisir d’activer ou non la prise en charge des certificats SSL auto-signés

Paramètres de la requête

La requête envoyée via GET/POST à votre URL comporte les paramètres suivants : sender : Numéro de l’expéditeur timestamp : Heure à laquelle SMSEagle a reçu/envoyé le message, au format suivant YYYYmmddHHiiss (exemple : 20140531092257) text : Contenu du message SMS attachments : (POST uniquement) Pièces jointes MMS dans le format exemple [0 => [name => image.png, content-type => image/png, content => wfFWgwOlgBRwdWvsvs=]] (optionnel) text_binary : Contenu binaire du message SMS msgid : Identifiant du message SMSEagle modemno : Numéro du modem sur lequel le message entrant a été reçu/depuis lequel le message a été envoyé status : Statut du message oid : Valeur de l’identifiant OID assigné au message sortant avec le numéro de téléphone correspondant (optionnel) apikey : Clé API de votre service (optionnel)

Réponse HTTP attendue & tentatives de réessai

Après l’envoi de la requête HTTP(S) GET/POST à votre URL de callback, SMSEagle attendra la réponse HTTP définie dans le paramètre « Expected HTTP Status Code(s) ». Si une autre réponse ou aucune réponse n’est reçue de votre URL de callback, SMSEagle continuera de réessayer toutes les X minutes pendant 24 heures. L’intervalle de réessai peut être défini dans le plugin principal

Fenêtre :

ACK Zabbix par SMS

SMSEagle Webhooks permet une intégration native avec l’API Zabbix pour un accusé de réception d’alerte bidirectionnel.

Une fois configuré :

• Zabbix envoie une alerte aux destinataires via SMSEagle

• Lorsque le destinataire répond au SMS, SMSEagle appelle automatiquement l’API Zabbix pour accuser réception de l’alerte dans Zabbix

• Le texte de la réponse est ajouté comme commentaire au problème Zabbix

Paramètres de configuration dans la règle de webhook :

• Method : sélectionnez « POST (Zabbix) », puis choisissez le mode :

  • Accusé de réception uniquement

  • Annulation d’accusé de réception uniquement

  • Les deux (ACK et NOACK — détectés automatiquement à partir du préfixe SMS)

• URL du serveur Zabbix

• Type d’authentification :

  • Jeton API (Zabbix ≥ 6.4)

  • Login/Mot de passe (pour les versions Zabbix plus anciennes)

• Format de réponse SMS attendu : ACK [eventid] [message optionnel] ou NOACK [eventid] [message optionnel]

Réponse automatique

Cette fonctionnalité permet de répondre automatiquement à chaque message reçu avec un texte de réponse défini.

Configuration de la fonctionnalité

La fonctionnalité « Réponse automatique » permet d’ajouter plusieurs règles de réponse automatique. Chaque règle peut être activée ou désactivée par l’utilisateur.

Capture d’écran de la fenêtre principale du plugin

Pour chaque règle, l’utilisateur peut définir :

• Quand le message de réponse automatique doit être envoyé :

  • toujours,

  • lorsque le message entrant contient un texte défini,

  • et/ou lorsque l’expéditeur du message appartient à un contact/groupe du répertoire

  • si le texte SMS entrant arrive sur un modem sélectionné

• Si le texte du message de réponse automatique doit être envoyé en caractères Unicode

Cette fonctionnalité permet également de définir une limite d’envoi pour les messages de réponse automatique. Il est possible de définir une limitation de maximum 5 messages / 10 minutes / numéro de téléphone.

Capture d’écran du formulaire « Add/edit autoreply rule »

Abonnements (newsletter)

Cette fonctionnalité permet d’activer des abonnements de type newsletter via SMS. Lorsqu’une personne envoie un message à votre SMSEagle contenant un texte défini, le numéro expéditeur sera automatiquement ajouté à un groupe du répertoire. Ce groupe peut ensuite être utilisé pour envoyer des messages via le web-GUI/API/Email vers SMS. La suppression automatique du groupe fonctionne de la même manière : lorsque le SMS entrant contient un texte défini, le numéro de téléphone expéditeur sera automatiquement supprimé.

Capture d’écran de la fonctionnalité « Subscriptions »

Capture d’écran de Subscriptions > Add or edit subscriptions rule

Dans la fenêtre Add or edit subscriptions rule :

• Vous pouvez ajouter un nom de règle

• Sélectionner un groupe dans le répertoire

• Définir la phrase qui ajoute le numéro de téléphone du SMS entrant au groupe

• Définir la phrase qui supprime le numéro du groupe

• Sélectionner si la phrase doit être sensible à la casse

• Lorsqu’un numéro de téléphone est ajouté au répertoire SMSEagle via cette fonctionnalité, un contact du répertoire est d’abord créé avec un nom : [NOM DE LA RÈGLE] [NUMÉRO DE TÉLÉPHONE]. Par exemple : « Alert Sub +48123456789 ». Le contact est ensuite ajouté au groupe de répertoire défini.

SMS périodique

La fonctionnalité « SMS périodique » permet d’envoyer des messages SMS ou des codes USSD à un intervalle de temps souhaité. L’utilisateur peut définir plusieurs règles d’envoi, et chaque règle sera traitée indépendamment.

Configuration de la fonctionnalité

La fonctionnalité « SMS périodique » permet d’ajouter plusieurs règles d’envoi. Chaque règle peut être activée ou désactivée par l’utilisateur.

Capture d’écran de la fenêtre principale du plugin

Pour chaque règle, l’utilisateur peut définir :

• Le nom de la règle

• L’intervalle d’envoi (Horaire, Quotidien, Hebdomadaire, Mensuel ou Annuel)

• Le type de message (SMS, code USSD)

• Le contenu du texte du SMS

• Les destinataires (numéro(s) de téléphone séparés par une virgule ou groupe(s) du répertoire)

Capture d’écran de la fenêtre « Add new rule »

Appel Vocal

Un message SMS peut être optionnellement suivi d’un appel de réveil ou d’un appel de synthèse vocale (text-to-speech). Cela peut être activé dans la définition de la règle. Cette fonctionnalité nécessite un appareil équipé d’un module complémentaire Voice-Call actif.

Entrées/Sorties numériques

Les appareils SMSEagle de la famille NXS sont équipés d’entrées numériques (DI) et de sorties numériques (DO). Les entrées numériques peuvent être utilisées pour recevoir des signaux provenant de capteurs ou d’appareils externes et déclencher automatiquement l’envoi d’un message SMS en fonction de l’état de l’entrée. D’autre part, les sorties numériques peuvent être utilisées pour activer des appareils externes connectés aux sorties lorsque certains messages SMS sont reçus par SMSEagle.

Type de port	Valeur
DI	4
DO	4

Les états logiques des entrées et sorties des appareils SMSEagle de la famille NXS sont représentés par les états suivants :

Niveau logique	Valeur
LOW (0)	+5V
HIGH (1)	0

Utilisation des sorties numériques

Depuis la sortie numérique, sans effets secondaires, vous pouvez directement contrôler un circuit externe avec une tension n’excédant pas 5V et un courant maximal de 450mA.

Mais la forme de contrôle la plus sûre pour les circuits externes consiste à utiliser un relais intermédiaire avec une diode de protection. Un exemple d’utilisation est présenté sur l’image ci-dessous.

Avertissement : Si vous prévoyez d’utiliser une sortie numérique avec un relais, il est fortement recommandé de connecter également une diode de protection séparée (aussi appelée « snubber ») aux bornes de la bobine du relais. Un circuit snubber à diode peut être ajouté lors de la commande auprès de certains fabricants de relais. Cette diode est installée dans le sens qui ne permet normalement pas la conduction du courant. Lorsque le courant alimentant la charge inductive est interrompu rapidement, un important pic de tension est produit dans le sens inverse, l’inducteur tentant de maintenir la circulation du courant dans le circuit. Placer la diode snubber en parallèle avec la charge inductive pour un flux à polarisation inverse permet au courant de l’inducteur de circuler à travers la diode plutôt qu’à travers l’élément de commutation, dissipant l’énergie stockée dans la charge inductive via sa résistance série et la faisant plutôt passer par la résistance bien plus faible de la diode.

Utilisation des entrées numériques

Les entrées numériques (DI) de l’appareil SMSEagle sont de type « résistance de tirage (pull-up) ». Ce type d’entrée est utilisé pour éviter les commutations accidentelles des circuits numériques. Pour y parvenir, toute entrée non connectée, appelée « entrée flottante », doit être reliée à un niveau logique « 1 » ou « 0 » selon les besoins du circuit. Ceci est réalisé en utilisant ce que l’on appelle généralement des résistances de tirage (Pull-up Resistors) afin de donner à la broche d’entrée un état par défaut défini lorsque rien n’y est connecté. Ceci peut être observé avec un niveau de tension de 3-5V sur une entrée numérique non connectée.

Configuration de la fonction DI/DO

La fonctionnalité « Digital input/output » vous permet de définir des règles contrôlant le comportement des entrées/sorties numériques sur l’appareil SMSEagle. L’utilisateur peut définir plusieurs règles de traitement, à la fois pour les entrées et pour les sorties.

Capture d’écran de la fenêtre du plugin

Entrées numériques

Pour chaque règle de traitement d’une entrée numérique, l’utilisateur peut définir :

• Le nom de la règle

• Numéro de port

• L’état du signal d’entrée qui déclenchera l’envoi d’un message SMS (champ « When input signal »)

• Le texte du SMS (champ « Send SMS message »)

• Le nom du destinataire issu du répertoire téléphonique

• Le délai d’alerte. Cette valeur définit le temps entre deux alertes consécutives. Si cette valeur est définie et que l’entrée est déclenchée plusieurs fois pendant le délai, un seul message d’alerte sera envoyé.

Capture d’écran de la fenêtre « Add or edit rule » de l’entrée numérique

Sorties numériques

Pour chaque règle de traitement d’une sortie numérique, l’utilisateur peut définir :

• Le nom de la règle

• Numéro de port

• La condition dans laquelle la sortie numérique doit être activée (tous les messages entrants, lorsque le SMS entrant provient d’un contact spécifié dans le répertoire téléphonique, ou lorsque le texte du SMS entrant contient une valeur donnée)

• L’état du signal de sortie qui sera déclenché par le message SMS entrant

• La durée du signal de sortie en secondes (0 = sans limite de temps)

• Le délai du signal de sortie avant l’activation du signal

• La définition d’un SMS sortant qui sera envoyé après le déclenchement du signal de sortie

Capture d’écran de la fenêtre « Add or edit rule » de la sortie numérique

Appel Vocal

Un message SMS déclenché par une règle d’entrée/sortie numérique peut éventuellement être suivi d’un appel de réveil ou d’un appel de synthèse vocale (text-to-speech). Cela peut être activé dans la définition de la règle. Cette fonctionnalité nécessite un appareil disposant d’un module complémentaire Voice-Call actif.

Digital I/O Extender Le Digital I/O Extender est un module d’extension conçu pour les appareils SMSEagle NXS et MHD. Il étend les capacités d’entrées et de sorties numériques du système en fournissant 32 ports d’E/S numériques configurables supplémentaires. Chaque port peut être configuré individuellement comme une entrée numérique ou une sortie

sortie, permettant une adaptation flexible aux exigences de l’application. Le module d’extension se connecte à l’appareil SMSEagle via une interface USB.

Une fois connecté :

• Des ports DI/DO supplémentaires deviennent disponibles dans la définition de règle (sélection du numéro de port)

• La même logique de règles s’applique que pour les ports intégrés

• L’état du périphérique d’E/S externe est visible dans le menu Settings > Sysinfo

Consultez la boutique en ligne SMSEagle ou le réseau de partenaires commerciaux pour l’extension d’E/S numérique (Digital I/O Extender) (P/N : ACCDPIOKIT).

Capteurs de température et d’humidité

Tous les appareils SMSEagle de la famille NXS sont équipés d’un capteur interne de température et d’humidité. Le capteur interne permet de mesurer la température avec une précision de ±0,5°C et l’humidité avec une précision de ±2% HR.

De plus, les appareils NXS-97xx Rev.3 (et supérieur) prennent également en charge des capteurs externes via l’interface 1-Wire.

Les valeurs mesurées par les capteurs peuvent être affichées dans l’interface Web de SMSEagle et utilisées pour déclencher l’envoi d’un SMS à un ou plusieurs destinataires.

Capture d’écran de la fenêtre principale du plugin

Configuration de la fonctionnalité - Alarms

L’onglet « Alarms » permet de définir des règles de déclenchement pour les alarmes SMS de température et d’humidité. L’utilisateur peut définir plusieurs règles de traitement.

Capture d’écran de la fenêtre « Alarms »

Pour chaque règle de traitement d’une sortie numérique, l’utilisateur peut définir :

• Le nom de la règle

• Capteur (actuellement un seul capteur est disponible)

• Sous quelle condition l’alarme SMS doit être envoyée (température/humidité supérieure/inférieure à une valeur donnée)

• Texte du SMS

• Destinataire du SMS : nom du contact ou nom du groupe issu du Phonebook

Capture d’écran de la fenêtre « Add or edit rule »

Configuration de la fonctionnalité - paramètres

L’onglet « Settings » permet de contrôler les paramètres du capteur. L’utilisateur peut activer/désactiver le capteur et définir la période de lecture du capteur (en minutes). Si des capteurs externes sont pris en charge, ils peuvent être ajoutés et définis ici. L’échelle de température peut être réglée en Celsius ou en Fahrenheit.

Capture d’écran de la fenêtre « Settings »

Lecture de la température/humidité via le protocole SNMP

Les valeurs actuelles de température et d’humidité issues du capteur interne/externe peuvent également être lues via le protocole SNMP. Consultez le chapitre « SNMP agent » pour une description détaillée.

Connexion d’un capteur de température externe

Des sondes externes avec capteurs de température pour les appareils SMSEagle NXS-97xx Rev.3 (et supérieur) peuvent être achetées dans notre boutique en ligne ou via notre réseau de partenaires commerciaux. Le but de ces sondes est de faciliter la mesure de la température et l’alerte SMS via le menu « Temp & humidity » de l’interface Web SMSEagle.

Le capteur externe se connecte à l’appareil via un connecteur à bloc comme suit :

• Fil rouge vers (5V)

• Fil jaune vers (1W)

• Fil noir vers (GND)

Plusieurs capteurs sont pris en charge et peuvent être connectés en parallèle.

Une fois connecté à l’appareil, vous devez « Scanner les capteurs » (Scan for sensors) dans le menu Temp & Sensors > Settings

LDAP

La fonctionnalité LDAP permet d’accéder aux services d’annuaire : Active Directory (ci-après désigné « AD ») et OpenLDAP. Le plugin permet de lire les contacts et groupes de l’annuaire dans le web-GUI de SMSEagle. En option, il permet de s’authentifier sur l’appareil SMSEagle via les services d’annuaire.

Configuration de la fonctionnalité

Choisissez « LDAP » dans le menu de gauche du web-GUI de SMSEagle pour accéder à la configuration du plugin. Après avoir activé le plugin, l’utilisateur doit renseigner tous les champs demandés en fonction des paramètres AD.

Dans le champ « AD phone attribute », l’utilisateur doit choisir quel attribut téléphonique de l’AD sera affiché dans le web-GUI de SMSEagle.

Capture d’écran de la fenêtre « LDAP settings »

Cliquez sur « Save » puis « Test connection » pour vous assurer que SMSEagle est bien connecté au serveur AD.

Capture d’écran montrant une connexion réussie au serveur AD.

Une fois la connexion établie, des suggestions de contacts/groupes AD s’affichent dans les modules sélectionnés du Web-GUI. Commencez à saisir une partie du nom ou du numéro d’un contact/groupe pour afficher les suggestions de contacts AD.

Tapez « LDAP » (sensible à la casse) pour vérifier tous les contacts répertoriés dans l’annuaire AD.

Capture d’écran du module « Compose » avec la connexion LDAP activée

Les suggestions de l’annuaire LDAP peuvent être utilisées dans les modules « Compose », « Autoreply », « Digital input/output », « Email To SMS » et « Email To SMS Poller ».

Authentification à SMSEagle via LDAP (facultatif)

Cette fonctionnalité permet l’authentification à votre appareil SMSEagle via LDAP. Pour commencer à l’utiliser :

• créez dans vos services d’annuaire un nouveau groupe pour le rôle admin de SMSEagle. Saisissez le nom du groupe créé dans le web GUI de SMSEagle > LDAP > « Admin group name in LDAP »

• créez dans vos services d’annuaire un nouveau groupe pour le rôle utilisateur de SMSEagle. Saisissez le nom du groupe créé dans le web GUI de SMSEagle > LDAP > « User group name in LDAP »

• Réglez le paramètre « Allow authentication to SMSEagle via LDAP » sur « Enable »

• appuyez sur le bouton « Save » »

Selon la structure d’annuaire de votre serveur LDAP, pour OpenLDAP vous devrez peut-être également spécifier des Distinguished Names distincts pour les utilisateurs et les groupes (s’ils se trouvent sous des chemins différents) :

Sur l’écran de connexion, l’utilisateur pourra choisir entre l’authentification « Local » ou « LDAP ». Utilisez l’un de ces paramètres comme utilisateur dans le formulaire de connexion SMSEagle :

• Common Name

• givenName

• sAMAccountName

• displayName

• userPrincipalName

Lors de la première connexion avec le type d’authentification LDAP, le système créera un nouvel utilisateur sur l’appareil SMSEagle, lié au compte LDAP. Les paramètres de ce compte seront synchronisés avec LDAP à chaque connexion.

Allow/Deny List

La fonctionnalité Allow/Deny List vous permet de contrôler le trafic SMS entrant et sortant sur votre appareil SMSEagle. En spécifiant quels numéros de téléphone ou plages de numéros sont autorisés ou bloqués, vous pouvez garantir que seules les sources approuvées peuvent envoyer des messages à l’appareil ou que les messages sortants ne sont envoyés qu’aux destinataires approuvés.

La liste Allow/Deny fonctionne selon l’un des deux modes mutuellement exclusifs suivants :

• Allow selected

• Deny selected

Un seul mode peut être actif à la fois.

Capture d’écran de la fonctionnalité « Allow/Deny List »

Mode: Allow selected

En mode Allow selected, seuls les numéros de téléphone ou plages de numéros explicitement définis dans la liste sont autorisés. Tous les autres numéros sont automatiquement bloqués.

Comportement :

• SMS entrants

Seuls les messages envoyés depuis les numéros figurant dans l’Allow List sont acceptés. Les messages provenant de tous les autres numéros sont rejetés.

• SMS sortants L’appareil ne peut envoyer des messages qu’aux numéros figurant dans l’Allow List. Les tentatives d’envoi de messages vers d’autres numéros sont bloquées.

Cas d’usage typiques

• Restreindre la communication à un ensemble connu de numéros de confiance

• Limiter le trafic sortant aux seuls destinataires approuvés

• Créer un environnement SMS fermé pour les intégrations, l’automatisation ou les tests

Exemple

Si la liste contient :

• +48123456789

• +4420*

Alors :

• Le trafic SMS est autorisé uniquement vers et depuis ce numéro spécifique +48123456789 et tous les numéros britanniques commençant par +4420

• Tout SMS impliquant d’autres numéros est bloqué

Capture d’écran de la fenêtre « Add number to allow list »

Mode : Deny selected

En mode Deny selected, tous les numéros de téléphone sont autorisés par défaut, à l’exception de ceux explicitement définis dans la liste.

Comportement :

• SMS entrants Les messages provenant des numéros figurant dans la Deny List sont bloqués. Les messages provenant de tous les autres numéros sont acceptés.

• SMS sortants L’appareil ne peut pas envoyer de messages aux numéros figurant dans la Deny List, mais peut envoyer des messages à tous les autres numéros.

Cas d’utilisation typiques :

• Blocage des expéditeurs indésirables ou abusifs

• Empêcher la livraison de SMS vers des destinations ou plages de numéros spécifiques

• Remplacement du filtrage traditionnel de type liste noire par un contrôle unifié entrant et sortant

Exemple

Si la liste contient :

• +1555000000

• +31*

Alors :

• Les messages vers ou depuis ces numéros sont bloqués

• Tout autre trafic SMS est autorisé

Capture d’écran de la fenêtre « Add number to deny list »

Stop word

La fonctionnalité STOP Word offre un moyen automatisé de bloquer les expéditeurs de SMS indésirables en fonction du contenu du message. Lorsqu’un mot STOP est défini, l’appareil SMSEagle surveille les messages SMS entrants à la recherche de ce mot-clé. Si un message entrant contient le mot STOP défini, le numéro de téléphone de l’expéditeur est automatiquement ajouté à la Deny list. Par conséquent, toute communication SMS entrante ou sortante ultérieure avec ce numéro est bloquée conformément aux règles du mode Deny selected.

Cette fonctionnalité est particulièrement utile pour :

• Traiter automatiquement les demandes de désinscription ou d’opt-out

• Bloquer les expéditeurs qui répondent avec des mots-clés prédéfinis (par ex. STOP, UNSUBSCRIBE)

• Réduire l’administration manuelle des numéros bloqués

Capture d’écran de la fenêtre « Define STOP Word »

Remarques :

• La Allow/Deny List s’applique globalement au trafic SMS sur l’appareil.

• Les numéros de téléphone peuvent être définis comme des numéros uniques ou des plages de numéros à l’aide de caractères génériques. Les caractères génériques suivants peuvent être utilisés pour plusieurs numéros : *NUMBER, *NUMBER*, NUMBER* (où * remplace n’importe quels caractères)

SMPP

(disponible sur les appareils NXS Rev. 3 et Rev. 4)

Short Message Peer-to-Peer (SMPP) est un protocole utilisé dans l’industrie des télécommunications. Il s’agit d’un protocole ouvert et standard de l’industrie, conçu pour fournir une interface de communication de données pour le transfert de données de messages courts entre les Entités de Messagerie Courte Externes (ESMEs) et les SMSC.

Le protocole SMPP est souvent utilisé pour permettre à des tiers d’envoyer des messages à des passerelles SMS pour un traitement ultérieur.

L’appareil SMSEagle est équipé d’un serveur SMPP intégré. Il prend en charge SMPP dans les scénarios suivants :

• Recevoir des requêtes SMS via SMPP et envoyer des messages à l’opérateur via SIM et module radio

• Recevoir des SMS entrants de l’opérateur cellulaire via le module radio avec SIM et transférer le SMS au client SMPP

Dans la fonctionnalité SMPP, il est possible de :

1. envoyer des messages SMS texte (1300 caractères max.)

2. recevoir des rapports de livraison

3. spécifier l’encodage du message (7bit ASCII ou UTF-8 est pris en charge)

4. recevoir des messages entrants et les transférer au client SMPP

5. sélectionner les modems utilisés pour l’envoi/la réception de SMS (uniquement pour les appareils multimodem)

Capture d’écran du menu Settings > SMPP.

Le serveur SMPP prend en charge la version 3.4 de SMPP.

Settings

Le menu Settings est divisé en plusieurs onglets pour une maintenance plus facile.

Application Settings

Les paramètres de l’application peuvent être modifiés sous l’onglet Settings > Application.

• Vous pouvez changer la langue de l’application en anglais, français, allemand, polonais et espagnol

• Vous pouvez changer le code d’appel du pays vers votre pays (ce paramètre affecte uniquement l’attribution correcte des numéros de téléphone aux entrées du répertoire)

• Vous pouvez trier la conversation pour afficher les messages soit « Newest First » soit « Oldest First »

• Vous pouvez changer la vue de conversation en « Table » (vue tabulaire) ou « Balloons » (vue type smartphone), comme indiqué dans le chapitre Folders

• Vous pouvez ajuster la quantité de données affichées sur une page à 10, 15, 20, 25, 50, 100, 250 ou Show all

• Vous pouvez configurer les messages pour qu’ils soient supprimés définitivement ou déplacés d’abord vers Trash

• Vous pouvez configurer la réception des rapports de livraison sur Yes, No ou Default (paramètre de l’opérateur réseau)

• Vous pouvez configurer la visibilité du contenu de Inbox sur All users, Only admins ou Only from assigned modems

• Vous pouvez configurer l’accès au module de reporting sur All users ou Only admins

• Vous pouvez définir un délai entre les envois de SMS en secondes (ce paramètre peut être utile dans les cas où l’opérateur mobile bloque un numéro en raison d’un trafic intensif. Remarque : définir un délai entre les envois de SMS introduit également un délai dans la réception des SMS)

• Vous pouvez activer ou désactiver l’accès à la base de données pour les applications externes

• Vous pouvez activer/désactiver la vérification de la complexité des mots de passe. Lorsque cette option est activée, le mot de passe utilisateur doit comporter au moins 8 caractères et inclure au moins une lettre minuscule, une lettre majuscule, un chiffre et un caractère spécial

• Vous pouvez activer l’authentification multifacteur (MFA) forcée pour le rôle utilisateur : pour tous les utilisateurs, uniquement pour les nouveaux utilisateurs, ou laisser les utilisateurs choisir leurs propres paramètres MFA (désactiver l’obligation)

Paramètres IP

Les paramètres IP peuvent être modifiés sous l’onglet Settings > IP Settings.

• Vous pouvez activer ou désactiver l’obtention de l’adresse IP via DHCP

• Vous pouvez saisir l’adresse IP

• Vous pouvez saisir le masque de sous-réseau

• Vous pouvez définir l’adresse IP de la passerelle

• Vous pouvez définir le DNS 1

• Vous pouvez éventuellement définir le DNS 2

• Vous pouvez consulter l’adresse MAC de votre appareil

• Vous pouvez saisir le nom d’hôte

• Vous pouvez choisir d’utiliser un proxy

Règles d’autorisation/refus pour les adresses IP

L’onglet IP Settings inclut une option permettant de définir des règles de contrôle d’accès basées sur les adresses IP. Les administrateurs peuvent créer une liste d’autorisation (whitelist) ou une liste de refus (blacklist) d’adresses IP ou de plages d’adresses autorisées ou bloquées pour accéder à l’interface web SMSEagle et à l’API. Cette fonctionnalité permet de restreindre l’accès à l’appareil aux seuls segments réseau approuvés. Séparez plusieurs adresses par une virgule.

Remarque : avec ces paramètres, tous les ports sont bloqués sauf le port 22.

Basculement (Failover)

La configuration du basculement a été décrite dans le chapitre « Fonctionnalité de basculement (cluster HA) ».

Date/Heure

Les paramètres de date/heure peuvent être modifiés sous l’onglet Settings Tab > Date/Time

• Vous pouvez vérifier la date et l’heure actuelles de l’appareil

• Vous pouvez définir votre fuseau horaire

• Vous pouvez configurer la synchronisation automatique de l’heure avec un serveur NTP, désactiver la synchronisation automatique de l’heure ou créer un serveur NTP sur l’appareil SMSEagle (la date et l’heure seront obtenues via le réseau 3G/4G)

• Vous pouvez définir l’adresse du serveur NTP (ou plusieurs adresses séparées par une virgule)

Maintenance

Les paramètres de maintenance sont accessibles sous l’onglet Settings > Maintenance

• Vous pouvez redémarrer votre appareil

• Vous pouvez activer ou désactiver le modem de l’appareil

• Vous pouvez saisir le code PIN de votre carte SIM

• Vous pouvez saisir le code PUK de votre carte SIM

• Vous pouvez activer les journaux étendus du modem (à des fins de débogage)

• Vous pouvez activer le mode d’analyse du signal (pour trouver le meilleur emplacement pour l’antenne)

• Vous pouvez configurer les appels entrants pour qu’ils soient toujours rejetés, acceptés ou ignorés

Les paramètres multi-modem sont décrits dans le chapitre Fonctionnalités multimodem.

Activer la connectivité 2G

Pour les appareils matériels Rev.4, il existe une option supplémentaire permettant d’activer la connectivité réseau 2G. La 2G est désactivée par défaut et ne doit être activée que pour les appareils situés dans des zones où il existe des problèmes de connectivité avec les réseaux cellulaires 4G/3G.

Mode d’analyse du signal

Cette fonctionnalité vous permet de trouver le meilleur emplacement pour l’antenne dans les environnements où la puissance du signal cellulaire est faible. Lorsqu’elle est activée, la valeur de la puissance du signal sur le tableau de bord SMSEagle sera actualisée toutes les 3 secondes. Cela vous permet d’essayer différents emplacements pour l’antenne et de trouver un endroit avec le meilleur signal.

AVERTISSEMENT : lorsque le mode d’analyse du signal est activé, vous ne pouvez pas envoyer/recevoir de messages sur l’appareil.

Renvoi d’appel

Les paramètres de renvoi d’appel sont accessibles sous l’onglet Settings > Call forward.

• Vous pouvez choisir de renvoyer tous les appels entrants vers un numéro choisi

Remarque importante : Cette fonctionnalité n’est pas disponible sur les appareils NXS-97xx-4G Rev.3.

MMS

Les paramètres MMS sont accessibles sous l’onglet Settings > MMS.

• Vous pouvez activer la prise en charge MMS

• Vous pouvez définir la valeur APN

• Vous pouvez saisir le nom d’utilisateur APN

• Vous pouvez saisir le mot de passe APN

• Vous pouvez définir le MMSC

• Vous pouvez définir le Proxy MMS

• Vous pouvez définir le Port MMS

• Vous pouvez configurer un répondeur automatique pour les MMS entrants

• Vous pouvez saisir le message du répondeur automatique MMS

Vous pouvez charger les valeurs par défaut de votre opérateur SIM en utilisant le bouton « Read APN Settings » ou saisir les valeurs trouvées sur le site web de votre opérateur SIM.

Connexion de données

Les paramètres de connexion de données sont accessibles sous l’onglet Settings > Data conn.

Ici, vous pouvez contrôler une connexion de données mobile sur votre appareil. Elle peut être utilisée, par exemple, pour utiliser SMSEagle comme source Internet de secours. La connexion de données N’EST PAS REQUISE pour le fonctionnement normal de l’appareil SMSEagle. Laissez-la désactivée (OFF) si vous ne souhaitez pas l’utiliser.

• Vous pouvez choisir de redémarrer automatiquement la connexion de données

• Vous pouvez saisir l’APN Internet

• Vous pouvez saisir le nom d’utilisateur APN

• Vous pouvez saisir le mot de passe APN

• Vous pouvez saisir le numéro d’accès

• Vous pouvez consulter l’adresse IP de votre appareil

Vous pouvez charger les valeurs par défaut de votre opérateur SIM en utilisant le bouton « Read APN Settings » ou saisir les valeurs trouvées sur le site web de votre opérateur SIM.

SNMP

Les paramètres SNMP sont accessibles sous l’onglet Settings > SNMP

• Vous pouvez activer/désactiver le démon SNMP

• Vous pouvez définir le nom de votre communauté SNMP (valeur personnalisée)

Le démon SNMP n’est nécessaire que si vous souhaitez surveiller votre appareil à partir de solutions de supervision externes telles que des systèmes de gestion de réseau (Network Monitoring Systems), etc. Vous pouvez en savoir plus sur les métriques SNMP personnalisées disponibles sur l’appareil SMSEagle dans le chapitre relatif à l’agent SNMP.

Certificat SSL et redirection HTTPS

Les paramètres SSL sont accessibles sous l’onglet Settings > SSL. Ces paramètres vous permettent de téléverser un certificat SSL sur votre appareil et de rediriger le trafic HTTP vers HTTPS.

** Certificat SSL** Par défaut, l’appareil SMSEagle est équipé d’un certificat SSL auto-signé. Si vous souhaitez installer votre propre certificat sur l’appareil, veuillez obtenir un fichier de certificat valide délivré par une autorité de certification. Pour téléverser le certificat, veuillez fournir le fichier de certificat et la clé privée au format PEM. Le certificat ne peut pas être protégé par mot de passe.

Remarque : Si vous souhaitez utiliser un certificat Let’s Encrypt, veuillez suivre ce guide dans notre base de connaissances.

Root CA et chaîne complète (optionnel) Si vous devez ajouter un certificat root CA ou un certificat de chaîne complète, vous pouvez les téléverser à l’aide des contrôles « Root CA Certificate » et « Full chain ».

Rediriger HTTP vers HTTPS Pour une sécurité optimale, nous recommandons d’utiliser des connexions exclusivement en HTTPS avec votre SMSEagle. Vous pouvez facilement rediriger le trafic HTTP vers HTTPS en réglant « Forward HTTP to HTTPS » sur « Yes ».

Générer un CSR

Cette fonctionnalité simplifie le processus d’obtention d’un certificat SSL. Elle crée deux fichiers :

• Fichier CSR (Certificate Signing Request). Il est nécessaire dans une procédure de certification SSL. Il s’agit d’un fichier contenant un texte chiffré généré par le serveur sur lequel le certificat doit fonctionner. Il contient des informations qui seront utilisées dans le certificat, telles que : le nom de l’organisation, le nom de domaine, la ville, le pays. Il contient également la clé publique utilisée pour chiffrer les informations transmises.

• Clé privée. La clé privée du fichier CSR (clé de déchiffrement) doit être conservée à l’usage exclusif du propriétaire du certificat. Ce fichier doit être téléversé conjointement avec le certificat SSL.

Sauvegarde/Restauration

Les paramètres de sauvegarde et de restauration sont accessibles sous l’onglet Settings > Backup/Restore

• Vous pouvez créer une sauvegarde des paramètres de votre appareil

• Vous pouvez activer la sauvegarde automatique vers SFTP/FTP(S)

  • Vous pouvez définir l’intervalle de sauvegarde automatique (quotidien/hebdomadaire/mensuel) et l’heure

  • Vous pouvez sélectionner le nombre de sauvegardes à conserver (suppression des sauvegardes)

• Vous pouvez restaurer les paramètres de l’appareil à partir d’un fichier précédemment enregistré

• Vous pouvez choisir de restaurer également la base de données

*ATTENTION* La restauration des paramètres de sauvegarde ne fonctionne qu’avec la même version de l’appareil et du logiciel

Mises à jour

Les paramètres de mise à jour sont accessibles dans le menu Settings > onglet Updates.

Le logiciel SMSEagle fait l’objet d’un processus d’amélioration continue. Nous sommes à l’écoute de nos clients, et les nouvelles versions sont basées sur les retours/demandes de nos clients. Les mises à jour logicielles sont publiées fréquemment et offrent l’accès à de nouvelles fonctionnalités ainsi que des corrections aux problèmes signalés. Le Web-GUI vous offre la possibilité de vérifier automatiquement la disponibilité de nouvelles mises à jour logicielles. Cela peut se faire de deux façons :

Vérification manuelle

Pour vérifier manuellement la disponibilité de mises à jour logicielles, allez dans le menu Settings > onglet Updates. Cliquez sur le bouton « Check for software update now ». En haut apparaît une bulle rouge indiquant si le logiciel est à jour.

Vérification automatique

Pour démarrer les vérifications automatiques des mises à jour logicielles, allez dans le menu Settings > onglet Updates, et cochez l’option « Automatically check for software updates ». Cela activera des vérifications périodiques (une fois par mois) de la disponibilité de mises à jour logicielles. Si une nouvelle mise à jour est disponible, un message « Update Available » apparaîtra dans le menu Settings > Sysinfo – à côté du numéro de version actuelle du logiciel.

Si vous sélectionnez « Notify Admin about new software version by SMS », l’appareil enverra également un SMS au compte administrateur par défaut (si le numéro de téléphone est renseigné dans le compte) avec une notification concernant la nouvelle mise à jour logicielle.

Notification d’expiration du support technique

Comme pour les vérifications automatiques des mises à jour logicielles, le mécanisme de validation du support technique fournit des informations sur la date d’expiration du support technique. Un mois avant l’expiration d’un package de support, votre appareil vous avertira de la date d’expiration à venir et vous fournira un lien pratique vers notre boutique en ligne et nos partenaires commerciaux où vous pourrez renouveler votre package.

Capture d’écran de « General Settings-Updates »

Remarque : Votre appareil SMSEagle doit disposer d’une connectivité HTTPS avec l’adresse updates.smseagle.eu pour que cette fonctionnalité puisse fonctionner.

Journaux

Disponible dans le menu Settings > section Logs présente une représentation visuelle des journaux les plus importants de l’appareil.

Les journaux d’appareil suivants sont disponibles via le Web-GUI :

1. Journal du modem

2. Journal de la base de données

3. Journal système

4. Journal d’application

Vous pouvez également télécharger le paquet complet des journaux de l’appareil à des fins de dépannage et de support. Cela peut se faire à l’aide du bouton « Download device logs »

• Vous pouvez choisir de télécharger les journaux de l’appareil des 14 derniers jours, des 30 derniers jours ou tous les journaux.

Sysinfo

Les informations générales sur l’appareil et le système sont accessibles dans le menu Settings > Sysinfo.

Les informations système contiennent :

• le modèle de l’appareil et le numéro de série (MAC)

• la version du logiciel

• les informations du modem : statut de la carte SIM, force du signal, statut d’enregistrement réseau, IMEI du modem

• la disponibilité de l’espace disque

Vous pouvez configurer des notifications SMS à envoyer lorsque l’utilisation du disque atteint une valeur spécifique. L’alerte SMS sera envoyée au numéro de téléphone attribué à l’utilisateur ayant le rôle de Master Admin (id=1).

Fonctionnalité Failover (cluster HA)

« Les clusters à haute disponibilité (également appelés clusters HA ou clusters de basculement) sont des groupes d’ordinateurs (…) qui peuvent être utilisés de manière fiable avec un minimum de temps d’arrêt. Ils fonctionnent en utilisant un logiciel de haute disponibilité pour exploiter des ordinateurs redondants en groupes ou clusters qui assurent un service continu lorsque des composants système tombent en panne. Sans clustering, si un serveur exécutant une application particulière plante, l’application sera indisponible jusqu’à ce que le serveur en panne soit réparé. Le clustering HA remédie à cette situation en détectant les défaillances matérielles/logicielles, et en redémarrant immédiatement l’application sur un autre système ou nœud entier sans nécessiter d’intervention administrative, un processus connu sous le nom de basculement (failover). » (source : Wikipedia)

Les appareils de la famille SMSEagle NXS disposent de leur propre mécanisme de failover basé sur un cluster HA. Cette fonctionnalité vous permet d’assurer une haute disponibilité des appareils SMSEagle dans des environnements critiques. Pour activer le failover (cluster HA), vous avez besoin de 2 appareils (dits « nœuds »). La fonctionnalité failover surveille les appareils fonctionnant dans le cluster et détecte les défaillances des services suivants :

1. Serveur WWW Apache2

2. Base de données PostgreSQL

3. Agent SNMP

4. Logiciel du modem (démon Gammu-SMSD)

5. Accessibilité (réponse au ping) du nœud entier.

Chaque nœud d’un cluster peut avoir l’un des trois états suivants :

• Master : nœud principal sain d’un cluster, accessible par défaut via l’adresse IP virtuelle

• Backup : second nœud sain d’un cluster, prêt et en attente pour remplacer le Master en cas de besoin

• Fault : nœud présentant une défaillance de service détectée

Dans le cluster, vous avez un appareil MASTER et un appareil BACKUP. Le cluster HA est accessible via une adresse IP virtuelle. Lorsque le démon fonctionnant sur l’appareil MASTER détecte une défaillance d’au moins une des fonctionnalités décrites, il bascule immédiatement et automatiquement l’attribution de l’IP du cluster vers l’appareil (nœud) BACKUP, assurant ainsi une utilisation continue du cluster HA SMSEagle pour l’utilisateur.

Les appareils (nœuds) doivent pouvoir se voir sur le réseau. Par défaut, les nœuds HA utilisent l’adresse IP multicast 224.0.0.18 pour le protocole VRRP (Virtual Router Redundancy Protocol) pour la communication entre les deux nœuds. Si les nœuds sont sur le même réseau (même sous-réseau et même plage IP), aucune configuration réseau n’est nécessaire. Si les deux nœuds sont derrière des pare-feux, assurez-vous que le pare-feu est configuré pour accepter le multicast et le protocole VRRP (protocole IP n° 112).

Comment configurer le failover (cluster HA) :

Le cluster de failover peut être facilement configuré via l’interface web. La configuration peut être effectuée dans le menu « Settings » > onglet « Failover ». La configuration doit être exactement identique sur les deux appareils du cluster HA. Veuillez d’abord configurer l’appareil MASTER, puis l’appareil BACKUP. Pour chaque appareil du cluster de failover :

• saisissez l’adresse IP virtuelle dans le champ « Virtual IP Address »

• saisissez les adresses IP Master et Backup (elles doivent correspondre aux adresses physiques de vos appareils)

• définissez « Enable Failover cluster » sur « Yes »

• vous pouvez éventuellement activer la réplication de base de données entre les nœuds

Enregistrez la configuration. Redémarrez chaque appareil après l’enregistrement.

Capture d’écran de « General Settings-Failover »

Notification SMS lors des changements d’état

La fonction Failover peut éventuellement envoyer des notifications SMS lorsque l’état du cluster change (par exemple, lorsqu’un nœud passe à l’état MASTER, par exemple : BACKUP > MASTER, ou FAULT> MASTER). Cela permet aux administrateurs de réagir rapidement aux pannes d’infrastructure sans avoir à surveiller l’appareil manuellement. La notification SMS peut être activée dans l’onglet de configuration Failover. Les notifications sont automatiquement envoyées au numéro de téléphone associé au compte Admin principal (id=1).

Réplication de base de données

La réplication de base de données (optionnelle) permet de répliquer automatiquement le contenu de la base de données entre les nœuds, du MASTER vers le BACKUP. Dans la version logicielle actuelle, le contenu suivant est répliqué : Dossiers (avec messages), Contacts du répertoire téléphonique, Utilisateurs. Nous recommandons d’utiliser les mêmes modèles d’appareils et la même version logicielle sur les deux appareils pour une réplication homogène entre les nœuds.

Après une configuration correcte du cluster HA, vous devez accéder au cluster via son adresse IP virtuelle.

SNMP-surveillance du cluster HA

La fonction Failover utilise KEEPALIVED-MIB pour la surveillance SNMP.

Exemple de lecture de la valeur device cluster state à l’aide de la bibliothèque NET-SNMP

a) Commande pour lire la valeur du résultat :* *snmpget -v 2c -c public ip-of-smseagle .1.3.6.1.4.1.9586.100.5.2.3.1.4.1

Résultat :* *KEEPALIVED-MIB::vrrpInstanceState.1 = INTEGER: master(2)

Commentaire : l’état actuel de l’appareil est master