Ce chapitre couvre la section Automatisation de l’interface web, dans le même ordre que l’apparition des règles.

Courrier électronique 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 Courrier électronique vers SMS vous permet de transférer les courriers électroniques 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 sur deux emplacements dans la WebGUI :

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

  • Settings > Channels > Email > Email to SMS (/settings/email/email-to-sms) est l’endroit où vous activez le service et configurez la conversion des courriers électroniques en messages - voir Courrier électronique vers SMS dans Paramètres.

Étape 1 : Comprendre le format d’adresse du destinataire

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

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

PHONE_NUMBER@ADDRESS_OF_SMSEAGLE_GATEWAY

Par exemple : 999888777@gateway.smseagle.eu

Pour transférer à un contact ou 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

À la place de l’adresse IP de la passerelle, vous pouvez utiliser un Nom de domaine pleinement qualifié, défini sous Settings > Channels > Email > Email to SMS > Advanced settings > FQDN hostname. Si Use LDAP contacts est activé ici, le même format NAME@GATEWAY résout également les contacts et groupes définis dans LDAP / Active Directory.

Par défaut, le corps du courrier électronique devient le texte du SMS. Cela dépend du paramètre What to do with email subject dans Paramètres : le sujet peut être ignoré, ajouté au texte du message, utilisé pour l’authentification ou envoyé à la place du corps.

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

Allez à Automation > Email > Email to SMS et cliquez sur Create new rule. Un panneau intitulé Add Email to SMS rule s’ouvre sur la droite.

Champ

Description

Nom de la règle *

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

Transférer pour *

Always send transfère chaque courrier électronique entrant correspondant au format d’adresse. Specified sender / message contains ajoute des conditions de filtrage, voir Étape 3.

Envoyer en utilisant le modem

Quel modem envoie le SMS. Par défaut, c’est Default. Affiché uniquement sur les appareils avec plusieurs modems.

Phrase d’arrêt

Le texte à 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 avoir sélectionné 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 e-mail du texte du message

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

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

Si vous sélectionnez Expéditeur spécifié / le message contient sous Transférer pour, trois conditions indépendantes deviennent disponibles, chacune avec sa propre case à cocher et son champ de texte :

  • Quand l’adresse e-mail entrante contient filtre par l’adresse e-mail de l’expéditeur

  • Quand l’objet du message entrant contient filtre par la ligne d’objet de l’e-mail

  • Quand le contenu du message entrant contient filtre par le corps de l’e-mail

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

Vous pouvez activer une, deux ou les trois conditions. La règle ne s’active que lorsque toutes les conditions activées sont remplies.

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

Chaque règle apparaît en tant que carte dans la liste E-mail vers SMS, affichant :

  • le nom de la règle

  • la condition de transfert, par exemple Transférer quand entrant : l’adresse e-mail contient : …, ou Toujours transférer quand aucune condition n’est définie

  • le modem utilisé pour l’envoi

  • la phrase d’arrêt configurée

  • un bouton bascule activé/désactivé 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 de la règle révèle les actions en bloc : Enable / Disable et Delete.

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

Le panneau d’aide de droite explique les formats d’adresses destinataire, avec un bouton Voir plus qui renvoie vers la page de fonctionnalité sur smseagle.eu.

Email vers 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 vers SMS Poller vérifie périodiquement une boîte aux lettres externe via POP3, IMAP ou IMAP avec OAuth2 (Microsoft 365 / Outlook), et convertit les e-mails qu’il y trouve en messages SMS selon les règles Email vers SMS Poller. Contrairement à Email vers SMS (qui exécute son propre serveur de messagerie et reçoit les e-mails activement), le Poller accède à 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) se font sous Email to SMS Poller dans Paramètres.

Créer 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 si elle transfère tous les e-mails interrogés ou seulement 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 vers Email

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

Règles SMS vers Email

Ce que fait cette fonctionnalité

SMS vers Email transfère les messages SMS et MMS reçus vers 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 seulement les messages de certains expéditeurs, ou seulement les messages contenant une certaine phrase.

Utilisations typiques : le transfert des réponses du personnel de terrain vers une boîte aux lettres d’assistance partagée, ou l’archivage des confirmations d’alerte dans la boîte de réception e-mail d’un système de tickets.

