Primire SMS în C#

Următorul ghid vă va demonstra cum puteți obține mesajele primite de către SMS Gateway cu o aplicație C#. Acest exemplu C# utilizează cereri HTTP pentru a solicita mesajele din folderul de primire din SMS Gateway. SMS Gateway colectează toate aceste mesaje primite și le trimite către aplicația C# ca răspuns la cererea HTTP. Ghidul arată, de asemenea, cum puteți utiliza conexiunea la serverul HTTP pentru a simula mesaje primite. Nu durează mai mult de cinci minute pentru a finaliza acest ghid, așa că să începem chiar acum.

API-ul SMS pentru C# este un instrument excelent pentru a putea trimite mesaje SMS din orice fel de proiect sau aplicație bazată pe C# prin inițierea cererilor HTTP și transmiterea lor către SMS Gateway.

• Visual Studio 2019 Community Edition instalat
• Ozeki 10 SMS Gateway instalat
• O conexiune HTTP Server configurată

• Deschideți Visual Studio
• Creați un nou proiect Console App
• Copiați codul exemplu C# de pe această pagină
• Lipiți codul în aplicația dvs. C#
• Deschideți Ozeki 10 SMS Gateway
• Selectați conexiunea HTTP Server
• Trimiteți mesaje de test folosind conexiunea HTTP Server
• Rulați aplicația dvs. C# pentru a obține toate mesajele primite

Exemplul de cod C# de mai jos este capabil să colecteze toate mesajele primite folosind cereri HTTP. Acest exemplu de cod este liber de utilizare, îl puteți modifica și implementa în propriul dvs. proiect de aplicație. Dacă doriți doar să testați soluția, trebuie să urmați instrucțiunile pas cu pas de mai jos sau să urmăriți videoclipul de mai sus care demonstrează cum puteți utiliza acest exemplu de cod C#.

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}");
        }

    }
}

Primul pas al ghidului, pentru a crea o aplicație C# unde puteți plasa exemplul de cod de pe această pagină. Cel mai bun instrument pentru a crea o aplicație C# este Visual Studio. Îl puteți descărca din secțiunea Cerințe preliminare dacă nu îl aveți deja. Dacă Visual Studio este deja instalat pe computer, trebuie doar să îl deschideți de pe desktop așa cum puteți vedea în Figura 1.

Pasul 2 - Creează un proiect nou

După ce ai deschis Visual Studio, va apărea fereastra de bun venit. Poți deschide un proiect recent sau poți crea unul complet nou din această fereastră. După cum demonstrează Figura 2, acum trebuie să creezi un proiect nou, așa că trebuie doar să selectezi această opțiune din fereastra respectivă.

După ce ai decis să creezi un proiect nou, următoarea fereastră listează toate opțiunile disponibile pe care le poți selecta dacă dorești să creezi o nouă aplicație C#. Pentru a urma acest ghid, trebuie doar să creezi o simplă aplicație Console, așa cum arată Figura 3, selectează această opțiune și apasă pe 'Next'.

Înainte de a crea în final proiectul Console App, trebuie să faci câteva configurații asupra proiectului. Acestea sunt configurații foarte simple; trebuie doar să dai un nume proiectului tău, așa cum poți vedea în Figura 4. În această fereastră, poți specifica și locația fișierelor proiectului. Dacă ai terminat cu toate configurațiile, apasă pe 'Create' pentru a crea proiectul Console App.

Proiectul creat conține un fișier C#, care este Program.cs. Acesta este fișierul în care trebuie să introduci codul exemplu. Pentru asta, derulează în sus la codul exemplu, selectează întregul cod și apasă Ctrl+C pe tastatură. Această operațiune a copiat codul în clipboard. După aceea, mergi la fișierul Program.cs, șterge codul pe care îl găsești aici, și, ca în Figura 5, apasă Ctrl+V pentru a lipi codul în acel fișier.

Următorul lucru pe care trebuie să-l faci este să aștepți mesaje primite în SMS Gateway. Acest lucru poate dura ceva timp, așa că poți alege opțiunea de a simula câteva mesaje folosind conexiunea HTTP Server. Așa cum demonstrează Figura 6, deschide formularul HTML al conexiunii HTTP Server. Acest formular oferă posibilitatea de a crea câteva mesaje. Trebuie doar să tastezi 'Ozeki' ca destinatar și să scrii un text în câmpul 'MessageData'. Pentru a trimite mesajul de test, apasă pe 'Submit'.

Ultimul pas pe care trebuie să-l efectuezi este să rulezi codul C# și să obții mesajele primite. Pentru a face asta, apasă pe butonul 'Run' în Visual Studio, așa cum poți vedea în Figura 7. Făcând acest lucru, va apărea o fereastră de consolă care afișează cererea HTTP trimisă de aplicația ta. De asemenea, afișează mesajul de răspuns de la SMS Gateway, care este o listă cu toate mesajele găsite în folderul de primite.

Acest tutorial ți-a oferit toate informațiile necesare despre cum poți primi mesaje SMS în C#. Primirea mesajelor în C# înseamnă că poți implementa o funcționalitate de primire de mesaje în orice proiect C# al tău. Acest lucru va rezulta într-un proiect versatil și larg utilizat. Această soluție se bazează pe Ozeki SMS Gateway, ceea ce înseamnă că poți urmări mesajele care trec prin sistem și poți detecta erorile ușor datorită capacității de logare la nivel scăzut a Ozeki SMS Gateway.

Asigură-te că nu te oprești aici în procesul de învățare. Simte-te liber să verifici alte articole pe site-ul Ozeki. De exemplu, începe cu trimiterea mesajelor SMS folosind C#. Un alt articol bun de învățat este cum să simulezi mesaje primite în scopuri de testare.

Următorul lucru de făcut este să descărci Ozeki SMS Gateway și să începi dezvoltarea acum!