Ce chapitre couvre la section Automatisation de l’interface web, dans le même ordre que celui dans lequel les règles y apparaissent.

Email vers SMS

Liste des règles Email vers SMS avec une règle, à côté de la boîte d'information Email vers SMS

Règles Email vers SMS

La fonction Email vers SMS vous permet de transférer les emails entrants en tant que messages SMS, soit à un numéro de téléphone, soit à un contact/groupe de votre Carnet d’adresses.

Où le trouver

La fonction est répartie en deux endroits dans la WebGUI :

  • Automatisation > Email > Email vers SMS (/automation/email-to-sms) est l’endroit où vous créez et gérez les règles de transfert.

  • Paramètres > Canaux > Email > Email vers SMS (/settings/email/email-to-sms) est l’endroit où vous activez le service et configurez comment les emails sont convertis en messages - voir Email vers SMS dans Paramètres.

Étape 1 : Comprendre le format d’adresse des destinataires

Les emails doivent être envoyés à une adresse spécialement formatée pour que SMSEagle sache où livrer le message.

Pour transférer vers un numéro de téléphone :

PHONE_NUMBER@ADDRESS_OF_SMSEAGLE_GATEWAY

Par exemple : 999888777@gateway.smseagle.eu

Pour transférer vers un contact ou un groupe du Carnet d’adresses (le contact ou le groupe doit être défini comme public) :

NAME@ADDRESS_OF_SMSEAGLE_GATEWAY

Par exemple : work@gateway.smseagle.eu

Si le nom du contact ou du groupe contient un espace, utilisez sa forme codée en URL : work%20group@gateway.smseagle.eu

Au lieu de l’adresse IP de la passerelle, vous pouvez utiliser un nom de domaine pleinement qualifié, défini sous Paramètres > Canaux > Email > Email vers SMS > Paramètres avancés > Nom d’hôte FQDN. Si Utiliser les contacts LDAP est activé là-bas, le même format NAME@GATEWAY résout également les contacts et groupes définis dans LDAP / Active Directory.

Par défaut, le corps de l’email devient le texte du SMS. Cela dépend du paramètre Que faire avec le sujet de l’email dans Paramètres : le sujet peut être ignoré, ajouté au début du texte du message, utilisé pour l’authentification, ou envoyé à la place du corps.

Étape 2 : Créer une nouvelle règle

Allez à Automatisation > Email > Email vers SMS et cliquez sur Créer une nouvelle règle. Un panneau intitulé Ajouter une règle Email vers SMS s’ouvre à droite.

Champ

Description

Nom de la règle *

Un nom pour identifier la règle (obligatoire, 100 caractères maximum)

Transférer pour *

Toujours envoyer transfère chaque email entrant qui correspond au format d’adresse. Expéditeur spécifié / le message contient ajoute des conditions de filtrage, voir Étape 3.

Envoyer à l’aide du modem

Quel modem envoie le SMS. Par défaut, Par défaut. S’affiche uniquement sur les appareils avec plus d’un modem.

Expression d’arrêt

Le texte commençant à partir de cette phrase sera supprimé du message (sensible à la casse)

Priorité

Priorité d’envoi de 0 à 5. Les messages avec une priorité plus élevée sont traités en premier.

Appel après envoi du SMS

Non, Sonnerie uniquement, Oui - synthèse vocale, ou Oui - synthèse vocale (avancée). Les options disponibles dépendent de la voix et des capacités TTS de votre appareil.

Modèle de voix

Voix utilisée pour l’appel de synthèse vocale. Affichée uniquement pour les appareils supportant la synthèse vocale avancée, et uniquement après sélection de Oui - synthèse vocale (avancée).

Forcer la conversion en UTF-8

Force la conversion du texte du message en UTF-8

Supprimer l’historique de conversation

Supprime l’historique cité de la conversation par courrier électronique du texte du message

Cliquez sur Save pour créer la règle, ou sur Cancel pour l’annuler.

Étape 3 : Ajouter des conditions de filtrage (facultatif)

Si vous sélectionnez Specified sender / message contains sous Forward for, trois conditions indépendantes deviennent disponibles, chacune avec sa propre case à cocher et son champ de texte :

  • When incoming email address contains filtre par l’adresse e-mail de l’expéditeur

  • When incoming messages subject contains filtre par la ligne d’objet du courrier électronique

  • When incoming message content contains filtre par le corps du courrier électronique

Le commutateur Case sensitive s’applique à toutes les conditions activées.

Vous pouvez activer une, deux, ou les trois conditions. La règle se déclenche uniquement lorsque toutes les conditions activées sont remplies.

Étape 4 : Gérer les règles existantes

Chaque règle apparaît sous forme de carte dans la liste Email to SMS, affichant :

  • le nom de la règle

  • la condition de transfert, par exemple Forward when incoming: email address contains: …, ou Always forward lorsqu’aucune condition n’est définie

  • le modem utilisé pour envoyer

  • la phrase d’arrêt configurée

  • un curseur marche/arrêt pour activer ou désactiver la règle sans la supprimer

  • un menu ⋮ avec Edit et Delete

Contrôles supplémentaires sur la liste :

  • Search filtre les règles par nom.

  • La sélection des cases à cocher des règles révèle les actions en masse : Enable / Disable et Delete.

  • Les contrôles de pagination en bas vous permettent de sauter à une page et de modifier le nombre de règles affichées par page.

Le panneau d’aide sur la droite explique les formats d’adresses de destinataires, avec un bouton See more qui renvoie à la page de fonction sur smseagle.eu.

Email to SMS Poller

Liste des règles Email vers SMS Poller avec une règle, à côté de la boîte d'information Email vers SMS Poller

Règles Email vers SMS Poller

Email to SMS Poller vérifie régulièrement une boîte aux lettres externe via POP3, IMAP ou IMAP avec OAuth2 (Microsoft 365 / Outlook), et convertit les e-mails trouvés en messages SMS selon les règles Email to SMS Poller. Contrairement à Email to SMS (qui exécute son propre serveur de messagerie et reçoit le courrier activement), le Poller contacte une boîte aux lettres existante que vous possédez déjà.

Où le trouver

Automation > Email > Email to SMS Poller (/automation/email-to-sms-poller/) est l’endroit où vous créez et gérez les règles. L’activation du service et la connexion à la boîte aux lettres (POP3, IMAP ou IMAP + OAuth2 pour Microsoft 365) s’effectuent sous Email to SMS Poller dans Settings.

Création d’une règle

Cliquez sur Create new rule. Les règles ici fonctionnent de la même manière que les règles Email to SMS - nommez la règle, choisissez de transférer chaque e-mail interrogé ou uniquement ceux correspondant à des conditions d’expéditeur/sujet/contenu, et définissez les mêmes options par règle (modem, phrase d’arrêt, priorité, appel après envoi).

SMS to Email

Liste des règles SMS to Email avec la règle de transfert par défaut

Règles SMS to Email

Ce que cette fonction fait

SMS to Email transfère les messages entrants SMS et MMS à une adresse e-mail, afin que vous puissiez les lire dans votre boîte aux lettres au lieu de vous connecter à SMSEagle.

Vous créez des règles qui décident quels messages sont transférés et où ils vont. Une règle peut tout transférer, ou uniquement les messages de certains expéditeurs, ou uniquement les messages contenant une certaine phrase.