Avant de commencer

SMSEagle a besoin d’une configuration de serveur de messagerie fonctionnelle 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 groupes d’expéditeur, ces contacts et groupes doivent être marqués comme Public dans le Phonebook.

Étape 1 : Ouvrir la page SMS vers 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.

Nommer la règle

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

Décider quels messages transférer

Choisissez Forward for :

Option

Ce que cela signifie

Always forward

Chaque SMS et MMS entrant est transmis.

Expéditeur / message spécifié

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

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, le message doit satisfaire les deux pour être transmis.

Quand un SMS entrant provient de Cochez cette case et sélectionnez les contacts ou groupes dont les messages doivent être transmis. Commencez à taper pour rechercher. 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 à 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 comme différents.

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

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

Choisissez l’adresse e-mail de destination

Choisissez Type de transmission par e-mail :

Option

Ce que cela signifie

À une adresse e-mail fixe

Chaque message correspondant est envoyé à l’une des adresses que vous entrez dans Transmettre à l’adresse e-mail.

À l’e-mail du dernier utilisateur ayant envoyé

Le message revient à l’adresse e-mail de la personne qui a last envoyé 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 solution de secours, utilisée lorsqu’il n’y a pas de dernier expéditeur enregistré.

Définissez l’objet du message e-mail

Objet de l’e-mail contrôle la ligne d’objet de l’e-mail transmis. 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 premiers X mots du texte du message

{CHARS,X}

Les premiers X caractères du texte du message

Exemple : SMS de {SENDER} : {WORDS,5} produit un objet comme SMS de +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 transmission pour SMS Forward

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

Ce que fait cette fonctionnalité

SMS Forward transmet les messages SMS entrants à d’autres personnes. Quand un message arrive, SMSEagle l’envoie de nouveau aux destinataires que vous choisissez.

Vous pouvez transmettre le message exactement tel qu’il a été reçu, ou le remplacer par votre propre texte. Vous pouvez également ajouter un appel vocal en plus du SMS transmis, de sorte qu’une alerte ne puisse pas être ignorée.

Utilisations typiques : envoi de messages d’alarme d’une machine à toute l’équipe de garde, transmission de messages d’un numéro partagé à la personne actuellement de service, ou conversion d’un court code machine en phrase lisible pour l’équipe.

Avant de commencer

  • Les contacts et les groupes vers lesquels vous transférez les messages doivent exister dans le Carnet d’adresses. 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 Transfert SMS

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. Maximum 100 caractères.

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é inférieure. Laissez la valeur par défaut à moins que vous ayez des règles urgentes qui doivent dépasser les règles en masse.

Décider 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 transmis.

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, le message doit satisfaire les deux pour être transmis.

When incoming SMS comes from Cochez cette option et sélectionnez les contacts ou les groupes de l’expéditeur dans Sender contacts. Seuls les contacts et les groupes publics peuvent être sélectionnés ici.

When incoming SMS text contains Cochez cette option 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.

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

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

Choisissez le contenu du 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 au lieu de l’original. Tapez-le dans Custom message (maximum 500 caractères). Vous pouvez extraire des parties du message original avec des 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 les 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

Call after sending SMS place également un appel vocal vers les mêmes destinataires. Les options disponibles dépendent du modèle de votre appareil :

Option

Ce qui se passe

Non

Aucun appel n’est effectué. C’est la valeur par défaut.

Sonnerie uniquement

L’appareil appelle 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, utilisant une voix plus naturelle et sélectionnable. Choisissez la voix dans le champ Voice model qui s’affiche.

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

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

Fonctionnement du transfert

  • La condition de texte est une correspondance de type contains, pas une correspondance exacte. Une règle recherchant ALARM transfère un message disant ROOM 4 ALARM triggered.

  • Si plusieurs règles correspondent au même message entrant, chacune transfère séparément, donc les destinataires peuvent 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à dans la boîte de réception.

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

Évitez les boucles de transfert. Ne transférez pas les messages vers un numéro qui transfère lui-même vers votre appareil. Deux appareils se pointant l’un l’autre continueront à envoyer des messages dans les deux sens.

