Extras

Zustellberichte

Die SMSEagle-Software ermöglicht es Ihnen, Zustellberichte für jede gesendete SMS zu aktivieren. Zustellberichte sind eine Funktion, mit der Sie eine Bestätigung erhalten, dass die SMS auf dem Telefon des Empfängers empfangen wurde.

Um Zustellberichte zu aktivieren, gehen Sie bitte im Web-GUI zum Menü Settings und setzen Sie „Delivery Reports“ auf „Yes“

Sobald Zustellberichte im Web-GUI aktiviert sind, können Sie überprüfen, ob eine SMS an den Empfänger zugestellt wurde:

Im Web-GUI Gehen Sie im Menü Folders > Sent items > öffnen Sie die Nachricht, die Sie überprüfen möchten. Klicken Sie oben rechts in der Nachricht auf „Show Details“. Das Feld „Modem Status“ enthält Informationen zum Zustellstatus

Mit Webhooks Die CallbackURL-Funktion ermöglicht es, einen Webhook für die Änderung des Zustellstatus zu definieren. Webhooks sind standardmäßige HTTP-Endpunkte, die in Ihrer externen Anwendung implementiert sind und HTTP-Anfragen vom SMSEagle-Gerät akzeptieren. Webhooks ersparen es Ihnen, kontinuierlich Anfragen an das SMSEagle-Gerät zu senden, um den Nachrichtenstatus abzufragen. Weitere Details finden Sie im Kapitel Callback URL dieses Benutzerhandbuchs.
Mit API

Verwenden Sie die Methode „read_sms“, um Daten für eine ausgewählte SMS im Ordner sentitems abzurufen. Die Daten enthalten die Spalten „Status“ und „DeliveryDateTime“ mit Informationen zum Zustellstatus der Nachricht. Weitere Informationen zu möglichen Werten der Spalte „Status“ finden Sie in der Tabelle „Field Description Of Response Data – Sentitems Folder“ in der APIv1-Referenz.

Direkte Verbindung zur SMSEagle-Datenbank

Die Datenbank von SMSEagle läuft auf der PostgreSQL-Datenbank-Engine. Sie können einen direkten Datenbankzugriff nutzen, um SMS-Nachrichten direkt über SQL-Abfragen aus der Datenbank zu lesen bzw. in diese zu schreiben.

Der Datenbankzugriff für externe Anwendungen ist standardmäßig deaktiviert. Um ihn zu aktivieren, gehen Sie im webGUI zum Menü Settings und aktivieren Sie die folgende Einstellung:

Sobald der Datenbankzugriff aktiviert ist, können Sie sich von einer externen Anwendung aus mit den folgenden Zugangsdaten mit der Datenbank verbinden:

Host: IP-Adresse Ihres Geräts
Datenbankname: smseagle
Benutzer: smseagleuser
Passwort: postgreeagle

Einfügen einer kurzen SMS mittels SQL

Das einfachste Beispiel ist eine kurze Textnachricht (begrenzt auf 160 Zeichen):

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;

Im obigen Beispiel gehört die Nachricht zum Benutzer mit id_user 1 (standardmäßig ‚admin‘). Die id_user-Werte für andere Benutzer finden Sie in der Tabelle public.“user“. Das Feld SenderID enthält die Identifikationsnummer des SMSEagle-Modems. Für Modem 1 gilt SenderID = smseagle1 und für Modem 2 SenderID = smseagle2.

Einfügen einer langen SMS mittels SQL

Das Einfügen mehrteiliger Nachrichten ist etwas komplizierter, Sie müssen auch einen UDH-Header konstruieren und diesen hexadezimal geschrieben im UDH-Feld speichern. Sofern Sie keinen guten Grund haben, dies manuell zu tun, verwenden Sie die API.

Bei einer langen Textnachricht beginnt der UDH mit 050003, gefolgt von einem Byte als Nachrichtenreferenz (Sie können hier einen beliebigen Hex-Wert einsetzen, er sollte jedoch für jede Nachricht unterschiedlich sein, im folgenden Beispiel D3), einem Byte für die Anzahl der Nachrichten (im Beispiel 02, es sollte für jede Nachricht, die Sie an dieselbe Telefonnummer senden, eindeutig sein) und einem Byte für die Nummer der aktuellen Nachricht (01 für die erste Nachricht, 02 für die zweite usw.).

Eine lange Textnachricht mit zwei Teilen könnte beispielsweise wie folgt aussehen:

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;

Hinweis: Das Hinzufügen des UDH bedeutet, dass Ihnen weniger Platz für Text zur Verfügung steht, im obigen Beispiel können Sie in einer einzelnen Nachricht nur 153 Zeichen verwenden.

Datenbank-Bereinigungsskripte

Wir haben einige nützliche Skripte hinzugefügt, mit denen SMS-Nachrichten über die Linux-CLI aus der Datenbank gelöscht werden können. Die Skripte befinden sich im folgenden Verzeichnis: /mnt/nand-user/scripts/

db_delete – Skript zum Löschen von SMS aus den Ordnern Inbox, SentItems, die älter als das angegebene Datum sind. Verwendung: ./db_delete YYYYMMDDhhmm
db_delete_7days – Skript zum Löschen von SMS aus den Ordnern Inbox, SentItems, die älter als 7 Tage sind. Verwendung: ./db_delete_7days
db_delete_allfolders – Skript zum Bereinigen der PostgreSQL-Datenbankordner (Inbox, SentItems, Outbox). Speziell dafür ausgelegt, regelmäßig über cron ausgeführt zu werden. Verwendung: ./db_delete_allfolders
db_delete_select - Skript zum Löschen von SMS aus einem gewählten Datenbankordner (Inbox, Outbox, SentItems, Trash). Verwendung: ./db_delete_select {inbox|outbox|sentitems|trash}

