Wie man SMS von C# über HTTP sendet

Sie können leicht eine C#-Konsolenanwendung erstellen, die es Ihnen ermöglicht, eine HTTP-Anfrage an das Ozeki 10 SMS-Gateway zu senden. Wenn Sie diese beigefügte Anwendung ausführen, wird sie zunächst eine HTTP-Anfrage auf der Konsole ausgeben und anschließend versenden. Wenn alles gut geht, empfängt das Ozeki 10 SMS-Gateway diese Anfrage und sendet eine Antwort zurück. Unsere C#-Anwendung empfängt diese Antwort und zeigt sie auf der Konsole an. Aus dieser Antwort können wir ersehen, ob die Zustellung erfolgreich war.

Was ist eine C# SMS API?

Die C# SMS API ist ein hervorragendes Werkzeug, um SMS-Nachrichten von jeder Art von C#-basiertem Projekt oder Anwendung aus zu senden, indem HTTP-Anfragen initiiert und an das SMS-Gateway weitergeleitet werden.

Voraussetzungen

SMS von C# senden

Wenn Sie SMS von C# aus senden möchten, können Sie die HTTP SMS API des Ozeki SMS Gateways verwenden.

So senden Sie SMS von C#:

  1. Öffnen Sie https://localhost:9515 in Ihrem Browser und melden Sie sich an
  2. Erstellen Sie einen neuen HTTP API Benutzer
  3. Überprüfen Sie die Portnummer des HTTP API Dienstes
  4. Starten Sie Visual Studio
  5. Erstellen Sie ein neues C# Konsolenprojekt
  6. Senden Sie SMS von C# aus, indem Sie den untenstehenden Quellcode eingeben
  7. Führen Sie das Konsolen-App-Projekt aus
  8. Sehen Sie die von Ihrem C#-Projekt gesendete SMS auf Ihrem Handy

Video: Wie man SMS von C# sendet

Video 1 - Wie man SMS von C# sendet (Video-Tutorial)

C# SMS Quellcode-Beispiel

Das folgende C#-Quellcode-Beispiel ist frei verwendbar, Sie können es einfach in Ihr Projekt implementieren oder den Quellcode für andere Projekte oder Anwendungen anpassen. Wenn Sie diesen Beispielcode ausführen möchten, müssen Sie ihn nur in Ihr Konsolen-App-Projekt einfügen und das Projekt ausführen.

using System;
using System.Net.Http;
using System.Text;
using System.Web;
namespace HttpApiTester
{
    class Program
    {
        static async System.Threading.Tasks.Task Main(string[] args)
        {
            var username = "john";
            var password = "Xc3ffs";
            var messagetype = "SMS:TEXT";
            var httpUrl = "https://127.0.0.1:9508/";
            var recipient = HttpUtility.UrlEncode("+36201324567", Encoding.UTF8);
            var messagedata = HttpUtility.UrlEncode("TestMessage", Encoding.UTF8);
            
            var sendString = $"{httpUrl}api?action=sendmessage&username=" +
                             $"{username}&password={password}" +
                             $"&recipient={recipient}&messagetype=" +
                             $"{messagetype}&messagedata={messagedata}";

            Console.WriteLine("Sending request: " + sendString);

            var handler = new HttpClientHandler();
            handler.ServerCertificateCustomValidationCallback = 
                (sender, cert, chain, sslPolicyErrors) => { return true; };

            using var client = new HttpClient(handler);

            try
            {
                var response = await client.GetStringAsync(sendString);
                Console.WriteLine("Http response received: ");
                Console.WriteLine(response);

            } catch(Exception e)
            {
                Console.WriteLine(e.Message);
            }
        }
    }
}

Schritt 1 - Visual Studio öffnen

Der erste Schritt zur Erstellung der Anwendung, die SMS-Nachrichten senden kann, ist das Öffnen von Visual Studio. Wenn Sie Visual Studio noch nicht heruntergeladen haben, folgen Sie einfach dem Link im Abschnitt Voraussetzungen oben, um die neueste Version herunterzuladen. Wenn Sie Visual Studio bereits auf Ihrem Computer installiert haben, müssen Sie nur auf das Symbol (Abbildung 1) auf dem Desktop klicken, um Visual Studio zu öffnen.

Visual Studio öffnen
Abbildung 1 - Visual Studio 2019 öffnen

Schritt 2 - Ein neues Projekt erstellen

Nachdem Sie Visual Studio geöffnet haben, erscheint das Startfenster, wie in Abbildung 2 zu sehen. Hier können Sie Ihre Lösungen sehen, eine bestehende öffnen, ein Repository klonen oder einen lokalen Ordner öffnen. Um der Anleitung zu folgen, müssen Sie jetzt auf den Button 'Neues Projekt erstellen' klicken, um das Projekt für das SMS-Senden zu erstellen.

Neues Projekt in Visual Studio erstellen
Abbildung 2 - Neues Projekt erstellen

Schritt 3 – Konsolen-App auswählen