Autoréponces

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

Règles d’autoréponce et options de limite d’envoi

Ce que fait cette fonctionnalité

Les autoréponces envoient 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 uniquement aux messages provenant de certains expéditeurs, ou uniquement aux messages contenant une certaine phrase.

Usages 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 heures d’ouverture.

Avant de commencer

  • L’appareil doit pouvoir 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 Autoréponces

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

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 dans É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.

Nommer la règle

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

Décider quels messages traiter

Choisir Envoyer réponse automatique pour :

Option

Ce que cela signifie

All incoming messages

Chaque SMS entrant reçoit la 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és, deux conditions deviennent disponibles. Vous pouvez en utiliser une ou les deux. Si vous utilisez les deux, le message doit satisfaire les deux pour recevoir une réponse.

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

Quand le texte du SMS entrant contient Cochez cette option et tapez 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.

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

Si votre appareil dispose de plus d’un modem, 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 réponde uniquement 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, gardez-le donc général.

Envoyer en Unicode Cochez cette option si la réponse contient des caractères en dehors de l’alphabet GSM standard, tels que 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 sur le côté droit 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 les réponses automatiques

Chaque message correspondant reçoit une réponse, quel que soit le nombre reçu.

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

Au maximum 5 réponses automatiques sont envoyées au même numéro de téléphone dans les 10 minutes. Les messages suivants de ce numéro ne sont pas traités jusqu’à ce que la fenêtre passe.

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

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

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

Fonctionnement de la correspondance

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

  • Si plusieurs règles correspondent au même message entrant, chacune d’elles envoie sa propre réponse, de sorte que 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à dans la boîte de réception.

SMS périodique

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

Boîte de dialogue Ajouter SMS périodique

Ce que fait cette fonctionnalité

Les SMS périodiques envoient un message automatiquement selon un calendrier récurrent, sans que quelqu’un n’ait besoin de cliquer sur Envoyer. Vous créez une règle une fois, et SMSEagle continue à l’envoyer chaque heure, jour, semaine, mois ou année.

Vous pouvez planifier deux choses :

  • un SMS vers des numéros de téléphone ou vers un groupe du Carnet d’adresses, optionnellement suivi 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 « système actif », 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 voulez envoyer à un groupe, le groupe doit exister dans Phonebook > Groups 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 l’ordonnancement suit l’heure de l’appareil. Vérifiez cela dans Settings > Date/Time.

Étape 1 : Ouvrir la page Periodic SMS

Dans la barre latérale, allez à Automation > SMS > Periodic SMS. 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.

Nommer la règle

Dans Rule name, tapez quelque chose que vous reconnaîtrez plus tard, par exemple Daily heartbeat ou Monthly SIM balance. Maximum 100 caractères.

Définir l’ordonnancement

Choisissez un Sending interval. Les champs sous le sélecteur changent selon votre choix :

Intervalle

Ce que vous définissez

Exemple

Hourly

At minute (par pas de 5 minutes)

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

Daily

At time

07:30 envoie chaque matin à 07:30

Weekly

At week day et At time

Monday + 08:00 envoie chaque lundi matin

Monthly

At day of month et At time

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

Annually

At month - day (format mm-dd) et At time

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-modems uniquement)

Si votre appareil dispose de plus d’un modem, un champ Modem selection apparaît. Laissez-le par défaut pour laisser SMSEagle choisir, ou choisissez un modem spécifique si le message doit passer par une carte SIM particulière. Sur les appareils mono-modem, ce champ n’est pas affiché.

Choisir ce qu’il faut 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 doit être envoyé :

    • Public groups - commencez à taper un nom de 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, pas de SMSEagle.

Ajouter optionnellement un appel téléphonique

Call after sending SMS fait que l’appareil effectue é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 la valeur par défaut.

Sonnerie uniquement

L’appareil appelle 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, utilisant une voix plus naturelle et sélectionnable. Choisissez la voix dans le champ Voice model qui s’affiche.

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

Cliquez sur Save. La règle apparaît dans la liste et commence à s’exécuter à l’heure suivante programmée.

Abonnements

Page des règles d'abonnement, état vide avec le bouton Créer une nouvelle règle

Règles d’abonnement