Utilisations typiques : transférer les réponses du personnel sur le terrain vers une boîte aux lettres de support partagée, ou archiver les confirmations d’alertes dans la boîte aux lettres de courrier entrant d’un système de ticketing.

Avant de commencer

SMSEagle a besoin d’une configuration de serveur de messagerie opérationnelle pour envoyer les e-mails. Allez à Settings > Channels > Email > SMTP Configuration et assurez-vous qu’elle est remplie et testée - voir SMTP Configuration. Sans cela, les règles correspondront mais aucun e-mail n’arrivera.

Si vous souhaitez transférer en fonction des contacts ou des groupes du destinataire, ces contacts et groupes doivent être marqués comme Public dans le Phonebook.

Étape 1 : Ouvrir la page SMS to Email

Dans la barre latérale, allez à Automation > Email > SMS to Email.

Étape 2 : Créer une règle

Cliquez sur Create new rule dans le coin supérieur droit. Un panneau latéral s’ouvre.

Nommez la règle

Dans Rule name, tapez quelque chose de descriptif, par exemple Forward all to support. Maximum 100 caractères.

Décidez quels messages transférer

Choisissez Forward for :

Option

Ce que cela signifie

Always forward

Chaque SMS et MMS entrant est transféré.

Expéditeur / message spécifié

Seuls les messages correspondant aux conditions que vous définissez ci-dessous sont transférés.

Si vous avez choisi Expéditeur / message spécifié, deux conditions deviennent disponibles. Vous pouvez en utiliser une ou les deux. Lorsque vous utilisez les deux, un message doit satisfaire aux deux pour être transféré.

Quand un SMS entrant provient de Cochez cette case et sélectionnez les contacts ou groupes dont les messages doivent être transférés. Commencez à taper pour effectuer une recherche. Seuls les contacts et groupes publics peuvent être sélectionnés ici.

Quand le texte SMS entrant contient Cochez cette case et tapez la phrase à rechercher, par exemple URGENT. La phrase peut apparaître n’importe où dans le texte du message. Cochez Respecter la casse si urgent et URGENT doivent être traités différemment.

Limiter la règle à un modem (appareils multi-modems uniquement)

Si votre appareil dispose de plus d’un modem, un champ Quand le message arrive à s’affiche. Laissez-le sur N’importe quel modem, ou sélectionnez un modem spécifique pour que la règle s’applique uniquement aux messages arrivant sur cette carte SIM. Sur les appareils mono-modem, ce champ n’est pas affiché.

Choisissez l’adresse e-mail de destination

Choisissez Type de transfert d’e-mail :

Option

Ce que cela signifie

À une adresse e-mail fixe

Chaque message correspondant est envoyé à l’adresse unique que vous entrez dans Transférer vers l’adresse e-mail.

À l’e-mail du dernier utilisateur expéditeur

Le message est renvoyé à l’adresse e-mail de la personne qui a envoyé en dernier un SMS à ce numéro de téléphone via SMSEagle. Cela ferme la boucle sur une conversation e-mail vers SMS. Entrez une Adresse e-mail par défaut comme secours, utilisée quand il n’y a pas de dernier expéditeur enregistré.

Définir le sujet de l’e-mail

Sujet de l’e-mail contrôle la ligne d’objet de l’e-mail transféré. Vous pouvez utiliser des espaces réservés, qui sont remplacés par des valeurs réelles lors de l’envoi de l’e-mail :

Espace réservé

Remplacé par

{SENDER}

Le numéro de téléphone d’où provient le SMS

{WORDS,X}

Les X premiers mots du texte du message

{CHARS,X}

Les X premiers caractères du texte du message

Exemple : SMS from {SENDER}: {WORDS,5} produit un sujet comme SMS from +48111222333: Server room temperature alarm triggered. Maximum 150 caractères.

Cliquez sur Save. La règle commence à fonctionner immédiatement sur les messages nouvellement reçus.

SMS Forward

Boîte de dialogue Ajouter une règle de transfert pour SMS Forward

Boîte de dialogue Ajouter une règle de transfert

Ce que cette fonction fait

SMS Forward transmet les messages SMS entrants à d’autres personnes. Quand un message arrive, SMSEagle le renvoie aux destinataires que vous choisissez.

Vous pouvez transférer le message exactement tel qu’il a été reçu, ou le remplacer par votre propre texte. Vous pouvez également ajouter un appel vocal au-dessus du SMS transféré, afin qu’une alerte ne puisse pas être ignorée.

Utilisations typiques : envoyer des messages d’alarme d’une machine à toute l’équipe d’astreinte, transmettre des messages d’un numéro partagé à la personne actuellement de service, ou convertir un court code machine en phrase lisible pour l’équipe.

Avant de commencer

  • Les contacts et groupes vers lesquels vous transférez doivent exister dans l”Annuaire. Les contacts et groupes utilisés comme destinataires de transfert ou comme conditions d’expéditeur doivent être marqués comme Public.

  • Décidez si les destinataires ont besoin du libellé original ou d’un message reformulé.

Étape 1 : Ouvrir la page SMS Forward

Dans la barre latérale, allez à Automation > SMS > SMS Forward.

Étape 2 : Créer une règle

Cliquez sur Create new rule dans le coin supérieur droit. Un panneau latéral s’ouvre.

Nommez la règle et définissez sa priorité

Rule name Quelque chose de descriptif, par exemple Alarms to on-call team. 100 caractères maximum.

Priority Un nombre de 0 à 9. Les messages produits par une règle de priorité plus élevée sont mis en file d’attente pour l’envoi avant les messages d’une règle de priorité plus faible. Laissez la valeur par défaut à moins que vous ayez des règles urgentes qui doivent dépasser les règles en masse.

Décidez quels messages transférer

Choisissez Forward for :

Option

Ce que cela signifie

All incoming messages

Chaque SMS entrant est transféré.

Expéditeur / message spécifié

Seuls les messages correspondant aux conditions que vous définissez ci-dessous sont transférés.

Si vous avez choisi Expéditeur / message spécifié, deux conditions deviennent disponibles. Vous pouvez en utiliser une ou les deux. Lorsque vous utilisez les deux, un message doit satisfaire aux deux pour être transféré.

When incoming SMS comes from Cochez cette case et sélectionnez les contacts ou groupes d’expéditeurs dans Sender contacts. Seuls les contacts et groupes publics peuvent être sélectionnés ici.

When incoming SMS text contains Cochez cette case et tapez la phrase dans Text fragment, par exemple ALARM. La phrase peut apparaître n’importe où dans le message. Cochez Case sensitive si alarm et ALARM doivent être traités comme différents.

Limiter la règle à un modem (appareils multi-modems uniquement)

Si votre appareil possède plus d’un modem, un champ When messages comes to s’affiche. Laissez-le sur la valeur par défaut ou choisissez un modem spécifique afin que la règle ne s’applique qu’aux messages arrivant sur cette carte SIM. Sur les appareils monomodem, ce champ n’est pas affiché.

Choisissez ce que dit le message transféré

Utilisez Message content :

Option A : Message original

Les destinataires reçoivent le texte entrant inchangé. Un choix supplémentaire apparaît, Message header :

Option

Résultat

Don’t include

Seul le texte original est transféré.

Include sender

Le numéro de téléphone de l’expéditeur original est ajouté au message transféré, afin que les destinataires sachent d’où il provient.

Option B : Texte personnalisé

