Extras

Rapports de livraison

Le logiciel SMSEagle vous permet d’activer les rapports de livraison pour chaque SMS envoyé. Les rapports de livraison sont une fonctionnalité qui permet de recevoir une confirmation que le SMS a été reçu sur le téléphone du destinataire.

Afin d’activer les rapports de livraison, veuillez aller dans le web-GUI > menu Settings et définir « Delivery Reports » sur « Yes »

Une fois les rapports de livraison activés dans le web-GUI, vous pouvez vérifier si le SMS a été livré au destinataire :

Dans le web-GUI Dans le menu Folders > Sent items > ouvrez le message que vous souhaitez vérifier. Appuyez sur « Show Details » dans le coin supérieur droit du message. Le champ « Modem Status » contient des informations sur le statut de livraison

En utilisant les Webhooks La fonctionnalité CallbackURL permet de définir un webhook pour le changement de statut de livraison. Les webhooks sont des points de terminaison HTTP standards implémentés dans votre application externe qui accepteront les requêtes HTTP provenant de l’appareil SMSEagle. Les webhooks vous évitent d’avoir à envoyer continuellement des requêtes à l’appareil SMSEagle pour demander le statut du message. Voir plus de détails dans le chapitre Callback URL de ce Manuel d’utilisation.
En utilisant l’API

Utilisez la méthode « read_sms » pour récupérer les données d’un SMS sélectionné dans le dossier sentitems. Les données contiendront les colonnes « Status » et « DeliveryDateTime » qui contiennent des informations sur le statut de livraison du message. Pour plus d’informations sur les valeurs possibles de la colonne « Status », veuillez vous référer au tableau « Field Description Of Response Data – Sentitems Folder » dans la Référence APIv1.

Connexion directe à la base de données SMSEagle

La base de données de SMSEagle fonctionne sur le moteur de base de données PostgreSQL. Vous pouvez utiliser un accès direct à la base de données pour lire/écrire des messages SMS directement depuis/vers la base de données via des requêtes SQL.

L’accès à la base de données pour les applications externes est désactivé par défaut. Afin de l’activer, allez dans webGUI > menu Settings et activez le paramètre suivant :

Une fois l’accès à la base de données activé, il est possible de se connecter à la base de données depuis une application externe en utilisant les identifiants suivants :

Host : adresse IP de votre appareil
Nom de la base de données : smseagle
Utilisateur : smseagleuser
Mot de passe : postgreeagle

Injection d’un SMS court en utilisant SQL

L’exemple le plus simple est un message texte court (limité à 160 caractères) :

INSERT INTO outbox (
    DestinationNumber,
    TextDecoded,
    CreatorID,
    Coding,
    Class,
    SenderID
) VALUES (
    '1234567',
    'This is a SQL test message',
    'Program',
    'Default_No_Compression',
    -1,
    'smseagle1'
);
INSERT INTO user_outbox (
    id_outbox,
    id_user
) SELECT CURRVAL(pg_get_serial_sequence('outbox','ID')), 1;

Dans l’exemple ci-dessus, le message appartiendra à l’utilisateur avec id_user 1 (par défaut “admin”). Vous pouvez trouver les valeurs id_user des autres utilisateurs dans la table public. »user ». Le champ SenderID contient le numéro d’identification du modem SMSEagle. Pour le modem 1, SenderID = smseagle1 et pour le modem 2, SenderID = smseagle2.

Injection d’un SMS long en utilisant SQL

L’insertion de messages multipartites est un peu plus délicate, vous devez également construire un en-tête UDH et le stocker écrit en hexadécimal dans le champ UDH. À moins que vous n’ayez une bonne raison de le faire manuellement, utilisez l’API.

Pour un message texte long, l’UDH commence par 050003 suivi d’un octet servant de référence de message (vous pouvez y mettre n’importe quelle valeur hexadécimale, mais elle doit être différente pour chaque message, D3 dans l’exemple suivant), d’un octet pour le nombre de messages (02 dans l’exemple, il doit être unique pour chaque message que vous envoyez au même numéro de téléphone) et d’un octet pour le numéro du message actuel (01 pour le premier message, 02 pour le second, etc.).

Par exemple, un message texte long en deux parties pourrait ressembler à ceci :

INSERT INTO outbox (
    "DestinationNumber",
    "CreatorID",
    "MultiPart",
    "UDH",
    "TextDecoded",
    "Coding",
    "Class",
    "SenderID"
) VALUES (
    '1234567',
    'Program',
    'true',
    '050003D30201',
    'Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, qui',
    'Default_No_Compression',
    -1,
    'smseagle1'
)
INSERT INTO outbox_multipart (
    "ID",
    "SequencePosition",
    "UDH",
    "TextDecoded",
    "Coding",
    "Class"
) SELECT
    CURRVAL(pg_get_serial_sequence('outbox','ID')),
    2,
    '050003D30202',
    's nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.',
    'Default_No_Compression',
    -1;
