Wie man eine SMS in Perl plant

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

wie man eine sms in perl plant
Abbildung 1 - Wie man eine SMS in Perl plant

Perl-Code zum Senden einer geplanten SMS an ein Mobiltelefon

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

SendScheduledSms.pl
use Ozeki::Libs::Rest::Configuration;
use Ozeki::Libs::Rest::MessageApi;
use Ozeki::Libs::Rest::Message;
use DateTime;

my $configuration = new Ozeki::Libs::Rest::Configuration();
$configuration->{ Username } = "http_user";
$configuration->{ Password } = "qwe123";
$configuration->{ ApiUrl } = "http://127.0.0.1:9509/api";

my $msg = new Ozeki::Libs::Rest::Message();
$msg->{ ToAddress } = "+36201111111";
$msg->{ Text } = "Hallo Welt!";
$msg->{ TimeToSend } = DateTime->new(year=>2021,month=>7,day=>2,hour=>16,minute=>0,second=>0)->stringify;

my $api = new Ozeki::Libs::Rest::MessageApi($configuration);

my $result = $api->Send($msg);

print($result->stringify);

Wie man das Perl-SMS-Beispiel verwendet:

Dieses Perl-SMS-Beispiel kann in jeder Perl-Anwendung verwendet werden. Um es zu verwenden, müssen Sie die Ozeki.Libs.Rest-Bibliothek zu Ihrem Projekt hinzufügen. Nachdem die Bibliothek hinzugefügt wurde, müssen Sie die Anweisung "use Ozeki::Libs::Rest;" in den Header-Bereich Ihres Perl-Quellcodes einfügen. Dies ermöglicht Ihnen die Verwendung der Klassen, die von der Ozeki.Libs.Rest-Bibliothek bereitgestellt werden. Sie können die Message-Klasse verwenden, um die SMS zu erstellen. Sie können die MessageApi-Klasse verwenden, um die geplante 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.pl herunterladen

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

Was befindet sich in der SendScheduledSms.pl-Datei?

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

Abbildung 2 - Was befindet sich in SendScheduledSms.pl.zip

Wie man eine geplante SMS von Perl aus sendet (Einfache Anleitung)

Um eine geplante SMS von Perl aus zu senden:

  1. HTTP-API-Benutzer installieren
  2. Die Datei SendScheduledSms.pl.zip herunterladen
  3. Die .zip-Datei aus dem Downloads-Ordner extrahieren
  4. Die Datei SendScheduledSms.pl in einem Texteditor öffnen
  5. Die Datei bearbeiten, um eine SMS von Perl aus zu planen
  6. Ozeki SMS Gateway starten
  7. SendScheduledSms.pl über die Eingabeaufforderung ausführen
  8. Die Protokolle überprüfen

Ozeki SMS Gateway installieren und einen HTTP-API-Benutzer erstellen

Um SMS von Perl aus 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 Perl-Code in Visual Studio entwickeln. Nach der Installation ist der nächste Schritt, Ozeki SMS Gateway mit dem Mobilfunknetz zu verbinden. Sie können eine Test-SMS von der Ozeki-GUI aus senden, um zu überprüfen, ob Ihre Mobilfunknetzverbindung funktioniert. Der letzte Schritt zur Vorbereitung Ihrer Umgebung ist die 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 Perl-Code ausführen.

HTTP-API-URL zum Senden von SMS von Perl aus

Um SMS von Perl aus zu senden, muss Ihre Perl-Anwendung eine HTTP-Anfrage an das SMS-Gateway stellen. Die API-URL wird unten gezeigt. 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 Perl-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 Perl aus

Um den Perl-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 ist: base64(Benutzername+":"+Passwort). In Perl können Sie den folgenden Code verwenden, um diese Kodierung durchzuführen:

my ($self, $Username, $Password) = @_;
my $Username_Password = "${Username}:${Password}";
my $Username_Password_encoded = encode_base64($Username_Password);
return "Basic ${Username_Password_encoded}";
	

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

HTTP-Anforderungsheader zum Senden von SMS aus C#

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 geplanter SMS aus Perl

Um die SMS zu übermitteln, sendet Ihre Perl-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: TE, close
Content-Length: 998
Content-Type: application/json; charset=utf8
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 192.168.0.14:9509
Te: deflate,gzip;q=0.3
User-Agent: libwww-perl/6.43

{
	"messages": [
		{
			"message_id": "ab4c1e78-db41-11eb-8298-c00c4d4e2ea7",
			"to_address": "+36201111111",
			"text": "Hello world 1",
			"create_date": "2021-07-02T14:27:45",
			"valid_until": "2021-07-09T14:27:45",
			"time_to_send": "2021-07-02T14:27:45",
			"submit_report_requested": true,
			"delivery_report_requested": true,
			"view_report_requested": true,
			"tags": []
		},
		{
	  		"message_id": "ab4c4523-db41-11eb-838d-c00c4d4e2ea7",
	  		"to_address": "+36202222222",
	  		"text": "Hello world 2",
	  		"create_date": "2021-07-02T14:27:45",
	  		"valid_until": "2021-07-09T14:27:45",
	  		"time_to_send": "2021-07-02T14:27:45",
	  		"submit_report_requested": true,
	  		"delivery_report_requested": true,
	  		"view_report_requested": true,
	  		"tags": []
		},
		{
			"message_id": "ab4c59cd-db41-11eb-82c0-c00c4d4e2ea7",
			"to_address": "+36203333333",
			"text": "Hello world 3",
			"create_date": "2021-07-02T14:27:45",
			"valid_until": "2021-07-09T14:27:45",
			"time_to_send": "2021-07-02T14:27:45",
			"submit_report_requested": true,
			"delivery_report_requested": true,
			"view_report_requested": true,
			"tags": []
		}
	]
}

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

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