Les destinataires reçoivent votre propre texte à la place de l’original. Tapez-le dans Custom message (500 caractères maximum). Vous pouvez incorporer des éléments du message original à l’aide d’espaces réservés :

Espace réservé

Remplacé par

{SENDER}

Le numéro de téléphone d’où provient le SMS

{MESSAGE}

Le texte complet du message original

Exemple : Alarm from {SENDER}. Details: {MESSAGE} envoie une phrase lisible construite autour du texte brut de la machine.

Choisissez les destinataires

Dans Forward to, sélectionnez les contacts ou groupes qui doivent recevoir le message. Commencez à taper pour rechercher. Ce champ est obligatoire, une règle ne peut pas être enregistrée sans au moins un destinataire.

Ajouter optionnellement un appel téléphonique

L’appel après envoi du SMS fait également passer un appel vocal au même groupe de destinataires par l’appareil. Les options disponibles dépendent de votre modèle d’appareil :

Option

Ce qui se passe

Non

Aucun appel n’est effectué. C’est l’option par défaut.

Sonnerie uniquement

L’appareil sonne le destinataire et raccroche. Aucun audio n’est lu.

Oui - synthèse vocale

L’appareil appelle et lit le texte du message.

Oui - synthèse vocale (avancée)

Identique à ce qui précède, en utilisant une voix plus naturelle et sélectionnable. Choisissez la voix dans le champ Voice model qui apparaît.

Si votre appareil ne supporte pas les appels vocaux, seul Non est disponible.

Cliquez sur Save. La règle commence à fonctionner immédiatement sur les messages nouvellement reçus.

Comment fonctionne le transfert

  • La condition de texte est une correspondance contains (contient), non une correspondance exacte. Une règle qui recherche ALARM transfère un message qui dit ROOM 4 ALARM triggered.

  • Si plusieurs règles correspondent au même message entrant, chacune d’elles transfère séparément, afin que les destinataires puissent recevoir plus d’un SMS. Gardez les conditions distinctes pour éviter les doublons.

  • Les règles s’appliquent uniquement aux messages arrivant après la création et l’activation de la règle. Elles ne traitent pas les messages déjà présents dans la boîte de réception.

  • Les destinataires peuvent toujours être ignorés pour leurs propres raisons : Mode vacances sur le contact, un shift actuellement en dehors de ses heures (voir Shifts), ou le numéro figurant sur la liste de refus.

Évitez les boucles de transfert. Ne transférez pas les messages vers un numéro qui lui-même les retransférerait à votre appareil. Deux appareils pointant l’un vers l’autre continueront à s’envoyer des messages sans fin.

Réponses automatiques

Liste des règles de réponse automatique avec la règle par défaut et les options de limite d'envoi

Règles de réponse automatique et options de limite d’envoi

Ce que cette fonction fait

La réponse automatique envoie une réponse textuelle automatique aux messages SMS entrants.

Vous créez des règles qui décident quels messages entrants reçoivent une réponse et ce que dit la réponse. Une règle peut répondre à tout, ou seulement aux messages de certains expéditeurs, ou seulement aux messages contenant une certaine phrase.

Utilisations typiques : confirmer qu’une demande de commande a été reçue, informer les gens que le numéro est sans surveillance la nuit, ou répondre à un mot clé avec des informations fixes telles que les horaires d’ouverture.

Avant de commencer

  • L’appareil doit être capable d’envoyer des SMS. Vérifiez qu’au moins un modem est connecté et enregistré sur le réseau.

  • Si vous voulez répondre uniquement à des expéditeurs spécifiques, ces contacts et groupes doivent être marqués comme Public dans le Phonebook.

Étape 1 : Ouvrir la page Réponses automatiques

Dans la barre latérale, allez à Automation > SMS > Autoreplies.

Sur le côté droit de la page se trouve une boîte Autoreply options. Elle contient un paramètre qui s’applique à toutes les règles, décrit à l”Étape 3.

Étape 2 : Créer une règle

Cliquez sur Create new rule dans le coin supérieur droit. Un panneau latéral s’ouvre.

Nommez la règle

Dans Rule name, tapez quelque chose de descriptif, par exemple Out of hours reply. 100 caractères maximum.

Décider quels messages traiter

Choisir Envoyer une réponse automatique pour :

Option

Ce que cela signifie

All incoming messages

Chaque SMS reçu obtient une réponse.

Expéditeur / message spécifié

Seuls les messages correspondant aux conditions que vous définissez ci-dessous reçoivent une réponse.

Si vous avez choisi Expéditeur / message spécifié, deux conditions deviennent disponibles. Vous pouvez en utiliser une ou les deux. Lorsque vous en utilisez deux, un message doit satisfaire les deux pour obtenir une réponse.

Quand le SMS reçu provient de Cochez cette option et sélectionnez les contacts ou groupes qui doivent recevoir une réponse. Commencez à taper pour rechercher. Seuls les contacts et groupes publics peuvent être sélectionnés ici.

Quand le texte du SMS reçu contient Cochez cette option et saisissez la phrase à rechercher, par exemple PRICE. La phrase peut apparaître n’importe où dans le texte du message. Cochez Sensible à la casse si price et PRICE doivent être traités comme différents.

Limiter la règle à un modem (appareils multi-modems uniquement)

Si votre appareil possède plusieurs de modems, un champ Quand les messages arrivent à apparaît. Laissez-le sur N’importe quel modem, ou sélectionnez un modem spécifique pour que la règle ne réponde qu’aux messages arrivant sur cette carte SIM. Sur les appareils monomodem, ce champ n’est pas affiché.

Rédiger la réponse

Message de réponse automatique Le texte qui est renvoyé. Maximum 2000 caractères. Le même texte est envoyé à tous ceux qui déclenchent cette règle, donc maintenez-le général.

Envoyer en Unicode Cochez cette option si la réponse contient des caractères en dehors de l’alphabet GSM standard, comme des lettres polonaises, allemandes ou cyrilliques. Les messages Unicode contiennent moins de caractères par partie SMS.

Cliquez sur Save. La règle commence à fonctionner immédiatement sur les messages nouvellement reçus.

Étape 3 : Définir la limite d’envoi

La boîte Options de réponse automatique à droite de la page contrôle la fréquence à laquelle l’appareil est disposé à répondre automatiquement au même numéro de téléphone :

Option

Résultat

Toujours envoyer des réponses automatiques

Chaque message correspondant reçoit une réponse, peu importe le nombre qui arrive.

Limiter l’envoi à max 5 messages / 10 minutes / numéro de téléphone

Au maximum 5 réponses automatiques vont au même numéro de téléphone dans 10 minutes. Les messages supplémentaires de ce numéro ne reçoivent pas de réponse jusqu’à ce que la fenêtre passe.

Choisissez l’option que vous souhaitez et cliquez sur Save.

Il est vivement recommandé d’utiliser la limite. Sans elle, deux appareils qui répondent automatiquement tous les deux peuvent finir par se répondre dans une boucle, ce qui consomme rapidement les crédits SMS. La limite est la protection contre cela.

Ce paramètre est global. Il s’applique à chaque règle de réponse automatique sur l’appareil.

