Wie man mehrere SMS aus Ruby sendet

Der einfachste Weg, mehrere SMS aus Ruby 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 Mobiltelefon des Empfängers und gibt eine HTTP-200-OK-Antwort auf Ihre Anfrage zurück.

wie man mehrere SMS aus Ruby sendet
Abbildung 1 - Wie man mehrere SMS aus Ruby sendet

Ruby-Code zum Senden mehrerer SMS an Mobiltelefone

Das folgende Ruby-SMS-Codebeispiel zeigt, wie Sie SMS mit der HTTP-Rest-SMS-API von Ozeki SMS Gateway unter Verwendung des Ruby-Gems 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.

SendMultipleSms.rb
require 'ozeki_libs_rest'

configuration = Configuration.new(
    "http_user",
    "qwe123",
    "http://127.0.0.1:9509/api"
);

msg1 = Message.new
msg1.to_address = "+36201111111"
msg1.text = "Hello world 1"

msg2 = Message.new
msg2.to_address = "+36202222222"
msg2.text = "Hello world 2"

msg3 = Message.new
msg3.to_address = "+36203333333"
msg3.text = "Hello world 3"

api = MessageApi.new(configuration)

result = api.send([ msg1, msg2, msg3 ])

print(result)
	

Wie man das Ruby-SMS-Beispiel verwendet:

Dieses Ruby-SMS-Beispiel kann in jeder Ruby-Anwendung verwendet werden. Um es zu verwenden, müssen Sie das ozeki_libs_rest-Gem herunterladen. Nachdem das Gem heruntergeladen wurde, müssen Sie es in Ihrem Ruby-Quellcode referenzieren. Dies ermöglicht Ihnen die Verwendung der Klassen, die vom ozeki_libs_rest-Gem 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.

SendMultipleSms.rb herunterladen

Der in diesem Artikel erklärte Quellcode kann kostenlos heruntergeladen, verwendet und modifiziert werden.
Download: SendMultipleSms.rb.zip (377B)

Was befindet sich in der Datei SendMultipleSms.rb.zip?

Die Datei SendMultipleSms.rb.zip enthält die Datei SendMultipleSms.rb, 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 SendMultipleSms.rb.zip

Wie man mehrere SMS aus Ruby sendet (Schnelle Schritte)

Um mehrere SMS aus Ruby zu senden:

  1. Laden Sie die Datei SendMultipleSms.rb.zip herunter
  2. Entpacken Sie die .zip-Datei aus dem Downloads-Ordner
  3. Öffnen Sie die Datei SendMultipleSms.rb in einem Texteditor wie Windows Notepad
  4. Starten Sie Ozeki SMS Gateway
  5. Erstellen Sie einen HTTP-API-Benutzer in Ozeki
  6. Führen Sie den Ruby-Code SendMultipleSms.rb über die Eingabeaufforderung aus
  7. Überprüfen Sie den "Gesendet"-Ordner in Ozeki SMS Gateway

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

Um SMS aus Ruby 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 Ruby-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 aus 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 Ruby-Code ausführen.

HTTP-API-URL zum Senden von SMS aus Ruby

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

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

username_password = username + ':' + password
username_password_encoded = Base64.encode64(username_password)
'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-Anfrageheader zum Senden von SMS aus Ruby

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 Ruby

Um die SMS zu übermitteln, sendet Ihre Ruby-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 ein JSON-kodierter Datenstring. Er enthält die Empfängernummer und den Text der Nachricht.

POST /api?action=sendmsg HTTP/1.1
Content-Length: 992
Content-Type: application/json
Accept: application/json
Accept-Encoding: gzip;q=1.0,deflate;q=0.6,identity;q=0.3
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 127.0.0.1:9509
User-Agent: Faraday v1.5.0

{
  "messages": [
    {
      "message_id": "49aa6f3a-5d2a-4d53-bd63-9eb9da8bb23e",
      "to_address": "+36201111111",
      "text": "Hello, World 1",
      "create_date": "2021-06-11 13:08:26",
      "valid_until": "2021-06-18 13:08:26",
      "time_to_send": "2021-06-11 13:08:26",
      "submit_report_requested": true,
      "delivery_report_requested": true,
      "view_report_requested": true,
      "tags": []
    },
    {
      "message_id": "62098595-5ff8-4ca8-8b06-54f0fb31ee12",
      "to_address": "+362222222",
      "text": "Hello, World 2",
      "create_date": "2021-06-11 13:08:26",
      "valid_until": "2021-06-18 13:08:26",
      "time_to_send": "2021-06-11 13:08:26",
      "submit_report_requested": true,
      "delivery_report_requested": true,
      "view_report_requested": true,
      "tags": []
    },
    {
      "message_id": "f5b576ff-52b8-4de0-9677-4731769198f9",
      "to_address": "+363333333",
      "text": "Hello, World 3",
      "create_date": "2021-06-11 13:08:26",
      "valid_until": "2021-06-18 13:08:26",
      "time_to_send": "2021-06-11 13:08:26",
      "submit_report_requested": true,
      "delivery_report_requested": true,
      "view_report_requested": true,
      "tags": []
    }
  ]
}

