SMS mit Ruby versenden

Lassen Sie uns sehen, wie Sie Ruby verwenden können, um SMS-Nachrichten mit HTTP-Anfragen zu versenden. Der Beispielcode zeigt, dass Sie nur wenige Codezeilen benötigen, um die Details der Nachricht einzurichten und eine HTTP-Anfrage zu senden. Dann empfängt das SMS-Gateway die Anfrage und liefert die SMS an den Empfänger. Schließlich sendet das SMS-Gateway die Antwort zurück an das Ruby-Programm, das diese Antwort auf der Konsole ausgibt.

Was ist die Ruby SMS API?

Die Ruby SMS API (Ruby sms) ermöglicht es Ihnen, SMS-Nachrichten aus Ihrem Ruby-Programm zu versenden. Die Ruby SMS API initiiert HTTP-Anfragen und sendet sie an das SMS-Gateway, das die Nachricht an den Empfänger liefert.

Voraussetzungen

SMS mit Ruby versenden

  1. Öffnen Sie Notepad
  2. Erstellen Sie eine neue Datei
  3. Kopieren Sie den Beispielcode unten und fügen Sie ihn ein
  4. Speichern Sie die Datei als HttpApiTester.rb
  5. Öffnen Sie die Eingabeaufforderung
  6. Navigieren Sie zum Ordner, in dem Sie die Ruby-Datei gespeichert haben
  7. Geben Sie 'ruby HttpApiTester.rb' in die Eingabeaufforderung ein
  8. Drücken Sie Enter, um das Ruby-Programm auszuführen
  9. Ruby Rails sendet SMS-Textnachrichten

Video 1 - Wie man SMS mit Ruby versendet (Video-Tutorial)

Ruby SMS Beispielquellcode

Der folgende einfache Beispielquellcode, geschrieben in der Programmiersprache Ruby, ist kostenlos nutzbar. Sie können ihn einfach in Ihr Projekt implementieren oder den Quellcode für andere Projekte oder Anwendungen anpassen. Um den Beispielcode auszuführen und zu sehen, wie HTTP-Anfragen mit Ruby gesendet werden, müssen Sie nur eine neue Ruby-Datei erstellen und diesen Beispielcode in die Datei einfügen. Um das Ruby-Programm auszuführen, starten Sie es einfach über die Eingabeaufforderung. Diese Schritte werden in den Anleitungen und im Videoabschnitt erläutert und demonstriert. 

require 'uri'
require 'net/http'

username = "john"
password = "Xc3ffs"
messagetype = "SMS:TEXT"
httpUrl = "https://127.0.0.1:9508/"
recipient = URI.encode_www_form_component("+36201324567")
messagedata = URI.encode_www_form_component("TestMessage")

sendString = "#{httpUrl}api?action=sendmessage&username=#{username}&password="\
			 "#{password}&recipient=#{recipient}&messagetype="\
			 "#{messagetype}&messagedata=#{messagedata}"

puts("Sending http request #{sendString}")

OpenSSL::SSL.send(:remove_const, :VERIFY_PEER)
OpenSSL::SSL.const_set(:VERIFY_PEER, OpenSSL::SSL::VERIFY_NONE)
url = URI(sendString)
response = Net::HTTP.get(url)
puts("Http response received:")
puts(response)

Schritt 1 - Öffnen Sie einen Texteditor

Der erste Schritt zur Ausführung des Ruby SMS Beispielcodes oben ist die Erstellung einer Ruby-Datei, die den Quellcode enthält. Für diese Operation benötigen Sie nur einen Texteditor. Sie können einen speziellen Texteditor herunterladen, aber die standardmäßig unter Windows installierte Notepad-Anwendung reicht ebenfalls aus. Wie in Abbildung 1 zu sehen ist, klicken Sie einfach auf das Notepad-Symbol, um es zu öffnen.

einen Texteditor öffnen
Abbildung 1 - Einen Texteditor öffnen

Schritt 2 - Kopieren Sie den Ruby-Quellcode

Der nächste Schritt der Anleitung ist das Beschaffen des Ruby-Quellcodes. Dies ist einfach möglich, da der Code auf dieser Seite zu finden ist. Sie müssen ihn also nur kopieren. Wie Abbildung 2 zeigt, gehen Sie einfach zum Beispielcode-Abschnitt, markieren Sie den gesamten Quellcode und drücken Sie Strg+C auf Ihrer Tastatur, um den Ruby-Code in die Zwischenablage zu kopieren.

Quellcode von der Website kopieren
Abbildung 2 - Quellcode von der Website kopieren

Schritt 3 - Fügen Sie den Ruby-Code in Ihren Texteditor ein