HTTP/1.1 200 OK
User-Agent: OZEKI 10.3.123 (www.myozeki.com)
Content-Type: application/json; charset=utf8
Last-Modified: Fri, 02 Jul 2021 16:00:35 GMT
Server: 10/10.3.123
Transfer-Encoding: chunked

{
	"http_code": 200,
	"response_code": "SUCCESS",
	"response_msg": "Messages queued for delivery.",
	"data": {
	  "total_count": 1,
	  "success_count": 1,
	  "failed_count": 0,
	  "messages": [
	    {
	      "message_id": "7596081e-db3e-11eb-827e-c00c4d4e2ea7",
	      "from_station": "%",
	      "to_address": "+36201111111",
	      "to_station": "%",
	      "text": "Hello world!",
	      "create_date": "2021-07-02 14:04:47",
	      "valid_until": "2021-07-09 14:04:47",
	      "time_to_send": "2021-07-02 16:10:00",
	      "submit_report_requested": true,
	      "delivery_report_requested": true,
	      "view_report_requested": false,
	      "tags": [
	        {
	          "name": "Type",
	          "value": "SMS:TEXT"
	        }
	      ],
	      "status": "SUCCESS"
	    }
	  ]
	}
}

Perl-SMS-Beispiel: SendScheduledSms.pl (Video-Tutorial)

In diesem Video lernen Sie den Download-Prozess der SendScheduledSMS.pl-Projektdatei kennen. Das Video beginnt mit dem Herunterladen des Projektordners. Es führt Sie durch den Aufbau des vollständigen Systems, das Sie sofort nutzen können. Sie werden sehen, was Sie im Terminal anpassen müssen. Das Video ist nur 1:36 Minuten lang, aber sehr detailliert. Sie werden keine Probleme haben, den Schritten zu folgen.

Video 1 - Wie Sie die oben genannte Lösung herunterladen und einrichten (Video-Tutorial)

Der Beispielcode

Der untenstehende Beispielcode ist Teil der SendScheduledSms.pl.zip. Dieser Code sendet geplante SMS-Nachrichten an die Nummer, die in der Variable 'ToAddress' gespeichert ist. Der Text der Nachrichten wird der in der Variable 'Text' enthaltene Text sein. Führen Sie den Code aus, um alle Nachrichten an alle Empfänger zu senden. Wenn Sie mit der Programmiersprache Perl vertraut sind, können Sie den Code gerne nach Ihren Wünschen anpassen.

Abbildung 3 - SendScheduledSms.pl

Wie Sie den Code verwenden (Video-Tutorial)

In diesem Video lernen Sie den Prozess des Ausführens des Codes und des Sendens von SMS-Nachrichten an den Empfänger kennen. Das Video beginnt mit dem geöffneten Code und endet mit dem Protokoll der gesendeten Nachrichten. Am Ende des Videos sehen Sie einen Ordner im Ozeki SMS Gateway mit dem Titel "Aufgeschobene Nachrichten". In diesem Ordner finden Sie alle gesendeten Nachrichten. Das Video ist nur eine Minute lang und führt Sie durch alle Schritte, die Sie benötigen, um die aufgeschobenen Nachrichten zu senden. Das Ozeki SMS Gateway bietet eine sehr intuitive Benutzeroberfläche, sodass Sie keine Probleme haben werden, den Schritten zu folgen.

Video 2 - Wie Sie die SendMultipleSms.pl-Datei verwenden (Video Tutorial)

Zusammenfassung

Der Zweck dieses Artikels war es, die Schritte zur SMS-Planung in Perl mit Hilfe des Ozeki SMS Gateways zu zeigen. Diese Lösung ermöglicht es, Nachrichten zu verschieben, was sehr nützlich sein kann, wenn Sie sicherstellen möchten, dass Sie Kunden nicht stören, wenn diese beschäftigt sind. Auf diese Weise können Sie ein kundenfreundliches Image erreichen und die Effizienz steigern. Die Wahrscheinlichkeit, dass Kunden die Nachrichten lesen, ist höher, wenn sie freie Zeit dafür haben. Es sei auch erwähnt, dass das Ozeki SMS Gateway Ihnen ermöglicht, SMS-Kosten zu verwalten und den SMS-Verkehr im Blick zu behalten.

Vergewissern Sie sich, dass die Lektüre hier nicht endet, besuchen Sie die Tutorial-Seite von Ozeki, wo Sie weitere Informationen zu Themen wie SMS-Löschung in Perl finden.

Das Einzige, was jetzt noch zu tun bleibt, ist das Ozeki SMS Gateway herunterzuladen und loszulegen!

More information