Wie man SMS von C# aus sendet

Der einfachste Weg, SMS von C# aus 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 wird eine Nachricht im JSON-Format enthalten. Das SMS-Gateway wird diese SMS an die Empfängertelefonnummer senden und eine HTTP-200-OK-Antwort auf Ihre Anfrage zurückgeben. (Abbildung 1)

wie man eine sms von c# aus sendet
Abbildung 1 - Wie man eine SMS von C# aus sendet

C#-Code zum Senden von SMS an Mobiltelefone

Das folgende C#-SMS-Codebeispiel zeigt, wie Sie SMS mit der HTTP-Rest-SMS-API von Ozeki SMS Gateway unter Verwendung der C#-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.cs
using Ozeki.Libs.Rest;
using System;

namespace SendSms
{
    class Program
    {
        static void Main(string[] args)
        {
            var configuration = new Configuration()
            {
                Username = "http_user",
                Password = "qwe123",
                ApiUrl = "http://127.0.0.1:9509/api"
            };

            var msg = new Message()
            {
                ToAddress = "+36201111111",
                Text = "Hallo, Welt!"
            };

            var api = new MessageApi(configuration);

            var result = api.Send(msg);

            Console.WriteLine(result);
            Console.ReadKey();
        }
    }
}

Wie man das C#-SMS-Beispiel verwendet:

Dieses C#-SMS-Beispiel kann in jeder .NET- oder .NET-Core-Anwendung verwendet werden. Um es zu verwenden, müssen Sie die Ozeki.Libs.Rest-DLL als Referenz zu Ihrem Projekt hinzufügen. Nachdem die Projektreferenz hinzugefügt wurde, müssen Sie die Direktive "using Ozeki.Libs.Rest;" in den Header-Bereich Ihres C#-Quellcodes einfügen. Dies ermöglicht Ihnen die Verwendung der Klassen der Ozeki.Libs.Rest-Bibliothek. 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.cs herunterladen

Der in diesem Artikel erklärte Quellcode kann kostenlos heruntergeladen, verwendet und modifiziert werden.
Download: SendSms.cs.zip (33,3Kb)

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

Die Datei SendSms.cs.zip enthält die Ozeki.Libs.Rest-Bibliothek, die Ihnen alle notwendigen Werkzeuge zum Senden und Empfangen von SMS-Nachrichten bietet. Sie finden auch das SendSms-Projekt in der ZIP-Datei, das den Beispielcode enthält, der Ihnen zeigt, wie Sie eine SMS senden können. Dieser Beispielcode ist unten aufgeführt. (Abbildung 2)

send sms cs verzeichnis
Abbildung 2 - Was befindet sich in SendSms.cs.zip

Wie man SMS von C# aus sendet (Einfache Anleitung)

Um SMS von C# aus 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 Datei SendSms.cs.zip herunter und entpacken Sie sie
  5. Öffnen Sie die Datei SendSms.sln in Visual Studio
  6. Starten Sie die Ozeki SMS Gateway App
  7. Führen Sie den C#-Code Program.cs in Visual Studio aus
  8. Ü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 C# 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 C#-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 über die 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 C#-Code ausführen.

HTTP-API-URL zum Senden von SMS von C# aus

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

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

var encoding = Encoding.GetEncoding("iso-8859-1");
var usernamePassword = username + ":" + password;
var usernamePasswordEncoded = Convert.ToBase64String(encoding.GetBytes(usernamePassword));

Wenn Sie beispielsweise den Benutzernamen 'http_user' und das Passwort 'qwe123' kodieren, erhalten Sie den folgenden base64-kodierten String: 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 von SMS aus C#

Um die SMS zu übermitteln, sendet Ihre C#-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 Empfängernummer und den Nachrichtentext.

POST /api?action=sendmsg HTTP/1.1
Connection: Keep-Alive
Content-Length: 336
Content-Type: application/json
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 127.0.0.1:9509

{
  "messages": [
    {
      "message_id": "b570dbae-3a05-456d-9dad-a02161b16f1c",
      "to_address": "+36201111111",
      "text": "Hallo, Welt!",
      "create_date": "2021-06-11 11:20:02",
      "valid_until": "2021-06-18 11:20:02",
      "time_to_send": "2021-06-11 11:20:02",
      "submit_report_requested": true,
      "delivery_report_requested": true,
      "view_report_requested": true,
      "tags": []
    }
  ]
}

HTTP-Antwort, die vom C#-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 wird auch eine JSON-kodierte Struktur zurückgeben, 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 11:17:49 GMT
Server: 10/10.3.116
Transfer-Encoding: chunked