Hinzufügen des Skripts zum System-cron-Daemon

Erstellen Sie eine Datei im Verzeichnis /etc/cron.d/ mit dem gewünschten Namen (z. B. pico db_cleaner)

Beispielinhalt dieser Datei: 0 0 1 * * root /mnt/nand-user/scripts/db_delete_allfolders

Dadurch wird das Bereinigungsskript jeden 1^sten Tag des Monats ausgeführt.

SNMP-Agent

„Simple Network Management Protocol (SNMP) ist ein Internet-Standardprotokoll zur Verwaltung von Geräten in IP-Netzwerken. Es wird hauptsächlich in Netzwerkmanagementsystemen eingesetzt, um netzwerkgebundene Geräte auf Zustände zu überwachen, die administrative Aufmerksamkeit erfordern“ (Quelle: Wikipedia).

Das SMSEagle-Gerät verfügt über einen integrierten Net-SNMP-Agenten. Der SNMP-Agent bietet Zugriff auf den Linux Host MIB-Baum des Geräts und ermöglicht zusätzlich (unter Verwendung der Erweiterung NET-SNMP-EXTEND-MIB) den Zugriff auf benutzerdefinierte, SMSEagle-spezifische Metriken.

Verfügbare SNMP-Metriken, die den Zustand eines SMSEagle-Geräts beschreiben, sind:

Metrikname	Beschreibung	OID
GSM_Signal1	Gibt die 3G/4G-Signalstärke in Prozent für Modem 1 zurück. Wertebereich: 0-100. Wenn das Modem vom Mobilfunknetz getrennt ist, gibt GSM_Signal 0 zurück.	.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]	Gibt die 3G/4G-Signalstärke in Prozent für Modem X zurück. Wertebereich: 0-100. Wenn das Modem vom Mobilfunknetz getrennt ist, gibt GSM_Signal 0 zurück.	.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	Gibt den Namen des Mobilfunknetzes auf Modem 1 zurück	.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]	Gibt den auf Modem X verwendeten Mobilfunknetznamen zurück	.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], wobei X die Nummer des Modems ist	Gibt Informationen zum Modemstatus (aktiviert/deaktiviert) zurück	.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 (für 1. 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 (für 2. Modem)
FolderOutbox_Total	Gibt die Anzahl der SMS-Nachrichten im Ordner Outbox zurück (Länge der ausgehenden Warteschlange)	.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	Gibt die Anzahl der SMS-Nachrichten im Ordner Inbox zurück	.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	Gibt die Anzahl der vom Gerät innerhalb der letzten 24 Stunden gesendeten SMS-Nachrichten zurück	.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	Gibt die Anzahl der vom Gerät innerhalb des letzten Monats gesendeten SMS-Nachrichten zurück	.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	Gibt die Anzahl der mit Fehler gesendeten SMS-Nachrichten innerhalb der letzten 24 Stunden zurück. Ein Fehler tritt auf, wenn das 3G-Modem die SMS-Nachricht nicht senden kann oder die Nachricht vom 3G/4G-Netzbetreiber abgelehnt wird (meist der Fall, wenn das Guthaben einer Prepaid-SIM-Karte aufgebraucht ist)	.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	Gibt den letzten Temperaturwert (in °C) des internen DHT22-Sensors zurück. Erfordert, dass der Sensor aktiviert ist.	.1.3.6.1.4.1.8072.1.3.2.4.1.2.4.84.101.109.112.1
Humidity	Gibt den letzten Luftfeuchtigkeitswert (in %) des internen DHT22-Sensors zurück. Erfordert, dass der Sensor aktiviert ist.	.1.3.6.1.4.1.8072.1.3.2.3.1.2.8.72.117.109.105.100.105.116.121
Temp[X] where X is between 1 and 4	Gibt den letzten Temperaturwert (in °C) zurück von: Temp1: internem Temperatursensor Temp2-Temp4: externen 1-Wire-Temperatursensoren.	.1.3.6.1.4.1.8072.1.3.2.4.1.2.5.84.101.109.112.49.1 (for 1st sensor) .1.3.6.1.4.1.8072.1.3.2.4.1.2.5.84.101.109.112.50.1 (for 2nd sensor) etc.
SIM_State[X] where X is the no of modem	Gibt Informationen zum physischen SIM-Status zurück	.1.3.6.1.4.1.8072.1.3.2.3.1.2.10.83.73.77.95.83.116.97.116.101.49 (for 1st 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 (for 2nd modem)
SIM_RegState[X] where X is the no of modem	Gibt Informationen zum Registrierungsstatus der SIM-Karte im Mobilfunknetz zurück.	.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 (for 1st 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 (for 2nd modem)

Ergebniswerte

Verwendung der OID

Ergebniswerte für jede benutzerdefinierte Metrik stehen zur Verfügung und können über die in der obigen Tabelle angegebene OID abgerufen werden.

Verwendung des Textnamens

Alternativ können Ergebniswerte für jede benutzerdefinierte Metrik über Textnamen aus dem OID-Baum unter: NET-SNMP-EXTEND-MIB::nsExtendOutputFull.“[METRIC NAME]“ abgerufen werden.

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

Falls Ihr gewähltes SNMP-Tool nicht auf NET-SNMP-EXTEND-MIB-Objekte zugreifen kann, können Sie die MIB-Definitionen herunterladen von: https://www.smseagle.eu/download/NET-SNMP-EXTEND-MIB.txt

Ergebniswerte auslesen Um die Parameterwerte testweise vom SNMP-Agenten auszulesen, können Sie jedes verfügbare Tool für das SNMP-Protokoll verwenden (zum Beispiel: NET-SNMP-Bibliothek für Linux oder iReasoning MiB-Browser für Windows).