Comment fonctionne la correspondance

  • La condition de texte est une correspondance contient, pas une correspondance exacte. Une règle cherchant PRICE répond à un message disant what is the PRICE of item 5.

  • Si plusieurs règles correspondent au même SMS reçu, chacune d’elles envoie sa propre réponse, donc l’expéditeur peut recevoir plus d’un SMS. Gardez les conditions distinctes si vous ne voulez qu’une seule réponse.

  • Les règles s’appliquent uniquement aux messages arrivant après la création et l’activation de la règle. Elles ne traitent pas les messages déjà présents dans la boîte de réception.

SMS périodique

Boîte de dialogue Ajouter une règle SMS périodique avec champs d'intervalle, de message et de destinataire

Boîte de dialogue Ajouter SMS périodique

Ce que cette fonction fait

SMS périodique envoie un message automatiquement selon un calendrier répétitif, sans que personne n’ait besoin de cliquer sur Envoyer. Vous créez une règle une fois, et SMSEagle continue à l’envoyer toutes les heures, tous les jours, toutes les semaines, tous les mois ou tous les ans.

Vous pouvez programmer deux choses :

  • un SMS vers des numéros de téléphone ou vers un groupe du Carnet d’adresses, suivi optionnellement d’un appel téléphonique,

  • un code USSD envoyé à votre opérateur mobile (par exemple pour vérifier le solde prépayé de la carte SIM).

Utilisations typiques : un message quotidien d”« état du système », un rappel hebdomadaire à une équipe de garde, une vérification mensuelle du solde d’une carte SIM prépayée.

Avant de commencer

  • Si vous souhaitez envoyer à un groupe, le groupe doit exister dans Carnet d’adresses > Groupes et être marqué comme Public. Les groupes privés ne peuvent pas être sélectionnés ici.

  • Assurez-vous que l’horloge et le fuseau horaire de l’appareil sont corrects, car la planification suit l’heure de l’appareil. Vérifiez cela dans Paramètres > Date/Heure.

Étape 1 : Ouvrir la page SMS périodique

Dans la barre latérale, allez à Automatisation > SMS > SMS périodique. Vous verrez la liste des règles que vous avez déjà.

Étape 2 : Créer une règle

Cliquez sur Create new rule dans le coin supérieur droit. Un panneau latéral s’ouvre.

Nommez la règle

Dans Nom de la règle, tapez quelque chose que vous reconnaîtrez plus tard, par exemple Daily heartbeat ou Monthly SIM balance. Maximum 100 caractères.

Définir la planification

Choisissez un Intervalle d’envoi. Les champs sous le sélecteur changent selon votre choix :

Intervalle

Ce que vous définissez

Exemple

Toutes les heures

À la minute (par étapes de 5 minutes)

15 envoie à 00:15, 01:15, 02:15 et ainsi de suite

Quotidiennement

À l’heure

07:30 envoie chaque matin à 07:30

Hebdomadairement

Au jour de la semaine et À l’heure

Monday + 08:00 envoie chaque lundi matin

Mensuellement

Au jour du mois et À l’heure

1 + 09:00 envoie le premier jour de chaque mois

Annuellement

Au mois - jour (format mm-dd) et À l’heure

12-24 + 10:00 envoie chaque 24 décembre

Jours qui n’existent pas : si vous planifiez quelque chose pour le jour 31 de chaque mois, il ne sera pas envoyé dans les mois plus courts. Utilisez le jour 28 ou antérieur si le message doit être envoyé chaque mois.

Choisir le modem (appareils multi-modem uniquement)

Si votre appareil dispose de plus d’un modem, un champ Sélection du modem apparaît. Laissez-le par défaut pour laisser SMSEagle choisir, ou sélectionnez un modem spécifique si le message doit passer par une carte SIM particulière. Sur les appareils monodem, ce champ ne s’affiche pas.

Choisir quoi envoyer

Utilisez le commutateur Message type en haut de cette section :

Option A : SMS
  1. Tapez le texte dans SMS Text (maximum 2000 caractères).

  2. Cochez Send as Unicode si le texte contient des caractères en dehors de l’alphabet GSM standard, tels que des lettres polonaises, allemandes ou cyrilliques. Notez que les messages Unicode contiennent moins de caractères par partie SMS.

  3. Sous Send to, choisissez où le message est envoyé :

    • Public groups - commencez à taper le nom d’un groupe et sélectionnez-le dans la liste. Vous pouvez ajouter plusieurs groupes.

    • Input manually - tapez les numéros de téléphone. Séparez plusieurs numéros par des virgules, par exemple +48111222333,+48444555666.

    Vous devez remplir l’un des deux, sinon la règle ne peut pas être enregistrée.

Option B : Code USSD

Tapez le code dans USSD code, par exemple *100#. La réponse de l’opérateur arrive sous forme de message entrant dans votre boîte de réception.

Les codes USSD sont envoyés via le modem à votre opérateur mobile. Les codes disponibles dépendent de l’opérateur, non de SMSEagle.

Ajouter optionnellement un appel téléphonique

Call after sending SMS fait en sorte que l’appareil place également un appel vocal aux mêmes destinataires, ce qui est utile pour les alertes qui ne doivent pas être manquées. Les options disponibles dépendent du modèle de votre appareil :

Option

Ce qui se passe

Non

Aucun appel n’est effectué. C’est l’option par défaut.

Sonnerie uniquement

L’appareil sonne le destinataire et raccroche. Aucun audio n’est lu.

Oui - synthèse vocale

L’appareil appelle et lit le texte du message.

Oui - synthèse vocale (avancée)

Identique à ce qui précède, en utilisant une voix plus naturelle et sélectionnable. Choisissez la voix dans le champ Voice model qui apparaît.

Si votre appareil ne supporte pas les appels vocaux, seul Non est disponible.

Cliquez sur Save. La règle apparaît dans la liste et commence à s’exécuter à son prochain horaire programmé.

Subscriptions

Page des règles d'abonnement, état vide avec bouton Create new rule

Subscriptions

Ce que cette fonction fait

Les abonnements permettent aux gens de rejoindre et quitter un groupe du carnet d’adresses en envoyant un SMS, de la même manière qu’une inscription à une infolettre.

Vous définissez deux mots-clés : l’un qui ajoute l’expéditeur à un groupe, et l’autre qui le supprime. Quand quelqu’un envoie un SMS à votre numéro SMSEagle avec l’un de ces mots-clés, son numéro de téléphone est automatiquement ajouté ou supprimé du groupe. Vous pouvez ensuite envoyer des messages à ce groupe à partir de Compose, de l’API ou d’Email to SMS.

Utilisations typiques : une liste d’alerte publique à laquelle les résidents peuvent s’abonner, ou une liste de notifications de quarts de travail à laquelle le personnel peut s’inscrire sans intervention d’un administrateur.

Avant de commencer

Créez le groupe auquel les gens s’abonneront :

  1. Allez à Phonebook > Groups.

  2. Cliquez sur Add new, donnez un nom au groupe et cochez Set as Public Group.

  3. Cliquez sur Save.

Seuls les groupes publics peuvent être utilisés dans une règle d’abonnement.

Vous devez également dire à vos utilisateurs quel numéro composer et quel mot-clé envoyer. SMSEagle ne fait pas cette publicité automatiquement.

Étape 1 : Ouvrir la page Subscriptions

Dans la barre latérale, allez à Automation > SMS > Subscriptions.

Étape 2 : Créer une règle

Cliquez sur Create new rule dans le coin supérieur droit. Un panneau latéral s’ouvre. Remplissez les champs :

