C#.Net SMS-Skript

Im Ozeki SMS Gateway können Sie ein Skript schreiben, das es Ihnen ermöglicht, C# .NET-Code auszuführen, wenn eine SMS-Nachricht eingeht. Dieses Skript kann jede Logik implementieren, um verschiedene Aufgaben mit den eingehenden Nachrichten zu erledigen und optional Antwort-SMS zu senden.

Schritt 1 - Neuen Benutzer/Anwendung hinzufügen...

Sie können den C#-Skript-Benutzer einfach in der Management-Konsole installieren, indem Sie im Bereich Benutzer/Anwendungen auf "Neuen Benutzer/Anwendung hinzufügen..." klicken (Abbildung 1).

Neuen Benutzer oder Anwendung hinzufügen
Abbildung 1 - Neuen Benutzer/Anwendung hinzufügen...

Schritt 2 - C#-Skript hinzufügen

Es öffnet sich eine Oberfläche mit zwei Bereichen. Der linke Bereich enthält die bereits installierten Benutzer und Anwendungen. Der rechte Bereich enthält die Benutzer und Anwendungen, die Sie installieren können, mit einer kurzen Beschreibung daneben. Suchen Sie den C#-Skript-Benutzer und klicken Sie auf den blauen "Installieren"-Button daneben (Abbildung 2).

C#-Skript hinzufügen
Abbildung 2 - C#-Skript hinzufügen

Schritt 3 - Skript bereitstellen

Das "Konfigurations"-Panel hat einen "Allgemein"-Tab, der die grundlegenden Einstellungen enthält. Geben Sie zunächst einen eindeutigen Namen an. Im Skript-Abschnitt des Tab-Seite befindet sich der Quellcode des Skripts, das Sie ausführen möchten (Abbildung 3).

Skript bereitstellen
Abbildung 3 - Skript bereitstellen

Schritt 4 - Benutzer aktivieren

Aktivieren Sie den Benutzer mit dem "Verbindung"-Schalter und überprüfen Sie im "Ereignisse"-Tab, dass das Skript kompiliert wurde und der Benutzer erfolgreich initialisiert wurde (Abbildung 4).

Benutzer aktivieren
Abbildung 4 - Benutzer aktivieren

Schritt 5 - Nachricht empfangen

Schließlich können Sie sehen, dass wenn eine Nachricht von diesem Benutzer empfangen wird, das Skript ausgeführt wird und, wie in diesem Beispiel, die Antwort-SMS an den ursprünglichen Absender gesendet wird (Abbildung 5).

Nachricht empfangen
Abbildung 5 - Nachricht empfangen

ASP C# Programmierleitfaden

Erstellen Sie eine Klasse namens 'Program' im 'Ozeki'-Namespace. Sie können auch die notwendigen using-Direktiven einfügen.

using System;
​
namespace Ozeki
{ 
    public class Program 
    {
    }
}

Implementieren Sie die 'Receive'-Funktion innerhalb der 'Program'-Klasse. Diese Funktion wird aufgerufen, wenn Ihre Verbindung eine Nachricht empfängt. Der Parameter der 'Receive'-Funktion ist ein Objekt vom Typ 'Message'.

using System;
​
namespace Ozeki
{ 
    public class Program 
    {
        public void Receive(Message msg)
        {
        }
    }
}

Eine Antwortnachricht senden

Beim Empfang einer Nachricht können Sie eine Antwort senden, um Ihren Absender über die erfolgreiche Zustellung zu informieren. Um dies zu erreichen, können Sie die eingebaute 'Reply'-Funktion verwenden.

using System;
​
namespace Ozeki
{ 
    public class Program 
    {
        public void Receive(Message msg)
        {
            Reply(msg, "Vielen Dank für die Nachricht!");
        }
    }
}

Nachrichtenweiterleitung

Sie können Ihre empfangene Nachricht auch an eine andere Verbindung weiterleiten, indem Sie die 'Send'-Funktion verwenden.

using System;
​
namespace Ozeki
{ 
    public class Program 
    {
        public void Receive(Message msg)
        {
            Send("admin@localhost", msg.Text);
        }
    }
}

Ihre Nachricht verfassen

Das Verfassen einer Nachricht ist einfacher, als Sie denken. Sie müssen nur den eingebauten 'Message'-Typ verwenden, um ein neues Nachrichtenobjekt zu erstellen. Im folgenden Beispiel erstellen und senden wir eine neue Nachricht an die Admin-Verbindung, wenn eine Nachricht empfangen wurde.

using System;
​
namespace Ozeki
{ 
    public class Program 
    {
        public void Receive(Message msg)
        {
            var message = new Message();
            message.Text = "Hallo Welt!";
            message.ToAddress = "+4412345678910";
            message.ToConnection = "admin@localhost";
            message.FromAddress = "+448888999910";
          
            Send(message);
        }
    }
}

Protokollierung

Die Verwendung von Protokollnachrichten macht das Debuggen Ihres Skripts viel einfacher. Durch Aufruf der 'Log'-Funktion können Sie bei Bedarf eine ordnungsgemäße Protokollierung in Ihrem Skript implementieren.

using System;
​
namespace Ozeki
{ 
    public class Program 
    {
        public void Receive(Message msg)
        {
            Log("Nachricht empfangen: " + msg.Text);
        }
    }
}

Zusammenfassung

Im obigen Artikel haben Sie wichtige Dinge über die Ausführung von C# .NET-Code mit dem Ozeki SMS Gateway gelernt. Die Kombination der Leistungsfähigkeit des Ozeki SMS Gateways und eines C#.NET-Skripts ergibt ein nützliches und vielseitiges Nachrichtensystem. Wenn Sie einen C#.NET-Code ausführen können, wenn eine SMS-Nachricht eingeht, können Sie Logiken implementieren, um jede Aufgabe auszuführen. Ein gutes Beispiel wäre, eine vordefinierte Antwort auf die eingehende Nachricht zu senden. Ein weiteres gutes Beispiel ist das Senden von Benachrichtigungsnachrichten innerhalb Ihrer Organisation im Falle einer eingehenden Nachricht.

Um mehr über die C# SMS API zu erfahren, folgen Sie dem Link zum Artikel über dieses Thema auf der Ozeki-Webseite: C# SMS API. Ozeki hat weitere Artikel zu diesem Thema. Zum Beispiel C# HTTP SMS.

Um mit der Arbeit zu beginnen, müssen Sie nur den Ozeki SMS Gateway jetzt herunterladen!

More information