Přijímání SMS v C#

Následující průvodce ukáže, jak můžete získat zprávy přijaté vaší SMS bránou pomocí aplikace v C#. Tento příklad v C# používá HTTP požadavky k dotazování na zprávy z vaší složky doručené pošty v SMS bráně. SMS brána shromažďuje všechny tyto přijaté zprávy a odesílá je do aplikace v C# jako odpověď na HTTP požadavek. Průvodce také ukazuje, jak můžete použít připojení HTTP serveru k simulaci příchozích zpráv. Dokončení tohoto průvodce nezabere více než pět minut, takže začněme hned teď.

Co je C# SMS API?

C# SMS API je skvělý nástroj pro odesílání SMS zpráv z jakéhokoli projektu nebo aplikace založené na C# pomocí iniciování HTTP požadavků a jejich předávání do SMS brány.

Předpoklady

• Nainstalované Visual Studio 2019 Community Edition
• Nainstalovaná Ozeki 10 SMS brána
• Nakonfigurované připojení HTTP serveru

Přijímání SMS v C#

• Otevřete Visual Studio
• Vytvořte nový projekt Console App
• Zkopírujte příklad kódu v C# z této stránky
• Vložte kód do vaší aplikace v C#
• Otevřete Ozeki 10 SMS bránu
• Vyberte připojení HTTP serveru
• Odešlete testovací zprávy pomocí připojení HTTP serveru
• Spusťte vaši aplikaci v C# pro získání všech příchozích zpráv

Níže uvedený příklad kódu v C# je schopen shromažďovat všechny příchozí zprávy pomocí HTTP požadavků. Tento příklad kódu je volně k použití, můžete jej upravit a implementovat do vlastního projektu nebo aplikace. Pokud si přejete pouze otestovat řešení, musíte postupovat podle podrobných pokynů níže nebo sledovat výše uvedené video, které demonstruje, jak můžete tento příklad kódu v C# použít.

using System;
using System.Net.Http;
using System.Xml;
using System.Threading.Tasks;

namespace ReceiveSMS
{
    class Program
    {
        static async Task Main(string[] args)
        {
            var username = "john";
            var password = "Xc3ffs";
            var httpUrl = "https://127.0.0.1:9508/";
            var folder = "inbox";
            var limit = "3";

            var sendString = $"{httpUrl}api?action=receivemessage&username=" +
                 $"{username}&password={password}&folder={folder}&limit=" +
                 $"{limit}&afterdownload=delete";

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

            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: ");
                DisplayMessages(response);
            }
            catch (Exception e)
            {
                Console.WriteLine(e.Message);
            }
        }
        static void DisplayMessages(string response)
        {
            var xmlDoc = new XmlDocument();
            xmlDoc.LoadXml(response);
            var nodes = xmlDoc.SelectNodes("response/data/message");

            foreach (XmlNode node in nodes)
            {
                try
                {
                    var sender = node.SelectSingleNode("originator").InnerText;
                    var text = node.SelectSingleNode("messagedata").InnerText;
                    DisplayMessage(sender, text);
                }
                catch (System.NullReferenceException e)
                {
                    Console.WriteLine("The inbox is empty!");
                } 
            }
        }
        static void DisplayMessage(string sender, string text)
        {
            Console.WriteLine($"{sender}: {text}");
        }

    }
}

Krok 1 - Otevřete Visual Studio

Prvním krokem průvodce je vytvoření aplikace v C#, kam můžete umístit příklad kódu z této stránky. Nejlepším nástrojem pro vytvoření aplikace v C# je Visual Studio. Můžete si jej stáhnout v sekci Předpoklady, pokud jej ještě nemáte. Pokud je Visual Studio již nainstalováno na vašem počítači, stačí jej otevřít z plochy, jak vidíte na Obrázku 1.

Po otevření Visual Studia se zobrazí uvítací okno. Můžete otevřít nedávný projekt nebo vytvořit zcela nový z tohoto okna. Jak ukazuje obrázek 2, nyní potřebujete vytvořit nový projekt, takže stačí vybrat tuto možnost z daného okna.

Krok 3 - Vyberte Console App

Po rozhodnutí vytvořit nový projekt, další okno zobrazí všechny dostupné možnosti, které můžete vybrat, pokud chcete vytvořit novou C# aplikaci. Pro následování tohoto průvodce stačí vytvořit jednoduchou Console App, tak jak ukazuje obrázek 3, stačí vybrat tuto možnost a kliknout na 'Další'.

Krok 4 - Nakonfigurujte svůj projekt

Před finálním vytvořením projektu Console App je potřeba provést některé konfigurace projektu. Tyto konfigurace jsou velmi jednoduché; stačí zadat název vašeho projektu, jak můžete vidět na obrázku 4. V tomto okně můžete také určit umístění souborů projektu. Pokud jste dokončili všechny konfigurace, stačí kliknout na 'Vytvořit' pro vytvoření projektu Console App.

Krok 5 - Vložte ukázkový kód do projektu

Vytvořený projekt obsahuje jeden C# soubor, který je Program.cs. Toto je soubor, kam potřebujete vložit ukázkový kód. Pro to stačí přejít nahoru k ukázkovému kódu, označit celý kód, a stisknout Ctrl+C na klávesnici. Tato operace zkopíruje kód do vaší schránky. Poté přejděte do souboru Program.cs, smažte kód, který zde najdete, a jak ukazuje obrázek 5, stiskněte Ctrl+V pro vložení kódu do tohoto souboru.

Krok 6 - Simulujte příchozí zprávy

Další věc, kterou potřebujete udělat, je počkat na příchozí zprávy ve vašem SMS Gateway. To může chvíli trvat, takže můžete zvolit možnost simulovat některé zprávy pomocí HTTP Server připojení. Tak, jak ukazuje obrázek 6, stačí otevřít HTML formulář HTTP Server připojení. Tento formulář poskytuje možnost vytvořit některé zprávy. Stačí zadat 'Ozeki' jako příjemce a napsat nějaký text do pole 'MessageData'. Pro odeslání testovací zprávy stačí kliknout na 'Odeslat'.

Krok 7 - Spusťte ukázkový C# kód

Poslední krok, který potřebujete provést, je spustit C# kód a získat přijaté zprávy. Pro to stačí kliknout na tlačítko 'Spustit' v Visual Studiu, jak můžete vidět na obrázku 7. Tím se zobrazí konzolové okno, které vypíše HTTP požadavek, který vaše aplikace odeslala. Také vypíše odpověď z SMS Gateway, což je seznam všech zpráv, které lze nalézt ve vaší složce příchozích zpráv.

Závěr

Tento tutoriál vám poskytl všechny potřebné informace o tom, jak můžete přijímat SMS zprávy v C#. Příjem zpráv v C# znamená, že můžete implementovat funkci příjmu zpráv v jakémkoli vašem C# projektu. To povede k univerzálnímu a široce používanému projektu. Toto řešení se točí kolem Ozeki SMS Gateway, což znamená, že můžete sledovat zprávy při průchodu systémem a můžete snadno detekovat chyby díky nízké úrovni logování Ozeki SMS Gateway.

Ujistěte se, že se zde nezastavíte v procesu učení. Neváhejte se podívat na další články na webu Ozeki. Například začněte s odesíláním SMS zpráv pomocí C#. Dalším dobrým článkem k učení je, jak simulovat příchozí zprávy pro testovací účely.

Další věc, kterou je třeba udělat, je stáhnout Ozeki SMS Gateway a začít vyvíjet hned teď!