Rule name Quelque chose que vous reconnaîtrez, par exemple Flood alerts opt-in. Maximum 100 caractères.

Groups Commencez à taper et sélectionnez un ou plusieurs groupes. Les abonnés sont ajoutés ou supprimés de tous les groupes listés ici. Seuls les groupes publics peuvent être sélectionnés.

Ajouter le numéro de téléphone aux groupes, lorsque le message entrant est égal à Le mot-clé qui permet à quelqu’un de s’abonner, par exemple JOIN ou START ALERTS. Le mot-clé doit être unique à la règle d’abonnement.

Supprimer le numéro de téléphone des groupes, lorsque le message entrant est égal à Le mot-clé qui permet à quelqu’un de se désabonner, par exemple STOP ou LEAVE.

Sensible à la casse Laissez cette case décochée pour que join, Join et JOIN fonctionnent tous. Cochez-la uniquement si vous avez besoin que le mot-clé corresponde exactement tel que saisi.

Cliquez sur Save.

Comment fonctionne la correspondance

C’est le détail le plus important à communiquer à vos utilisateurs :

Le message entrant complet doit être exactement le mot-clé. Rien d’autre ne doit être dans le message.

Le mot-clé est JOIN

Résultat

L’utilisateur envoie JOIN

Abonné

L’utilisateur envoie join

Abonné (sauf si Sensible à la casse est coché)

L’utilisateur envoie Please JOIN me

Rien ne se passe

L’utilisateur envoie JOIN ALERTS

Rien ne se passe

Pour cette raison, gardez les mots-clés courts et faciles à taper, et demandez à vos utilisateurs d’envoyer uniquement le mot-clé.

Ce qui se passe quand quelqu’un s’abonne

  • Si le numéro de téléphone de l’expéditeur est déjà dans l’Annuaire, ce contact existant est ajouté au groupe.

  • Si le numéro n’est pas dans l’Annuaire, SMSEagle crée automatiquement un nouveau contact pour celui-ci. Le contact est nommé d’après la règle plus le numéro de téléphone, par exemple Flood alerts opt-in +48111222333, et il est créé en tant que contact privé.

Quand quelqu’un se désabonne, il est retiré du groupe, mais le contact lui-même est conservé dans l’Annuaire.

Vous pouvez vérifier qui s’est abonné à tout moment : allez à Annuaire > Groupes, trouvez le groupe et ouvrez Gérer les contacts.

Liste Autoriser / Refuser

Page Liste Autoriser / Refuser avec options de mode Actif et mot STOP global

Options globales de la Liste Autoriser / Refuser

Ce que cette fonction fait

La Liste Autoriser / Refuser filtre le trafic SMS sur votre appareil par numéro de téléphone.

Vous tenez une liste de numéros et choisissez comment l’appareil la traite :

Mode actif

Ce qui se passe

Autoriser les numéros sélectionnés

Seuls les numéros de la liste sont acceptés. Tout le reste est ignoré.

Refuser les numéros sélectionnés

Les numéros de la liste sont ignorés. Tout le reste est accepté.

Désactivé

Aucun filtrage du tout. La liste est conservée mais n’est pas utilisée.

Utilisations typiques : bloquer un numéro qui envoie du spam sur l’appareil (Deny), ou verrouiller une passerelle de sorte que seuls vos propres systèmes d’alarme puissent y accéder (Allow).

Il y a aussi une option STOP word, qui ajoute un expéditeur à la liste automatiquement lorsque son message correspond à une phrase que vous définissez. C’est ce qui fait fonctionner un mot-clé opt-out tel que STOP.

Avant de commencer

Décidez du sens dans lequel vous voulez travailler. Allow selected et Deny selected utilisent deux listes distinctes, donc les règles que vous ajoutez dans un mode ne sont pas visibles dans l’autre. Changer le mode bascule la liste entière, cela ne l’inverse pas.

Étape 1 : Ouvrir la page Allow / Deny List

Dans la barre latérale, allez à Automation > General > Allow / Deny List.

Sur le côté droit se trouve une boîte Global options contenant le paramètre Active mode et la configuration STOP word. Les deux sont décrits ci-dessous.

Étape 2 : Choisir le mode actif

Dans la boîte Global options, définissez Active mode sur Allow selected, Deny selected ou Disabled, puis cliquez sur Save. La page se recharge en affichant la liste qui appartient au mode que vous avez choisi.

Tant que le mode est Disabled, la page affiche un avis « Filtering is disabled » au lieu de la liste, et les règles ne peuvent pas être ajoutées ou modifiées. Passez à Allow selected ou Deny selected pour les gérer à nouveau.

Étape 3 : Ajouter un numéro

Cliquez sur Create new dans le coin supérieur droit. Un panneau latéral s’ouvre.

Phone number Le numéro auquel cette règle s’applique. Maximum 15 caractères. Seuls les chiffres, + et * sont autorisés, et l’entrée doit contenir au moins un chiffre.

Vous pouvez faire correspondre une plage entière de numéros en utilisant * comme caractère générique, qui représente n’importe quel caractère :

Motif

Correspond à

NUMBER

Exactement ce numéro

*NUMBER

Tout numéro se terminant par

NUMBER*

Tout numéro commençant par

*NUMBER*

Tout numéro contenant

Par exemple, 48512* couvre tous les numéros commençant par 48512, et *12345678 correspond au même abonné quel que soit le format du préfixe de pays reçu.

Description Une courte note expliquant pourquoi le numéro figure sur la liste, par exemple Spam ou Alarm panel, HQ. Obligatoire, maximum 255 caractères.

Cliquez sur Save.

Étape 4 : Importer une liste à partir d’un fichier CSV

Si vous avez déjà les numéros dans une feuille de calcul, cliquez sur Import rules dans le coin supérieur droit au lieu de les ajouter un par un.

  1. Préparez un fichier CSV codé en UTF-8 avec exactement deux colonnes, intitulées Number et Reason.

  2. Cliquez sur Import rules, déposez le fichier dans la zone de téléchargement ou cliquez dessus pour parcourir.

  3. Cliquez sur Importer.

Les numéros sont ajoutés à la liste actuellement active.

Étape 5 : Configurer le mot STOP (facultatif)

Le mot STOP ajoute automatiquement les expéditeurs à la liste, ce qui permet aux utilisateurs de se désabonner en envoyant un mot clé.

Dans la zone Global options, cliquez sur Edit config à côté de STOP word. Un panneau latéral s’ouvre. Choisissez Auto add number to list when :

Option

Ce que cela signifie

Jamais

Le mot STOP est désactivé. Les numéros sont ajoutés uniquement manuellement ou par importation.

Le message entrant est égal à…

Le message entier doit être exactement la phrase que vous tapez.

Le message entrant contient…

La phrase peut apparaître n’importe où dans le message.

Si vous choisissez l’une des deux options de correspondance, deux autres champs apparaissent :

  • La phrase elle-même, 160 caractères maximum, par exemple STOP.

  • Autoreply message, 160 caractères maximum. Ce texte est renvoyé au numéro après son ajout à la liste. Laissez vide si vous ne souhaitez pas confirmer le désabonnement.

Cliquez sur Save. Le résumé de la zone Global options affiche désormais la condition active et le texte de réponse automatique.

Utilisez « equals » plutôt que « contains » pour les mots clés de désabonnement. Avec contains, un message ordinaire tel que please stop sending the night reports supprimerait également l’expéditeur.