Ce que fait cette fonctionnalité

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 : un qui ajoute l’expéditeur à un groupe, et un qui le supprime. Lorsque 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 via Compose, l’API ou Email to SMS.

Utilisations typiques : une liste d’alertes publiques à laquelle les résidents peuvent s’inscrire, ou une liste de notifications d’équipe à laquelle le personnel peut s’inscrire sans intervention d’un administrateur.

Avant de commencer

Créez le groupe auquel les gens vont s’abonner :

  1. Allez dans 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 indiquer à vos utilisateurs quel numéro texte et quel mot-clé envoyer. SMSEagle ne fait pas cela automatiquement.

Étape 1 : Ouvrir la page Abonnements

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 un 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.

Retirer le numéro de téléphone des groupes, quand le message entrant est égal à Le mot-clé qui désinscrit quelqu’un, 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.

Fonctionnement de la correspondance

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

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

Le mot-clé est JOIN

Résultat

L’utilisateur envoie JOIN

Inscrit

L’utilisateur envoie join

Inscrit (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’inscrit

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

  • Si le numéro n’est pas dans le Carnet d’adresses, SMSEagle crée automatiquement un nouveau contact. 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éé comme contact privé.

Quand quelqu’un se désinscrit, il est supprimé du groupe, mais le contact lui-même est conservé dans le Carnet d’adresses.

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

Liste d’autorisation / interdiction

Page Liste d'autorisation / interdiction avec le mode Actif et les options globales du mot STOP

Options globales de la Liste d’autorisation / interdiction

Ce que fait cette fonctionnalité

La Liste d’autorisation / interdiction filtre le trafic SMS sur votre appareil par numéro de téléphone.

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

Mode actif

Ce qui se passe

Autoriser la sélection

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

Refuser la sélection

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

Désactivé

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

Utilisations typiques : bloquer un numéro qui spamme constamment l’appareil (Refuser), ou verrouiller une passerelle pour que seuls vos propres systèmes d’alarme puissent communiquer avec elle (Autoriser).

Il existe également une option mot STOP, qui ajoute automatiquement un expéditeur à la liste quand son message correspond à une phrase que vous définissez. C’est ce qui fait fonctionner un mot clé de désinscription comme STOP.

Avant de commencer

Décidez du sens de fonctionnement souhaité. Autoriser sélectionné et Refuser sélectionné utilisent deux listes distinctes, donc les règles que vous ajoutez dans un mode ne sont pas visibles dans l’autre. Changer de mode bascule toute la liste, ce n’est pas l’inverser.

Étape 1 : Ouvrir la page Liste Autoriser / Refuser

Dans la barre latérale, accédez à Automation > Général > Liste Autoriser / Refuser.

Sur le côté droit se trouve une zone Options globales contenant le paramètre Mode actif et la configuration du mot STOP. Les deux sont décrits ci-dessous.

Étape 2 : Choisir le mode actif

Dans la zone Options globales, définissez Mode actif sur Autoriser sélectionné, Refuser sélectionné ou Désactivé, puis cliquez sur Enregistrer. La page se recharge en affichant la liste appartenant au mode que vous avez choisi.

Quand le mode est Désactivé, la page affiche un avis « Le filtrage est désactivé » à la place de la liste, et les règles ne peuvent pas être ajoutées ou modifiées. Basculez sur Autoriser sélectionné ou Refuser sélectionné pour les gérer à nouveau.

Étape 3 : Ajouter un numéro

Cliquez sur Créer nouveau dans le coin supérieur droit. Un panneau latéral s’ouvre.

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

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

Motif

Correspond à

NUMÉRO

Exactement ce numéro

*NUMÉRO

N’importe quel numéro se terminant par celui-ci

NUMÉRO*

N’importe quel numéro commençant par celui-ci

*NUMÉRO*

N’importe quel numéro le 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 de préfixe de pays qui arrive.

Description Une courte note expliquant pourquoi le numéro est sur la liste, par exemple Spam ou Panneau d'alarme, Siège social. Obligatoire, 255 caractères maximum.

Cliquez sur Save.

Étape 4 : Importer une liste depuis un CSV

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

  1. Préparez un fichier CSV encodé en UTF-8 avec exactement deux colonnes, en-têtes Numéro et Raison.

  2. Cliquez sur Importer des règles, 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-clé STOP (facultatif)

Le mot-clé STOP ajoute automatiquement les numéros à la liste, ce qui permet aux utilisateurs de refuser par texto en utilisant un mot-clé.

Dans la boîte 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

Never

Le mot-clé STOP est désactivé. Les numéros ne sont ajoutés que manuellement ou par importation.

Incoming message equals to…

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

Incoming message contains to…

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

Si vous choisissez l’une des deux options de correspondance, deux champs supplémentaires apparaissent :

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

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

Cliquez sur Save. Le résumé dans la boîte Global options affiche maintenant la condition active et le texte de réponse automatique.

Préférez « equals » à « contains » pour les mots-clés de refus. Avec contains, un message ordinaire comme please stop sending the night reports supprimerait aussi 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 séparées. Si vous changez de mode et que la page semble vide, vous regardez l’autre liste, rien n’a été supprimé.

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

Workflows

Page de liste 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 comprend 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 remise/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 initier 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 que le workflow s’exécute. 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 passer un appel.

Cliquez sur Save workflow pour l’activer.

Webhooks

Page Webhooks, état vide, avec le panneau d'explication des fonctionnalités et l'option d'intervalle de nouvelle tentative global

Aperçu des webhooks

Ce que fait cette fonctionnalité

Un webhook fait que SMSEagle appelle votre système. Chaque fois que quelque chose se passe 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) vers une URL de votre choix, en transportant les détails en tant que paramètres.