INSERT INTO user_outbox (
    id_outbox,
    id_user
) SELECT
    CURRVAL(pg_get_serial_sequence('outbox','ID')),
    1;

Remarque : Ajouter un UDH signifie que vous avez moins d’espace pour le texte, dans l’exemple ci-dessus vous ne pouvez utiliser que 153 caractères dans un seul message.

Scripts de nettoyage de la base de données

Nous avons ajouté quelques scripts utiles qui peuvent être utilisés pour supprimer des messages SMS de la base de données via la CLI Linux. Les scripts se trouvent dans le répertoire suivant : /mnt/nand-user/scripts/

db_delete – script pour supprimer les SMS des dossiers Inbox, SentItems plus anciens que la date fournie. Utilisation : ./db_delete YYYYMMDDhhmm
db_delete_7days – script pour supprimer les SMS des dossiers Inbox, Sentitems plus anciens que 7 jours. Utilisation : ./db_delete_7days
db_delete_allfolders – script pour nettoyer les dossiers de la base de données PostgreSQL (Inbox, SentItems, Outbox). Spécialement conçu pour être exécuté périodiquement via cron. Utilisation : ./db_delete_allfolders
db_delete_select - script pour supprimer les SMS du dossier de base de données choisi (Inbox, Outbox, SentItems, Trash). Utilisation : ./db_delete_select {inbox|outbox|sentitems|trash}

Ajout du script au démon système cron

Créez un fichier dans le répertoire /etc/cron.d/ avec le nom souhaité (par ex. pico db_cleaner)

Exemple de contenu de ce fichier : 0 0 1 * * root /mnt/nand-user/scripts/db_delete_allfolders

Ceci exécutera le script de nettoyage chaque 1^er jour du mois.

Agent SNMP

“Simple Network Management Protocol (SNMP) est un protocole standard Internet pour la gestion des périphériques sur les réseaux IP. Il est principalement utilisé dans les systèmes de gestion de réseau pour surveiller les appareils connectés au réseau et détecter les conditions nécessitant une attention administrative” (source : Wikipedia).

L’appareil SMSEagle dispose d’un agent Net-SNMP intégré. L’agent SNMP donne accès à l’arborescence MIB Linux Host de l’appareil, et permet en outre (grâce à l’extension NET-SNMP-EXTEND-MIB) d’accéder à des métriques personnalisées spécifiques à SMSEagle.

Les métriques SNMP disponibles décrivant l’état d’un appareil SMSEagle sont :

