Wie man SMS von R sendet

Der einfachste Weg, SMS von R zu senden, 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 das Handy des Empfängers und gibt eine HTTP-200-OK-Antwort auf Ihre Anfrage zurück.

Was ist R?

R ist eine Programmiersprache und -umgebung, die hauptsächlich für statistische Berechnungen und Grafiken verwendet wird.

wie man sms von r sendet
Abbildung 1 - Wie man SMS von R sendet

R-Code zum Senden von SMS an Mobiltelefone

Das R-SMS-Codebeispiel unten zeigt, wie Sie SMS mit der HTTP-Rest-SMS-API von Ozeki SMS Gateway unter Verwendung der R-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 modifizieren.

SendSms.R
library(Ozeki.Libs.Rest)


configuration <- Ozeki.Libs.Rest::Configuration$new(
  username = "http_user",
  password = "qwe123",
  api_url = "http://127.0.0.1:9509/api"
)

msg <- Ozeki.Libs.Rest::Message$new()
msg$to_address <- "+36201111111"
msg$text <- "Hello world!"

api <- Ozeki.Libs.Rest::MessageApi$new(configuration)

result <- api$send(msg)

print(result$to_string())
	

Code 1 - SendSms.R

Wie man das R-SMS-Beispiel verwendet:

Dieses R-SMS-Beispiel kann in jeder R-Anwendung verwendet werden. Um es zu verwenden, müssen Sie die Ozeki.Libs.Rest-Bibliothek herunterladen. Nach dem Herunterladen der Bibliothek müssen Sie in Ihrem R-Quellcode einen Verweis darauf hinzufü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 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.

SendSms.R herunterladen

Der in diesem Artikel erklärte Quellcode kann kostenlos heruntergeladen, verwendet und modifiziert werden.
Download: SendSms.R.zip (350B)

Was befindet sich in der SendSms.R.zip-Datei?

In der SendSms.R.zip finden Sie die Datei SendSms.R, die den Beispielcode enthält, der Ihnen zeigt, wie Sie eine SMS senden können. Dieser Beispielcode ist unten aufgeführt.

Abbildung 2 - Was befindet sich in SendSms.R.zip

Wie man die Ozeki.Libs.Rest-Bibliothek mit der Windows-Shell installiert

r
install.packages("devtools")
library(devtools)
install_github('ozekisms/r-send-sms-http-rest-ozeki')
	

Code 2 - Befehl zur Installation der Ozeki.Libs.Rest-Bibliothek

Sie können testen, ob die Bibliothek installiert wurde, indem Sie eingeben:

library(Ozeki.Libs.Rest)
	

Wenn kein Fehler zurückgegeben wurde, wurde die Bibliothek korrekt installiert.

Wie man die Ozeki.Libs.Rest-Bibliothek installiert

In diesem Video zeigen wir Ihnen, wie Sie die Ozeki.Libs.Rest-Bibliothek für die spätere Verwendung installieren. Das Video beginnt mit dem Öffnen der Eingabeaufforderung und führt Sie durch alle installierten Pakete. Das Video ist nur 1:29 Minuten lang, aber sehr detailliert. Dieses Video wird eine große Hilfe im Prozess sein.

Video 1 - Wie man die Ozeki.Libs.Rest-Bibliothek installiert (Video- Tutorial)

Wie man SMS von R sendet (Einfache Anleitung)

Um SMS von R zu senden:

  1. Installieren Sie einen HTTP-API-Benutzer
  2. Aktivieren Sie "Log communication events" auf der Registerkarte "Advanced"
  3. Richten Sie Visual Studio ein
  4. Laden Sie die SendSms.R.zip-Datei herunter und entpacken Sie sie
  5. Starten Sie die Ozeki SMS Gateway App
  6. Führen Sie den R-Code SendSms.R über die Eingabeaufforderung aus
  7. Überprüfen Sie die Protokolle, um zu sehen, ob die SMS gesendet wurde

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

Um SMS von R 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 R-Code in einem beliebigen Texteditor wie Windows Notepad entwickeln. Nach der Installation besteht der nächste Schritt darin, Ozeki SMS Gateway mit dem Mobilfunknetz zu verbinden. Sie können eine Test-SMS von der Ozeki-GUI 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 R-Code ausführen.

HTTP-API-URL zum Senden von SMS von R

Um SMS von R zu senden, muss Ihre R-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 R-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 aus R

Um den R-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 R können Sie den folgenden Code verwenden, um diese Kodierung durchzuführen:

username_password <- paste(username, ":", password, sep="")
username_password_encoded <- base64enc::base64encode(charToRaw(username_password))
return (paste("Basic", username_password_encoded, sep=" "))
	

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

HTTP-Anfrageheader zum Senden von SMS aus R

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

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

HTTP-Anfrage zum Senden von SMS aus R

Um die SMS zu übermitteln, sendet Ihre R-Anwendung eine HTTP-Anfrage ähnlich der untenstehenden. Beachten Sie, dass diese Anfrage einen HTTP-Header-Teil und einen HTTP-Body-Teil enthält. Der HTTP-Body ist eine JSON-kodierte Datenzeichenkette. Sie enthält die Empfängernummer und den Text der Nachricht.

POST /api?action=sendmsg HTTP/1.1
Content-Length: 329
Content-Type: application/json
Accept: application/json
Accept-Encoding: deflate, gzip
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 127.0.0.1:9509
User-Agent: libcurl/7.64.1 r-curl/4.3.2 httr/1.4.2

