Ako naplánovať SMS vo Visual Basic

Najjednoduchší spôsob, ako odoslať SMS z Visual Basic, je použiť vstavanú HTTP/Rest SMS API Ozeki SMS Gateway. Keď použijete toto API, budete odosielať SMS správy vytvorením HTTP POST požiadavky na SMS bránu. HTTP POST požiadavka bude obsahovať správu formátovanú v json formáte. SMS brána odošle túto SMS na príjemcove telefónne číslo a vráti HTTP 200 OK odpoveď na vašu požiadavku.

Nižšie uvedený ukážkový kód Visual Basic pre SMS demonštruje, ako môžete odosielať SMS pomocou http rest sms api Ozeki SMS Gateway s použitím knižnice Visual Basic Ozeki.Libs.Rest. Táto knižnica je poskytovaná bezplatne a môžete ju použiť a upraviť v akomkoľvek z vašich projektov.

Imports Ozeki.Libs.Rest

Module Program
    Sub Main(args As String())

        Dim configuration As New Configuration
        configuration.Username = "http_user"
        configuration.Password = "qwe123"
        configuration.ApiUrl = "http://127.0.0.1:9509/api"

        Dim msg As New Message
        msg.ToAddress = "+36201111111"
        msg.Text = "Hello, World!"
        msg.TimeToSend = DateTime.Parse("2021-06-11 14:46:00")

        Dim api = New MessageApi(configuration)

        Dim result = api.Send(msg)

        Console.WriteLine(result)
        Console.ReadKey()

    End Sub
End Module
	

Ako použiť ukážku Visual Basic pre SMS:

Túto ukážku Visual Basic pre SMS môžete použiť v akomkoľvek .NET alebo .NET core aplikácii. Na použitie je potrebné pridať Ozeki.Libs.Rest dll ako referenciu do vášho projektu. Po pridaní referencie projektu musíte vložiť direktívu using Ozeki.Libs.Rest; do hlavičkovej časti vášho zdrojového kódu Visual Basic. To vám umožní používať triedy poskytované knižnicou Ozeki.Libs.Rest. Môžete použiť triedu Message na vytvorenie SMS. Môžete použiť triedu MessageApi na odoslanie SMS na SMS bránu. SMS brána prepošle vašu správu do mobilnej siete buď prostredníctvom bezdrôtového pripojenia alebo cez internet.

Zdrojový kód vysvetlený v tomto článku je možné stiahnuť, použiť a upraviť bezplatne.
Stiahnuť: SendScheduledSms.vb.zip (47.6Kb)

Súbor SendScheduledSms.cs obsahuje knižnicu Ozeki.Libs.Rest, ktorá vám poskytuje všetky potrebné nástroje na odosielanie a prijímanie SMS správ. V zip súbore nájdete aj projekt SendScheduleSms, ktorý obsahuje ukážkový kód, ktorý vám ukáže, ako odoslať SMS. Tento ukážkový kód je uvedený nižšie.

Na odoslanie SMS z Visual Basic:

1. Nainštalujte Ozeki SMS Gateway
2. Pripojte Ozeki SMS Gateway k mobilnej sieti
3. Odošlite testovaciu SMS z Ozeki GUI
4. Vytvorte používateľa HTTP SMS API
5. Spustite Visual Studio
6. Vytvorte riešenie s názvom SendScheduledSms.sln
7. Pridajte Visual Basic konzolový projekt: SendScheduledSms.vbproj
8. Vložte kód do Program.vb alebo SendScheduledSms.vb
9. Vytvorte funkciu Visual Basic s názvom Send_SMS
10. Vytvorte JSON dáta pre SMS
11. Vytvorte HTTP požiadavku na odoslanie SMS
12. Prečítajte si HTTP odpoveď
13. Vypíšte odpoveď na konzolu
14. Skontrolujte záznamy v SMS bráne

Na odosielanie SMS z Visual Basic je potrebné najprv nainštalovať Ozeki SMS Gateway. SMS bránu je možné nainštalovať na rovnakom počítači, kde vyvíjate svoj Visual Basic kód v Visual studio. Po inštalácii je ďalším krokom pripojenie Ozeki SMS Gateway k mobilnej sieti. Môžete odoslať testovaciu SMS z Ozeki GUI na overenie, či vaše mobilné pripojenie funguje. Posledným krokom pri príprave vášho prostredia je vytvorenie používateľa HTTP SMS API. Vytvorte používateľa s používateľským menom "http_user" a heslom "qwe123", aby ukážka fungovala bez úprav.

Po nastavení prostredia môžete spustiť svoj Visual Basic kód.

Na odosielanie SMS z Visual Basic bude váš Visual Basic kód musieť vytvoriť HTTP požiadavku na SMS bránu. API URL je uvedené nižšie. Upozorňujeme, že IP adresa (127.0.0.1) by mala byť nahradená IP adresou vašej SMS brány. Ak je Ozeki SMS Gateway nainštalovaná na rovnakom počítači, kde beží Visual Basic SMS aplikácia, môže to byť 127.0.0.1. Ak je nainštalovaná na inom počítači, mala by to byť IP adresa toho počítača.

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

HTTP autentifikácia na odosielanie SMS z Visual Basic

Na autentifikáciu Visual Basic SMS klienta musíte odoslať používateľské meno a heslo v base64 kódovanom reťazci na server v HTTP požiadavke. Použitý formát je: base64(používateľské meno+":"+heslo). V C# môžete na toto kódovanie použiť nasledujúci kód:

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