Fonctionnement du filtrage

  • Le filtre s’applique aux messages arrivant après la création et l’activation de la règle. Il ne retraite pas les messages déjà présents dans la boîte de réception.

  • Une règle désactivée est complètement ignorée, quel que soit le mode actif.

  • Allow selected et Deny selected conservent des listes distinctes. Si vous changez de mode et que la page semble vide, vous consultez l’autre liste, rien n’a été supprimé.

  • Le paramètre du mot STOP est global : il s’applique à la liste actuellement active.

Workflows

Page de liste des workflows, état vide, avec le panneau d'explication Trigger/Condition/Action

Présentation des workflows

Les workflows vous permettent de créer des règles d’automatisation flexibles sans avoir besoin d’une intégration séparée pour chaque combinaison de déclencheur et d’action. Chaque workflow se compose de trois parties :

  • Trigger - l’événement qui démarre la règle : un message SMS, MMS, email, WhatsApp ou Signal entrant (ou un événement de livraison/envoi/erreur d’envoi du modem).

  • Condition - logique facultative qui décide si la règle doit s’exécuter pour un événement donné.

  • Action - ce qui se passe quand la règle s’exécute : envoyer un message SMS, MMS, WhatsApp ou Signal, ou lancer un appel vocal, un appel TTS ou un appel wave.

Où le trouver

Automation > General > Workflows (/automation/workflows/).

Étape 1 : Créer un workflow et choisir un déclencheur

Cliquez sur Create new, donnez un Name au workflow, et choisissez un Trigger : Modem, Email, Signal, WhatsApp, Modem (delivered), Modem (sent), ou Modem (sending error).

Étape 2 : Ajouter des groupes de conditions (facultatif)

Sous Condition groups, cliquez sur Add group pour ajouter une ou plusieurs conditions que l’événement entrant doit respecter avant l’exécution du workflow. Laissez ce champ vide si le workflow doit s’exécuter pour chaque événement correspondant au déclencheur.

Étape 3 : Ajouter des actions

Sous Actions, cliquez sur Add action pour définir ce que le workflow fait lors de son exécution - par exemple, envoyer une réponse, transférer le message vers un autre canal, ou placer un appel.

Cliquez sur Save workflow pour l’activer.

Webhooks

Page Webhooks, état vide, avec le panneau d'explication de la fonctionnalité et l'option d'intervalle de réessai global

Aperçu des webhooks

Ce que cette fonction fait

Un webhook fait appeler par SMSEagle votre système. Chaque fois que quelque chose se produit sur l’appareil (un message arrive, un message est envoyé, un rapport de livraison revient, un appel arrive), l’appareil envoie une requête HTTP(S) à une URL que vous choisissez, en portant les détails en tant que paramètres.

C’est ainsi que vous poussez le trafic SMS dans un système de tickets, un CRM, un chatbot ou votre propre application sans interroger l’API.

Deux intégrations bénéficient d’un support dédié :

Méthode

C’est pour quoi faire

POST (3CX)

Pousser les messages dans un système téléphonique 3CX.

POST (Zabbix)

Reconnaître les événements Zabbix par SMS, afin qu’un ingénieur puisse répondre ACK 12345 pour fermer une alerte.

Avant de commencer

  • Vous avez besoin de l’URL qui recevra les requêtes, accessible depuis l’appareil. Les adresses locales et privées sont rejetées.

  • Votre endpoint doit répondre avec HTTP 200 OK, ou avec les codes d’état que vous configurez dans la règle.

  • Pour Zabbix, vous avez besoin soit d’un jeton API (Zabbix 6.4 et plus récent), soit d’un nom d’utilisateur et d’un mot de passe.

Étape 1 : Ouvrir la page Webhooks

Dans la barre latérale, allez sur Automation > General > Webhooks.

Chaque règle affiche son URL, ce pour quoi elle s’active et, sur les appareils multi-modem, à quel modem elle est limitée. Chaque règle a un commutateur pour l”enable or disable, une action Edit et une action Delete.

La boîte Global options sur la droite contient un paramètre qui s’applique à toutes les règles, décrit dans Étape 6.

Étape 2 : Créer une règle

Cliquez sur Create new dans le coin supérieur droit. Le formulaire webhook s’ouvre en tant que page complète avec trois sections.

Étape 3 : Configuration de base

Champ

Ce qu’il faut entrer

Rule name

Un nom descriptif, maximum 100 caractères.

URL

L’adresse à appeler, maximum 300 caractères, par exemple https://example.com/webhook.

Méthode URL

GET, POST, POST (3CX) ou POST (Zabbix).

Type de contenu

Uniquement pour POST simple : FormData ou JSON.

À (3CX)

Uniquement pour POST (3CX) : la destination dans votre système 3CX.

Cliquez sur Test connection à côté de l’URL pour envoyer une demande d’exemple immédiatement. Le résultat apparaît sous le champ et vous indique le statut HTTP retourné, afin que vous puissiez confirmer que le point de terminaison fonctionne avant d’enregistrer.

Pour GET et POST, un exemple de la chaîne de demande est affiché sous les champs, afin que vous puissiez voir exactement ce que votre point de terminaison recevra.

Contenu de la demande

La demande que votre point de terminaison reçoit contient les détails de l’événement en tant que paramètres. Certains sont envoyés pour chaque événement, d’autres uniquement pour les messages ou uniquement pour les appels.

Toujours envoyé

Paramètre

Ce qu’il contient

sender

Numéro de l’expéditeur.

timestamp

Quand SMSEagle a reçu ou envoyé le message, au format YYYYmmddHHiiss, par exemple 20140531092257.

msgid

L’identifiant de message SMSEagle.

modemno

Le modem sur lequel le message entrant a été reçu, ou celui à partir duquel le message a été envoyé.

apikey

La clé API de votre service, si vous en avez défini une dans les Security settings. Optionnel.

Envoyé pour SMS et MMS uniquement

Paramètre

Ce qu’il contient

text

Contenu du message SMS.

text_binary

Contenu binaire du message SMS.

status

Statut du message.

oid

Valeur de l’identifiant OID assigné à un message sortant avec un numéro de téléphone correspondant. Facultatif.

attachments

Pièces jointes MMS, par exemple [0 => [name => image.png, content-type => image/png, content => wfFWgwOlgBRwdWvsvs=]]. POST uniquement, car une chaîne de requête GET ne peut pas transporter de données de fichier. Facultatif.

Envoyé pour les appels vocaux entrants uniquement

Paramètre

Ce qu’il contient

status

Statut de l’appel entrant : accepted, rejected ou ignored.

Une règle se déclenche pour un seul type d’événement, donc une requête ne contient que les paramètres de ce type. Une règle avec un déclencheur Incoming call, par instance, n’envoie jamais text ou attachments.

Quelle que soit la méthode, SMSEagle s’attend à ce que votre endpoint réponde avec 200 [OK], sauf si vous l’élargissez avec Expected HTTP Status Code(s) dans les Paramètres de sécurité.

Le lien Show Parameter description sur la page des règles ouvre cette même liste dans l’application, ainsi qu’un exemple de requête GET :

?sender=48601123123&timestamp=20140531092257&msgid=431&modemno=1&text=This+is+an+incoming+message

Personnalisation des noms de paramètres