Nachdem Sie den Ruby-Code von dieser Seite kopiert haben, müssen Sie ihn in Ihre leere Textdatei einfügen. Dazu navigieren Sie einfach zur Textdatei und drücken Strg+V auf Ihrer Tastatur. Durch diese Aktion wird der Ruby-Code wie in Abbildung 3 gezeigt in Ihre Textdatei eingefügt.

den Programmcode in den Texteditor einfügen
Abbildung 3 - Den Programmcode in den Texteditor einfügen

Schritt 4 - Speichern der Ruby-Datei

Nachdem Sie den Quellcode in die Textdatei eingefügt haben, müssen Sie als Nächstes die Datei mit der Ruby-Dateierweiterung '.rb' speichern. Wählen Sie einfach die Option "Speichern unter" im Editor, benennen Sie die Datei und fügen Sie die Dateierweiterung '.rb' hinzu, wie in Abbildung 4 zu sehen ist. Klicken Sie abschließend auf "Speichern".

HttpApiTester-Ruby-Datei speichern
Abbildung 4 - HttpApiTester-Ruby-Datei speichern

Schritt 5 - Eingabeaufforderung öffnen

Der nächste Schritt besteht darin, die erstellte Ruby-Datei auszuführen. Dies kann einfach über die Eingabeaufforderung erfolgen. Öffnen Sie den Datei-Explorer, navigieren Sie zum Ordner, in dem Sie die Ruby-Datei gespeichert haben, und geben Sie "cmd" in die Adressleiste des Datei-Explorers ein, wie in Abbildung 5 gezeigt. Wenn Sie nun die Eingabetaste drücken, wird die Eingabeaufforderung geöffnet und ist einsatzbereit.

Eingabeaufforderung öffnen
Abbildung 5 - Eingabeaufforderung öffnen

Schritt 6 - Ruby-Datei ausführen

In der Eingabeaufforderung müssen Sie nur einen einfachen Befehl ausführen, um das Ruby-SMS-Beispiel zu starten. Der Befehl lautet "ruby *Dateiname*.rb". Nachdem Sie den Befehl eingegeben haben, drücken Sie die Eingabetaste, und das Ruby-Programm wird ausgeführt. Das Beispielprogramm gibt die HTTP-Anfrage und die Antwortnachricht des SMS-Gateways in der Eingabeaufforderung aus (Abbildung 6).

HttpApiTester.rb-Datei in cmd ausführen
Abbildung 6 - HttpApiTester.rb-Datei in cmd ausführen

Schritt 7 - Sendeergebnis im Ozeki-Protokoll überprüfen

In der Ozeki 10 SMS Gateway können Sie leicht überprüfen, welche Nachrichten von Ihrer Anwendung gesendet wurden, da der HTTP-API-Dienst alle Ereignisse protokolliert, die während seiner Aktivierung auftreten. Wenn Sie die SMS Gateway öffnen und die Details des HTTP-API-Dienstes auswählen, können Sie die Ereignisse einsehen. Wie in Abbildung 7 zu sehen ist, protokollierte der Dienst ein Ereignis, als das Ruby-Beispielprogramm die HTTP-Anfrage an den Dienst sendete.

Protokolle des HTTP-API-Dienstes überprüfen
Abbildung 7 - Protokolle des HTTP-API-Dienstes überprüfen

Der Prozess des Nachrichtenversands kann ebenfalls über die Ereignisse nachverfolgt werden. Öffnen Sie dazu die HTTP-API-Benutzerverbindung, die Sie zuvor konfigurieren mussten. Abbildung 8 zeigt, wie die Verbindung die HTTP-Anfrage verarbeitet und die Nachricht an den Empfänger sendet, den Sie in Ihrem Ruby-SMS-Beispielprogramm angegeben haben.

Protokolle des HTTP-API-Benutzers überprüfen
Abbildung 8 - Protokolle des HTTP-API-Benutzers überprüfen

Zusammenfassung

Dieser Artikel hat Ihnen erklärt, wie Sie SMS-Nachrichten aus einem in Ruby geschriebenen Projekt versenden können. Das Versenden von Nachrichten aus jedem Ruby-Objekt bedeutet, dass Sie Ihren Kunden SMS-Dienste in jeder Ruby-Lösung anbieten können. Dies macht Ihre Lösung vielseitig und weit verbreitet. Die Lösung basiert auf der Ozeki SMS Gateway. Der bereitgestellte Code sendet HTTP-Anfragen von Ruby an die Ozeki SMS Gateway, und die Ozeki SMS Gateway führt die Anfragen aus.

Um mehr über das System zu erfahren, besuchen Sie die Ozeki-Website, wo Sie weitere Informationen zu verschiedenen Setup-Optionen mit der Ozeki SMS Gateway finden. Beginnen Sie mit dem Artikel über PHP.

Der nächste Schritt besteht darin, die Ozeki SMS Gateway herunterzuladen und sofort mit der Arbeit zu beginnen!

More information