C’est ainsi que vous intégrez le trafic SMS dans un système de ticketing, 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

À quoi ça sert

POST (3CX)

Intégrer 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 de statut que vous configurez dans la règle.

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

Étape 1 : Ouvrir la page Webhooks

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

Chaque règle affiche son URL, ce pour quoi elle s’active et, sur les appareils multi-modems, le modem auquel 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 en haut à droite. 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, 100 caractères maximum.

URL

L’adresse à appeler, 300 caractères maximum, 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.

To (3CX)

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

Cliquez sur Test connection à côté de l’URL pour envoyer immédiatement une requête d’exemple. Le résultat s’affiche sous le champ et vous indique le statut HTTP reçu, pour que vous puissiez confirmer que le point de terminaison fonctionne avant d’enregistrer.

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

Contenu de la requête

La requête que votre point de terminaison reçoit contient les détails de l’événement sous forme de 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 Paramètres de sécurité. 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’identificateur OID attribué à 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é uniquement pour les appels vocaux entrants

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 porte que les paramètres de ce type. Une règle avec le déclencheur Incoming call, par exemple, n’envoie jamais text ou attachments.

Quel que soit la méthode, SMSEagle s’attend à ce que votre point de terminaison réponde par 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 point de terminaison en attend d’autres, cochez Customize parameter names et tapez votre propre nom à côté de chaque paramètre que vous souhaitez renommer. Chaque paramètre des trois tableaux peut être renommé ; 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 quand 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 un 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 l’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 en utiliser une ou les deux, et un événement doit satisfaire à chaque condition que vous activez.

Quand le SMS entrant provient de Cochez cette case 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 case et tapez la phrase. Cochez Case sensitive si les majuscules et minuscules doivent être traitées comme différentes. Cette condition n’est pas disponible pour le déclencheur Incoming call, car un appel n’a pas de texte.

Sur les appareils multi-modem, When message comes to/from limite la règle à un seul modem. Laissez-la sur Any modem sinon.

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

Champ

Ce qu’il fait

Clé API de votre service

Une clé optionnelle 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 les certificats SSL auto-signés

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

Vérifier le pair

Vérifier le certificat du serveur.

Vérifier le nom du pair

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 relancé selon l’intervalle de nouvelle tentative global.

Règles Zabbix

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

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

  • Auth type - API Token (Zabbix 6.4 et versions plus récentes, recommandé) ou Login/Password pour les versions plus anciennes. Avec un jeton, vous le saisissez dans le champ clé API ; avec la connexion, vous saisissez Zabbix username et Zabbix password.

  • Test values - un Event ID et un Message utilisés uniquement par Test connection, jamais enregistré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 ce délai 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 webhook sur l’appareil.