Par défaut, la requête utilise les noms de paramètres SMSEagle listés ci-dessus. Si votre endpoint en attend d’autres, cochez Customize parameter names et tapez votre propre nom à côté de chaque paramètre que vous souhaitez renommer. Tous les paramètres des trois tableaux peuvent être renommés ; ceux que vous laissez vides conservent leur nom par défaut.

Le renommage change uniquement le nom du paramètre dans la requête, jamais sa valeur ou le moment où il est envoyé.

Étape 4 : Conditions de déclenchement

Send request for détermine quel événement déclenche le webhook :

Option

Se déclenche quand

Incoming message

Un SMS ou MMS arrive.

Sent message

Un message sortant a été envoyé.

Delivery report

Un rapport de livraison revient.

Sending error

Un message sortant a échoué.

Incoming call

Un appel arrive.

Send request when affine davantage :

Option

Ce que cela signifie

Always

Chaque événement du type choisi déclenche le webhook.

Pour les expéditeurs spécifiés / quand le texte contient

Seuls les événements correspondant aux conditions ci-dessous le déclenchent.

Si vous avez choisi la deuxième option, deux conditions deviennent disponibles. Vous pouvez utiliser l’une ou l’autre, ou les deux, et un événement doit satisfaire à chaque condition que vous activez.

Quand un SMS entrant provient de Cochez cette option et sélectionnez les contacts ou groupes. Seuls les contacts et groupes publics sont acceptés.

Quand le texte du SMS entrant contient Cochez cette option et tapez la phrase. Cochez Sensible à la casse si les majuscules et minuscules doivent être traitées comme différentes. Cette condition n’est pas disponible pour le déclencheur Appel entrant, car un appel n’a pas de texte.

Sur les appareils multi-modems, Quand le message arrive/provient de limite la règle à un seul modem. Laissez-le sur N’importe quel modem sinon.

Étape 5 : Paramètres de sécurité

Champ

Ce qu’il fait

Clé API de votre service

Une clé facultative envoyée avec la demande, afin que votre point de terminaison puisse vérifier que l’appel provient vraiment de votre appareil.

Code(s) de statut HTTP attendu(s)

Quelles réponses comptent comme un succès. Un ou plusieurs codes à trois chiffres séparés par des virgules, par exemple 200,201,202. La valeur par défaut est 200, maximum 20 caractères.

Autoriser le certificat SSL auto-signé

Accepter un certificat qui n’est pas signé par une autorité publique.

Vérifier l’homologue

Vérifier le certificat du serveur.

Vérifier le nom de l’homologue

Vérifier que le certificat correspond au nom d’hôte.

Tout ce qui ne correspond pas aux codes de statut attendus compte comme une demande échouée et est réessayé selon l’intervalle de nouvelle tentative global.

Règles Zabbix

Si vous avez choisi POST (Zabbix) comme méthode, des champs supplémentaires apparaissent :

  • Action Zabbix - Acknowledge (ACK), Unacknowledge (NOACK) ou les deux. Le panneau affiche le format SMS que l’appareil attend, par exemple ACK 12345 Problem resolved.

  • Type d’authentification - Jeton API (Zabbix 6.4 et plus récent, recommandé) ou Identifiant/Mot de passe pour les versions plus anciennes. Avec un jeton, vous l’entrez dans le champ de clé API ; avec l’identifiant, vous entrez Nom d’utilisateur Zabbix et Mot de passe Zabbix.

  • Valeurs de test - un ID d’événement et un Message utilisés uniquement par Tester la connexion, jamais sauvegardés.

Cliquez sur Save webhook.

Étape 6 : Définir l’intervalle de nouvelle tentative

La boîte Global options sur la page des règles contient Retry interval after failed request, en minutes. Quand une demande échoue, l’appareil attend cette durée avant de réessayer.

Entrez un nombre entier de minutes et cliquez sur Save. Le paramètre est global : il s’applique à chaque règle de webhook sur l’appareil.

Comportement des webhooks

  • Les règles s’appliquent aux événements qui se produisent après la création et l’activation de la règle. Ils ne rejouent pas les messages passés.

  • La condition de texte est une correspondance contient, pas une correspondance exacte.

  • Si plusieurs règles correspondent au même événement, chacune d’elles envoie sa propre requête, donc un message peut atteindre plusieurs points de terminaison.

  • Une requête ne compte comme réussie que si le statut de réponse est l’un des Code(s) de statut HTTP attendu(s). Tout le reste, y compris l’absence de réponse, est un échec et est relancé.

  • Test connection envoie un exemple de charge utile, pas un vrai message, donc il est sûr de l’exécuter sur un point de terminaison de production qui se contente de consigner les informations.

MQTT

