Cum să trimiți SMS programat din C#

Cea mai simplă metodă de a trimite SMS din C# este utilizarea API-ului HTTP/Rest SMS încorporat al Ozeki SMS Gateway. Când folosești acest API, vei trimite mesaje SMS prin emiterea unei cereri HTTP Post către gateway-ul SMS. Cererea HTTP Post va conține un mesaj formatat în format json. Gateway-ul SMS va trimite acest SMS către telefonul destinatar și va returna un răspuns HTTP 200 OK la cererea ta.

Exemplul de cod C# pentru SMS de mai jos demonstrează cum poți trimite SMS folosind API-ul http rest sms al Ozeki SMS Gateway utilizând biblioteca C# Ozeki.Libs.Rest. Această bibliotecă este oferită gratuit și o poți folosi și modifica în oricare dintre proiectele tale.

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 = "Bună, Lume!",
                TimeToSend = DateTime.Parse("2021-06-11 13:25:00")
            };


            var api = new MessageApi(configuration);

            var result = api.Send(msg);

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

Cum să folosești exemplul C# pentru SMS:

Acest exemplu C# pentru SMS poate fi folosit în orice aplicație .NET sau .NET core. Pentru a-l folosi, trebuie să adaugi DLL-ul Ozeki.Libs.Rest ca referință în proiectul tău. După ce referința proiectului este adăugată, trebuie să incluzi directiva using Ozeki.Libs.Rest; în secțiunea de antet a codului sursă C#. Acest lucru îți va permite să folosești clasele oferite de biblioteca Ozeki.Libs.Rest. Poți folosi clasa Message pentru a crea SMS-ul. Poți folosi clasa MessageApi pentru a trimite SMS-ul către gateway-ul SMS. Gateway-ul SMS va transmite mesajul tău către rețeaua mobilă fie printr-o conexiune fără fir, fie prin Internet.

Codul sursă explicat în acest articol poate fi descărcat, folosit și modificat gratuit.
Descarcă: SendScheduledSms.cs.zip (34.2Kb)

Fișierul SendScheduledSms.cs conține biblioteca Ozeki.Libs.Rest, care îți oferă toate instrumentele necesare pentru a trimite și primi mesaje SMS. Vei găsi de asemenea proiectul SendScheduleSms în arhiva zip, care conține codul exemplu pentru a-ți arăta cum să trimiți un SMS. Acest cod exemplu este listat mai jos.

Pentru a trimite SMS programat din C#:

1. Instalează utilizatorul HTTP API
2. Configurează Visual Studio
3. Descarcă fișierul SendScheduledSms.cs.zip
4. Extrage fișierul .zip din folderul Descărcări
5. Deschide fișierul SendScheduledSms.sln în Visual Studio
6. Adaugă DLL-ul Ozeki.Libs.Rest ca referință
7. Editează fișierul pentru a programa SMS din C#
8. Lansează Ozeki SMS Gateway
9. Rulează Program.cs în Visual Studio pentru a trimite SMS din C#
10. Verifică jurnalele

Pentru a putea trimite SMS din C#, mai întâi trebuie să instalezi Ozeki SMS Gateway. Gateway-ul SMS poate fi instalat pe același calculator pe care îți dezvolți codul C# în Visual Studio. După instalare, următorul pas este să conectezi Ozeki SMS Gateway la rețeaua mobilă. Poți trimite un SMS test din interfața grafică Ozeki pentru a verifica dacă conexiunea ta la rețeaua mobilă funcționează. Ultimul pas pentru a-ți pregăti mediul este să creezi un utilizator HTTP SMS API. Creează un utilizator cu numele de utilizator "http_user" și parola "qwe123" pentru ca exemplul să funcționeze fără modificări.

După ce mediul este configurat, poți rula codul tău C#.

Pentru a trimite SMS din C#, aplicația ta C# va trebui să emită o cerere HTTP către gateway-ul SMS. URL-ul API este afișat mai jos. Reține că adresa IP (127.0.0.1) ar trebui să fie înlocuită cu adresa IP a gateway-ului tău SMS. Dacă Ozeki SMS Gateway este instalat pe același calculator pe care rulează aplicația C# pentru SMS, aceasta poate fi 127.0.0.1. Dacă este instalat pe un calculator diferit, ar trebui să fie adresa IP a acelui calculator.

http://127.0.0.1:9509/api?action=rest