Comment se comportent les webhooks

  • Les règles s’appliquent aux événements survenant après la création et l’activation de la règle. Elles ne relisent pas les messages passés.

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

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

  • Une demande n’est considérée comme réussie que si le statut de la réponse est l’un des Expected HTTP Status Code(s). Tout le reste, y compris l’absence de réponse, est un échec et est réessayé.

  • Test connection envoie une charge utile d’exemple, pas un vrai message, il est donc sûr de l’exécuter sur un point de terminaison de production qui enregistre uniquement.

MQTT

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

Règles MQTT Publish

Ce que fait cette fonctionnalité

MQTT est le protocole de messagerie utilisé par la plupart des appareils IoT, des capteurs et des systèmes d’automatisation des bâtiments. Les appareils envoient de courts messages à un courtier, chacun étiqueté avec une rubrique telle que building/boiler/temperature. Quiconque connecté au courtier peut écouter les rubriques qui l’intéressent.

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

Type de règle

Direction

Ce qu’il fait

Subscribe

MQTT vers SMS

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

Publish

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 à l’équipe de maintenance (Subscribe), ou permettre à un technicien d’envoyer un message texte qui est capté par le système d’automatisation (Publish).

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 détails de connexion de votre courtier MQTT : adresse de l’hôte, port, et un nom d’utilisateur et un mot de passe si le courtier les nécessite - configurés une fois sous MQTT dans Paramètres, avant d’écrire des règles Subscribe ici.

Pour les règles Subscribe, vous avez également besoin de la liste des rubriques à écouter (également définie dans Paramètres). Pour les règles Publish, vous avez besoin de la rubrique à publier (définie par règle, ci-dessous).


Partie 1 : Subscribe (MQTT vers SMS)

Les règles Subscribe transforment les messages MQTT entrants en SMS, une fois que la connexion au courtier elle-même est configurée sous Paramètres.

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

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

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

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

Nommer la règle

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

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

Choisissez Forward for :

Option

Ce que cela signifie

Any message

Chaque message MQTT reçu par l’appareil 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. Lorsque vous utilisez les deux, un message doit satisfaire aux deux.

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

Lorsque le message entrant contient Cochez cette case et tapez 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 les groupes publics peuvent être sélectionnés ici. Ce champ est obligatoire.

Rédigez 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}, qui produit un SMS comme building/boiler/temperature: 94. Vous pouvez également rédiger 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-modems uniquement) - envoyez le SMS via une carte SIM spécifique au lieu de celle 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 supporte votre modèle d’appareil. 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 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 vers 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 vers différents courtiers.

Étape 1 : Ouvrez 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.

Nommer la règle

Dans Rule name, tapez 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 à tous ceux 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 Fragments de texte. Cochez Sensible à la casse si les majuscules et les minuscules doivent être traitées comme différentes.

Quand les messages arrivent à (appareils multi-modem uniquement) Laissez sur N’importe quel modem, ou sélectionnez 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, n’importe qui connaissant votre numéro peut pousser du contenu dans votre système IoT.

Entrez la connexion du courtier

Remplissez le courtier auquel 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 1 à 65535.

Nom d’utilisateur

L’utilisateur du courtier, si requis. Laissez vide pour un courtier ouvert.

Mot de passe

Le mot de passe du courtier, si requis.

Sujet

Le sujet à publier, par exemple smseagle/incoming

TLS/SSL

Activez si le courtier utilise une connexion chiffrée.

Vérification du certificat TLS

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

Cliquez sur Save. Les SMS entrants correspondant à la règle sont publiés à partir de maintenant.

Fonctionnement de la correspondance Publish

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

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

  • 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à 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 d’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 par ordre de priorité. Faites glisser une règle vers le haut ou vers le bas à l’aide de 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.

Cleanup Folders

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

Vue d’ensemble de Cleanup Folders

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, quotidienne, hebdomadaire, mensuelle ou annuelle), choisissez les dossiers à nettoyer et l’ancienneté d’un message avant sa suppression. Vous pouvez également nettoyer les journaux de modem et de message selon le même calendrier.