Wie man geplante SMS aus C# sendet

Der einfachste Weg, SMS aus C# 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.

C#-Code zum Senden geplanter 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.

using Ozeki.Libs.Rest;
using System;

namespace SendScheduledSms
{
    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 = "Hello, World!",
                TimeToSend = DateTime.Parse("2021-06-11 13:25:00")
            };


            var api = new MessageApi(configuration);

            var result = api.Send(msg);

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

So verwenden Sie das C#-SMS-Beispiel:

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 Kopfbereich 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.

SendScheduledSms.cs herunterladen

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

Was befindet sich in der SendScheduledSms.cs-Datei?

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

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

Um geplante SMS aus C# zu senden:

1. HTTP-API-Benutzer installieren
2. Visual Studio einrichten
3. Die Datei SendScheduledSms.cs.zip herunterladen
4. Die .zip-Datei aus dem Downloads-Ordner extrahieren
5. Die Datei SendScheduledSms.sln in Visual Studio öffnen
6. Die Ozeki.Libs.Rest-DLL als Referenz hinzufügen
7. Die Datei bearbeiten, um SMS aus C# zu planen
8. Ozeki SMS Gateway starten
9. Program.cs in Visual Studio ausführen, um SMS aus C# zu senden
10. Die Protokolle überprüfen

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

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

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

Um SMS aus C# 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 aus C#

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 aufnehmen. 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 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 Nummer des Empfängers und den Text der Nachricht.

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:9511

{
  "messages": [
    {
      "message_id": "212a019e-a6f5-46f8-80e5-abddb273451b",
      "to_address": "+36201111111",
      "text": "Hello, World!",
      "create_date": "2021-06-11 13:20:09",
      "valid_until": "2021-06-18 13:20:09",
      "time_to_send": "2021-06-11 13:25:00",
      "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, 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.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": 1,
    "success_count": 1,
    "failed_count": 0,
    "messages": [
      {
        "message_id": "212a019e-a6f5-46f8-80e5-abddb273451b",
        "from_station": "%",
        "to_address": "+36201111111",
        "to_station": "%",
        "text": "Hello, World!",
        "create_date": "2021-06-11 13:20:09",
        "valid_until": "2021-06-18 13:20:09",
        "time_to_send": "2021-06-11 13:25:00",
        "submit_report_requested": true,
        "delivery_report_requested": true,
        "view_report_requested": false,
        "tags": [
          {
            "name": "Type",
            "value": "SMS:TEXT"
          }
        ],
        "status": "SUCCESS"
      }
    ]
  }
}

C#-SMS-Beispiel: SendSMS.sln

Wie man das Projekt herunterlädt (Video-Tutorial)

In diesem Video zeigen wir Ihnen, wie Sie das SendSMS.sln-Projekt öffnen und damit arbeiten können. Das Video beginnt mit der Tutorial-Seite und dem Download-Link und führt Sie bis zum geöffneten Code. Sie lernen, wie Sie das Projekt herunterladen und öffnen. Das Video dauert nur 1 Minute, enthält aber alle notwendigen Informationen, damit Sie das SendSMS.sln-Projekt für geplantes SMS-Senden öffnen können.

Der Beispielcode unten ist Teil der SendScheduledSms.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: SendScheduledSms.csproj, und eine Datei: Program.cs.

Wie man das Projekt verwendet (Video-Tutorial)

Dieses Video zeigt Ihnen, wie Sie das SendSMS.sln-Projekt für geplantes SMS-Senden verwenden können. Es beginnt mit dem geöffneten Projekt und endet mit dem Protokoll der gesendeten Nachrichten. Sie lernen, wie Sie die Zeit hinzufügen, zu der Sie die Nachricht senden möchten, und wie Sie den Code ausführen. Danach können Sie den Ereignis-Tab mit dem Protokoll für das SMS-Senden überprüfen. Das Video dauert nur 80 Sekunden und enthält alle wichtigen Schritte. Sie werden keine Probleme haben, dem Tutorial zu folgen.

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

Der obige Artikel erklärte die Schritte zur SMS-Planung mit C#. Ozeki stellt alle Tools und Anleitungen bereit, sodass Sie nach Abschluss dieser Anleitung in der Lage sein sollten, Ihre Nachrichten mit C# und dem Ozeki SMS Gateway zu planen.

Die SMS-Planung ist besonders nützlich, wenn Sie Informationen an Kunden senden möchten und sicherstellen wollen, dass sie genügend Zeit haben, die Nachricht zu beachten. Auf diese Weise können Sie vermeiden, dass die Nachricht ignoriert oder vergessen wird, indem Sie geschäftige Zeiten umgehen. Wichtig zu erwähnen ist, dass das Ozeki SMS Gateway hervorragende Protokollierungsfunktionen bietet, sodass auftretende Fehler einfach und schnell nachverfolgt werden können.

Setzen Sie Ihre Studien auf den Tutorial-Seiten von Ozeki fort, wo Sie weitere Informationen zu ähnlichen Themen erhalten, wie z.B. Löschen in C#.

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