HTTP-Antwort, die vom Ruby-SMS-Beispiel empfangen wurde

Sobald das SMS-Gateway diese Anfrage empfängt, generiert es eine HTTP-Antwort. Die HTTP-Antwort enthält einen Statuscode, der anzeigt, 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.116 (www.myozeki.com)
Content-Type: application/json; charset=utf8
Last-Modified: Fri, 11 Jun 2021 13:06:37 GMT
Server: 10/10.3.116
Transfer-Encoding: chunked

{
  "http_code": 200,
  "response_code": "SUCCESS",
  "response_msg": "Messages queued for delivery.",
  "data": {
    "total_count": 3,
    "success_count": 3,
    "failed_count": 0,
    "messages": [
      {
        "message_id": "49aa6f3a-5d2a-4d53-bd63-9eb9da8bb23e",
        "from_station": "%",
        "to_address": "+36201111111",
        "to_station": "%",
        "text": "Hello, World 1",
        "create_date": "2021-06-11 13:08:26",
        "valid_until": "2021-06-18 13:08:26",
        "time_to_send": "2021-06-11 13:08:26",
        "submit_report_requested": true,
        "delivery_report_requested": true,
        "view_report_requested": false,
        "tags": [
          {
            "name": "Type",
            "value": "SMS:TEXT"
          }
        ],
        "status": "SUCCESS"
      },
      {
        "message_id": "62098595-5ff8-4ca8-8b06-54f0fb31ee12",
        "from_station": "%",
        "to_address": "+362222222",
        "to_station": "%",
        "text": "Hello, World 2",
        "create_date": "2021-06-11 13:08:26",
        "valid_until": "2021-06-18 13:08:26",
        "time_to_send": "2021-06-11 13:08:26",
        "submit_report_requested": true,
        "delivery_report_requested": true,
        "view_report_requested": false,
        "tags": [
          {
            "name": "Type",
            "value": "SMS:TEXT"
          }
        ],
        "status": "SUCCESS"
      },
      {
        "message_id": "f5b576ff-52b8-4de0-9677-4731769198f9",
        "from_station": "%",
        "to_address": "+363333333",
        "to_station": "%",
        "text": "Hello, World 3",
        "create_date": "2021-06-11 13:08:26",
        "valid_until": "2021-06-18 13:08:26",
        "time_to_send": "2021-06-11 13:08:26",
        "submit_report_requested": true,
        "delivery_report_requested": true,
        "view_report_requested": false,
        "tags": [
          {
            "name": "Type",
            "value": "SMS:TEXT"
          }
        ],
        "status": "SUCCESS"
      }
    ]
  }
}
	

Ruby-SMS-Beispiel: SendMultipleSms.rb

Video 1 - Wie Sie die obenstehende Lösung herunterladen und öffnen (Video-Tutorial)

Der untenstehende Beispielcode ist Teil der SendMultipleSms.rb.

Abbildung 3 - SendMultipleSms.rb-Datei

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

Zusammenfassung

Dieser Artikel erklärte die Schritte zum Senden mehrerer SMS in Ruby mit dem Ozeki SMS Gateway. Diese Innovation kann sehr hilfreich sein, wenn Sie Textnachrichten an eine große Anzahl von Kunden gleichzeitig senden möchten. Die Synergie zwischen Ruby-Codes und dem Ozeki SMS Gateway stellt sicher, dass Sie die bestmögliche Leistung erhalten. Das Ozeki SMS Gateway kann von der Ozeki-Website heruntergeladen werden und kann in einer Testphase kostenlos verwendet werden.

Stellen Sie sicher, dass Sie hier nicht aufhören zu lesen, besuchen Sie die Tutorial-Seite von Ozeki, wo Sie mehr Informationen zu Themen wie Empfang in Ruby finden.

Jetzt müssen Sie nur noch das Ozeki SMS Gateway herunterladen und die Arbeit kann beginnen!

More information