{
	"messages": [
		{
			"message_id": "38ad4dfe-3fa3-449c-95c9-b5e9c6ce3b62",
			"to_address": "+36201111111",
			"text": "Hello world!",
			"create_date": "2021-07-13T12:46:23",
			"valid_until": "2021-07-20T12:46:23",
			"time_to_send": "2021-07-13T12:46:23",
			"is_submit_report_requested": true,
			"is_delivery_report_requested": true,
			"is_view_report_requested": true
		}
	]
}
	

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

Sobald das SMS-Gateway diese Anfrage empfängt, wird es eine HTTP-Antwort generieren. Die HTTP-Antwort enthält einen Statuscode, der angibt, ob die SMS-Übermittlungsanfrage 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.123 (www.myozeki.com)
Content-Type: application/json; charset=utf8
Last-Modified: Tue, 13 Jul 2021 13:39:07 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": "38ad4dfe-3fa3-449c-95c9-b5e9c6ce3b62",
	      "from_station": "%",
	      "to_address": "+36201111111",
	      "to_station": "%",
	      "text": "Hello world!",
	      "create_date": "2021-07-13 12:46:23",
	      "valid_until": "2021-07-20 12:46:23",
	      "time_to_send": "2021-07-13 12:46:23",
	      "submit_report_requested": true,
	      "delivery_report_requested": false,
	      "view_report_requested": false,
	      "tags": [
	        {
	          "name": "Type",
	          "value": "SMS:TEXT"
	        }
	      ],
	      "status": "SUCCESS"
	    }
	  ]
	}
}
	

Verbinden Sie Ihr SMS-Gateway mit dem Mobilfunknetz und erstellen Sie ein HTTP-API Benutzerkonto (Video-Tutorial)

Wir gehen davon aus, dass Sie bereits Ozeki SMS Gateway installiert haben und es mit dem Mobilfunknetz verbunden haben. Um SMS von R an ein Mobiltelefon senden zu können, müssen Sie ein HTTP-API-Benutzerkonto in Ozeki SMS Gateway einrichten. In diesem Video erklären wir Ihnen den Prozess der Installation einer HTTP-API. Das Video ist nur 30 Sekunden lang und enthält alle Informationen, die Sie zur Einrichtung einer HTTP-API benötigen. Sie erfahren, wie Sie einen neuen Benutzer im Ozeki SMS Gateway erstellen und konfigurieren.

Video 2 - Wie Sie ein HTTP-API-Benutzerkonto einrichten (Video-Tutorial)

Wie Sie SMS aus R mit der R-SMS-API senden (Video-Tutorial)

Dieses Video zeigt Ihnen, wie Sie die Datei SendSms.R.zip von dieser Seite herunterladen. Wenn Sie das Video ansehen, werden Sie feststellen, dass der Inhalt der SendSms.R.zip auf dem Windows-Desktop platziert wird. Sie werden auch sehen, dass wir die Eingabeaufforderung verwenden, um die SMS zu senden. Das Video ist nur 32 Sekunden lang und zeigt alle Schritte, die Sie unternehmen müssen. Wir verwenden in diesem Video das Ozeki SMS Gateway, eine leistungsstarke und dennoch einfach zu erlernende Gateway-Anwendung.

R-SMS-Beispiel: SendSms.R

Der Beispielcode unten ist Teil der SendSms.R.

R-Quellcode zum Senden einer SMS
Abbildung 3 - SendSms.R-Datei

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

Nachdem die SMS übermittelt wurde, ist es ratsam, 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 4 - Wie man überprüft, ob die SMS vom HTTP-Benutzer akzeptiert wurde (Video-Tutorial)

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

Der letzte Schritt zur Überprüfung des Vorgangs besteht darin, die Protokolle der Mobilfunknetzverbindung einzusehen. 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, sehen Sie die Telefonnummer und den Text der von Ihnen gesendeten Nachricht.

Video 5 - Wie man überprüft, ob die SMS an das Mobilfunknetz gesendet wurde (Video-Tutorial)

Wie man SMS auf einem Android-Handy empfängt (Video-Tutorial)

In diesem Video werden Sie den Prozess des Empfangens einer SMS auf einem Android-Handy miterleben. Es beginnt mit einer gewöhnlichen Android-Startseite. Sie werden sehen, wie die SMS-Benachrichtigung auftaucht. Sie werden auch lernen, wie Sie die SMS-Nachricht aus der Benachrichtigung öffnen. Das Video ist nur 18 Sekunden lang, zeigt aber den gesamten Prozess.

Video 6 - Wie man SMS auf einem Android-Handy empfängt (Video-Tutorial)

Zusammenfassung

Der Zweck dieser Anleitung war es, den Prozess des SMS-Versands in R mit Hilfe des Ozeki SMS Gateways zu zeigen. Dieses Wissen ermöglicht es, Kunden mit einem einfachen R-Code und dem Ozeki SMS Gateway zu erreichen. Wichtig zu beachten ist, dass das Ozeki SMS Gateway in jedem Land funktioniert und SMS über verschiedene Mobilfunkverbindungen senden und empfangen kann, was bedeutet, dass auch internationales Messaging mit diesem Programm möglich ist.

Stellen Sie sicher, dass Sie Ihre Studien hier nicht beenden, besuchen Sie die Tutorial-Seite von Ozeki, wo Sie mehr Informationen zu ähnlichen Themen finden, wie z.B. mehrfacher SMS-Versand und SMS-Planung in R.

Das nächste, was Sie jetzt tun sollten, ist, Ozeki SMS Gateway herunterzuladen und loszulegen!

More information