Napríklad, ak zakódujete používateľské meno 'http_user' a heslo 'qwe123', dostanete nasledujúci base64 kódovaný reťazec: aHR0cF91c2VyOnF3ZTEyMw==. Na odoslanie

Na odoslanie SMS správ musíte do HTTP požiadavky zahrnúť nasledujúce riadky ako hlavičky. Poznamenajte, že zahrňujeme typ obsahu a autorizačnú hlavičku.

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

Na odoslanie SMS bude vaša Visual Basic aplikácia odosielať HTTP požiadavku podobnú nižšie uvedenej. Poznamenajte, že táto požiadavka obsahuje časť HTTP hlavičky a časť tela HTTP. Telo HTTP je reťazec dát zakódovaný v JSON. Obsahuje číslo príjemcu a text správy.

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:9509

{
  "messages": [
    {
      "message_id": "9f79a6bd-5264-4ebe-a04c-4f1353c54657",
      "to_address": "+36201111111",
      "text": "Hello, World!",
      "create_date": "2021-06-11 14:34:41",
      "valid_until": "2021-06-18 14:34:41",
      "time_to_send": "2021-06-11 14:46:00",
      "submit_report_requested": true,
      "delivery_report_requested": true,
      "view_report_requested": true,
      "tags": []
    }
  ]
}
	

Keď SMS brána prijme túto požiadavku, vygeneruje HTTP odpoveď. HTTP odpoveď bude obsahovať stavový kód, ktorý indikuje, či bola požiadavka na odoslanie SMS úspešná alebo nie. Tiež vráti štruktúru zakódovanú v JSON, ktorá poskytne užitočné informácie o odoslaní správy.

HTTP/1.1 200 OK
User-Agent: OZEKI 10.3.118 (www.myozeki.com)
Content-Type: application/json; charset=utf8
Last-Modified: Fri, 11 Jun 2021 08:44:45 GMT
Server: 10/10.3.118
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": "ca824cbe-784c-44f9-b657-1c04f711f529",
        "from_station": "%",
        "to_address": "+36201111111",
        "to_station": "%",
        "text": "Hello, World!",
        "create_date": "2021-06-11 14:34:41",
        "valid_until": "2021-06-18 14:34:41",
        "time_to_send": "2021-06-11 14:46:00",
        "submit_report_requested": true,
        "delivery_report_requested": true,
        "view_report_requested": false,
        "tags": [
          {
            "name": "Type",
            "value": "SMS:TEXT"
          }
        ],
        "status": "SUCCESS"
      }
    ]
  }
}
	

V tomto videu sa naučíte, ako stiahnuť a spustiť príkladový projekt SendScheduledSms.sln. Video začne stránkou na stiahnutie a skončí otvoreným editorom kódu. Naučíte sa, ako stiahnuť a ako otvoriť príkladový kód v Visual Basic. Toto veľmi podrobné video je dlhé len 1 minútu a je ľahko pochopiteľné. Nebojte sa, nebudete mať problém s jeho sledovaním.

Príkladový kód nižšie je súčasťou SendScheduledSms.sln riešenia Visual Studio. Riešenie Visual Studio môže obsahovať viacero projektov a viacero súborov. V tomto riešení je len jeden projekt: SendScheduledSms.vbproj, a jeden súbor: Program.vb.

V ďalšom videu sa naučíte, ako spustiť príkladový kód a ako skontrolovať záznam procesu. Začne sa spustením Ozeki SMS Gateway a prevedie vás až k zoznamu odložených správ. Naučíte sa, ako skontrolovať záznam a ako spustiť projekt na odoslanie naplánovaných správ. Video je dlhé len 1:22 minúty, takže nebudete mať problém s jeho pochopením. Používame softvér Ozeki SMS Gateway na zaznamenávanie a odosielanie SMS. Je to výkonný, no ľahko naučiteľný softvér brány.

Keď použijete Windows na spustenie tohto príkladu SMS napísaného v Visual Basic, zistíte, že dostanete mierne lepší výkon, ako keď ho spustíte na Linuxe. Aby ste pochopili prečo sa to deje, musíte mať na pamäti, že Visual Basic používa na vykonávanie kódu .NET framework. Je to preto, lebo implementácia .NET na Windows je optimalizovaná pre výkon, zatiaľ čo mono, implementácia .NET na Linuxe, má v tejto oblasti nejaké dobiehanie.

Záver

Cieľom tohto článku bolo ukázať kroky naplánovania SMS vo VB s pomocou Ozeki SMS Gateway. Nástroje a vysvetlenie sú poskytované spoločnosťou Ozeki. Ak ste si všetko pozorne prečítali a vykonali všetky kroky, mali by ste byť schopní naplánovať správy v jazyku Visual Basic.

Ozeki SMS Gateway si môžete stiahnuť z webovej stránky Ozeki a môžete ho používať počas skúšobného obdobia, ktoré je úplne zadarmo. Plánovanie správ vám umožňuje odosielať SMS mobilným používateľom, keď nie sú zaneprázdnení, čo znamená, že môžete pracovať s vyššou efektivitou.

Nezastavujte sa len pri tomto čítaní, pozrite si stránku s návodmi od Ozeki, kde nájdete viac informácií o podobných témach, ako je prijímanie vo VB.

Ďalšou vecou, ktorú by ste mali urobiť, je stiahnuť si Ozeki SMS Gateway a nechať prácu začať!