{
  "http_code": 200,
  "response_code": "SUCCESS",
  "response_msg": "Nachrichten wurden zur Zustellung in die Warteschlange gestellt.",
  "data": {
    "total_count": 1,
    "success_count": 1,
    "failed_count": 0,
    "messages": [
      {
        "message_id": "b570dbae-3a05-456d-9dad-a02161b16f1c",
        "from_station": "%",
        "to_address": "+36201111111",
        "to_station": "%",
        "text": "Hallo, Welt!",
        "create_date": "2021-06-11 11:20:02",
        "valid_until": "2021-06-18 11:20:02",
        "time_to_send": "2021-06-11 11:20:02",
        "submit_report_requested": true,
        "delivery_report_requested": true,
        "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

Wir gehen davon aus, dass Sie bereits Ozeki SMS Gateway installiert haben und es mit dem Mobilfunknetz verbunden haben. Um SMS von C# aus an ein Mobiltelefon senden zu können, müssen Sie ein HTTP-API-Benutzerkonto in Ozeki SMS Gateway einrichten.

Erstellen Sie einen neuen Benutzer (Video-Tutorial)

Dieses Video zeigt Ihnen, wie Sie ein neues HTTP-API-Benutzerkonto einrichten. Es beginnt mit der Startseite des Ozeki SMS Gateway und endet mit dem Reiter "Ereignisse" des neuen Benutzers. Das Video zeigt Ihnen, wie Sie Ihren neuen Benutzer erstellen und konfigurieren. Das Tolle an diesem Video ist, dass es nur 30 Sekunden lang ist, aber alle Informationen enthält, die Sie benötigen, um einen neuen HTTP-API-Benutzer zu erstellen.

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

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

Dieses Video zeigt Ihnen, wie Sie die Datei SendSms.cs.zip von dieser Seite herunterladen und wie Sie deren Inhalt in Visual Studio öffnen. Wenn Sie das Video ansehen, werden Sie feststellen, dass der Inhalt der SendSms.cs-Zip-Datei auf den Windows-Desktop kopiert wird. Sie werden auch sehen, dass wir auf die SendSms.sln-Lösungsdatei doppelklicken, um die Lösung zu öffnen. Visual Studio zeigt einige Warnungen an, da die Datei aus dem Internet stammt. Klicken Sie einfach auf OK, um diese Warnungen zu vermeiden.

Video 2 - Wie Sie das Beispielprojekt herunterladen und ausführen (Video-Tutorial)

C#-SMS-Beispiel: SendSms.sln

Der Beispielcode unten ist Teil der SendSms.sln Visual Studio-Lösung. Eine Visual Studio-Lösung kann mehrere Projekte und mehrere Dateien enthalten. In dieser Lösung gibt es nur ein Projekt: SendSms.csproj, und eine Datei: Program.cs.

Abbildung 2 - SendSms.sln

Wie man überprüft, ob die SMS vom HTTP-Benutzer akzeptiert wurde (Video-Tutorial)

Nachdem die SMS übermittelt wurde, ist es eine gute Idee, Ihr SMS-Gateway zu überprüfen, um zu sehen, was es erhalten hat. Sie können das Protokoll überprüfen, indem Sie die Details des HTTP-Benutzers in der Ozeki SMS Gateway Management-Konsole öffnen. Das folgende Video zeigt Ihnen, worauf Sie achten müssen. Das Video beginnt mit dem geöffneten Code und endet mit den Details der gesendeten Nachricht. Sie lernen, wie Sie das Projekt starten, wie das Projekt während des Betriebs aussieht und wie die Protokolldatei danach aussieht. Das Video ist nur 42 Sekunden lang und leicht verständlich. Sie werden keine Probleme haben, ihm zu folgen.

Video 3 - Wie man SMS mit dem obigen C#-Code sendet (Video-Tutorial)

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

Der letzte Schritt zur Überprüfung des Verfahrens besteht darin, die Protokolle der Mobilfunknetzverbindung zu betrachten. 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 Nachricht, die Sie gesendet haben.

Testen, ob die Anfrage akzeptiert wurde (Video-Tutorial)

Im folgenden Video sehen Sie, wie Sie überprüfen können, ob der SMPP-Client Ihre Nachricht erfolgreich gesendet hat. Sie lernen, wie Sie die Ereignisregisterkarte des SMPP-Benutzers öffnen und worauf Sie achten müssen. Das Video ist nur 18 Sekunden lang, aber sehr hilfreich.

Video 4 - Wie man testet, ob die Anfrage vom SMPP-Client akzeptiert wurde (Video-Tutorial)

SMS auf dem Handy empfangen (Video-Tutorial)

Im folgenden Video sehen Sie, wie eine eingehende Nachricht aussieht, die vom Ozeki SMS Gateway gesendet wurde. Es beginnt mit dem Startbildschirm eines Android-Handys und endet mit der geöffneten Nachricht. Es ist nur 18 Sekunden lang und Sie können den gesamten Prozess des Empfangens einer Nachricht sehen.

Video 5 - Wie sieht eine eingehende Nachricht von Ozeki SMS Gateway aus (Video-Tutorial)

Ausführen des C#-SMS-Beispiels unter Windows

Wenn Sie Windows verwenden, um dieses in C# geschriebene SMS-Beispiel auszuführen, werden Sie feststellen, dass Sie eine etwas bessere Leistung erhalten, als wenn Sie es unter Linux ausführen. Um zu verstehen, warum dies geschieht, müssen Sie bedenken, dass C# das .NET-Framework für die Codeausführung verwendet. Dies liegt daran, dass die .NET-Implementierung unter Windows für Leistung optimiert ist, während Mono, die .NET-Implementierung unter Linux, in diesem Bereich noch einiges aufzuholen hat.

Zusammenfassung

Die obige Anleitung hat die Schritte zum Senden von SMS aus C# erklärt. Wie gesehen, gibt Ihnen Ozeki alle notwendigen Tools für die Nachrichtenübermittlung, wenn die Schritte sorgfältig befolgt wurden, ist das Versenden von Nachrichten aus C# kein Problem mehr. Ozeki SMS Gateway spielt eine enorme Rolle bei der Übermittlung, ohne dieses Programm könnten Sie die Mobilfunknutzer nicht erreichen. Wichtig zu beachten ist, dass Ozeki SMS Gateway in jedem Land funktioniert, so dass Nachrichten mit dieser Lösung international versendet werden können.

Beenden Sie die Lektüre nicht hier, durchstöbern Sie die Tutorial-Seite von Ozeki und erfahren Sie mehr über SMS-Empfang in C#.

Ihr nächster Schritt ist es, Ozeki SMS Gateway herunterzuladen und die Arbeit zu beginnen!

More information