Wie man eine SMS in Node.js plant

Der einfachste Weg, SMS von Node.Js zu versenden, ist die Verwendung der integrierten HTTP/Rest-SMS-API von Ozeki SMS Gateway. Wenn Sie diese API verwenden, senden Sie SMS-Nachrichten, indem Sie eine HTTP-Post-Anfrage an das SMS-Gateway stellen. Die HTTP-Post-Anfrage enthält eine Nachricht im JSON-Format. Das SMS-Gateway sendet diese SMS an die Empfängertelefonnummer und gibt eine HTTP-200-OK-Antwort auf Ihre Anfrage zurück.

wie man eine geplante SMS-Nachricht mit node js sendet
Abbildung 1 - Wie man eine geplante SMS von Node.Js sendet

JavaScript-Code zum Senden einer SMS an ein Mobiltelefon

Das folgende JavaScript-SMS-Codebeispiel zeigt, wie Sie SMS mit der HTTP-Rest-SMS-API von Ozeki SMS Gateway unter Verwendung der JavaScript-Bibliothek Ozeki.Libs.Rest senden können. Diese Bibliothek wird Ihnen kostenlos zur Verfügung gestellt, und Sie können sie in Ihren Projekten verwenden und nach Belieben modifizieren.

SendScheduledSms.mjs 
import { Configuration, Message, MessageApi } from './Ozeki.Libs.Rest.js';


var configuration = new  Configuration();
configuration.Username = "http_user";
configuration.Password = "qwe123";
configuration.ApiUrl = "http://127.0.0.1:9509/api";

var msg = new Message();
msg.ToAddress = "+36201111111";
msg.Text = "Hallo Welt!";
msg.TimeToSend = new Date(Date.UTC(2021, 5, 21, 14, 55, 0));

var api = new MessageApi(configuration);

const result = await api.Send(msg);

console.log(result.toString());

Wie man das JavaScript-SMS-Beispiel verwendet:

Sie können die Message-Klasse verwenden, um die SMS zu erstellen, und die MessageApi-Klasse, um die SMS an das SMS-Gateway zu senden. Das SMS-Gateway leitet Ihre Nachricht entweder über eine drahtlose Verbindung oder über das Internet an das Mobilfunknetz weiter.

SendScheduledSms.js herunterladen

Der in diesem Artikel erklärte Quellcode kann kostenlos heruntergeladen, verwendet und modifiziert werden.
Download: SendScheduledSms.js.zip (4,46Kb)

Was befindet sich in der SendScheduledSms.js.zip-Datei?

Die Datei SendScheduledSms.js.zip enthält die Ozeki.Libs.Rest-Bibliothek, die Ihnen alle notwendigen Werkzeuge zum Senden und Empfangen von SMS-Nachrichten bietet. Sie finden dort auch eine Datei SendScheduledSms.mjs, die den Beispielcode enthält, der Ihnen zeigt, wie Sie eine SMS senden können. Dieser Beispielcode ist unten aufgeführt.

Abbildung 2 - SendScheduledSms.js-Verzeichnis

Dieses Projekt hat Abhängigkeiten, daher müssen Sie vor dem Start das node-fetch-Paket mit dem folgenden Befehl installieren: 

npm install node-fetch

Code 1 - Befehl zur Installation des node-fetch-Pakets

.

Wie man eine geplante SMS von Node.Js sendet (Schnelle Schritte)

Um eine geplante SMS von Node.Js zu senden:

  1. Installieren Sie Ozeki SMS Gateway
  2. Verbinden Sie Ozeki SMS Gateway mit dem Mobilfunknetz
  3. Senden Sie eine Test-SMS über die Ozeki-GUI
  4. Erstellen Sie einen HTTP-SMS-API-Benutzer
  5. Apache NetBeans
  6. Laden Sie das oben genannte Beispielprojekt herunter
  7. Erstellen Sie die SMS, indem Sie ein neues Message-Objekt erstellen
  8. Erstellen Sie eine API, um Ihre Nachricht zu senden
  9. Verwenden Sie die Send-Methode, um Ihre Nachricht zu senden
  10. Lesen Sie die Antwortnachricht auf der Konsole
  11. Überprüfen Sie die Protokolle im SMS-Gateway

Installieren Sie Ozeki SMS Gateway und erstellen Sie einen HTTP-API-Benutzer

Um SMS von Node.Js senden zu können, müssen Sie zunächst Ozeki SMS Gateway installieren. Das SMS-Gateway kann auf demselben Computer installiert werden, auf dem Sie Ihren JavaScript-Code in Visual Studio Code oder einem anderen Code-Editor entwickeln. Nach der Installation ist der nächste Schritt, Ozeki SMS Gateway mit dem Mobilfunknetz zu verbinden. Sie können Erstellung eines HTTP-SMS-API-Benutzerkontos. Erstellen Sie einen Benutzer mit dem Benutzernamen "http_user" und dem Passwort "qwe123", damit das Beispiel ohne Änderungen funktioniert.