Im nächsten Fenster werden alle verfügbaren Projekttypen aufgelistet, die in Visual Studio erstellt werden können. Dieses Beispiel erfordert die Erstellung einer einfachen Konsolen-App, wie in Abbildung 3 gezeigt, aber Sie können den SMS-Versanddienst auch in vielen anderen Projekttypen verwenden. Alles, was Sie hier tun müssen, ist, die Option "Konsolen-App" aus der Liste der verfügbaren Projekttypen auszuwählen.

Konsolenanwendung auswählen
Abbildung 3 – Konsolenanwendung auswählen

Schritt 4 – Projekt konfigurieren

Vor der Erstellung des Projekts ist der letzte Schritt die Konfiguration durch Angabe einiger Details. Hier können Sie dem Projekt einen Namen geben und auch den Speicherort festlegen, wie in Abbildung 4 zu sehen ist. Wenn Sie mit der Konfiguration fertig sind, klicken Sie einfach auf "Erstellen", um das Konsolen-App-Projekt anzulegen.

Visual Studio-Projekt einrichten
Abbildung 4 – Visual Studio-Projekt einrichten

Schritt 5 – Beispielcode kopieren

Nachdem Sie das Konsolen-App-Projekt erstellt haben, müssen Sie nun den Beispielcode einrichten, den Sie ausführen möchten. Scrollen Sie dazu auf dieser Seite nach oben, um den Abschnitt mit dem Beispielcode zu finden, und markieren Sie den gesamten Quellcode, wie in Abbildung 5 gezeigt. Drücken Sie dann einfach Strg+C auf Ihrer Tastatur, um den Quellcode zu kopieren.

Code von der Website kopieren
Abbildung 5 – Code von der Website kopieren

Schritt 6 – Quellcode in Ihr Projekt einfügen

In Visual Studio enthält das erstellte Projekt eine anfängliche Program.cs-Quelldatei. An diesem Punkt ist dies die Datei, die Sie verwenden müssen, um das Beispielprogramm auszuführen. Markieren Sie zunächst den Code in dieser Datei und löschen Sie ihn. Wie in Abbildung 6 gezeigt, drücken Sie dann Strg+V auf Ihrer Tastatur, um den Beispielcode in Ihre Program.cs-Datei einzufügen. Nun ist das Projekt einsatzbereit.

Code in Visual Studio einfügen
Abbildung 6 – Code in Visual Studio einfügen

Schritt 7 – Beispielprojekt ausführen

Der letzte Schritt dieser Anleitung ist die Ausführung des Beispielprogramms. In Visual Studio ist es ganz einfach, das Projekt zu starten: Sie müssen nur auf die Schaltfläche "Start" klicken, wie in Abbildung 7 zu sehen ist. Nach dem Start des Programms erscheint ein Konsolenfenster, das die HTTP-Anfrage anzeigt, die das Programm an das SMS-Gateway gesendet hat. Es zeigt auch die Antwort des SMS-Gateways an, die anzeigt, ob die Zustellung der SMS erfolgreich war.

Code in Visual Studio erstellen und ausführen
Abbildung 7 – Code in Visual Studio erstellen und ausführen

Schritt 8 – 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 jedes Ereignis protokolliert, das während seiner Aktivität auftritt. Wenn Sie das SMS-Gateway öffnen und die Details des HTTP-API-Dienstes auswählen, können Sie die Ereignisse einsehen. Wie in Abbildung 8 zu sehen ist, hat der Dienst ein Ereignis protokolliert, als das C#-Beispielprogramm die HTTP-Anfrage an den Dienst gesendet hat.

Protokolle des HTTP-API-Dienstes überprüfen
Abbildung 8 – Protokolle des HTTP-API-Dienstes überprüfen

Der Prozess des Nachrichtenversands kann ebenfalls anhand der Ereignisse nachverfolgt werden. Öffnen Sie dazu die HTTP-API-Benutzerverbindung, die Sie zuvor konfigurieren mussten. Abbildung 9 zeigt, wie die Verbindung die HTTP-Anfrage verarbeitet und die Nachricht an den Empfänger sendet, den Sie in Ihrem C#-Programm angegeben haben.

Protokolle des HTTP-API-Benutzers überprüfen
Abbildung 9 – Protokolle des HTTP-API-Benutzers überprüfen

Fazit

Diese Anleitung enthielt alle notwendigen Informationen, wie Sie eine SMS von Ihrem Computer an einen beliebigen Empfänger senden können. Diese Lösung kombiniert C# mit der Ozeki SMS Gateway, die in jedem Land funktioniert und SMS über verschiedene Mobilfunkverbindungen senden und empfangen kann. Dies erleichtert die Kommunikation mit Ihren Kollegen und Kunden erheblich.

Die Ozeki SMS Gateway ist ein Tool, das über HTTP-Anfragen gesteuert werden kann. Um mehr darüber zu erfahren, besuchen Sie gerne den Artikel zum Empfangen von SMS mit der C# HTTP SMS API oder informieren Sie sich über andere unterstützte Sprachen wie PHP.

Alles, was Sie tun müssen, ist die Ozeki SMS Gateway herunterzuladen und Ihre Lösung jetzt zu entwickeln!

More information