Pentru a autentifica clientul C# pentru SMS, trebuie să trimiți numele de utilizator și parola într-un șir codificat base64 către server într-o cerere HTTP. Formatul folosit este: base64(nume_utilizator+":"+parolă). În C# poți folosi următorul cod pentru a face această codificare:

var encoding = Encoding.GetEncoding("iso-8859-1");
var usernamePassword = username + ":" + password;
var usernamePasswordEncoded = Convert.ToBase64String(encoding.GetBytes(usernamePassword));

De exemplu, dacă codezi numele de utilizator 'http_user' și parola 'qwe123', vei obține următorul șir codificat base64: aHR0cF91c2VyOnF3ZTEyMw==. Pentru a trimite

Antetul cererii HTTP pentru trimiterea SMS-urilor din C#

Pentru a trimite mesajele SMS, trebuie să includeți următoarele linii ca antete în cererea HTTP. Rețineți că includem un tip de conținut și un antet de autorizare.

Content-Type: application/json
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==

Pentru a trimite SMS-ul, aplicația dvs. C# va trimite o cerere HTTP similară cu cea de mai jos. Rețineți că această cerere conține o parte de antet HTTP și o parte de corp HTTP. Corpul HTTP este un șir de date codificat în JSON. Acesta conține numărul destinatarului și textul mesajului.

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": []
    }
  ]
}

Odată ce gateway-ul SMS primește această cerere, va genera un răspuns HTTP. Răspunsul HTTP va conține un cod de stare, pentru a indica dacă cererea de trimitere a SMS-ului a fost reușită sau nu. De asemenea, va returna o structură codificată în JSON pentru a vă oferi detalii utile despre trimiterea mesajului.

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"
      }
    ]
  }
}

În acest videoclip, vă vom arăta cum să deschideți proiectul SendSMS.sln și să începeți să lucrați cu el. Videoclipul va începe cu pagina de tutorial și linkul de descărcare și vă va conduce până la codul deschis. Veți învăța cum să descărcați proiectul și cum să îl deschideți. Videoclipul durează doar 1 minut, dar conține toate informațiile necesare pentru a deschide proiectul SendSMS.sln pentru trimiterea programată a SMS-urilor.

Codul exemplu de mai jos face parte din Soluția Visual Studio SendScheduledSms.sln. O soluție Visual Studio poate conține mai multe proiecte și mai multe fișiere. În această soluție există un singur proiect: SendScheduledSms.csproj, și un singur fișier: Program.cs.

Acest videoclip vă prezintă cum să utilizați proiectul SendSMS.sln pentru trimiterea programată a SMS-urilor. Acesta va începe cu proiectul deschis și se va încheia cu jurnalul mesajelor trimise. Veți învăța cum să adăugați ora la care doriți să trimiteți mesajul și cum să rulați codul. După aceea, veți putea verifica fila Evenimente cu jurnalul pentru trimiterea SMS-urilor. Videoclipul durează doar 80 de secunde și conține toți pașii importanți. Nu veți avea probleme în urmărirea tutorialului.

Când utilizați Windows pentru a rula acest exemplu de SMS scris în C#, veți observa că obțineți o performanță ușor mai bună decât atunci când îl rulați pe Linux. Pentru a înțelege de ce se întâmplă acest lucru, trebuie să țineți cont de faptul că C# utilizează cadrul .NET pentru executarea codului. Acest lucru se datorează faptului că implementarea .NET pe Windows este optimizată pentru performanță, în timp ce mono, implementarea .NET pe Linux, mai are de recuperat în acest domeniu.

Rezumat

Articolul de mai sus a explicat pașii de programare a SMS-urilor din C#. Ozeki oferă toate instrumentele și instrucțiunile, așa că finalizarea acestui ghid înseamnă că ar trebui să fii capabil să îți programezi mesajele folosind C# și Ozeki SMS Gateway.

Programarea SMS-urilor este foarte utilă dacă dorești să transmiți informații clienților și, de asemenea, să te asiguri că aceștia au timp să acorde atenție mesajului. În acest fel, poți fi sigur că mesajul nu va fi ignorat sau uitat, deoarece orele lor aglomerate vor fi evitate. Este important de menționat că Ozeki SMS Gateway oferă capabilități excelente de înregistrare, astfel încât erorile care apar pot fi urmărite ușor și rapid.

Continuă studiile pe paginile de tutoriale ale Ozeki, unde poți obține mai multe informații despre subiecte similare, cum ar fi ștergerea în C#.

Acum, singurul lucru pe care trebuie să-l faci este să descărci Ozeki SMS Gateway și să începi lucrul!