Nachdem die Umgebung eingerichtet ist, können Sie Ihren JavaScript-Code ausführen.

HTTP-API-URL zum Senden von SMS von Node.Js

Um SMS von Node.Js zu senden, muss Ihre JavaScript-Anwendung eine HTTP-Anfrage an das SMS-Gateway stellen. Die API-URL wird unten angezeigt. Beachten Sie, dass die IP-Adresse (127.0.0.1) durch die IP-Adresse Ihres SMS-Gateways ersetzt werden sollte. Wenn Ozeki SMS Gateway auf demselben Computer installiert ist, auf dem die JavaScript-SMS-Anwendung läuft, kann dies 127.0.0.1 sein. Wenn es auf einem anderen Computer installiert ist, sollte es die IP-Adresse dieses Computers sein. 

http://127.0.0.1:9509/api?action=rest

HTTP-Authentifizierung zum Senden von SMS von JavaScript

Um den Node.Js-SMS-Client zu authentifizieren, müssen Sie den Benutzernamen und das Passwort in einer base64-kodierten Zeichenkette an den Server in einer HTTP-Anfrage senden. Das verwendete Format lautet: base64(Benutzername+":"+Passwort). In JavaScript können Sie den folgenden Code verwenden, um diese Kodierung durchzuführen: 

var usernamePassword = username + ":" + password;
return `Basic ${Base64.encode(usernamePassword)}`;

Wenn Sie beispielsweise den Benutzernamen 'http_user' und das Passwort 'qwe123' kodieren, erhalten Sie die folgende base64-kodierte Zeichenkette: aHR0cF91c2VyOnF3ZTEyMw==. Um zu senden

HTTP-Anforderungsheader zum Senden von SMS aus JavaScript

Um die SMS-Nachrichten zu senden, müssen Sie die folgenden Zeilen als Header in die HTTP-Anforderung einfügen. Beachten Sie, dass wir einen Content-Type und einen Authorization-Header einbeziehen. 

Content-Type: application/json
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==

HTTP-Anforderung zum Senden von SMS aus Node.Js

Um die SMS zu übermitteln, sendet Ihre Node.Js-Anwendung eine HTTP-Anforderung ähnlich der untenstehenden. Beachten Sie, dass diese Anforderung einen HTTP-Header-Teil und einen HTTP-Body-Teil enthält. Der HTTP-Body ist ein JSON-kodierter Datenstring. Er enthält die Nummer des Empfängers und den Text der Nachricht. 