Nom de la métrique	Description	OID
GSM_Signal1	Renvoie la force du signal 3G/4G en pourcentage pour le modem 1. Plage de valeurs : 0-100. Si le modem est déconnecté du réseau cellulaire, GSM_Signal renvoie 0.	.1.3.6.1.4.1.8072.1.3.2.3.1.2.11.71.83.77.95.83.105.103.110.97.108.49
GSM_Signal[X]	Renvoie la force du signal 3G/4G en pourcentage pour le modem X. Plage de valeurs : 0-100. Si le modem est déconnecté du réseau cellulaire, GSM_Signal renvoie 0.	.1.3.6.1.4.1.8072.1.3.2.3.1.2.11.71.83.77.95.83.105.103.110.97.108.[48+X]
GSM_NetName1	Renvoie le nom du réseau cellulaire sur le modem 1	.1.3.6.1.4.1.8072.1.3.2.3.1.2.12.71.83.77.95.78.101.116.78.97.109.101.49
GSM_NetName[X]	Renvoie le nom du réseau cellulaire utilisé sur le modem X	.1.3.6.1.4.1.8072.1.3.2.3.1.2.12.71.83.77.95.78.101.116.78.97.109.101.[48+X]
GSM_ModemState[X] où X est le numéro du modem	Renvoie l’information d’état du modem activé/désactivé	.1.3.6.1.4.1.8072.1.3.2.3.1.2.11.77.111.100.101.109.83.116.97.116.101.49 (pour le 1er modem) .1.3.6.1.4.1.8072.1.3.2.3.1.2.11.77.111.100.101.109.83.116.97.116.101.50 (pour le 2ème modem)
FolderOutbox_Total	Retourne le nombre de messages SMS dans le dossier Outbox (longueur de la file d’attente sortante)	.1.3.6.1.4.1.8072.1.3.2.3.1.2.18.70.111.108.100.101.114.79.117.116.98.111.120.95.84.111.116.97.108
FolderInbox_Total	Retourne le nombre de messages SMS dans le dossier Inbox	.1.3.6.1.4.1.8072.1.3.2.3.1.2.17.70.111.108.100.101.114.73.110.98.111.120.95.84.111.116.97.108
FolderSent_Last24H	Retourne le nombre de messages SMS envoyés depuis l’appareil au cours des dernières 24 heures	.1.3.6.1.4.1.8072.1.3.2.3.1.2.18.70.111.108.100.101.114.83.101.110.116.95.76.97.115.116.50.52.72
FolderSent_Last1M	Retourne le nombre de messages SMS envoyés depuis l’appareil au cours du dernier mois	.1.3.6.1.4.1.8072.1.3.2.3.1.2.17.70.111.108.100.101.114.83.101.110.116.95.76.97.115.116.49.77
FolderSent_Last24HSendErr	Retourne le nombre de messages SMS envoyés avec erreur au cours des dernières 24h. Une erreur se produit lorsque le modem 3G ne peut pas envoyer le message SMS ou lorsque le message est rejeté par l’opérateur 3G/4G (cela se produit surtout lorsque le crédit d’une carte SIM prépayée est épuisé)	.1.3.6.1.4.1.8072.1.3.2.3.1.2.25.70.111.108.100.101.114.83.101.110.116.95.76.97.115.116.50.52.72.83.101.110.100.69.114.114
Temp	Retourne la dernière valeur de température (en °C) issue du capteur DHT22 interne. Nécessite que le capteur soit activé.	.1.3.6.1.4.1.8072.1.3.2.4.1.2.4.84.101.109.112.1
Humidity	Retourne la dernière valeur d’humidité (en %) issue du capteur DHT22 interne. Nécessite que le capteur soit activé.	.1.3.6.1.4.1.8072.1.3.2.3.1.2.8.72.117.109.105.100.105.116.121
Temp[X] où X est compris entre 1 et 4	Retourne la dernière valeur de température (en °C) à partir de : Temp1 : capteur de température interne Temp2-Temp4 : capteurs de température 1-Wire externes.	.1.3.6.1.4.1.8072.1.3.2.4.1.2.5.84.101.109.112.49.1 (pour le 1er capteur) .1.3.6.1.4.1.8072.1.3.2.4.1.2.5.84.101.109.112.50.1 (pour le 2ème capteur) etc.
SIM_State[X] où X est le numéro du modem	Retourne l’information sur l’état physique de la carte SIM	.1.3.6.1.4.1.8072.1.3.2.3.1.2.10.83.73.77.95.83.116.97.116.101.49 (pour le 1er modem) .1.3.6.1.4.1.8072.1.3.2.3.1.2.10.83.73.77.95.83.116.97.116.101.50 (pour le 2ème modem)
SIM_RegState[X] où X est le numéro du modem	Retourne l’information sur l’état d’enregistrement de la carte SIM dans le réseau mobile.	.1.3.6.1.4.1.8072.1.3.2.3.1.2.13.83.73.77.95.82.101.103.83.116.97.116.101.49 (pour le 1er modem) .1.3.6.1.4.1.8072.1.3.2.3.1.2.13.83.73.77.95.82.101.103.83.116.97.116.101.50 (pour le 2ème modem)

Valeurs de résultat

Utilisation de l’OID

Les valeurs de résultat pour chaque métrique personnalisée sont disponibles et peuvent être récupérées à partir de l’OID indiqué dans le tableau ci-dessus.

Utilisation du nom textuel

Alternativement, les valeurs de résultat pour chaque métrique personnalisée peuvent être récupérées en utilisant les noms textuels de l’arborescence OID sous : NET-SNMP-EXTEND-MIB::nsExtendOutputFull. »[METRIC NAME] »

For example:
Result value for parameter GSM_Signal1:
NET-SNMP-EXTEND-MIB::nsExtendOutputFull. »GSM_Signal1 »

Si l’outil SNMP que vous avez choisi ne peut pas accéder aux objets NET-SNMP-EXTEND-MIB, vous pouvez télécharger les définitions MIB depuis : https://www.smseagle.eu/download/NET-SNMP-EXTEND-MIB.txt

Lecture des valeurs de résultat Afin de tester la lecture des valeurs de paramètres depuis l’agent SNMP, vous pouvez utiliser n’importe quel outil disponible pour le protocole SNMP (par exemple : la bibliothèque NET-SNMP pour Linux ou iReasoning MiB-Browser pour Windows).