Liste des règles MQTT Publish avec une règle transférant tous les messages entrants (valeurs d'exemple)

Règles MQTT Publish

Ce que cette fonction fait

MQTT est le protocole de messagerie utilisé par la plupart des appareils IoT, des capteurs et des systèmes d’automatisation du bâtiment. Les appareils envoient des messages courts à un courtier, chacun étiqueté avec un sujet tel que building/boiler/temperature. Toute personne connectée au courtier peut écouter les sujets qui l’intéressent.

SMSEagle se situe des deux côtés de cette conversation :

Type de règle

Direction

Ce qu’il fait

S’abonner

MQTT vers SMS

Écoute un courtier et transforme les messages MQTT entrants en messages SMS envoyés à vos contacts.

Publier

SMS vers MQTT

Prend les messages SMS entrants et les publie sur un courtier, afin que votre système IoT puisse y réagir.

Utilisations typiques : transformer une alarme de capteur en SMS adressé à l’équipe de maintenance (S’abonner), ou permettre à un technicien d’envoyer un message texte qui est capté par le système d’automatisation (Publier).

Les deux types de règles sont configurés séparément et ne dépendent pas l’un de l’autre. Utilisez celui dont vous avez besoin.

Avant de commencer

Vous avez besoin des paramètres de connexion de votre courtier MQTT : adresse d’hôte, port, et un nom d’utilisateur et un mot de passe si le courtier les exige - configurés une seule fois sous MQTT dans Paramètres, avant de rédiger les règles S’abonner ici.

Pour les règles S’abonner, vous avez également besoin de la liste des sujets à écouter (également définie dans Paramètres). Pour les règles Publier, vous avez besoin du sujet à publier (défini par règle, ci-dessous).


Partie 1 : S’abonner (MQTT vers SMS)

Les règles S’abonner transforment les messages MQTT entrants en SMS, une fois que la connexion du courtier elle-même est configurée dans Paramètres.

Étape 1 : Ouvrir la page des règles S’abonner

Dans la barre latérale, allez à Automation > General > MQTT, puis choisissez Subscribe.

Étape 2 : Créer une règle S’abonner

Cliquez sur Create new rule dans le coin supérieur droit. Un panneau latéral s’ouvre.

Nommez la règle

Dans Rule name, tapez quelque chose de descriptif, par exemple Boiler alarm to maintenance. Maximum 100 caractères.

Décider quels messages MQTT doivent déclencher cette règle

Choisissez Forward for :

Option

Ce que cela signifie

Any message

Chaque message MQTT que l’appareil reçoit déclenche cette règle.

Rubrique/message spécifié

Seuls les messages correspondant aux conditions que vous définissez ci-dessous le déclenchent.

Si vous avez choisi Rubrique/message spécifié, deux conditions deviennent disponibles. Vous pouvez en utiliser une ou les deux. Si vous utilisez les deux, un message doit satisfaire aux deux.

Quand le message entrant a une rubrique Cochez cette case et saisissez la rubrique dans Topic, par exemple building/boiler.

Quand le message entrant contient Cochez cette case et saisissez la phrase dans Message phrase, par exemple ALARM. Cochez Case sensitive si alarm et ALARM doivent être traités comme différents.

Choisissez les destinataires

Dans Forward to, sélectionnez les contacts ou les groupes qui doivent recevoir le SMS. Seuls les contacts et groupes publics peuvent être sélectionnés ici. Ce champ est obligatoire.

Écrivez le texte du SMS

Message format contrôle ce que dit le SMS. Vous le construisez à partir du message MQTT en utilisant des espaces réservés :

Espace réservé

Remplacé par

{TOPIC}

La rubrique sur laquelle le message MQTT est arrivé

{MESSAGE}

Le contenu du message MQTT

La valeur par défaut est {TOPIC}: {MESSAGE}, ce qui produit un SMS comme building/boiler/temperature: 94. Vous pouvez également écrire votre propre phrase autour d’eux, par exemple Boiler warning on {TOPIC}, value {MESSAGE}.

Cochez Send as Unicode si le texte contient des caractères en dehors de l’alphabet GSM standard, tels que des lettres polonaises, allemandes ou cyrilliques.

Options avancées

Cliquez sur Advanced options pour développer cette section. Vous n’en avez pas besoin pour une configuration de base.

  • Modem (appareils multi-modem uniquement) - envoyez le SMS via une carte SIM spécifique au lieu de la carte par défaut.

  • Call after sending SMS - placez également un appel vocal aux mêmes destinataires. Les options sont No, Ring only, Yes - text to speech et Yes - text to speech (advanced), selon ce que votre modèle d’appareil supporte. Avec l’option avancée, vous choisissez également un Voice model.

Cliquez sur Save. La règle commence à fonctionner sur les messages MQTT reçus à partir de maintenant.

Comment fonctionne la correspondance Subscribe

  • La condition Topic est une correspondance contains et ignore les majuscules et les minuscules. Une règle avec la rubrique boiler correspond également à building/boiler/temperature.

  • La case à cocher Case sensitive s’applique uniquement à la phrase du message, jamais à la rubrique.

  • Si plusieurs règles Subscribe correspondent au même message MQTT, chacune d’elles envoie son propre SMS.


Partie 2 : Publish (SMS dans MQTT)

Les règles Publish n’utilisent pas les paramètres du service MQTT sous Settings. Chaque règle porte sa propre connexion au courtier, de sorte que différentes règles peuvent publier sur différents courtiers.

Étape 1 : Ouvrir la page des règles Publish

Dans la barre latérale, allez à Automation > General > MQTT, puis choisissez Publish.

Étape 2 : Créer une règle Publish

Cliquez sur Create new rule dans le coin supérieur droit. Un panneau latéral s’ouvre.

Nommez la règle

Dans Rule name, saisissez quelque chose de descriptif, par exemple Technician commands to automation. Maximum 100 caractères.

Décidez quels messages SMS publier

Choisissez Forward for :

Option

Ce que cela signifie

Any message

Chaque SMS entrant est publié au courtier.

Expéditeur / message spécifié

Seuls les messages correspondant aux conditions que vous définissez ci-dessous sont publiés.

Si vous avez choisi Expéditeur spécifié / message, les conditions ci-dessous deviennent disponibles. Vous pouvez les combiner, et un message doit alors satisfaire à toutes celles que vous activez.

Quand un SMS entrant provient de Cochez cette case et sélectionnez les contacts ou groupes de l’expéditeur. Seuls les contacts et groupes publics peuvent être sélectionnés ici.

Quand le texte du SMS entrant contient Cochez cette case et tapez la phrase dans Fragment de texte. Cochez Sensible à la casse si les majuscules et minuscules doivent être traitées différemment.

Quand les messages arrivent à (appareils multi-modems uniquement) Laissez sur N’importe quel modem, ou choisissez un modem spécifique pour que seuls les messages arrivant sur cette carte SIM soient publiés.

Restreindre une règle Publish par expéditeur est une précaution judicieuse. Sans condition d’expéditeur, quiconque connaît votre numéro peut introduire du contenu dans votre système IoT.

Entrez la connexion au courtier

Remplissez le courtier vers lequel cette règle publie :

Champ

Ce qu’il faut entrer

Hôte

L’adresse du courtier, par exemple test.host.io

Port

Le port du courtier, par exemple 1883. La plage autorisée est de 1 à 65535.

Nom d’utilisateur

L’utilisateur du courtier, si nécessaire. Laissez vide pour un courtier ouvert.

Mot de passe

Le mot de passe du courtier, si nécessaire.

Sujet

Le sujet dans lequel publier, par exemple smseagle/incoming

TLS/SSL

Activez cette option si le courtier utilise une connexion chiffrée.

Vérification du certificat TLS

Laissez activé sauf si le courtier utilise un certificat autosigné que l’appareil ne peut pas valider.

Cliquez sur Save. Les messages SMS entrants qui correspondent à la règle sont maintenant publiés.

Fonctionnement de la correspondance Publish

  • La condition de texte est une correspondance contient, pas une correspondance exacte.

  • Si plusieurs règles Publish correspondent au même SMS, chacune d’entre elles publie, de sorte que le message peut arriver sur plus d’un courtier ou sujet.

  • Les règles s’appliquent uniquement aux messages arrivant après la création et l’activation de la règle. Elles ne traitent pas les messages déjà présents dans la boîte de réception.

Règles de la Boîte de réception

Page Règles de la Boîte de réception, état vide, avec le panneau d'explication de la fonctionnalité

Aperçu des Règles de la Boîte de réception

Les Règles de la Boîte de réception trient automatiquement les messages entrants dans vos dossiers personnalisés (Mes Dossiers), au lieu de tout laisser dans la Boîte de réception principale.

Où le trouver

Automation > Folders > Inbox Rules (/automation/inbox-rules/).

Configuration d’une règle de boîte de réception

Cliquez sur Create new rule. Chaque règle peut correspondre au numéro de l’expéditeur, au contenu du message, ou au modem sur lequel le message est arrivé ; un message correspondant à la règle est déplacé vers le dossier que vous choisissez.

Les règles sont vérifiées dans l’ordre de priorité. Faites glisser une règle vers le haut ou vers le bas en utilisant la poignée à côté de son ID pour contrôler quelle règle est appliquée en premier, et n’oubliez pas d’enregistrer vos modifications après réorganisation.

Nettoyage des dossiers

Page Cleanup Folders, état vide, avec le panneau d'explication de la fonctionnalité

Aperçu du nettoyage des dossiers

Cleanup Folders supprime automatiquement les anciens messages de vos dossiers, afin qu’ils ne s’accumulent pas indéfiniment.

Où le trouver

Automation > Folders > Cleanup Folders (/automation/cleanup-folders/).

Configuration d’une règle de nettoyage

Cliquez sur Create new rule, puis définissez un calendrier (toutes les heures, quotidien, hebdomadaire, mensuel ou annuel), choisissez les dossiers à nettoyer et l’ancienneté d’un message avant sa suppression. Vous pouvez également nettoyer en option les journaux du modem et des messages selon le même calendrier.