POST /api?action=sendmsg HTTP/1.1
Connection: close
Content-Length: 319
Content-Type: application/json
Accept: */*
Accept-Encoding: gzip,deflate
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 127.0.0.1:9509
User-Agent: node-fetch/1.0 (+https://github.com/bitinn/node-fetch)
{
    "messages":	[
        {
            "message_id":	"7f9016d5-1e23-d85d-b425-30a435af529e",
            "to_address":	"+36201111111",
            "text":	"Hallo Welt!",
            "create_date":	"2021-06-14T10:16:21",
            "vaild_date":	"2021-06-21T10:16:21",
            "time_to_send":	"2021-06-14T10:20:00",
            "submit_report_requested":	true,
            "delivery_report_requested":	true,
            "view_report_requested":	true
        }
    ]
}

HTTP-Antwort, die vom JavaScript-SMS-Beispiel empfangen wird

Sobald das SMS-Gateway diese Anforderung erhält, wird es eine HTTP-Antwort generieren. Die HTTP-Antwort enthält einen Statuscode, der angibt, ob die SMS-Übermittlungsanforderung erfolgreich war oder nicht. Sie gibt auch eine JSON-kodierte Struktur zurück, die Ihnen nützliche Details über die Übermittlung der Nachricht liefert. 

HTTP/1.1 200 OK
User-Agent: OZEKI 10.3.120 (www.myozeki.com)
Content-Type: application/json; charset=utf8
Last-Modified: Mon, 14 Jun 2021 09:12:00 GMT
Server: 10/10.3.120
Transfer-Encoding: chunked
{
    "http_code": 200,
    "response_code": "SUCCESS",
    "response_msg": "Nachrichten wurden für die Zustellung in die Warteschlange gestellt.",
    "data": {
      "total_count": 1,
      "success_count": 1,
      "failed_count": 0,
      "messages": [
        {
          "message_id": "7f9016d5-1e23-d85d-b425-30a435af529e",
          "from_station": "%",
          "to_address": "+36201111111",
          "to_station": "%",
          "text": "Hallo Welt!",
          "create_date": "2021-06-14 10:16:21",
          "valid_until": "2021-06-21 10:16:21",
          "time_to_send": "2021-06-14 10:20:00",
          "submit_report_requested": true,
          "delivery_report_requested": true,
          "view_report_requested": false,
          "tags": [
            {
              "name": "Typ",
              "value": "SMS:TEXT"
            }
          ],
          "status": "SUCCESS"
        }
      ]
    }
}

Wie man SMS aus Node.Js mit der SMS-API sendet (Video-Tutorial)

Dieses Video zeigt Ihnen, wie Sie das SendScheduledSms.js-Projekt herunterladen und verwenden. Sobald Sie die benötigten Dateien zu Ihrem Projekt hinzugefügt haben, werden Sie möglicherweise feststellen, dass es eine Datei namens Ozeki.Lbis.Rest.js gibt. Dies ist die Datei, die die MessageApi und alles, was Sie benötigen, enthält, um eine SMS mit JavaScript zu senden.

Video 1 - Wie man Ozeki.Libs.Rest herunterlädt und Ihr Projekt einrichtet (Video-Tutorial)

Node.Js SMS-Beispiel: SendScheduledSms.mjs (in Notepad)

Auf Abbildung 3 können Sie den Quellcode des SendScheduledSMS-Projekts sehen, geöffnet in Notepad. Sie können ihn verwenden, um den Code zu bearbeiten, wenn Sie mit der Node.js-Programmiersprache vertraut sind. Ändern Sie die Werte der Variablen, um eine benutzerdefinierte Nachricht an eine benutzerdefinierte Adresse zu senden.

JavaScript-Beispiel zum Senden geplanter SMS
Abbildung 3 - SendScheduledSms.mjs in Notepad

Node.Js SMS-Beispiel: SendScheduledSms.mjs (in Visual Studio Code)

Wenn Sie eine IDE mit Farbkodierung, Erweiterungen und hilfreicher Dokumentation verwenden möchten, nutzen Sie Visual Studio Code (Abbildung 4). Es ist eine kostenlose IDE, die Ihnen hilft, bessere Programme zu erstellen. Wenn Sie mit der Node.js-Programmiersprache vertraut sind, können Sie die Werte der Variablen anpassen, um eine benutzerdefinierte Nachricht an eine benutzerdefinierte Adresse zu senden.

JavaScript-Beispiel zum Senden geplanter SMS
Abbildung 4 - SendScheduledSms.mjs in Visual Studio Code

Wie man überprüft, dass die SMS vom HTTP-Benutzer akzeptiert wurde

Nachdem die SMS übermittelt wurde, ist es eine gute Idee, Ihr SMS-Gateway zu überprüfen, um zu sehen, was es empfangen hat. Sie können das Protokoll einsehen, indem Sie die Details des HTTP-Benutzers aus der Ozeki SMS Gateway Management-Konsole öffnen. Das folgende Video zeigt Ihnen, worauf Sie achten müssen.

Video 2 - Wie man geplante SMS-Nachrichten mit dem obenstehenden JavaScript-Code sendet (Video-Tutorial)

Wie man überprüft, dass die SMS an das Mobilfunknetz gesendet wurde

Der letzte Schritt zur Überprüfung des Vorgangs besteht darin, sich die Protokolle der Mobilfunknetzverbindung anzusehen. Möglicherweise müssen Sie die Protokollierung in der Konfiguration der Verbindung aktivieren, bevor Sie die Nachricht senden, um die Protokolle zu sehen. Wenn die Protokollierung aktiviert ist, werden Sie die Telefonnummer und den Text der gesendeten Nachricht sehen.

Fazit

Die Hauptfunktion dieses Artikels war es, Ihnen zu zeigen, wie Sie geplante SMS-Nachrichten von Node.js aus mit dem HTTP-Benutzer des Ozeki SMS Gateways senden können. Wenn Sie die Schritte aufmerksam verfolgt haben, sollten Sie problemlos SMS-Nachrichten mit Ihrem Node.js-Programm planen können. Um Informationen am effektivsten zu teilen, müssen Sie großen Wert auf das Timing legen, da es den Nachrichtenverkehr ausgewogen halten und eine reibungslosere Kommunikation fördern kann.

Lesen Sie weiterhin Anleitungen auf der Ozeki-Webseite, um mehr über die Entwicklung Ihres Nachrichtensystems zu erfahren. Finden Sie andere Node.js-Tutorials wie Wie man eine SMS in Node.js empfängt und vieles mehr.

Laden Sie das Ozeki SMS Gateway jetzt herunter und legen Sie los!

More information