Jak wysłać SMS z C# przy użyciu HTTP

Możesz łatwo zbudować aplikację konsolową w C#, która pozwoli Ci wysłać żądanie HTTP do bramki SMS Ozeki 10. Po uruchomieniu załączonej aplikacji, najpierw wyświetli ona żądanie HTTP w konsoli, a następnie je wyśle. Jeśli wszystko pójdzie dobrze, bramka SMS Ozeki 10 odbierze to żądanie i wyśle odpowiedź. Nasza aplikacja w C# odbierze tę odpowiedź i wyświetli ją w konsoli. Z tej odpowiedzi możemy dowiedzieć się, czy dostarczenie wiadomości zakończyło się sukcesem.

Co to jest API SMS w C#?

API SMS w C# to doskonałe narzędzie umożliwiające wysyłanie wiadomości SMS z dowolnego projektu lub aplikacji opartej na C#, poprzez inicjowanie żądań HTTP i przekazywanie ich do Bramki SMS.

Wymagania wstępne

Wysyłanie SMS z C#

Jeśli chcesz wysyłać SMS-y z C#, możesz użyć HTTP SMS API Bramki SMS Ozeki.

Aby wysłać SMS z C#:

  1. Otwórz https://localhost:9515 w przeglądarce i zaloguj się
  2. Utwórz nowego użytkownika HTTP API
  3. Sprawdź numer portu usługi HTTP API
  4. Uruchom Visual Studio
  5. Utwórz nowy projekt konsolowy w C#
  6. Wyślij SMS z C#, wpisując poniższy kod źródłowy
  7. Uruchom projekt aplikacji konsolowej
  8. Sprawdź SMS wysłany z Twojego projektu C# na swoim telefonie

Wideo: Jak wysłać SMS z C#

Wideo 1 - Jak wysłać SMS z C# (Samouczek wideo)

Przykładowy kod źródłowy SMS w C#

Poniższy przykładowy kod źródłowy w C# jest darmowy do użycia, możesz go po prostu zaimplementować w swoim projekcie lub zmodyfikować kod źródłowy, aby użyć go w innych projektach lub aplikacjach. Jeśli chcesz uruchomić ten przykładowy kod, wystarczy, że skopiujesz i wkleisz go do swojego projektu aplikacji konsolowej i uruchomisz projekt.

using System;
using System.Net.Http;
using System.Text;
using System.Web;
namespace HttpApiTester
{
    class Program
    {
        static async System.Threading.Tasks.Task Main(string[] args)
        {
            var username = "john";
            var password = "Xc3ffs";
            var messagetype = "SMS:TEXT";
            var httpUrl = "https://127.0.0.1:9508/";
            var recipient = HttpUtility.UrlEncode("+36201324567", Encoding.UTF8);
            var messagedata = HttpUtility.UrlEncode("TestMessage", Encoding.UTF8);
            
            var sendString = $"{httpUrl}api?action=sendmessage&username=" +
                             $"{username}&password={password}" +
                             $"&recipient={recipient}&messagetype=" +
                             $"{messagetype}&messagedata={messagedata}";

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

            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: ");
                Console.WriteLine(response);

            } catch(Exception e)
            {
                Console.WriteLine(e.Message);
            }
        }
    }
}

Krok 1 - Otwórz Visual Studio

Pierwszym krokiem do stworzenia aplikacji, która może wysyłać wiadomości SMS, jest otwarcie Visual Studio. Jeśli jeszcze nie pobrałeś Visual Studio, po prostu kliknij w link w sekcji Wymagania wstępne powyżej, aby pobrać najnowszą wersję. Jeśli masz zainstalowane Visual Studio na swoim komputerze, wystarczy, że klikniesz jego ikonę (Rysunek 1) na pulpicie, aby je otworzyć.

otwórz visual studio
Rysunek 1 - Otwórz Visual Studio 2019

Krok 2 - Utwórz nowy projekt

Po otwarciu Visual Studio pojawi się okno startowe, jak widać na Rysunku 2. Tutaj możesz zobaczyć swoje rozwiązania, otworzyć istniejące, sklonować repozytorium lub otworzyć lokalny folder. Aby postępować zgodnie z przewodnikiem, musisz kliknąć przycisk 'Utwórz nowy projekt', aby utworzyć projekt do wysyłania SMS-ów.

tworzenie nowego projektu w visual studio
Rysunek 2 - Tworzenie nowego projektu

Krok 3 - Wybierz aplikację konsolową

W następnym oknie zostanie wyświetlona lista wszystkich dostępnych typów projektów, które można utworzyć w Visual Studio. W tym przykładzie należy utworzyć prostą aplikację konsolową, jak pokazuje to Rysunek 3, ale możesz użyć usługi wysyłania SMS w wielu innych typach projektów. Więc wszystko, co musisz tutaj zrobić, to kliknąć opcję Aplikacja konsolowa z listy dostępnych typów projektów.

wybieranie aplikacji konsolowej
Rysunek 3 - Wybieranie aplikacji konsolowej

Krok 4 - Konfiguracja projektu

Przed utworzeniem projektu, ostatnim krokiem jest jego skonfigurowanie poprzez określenie niektórych szczegółów projektu. Tutaj możesz nadać nazwę projektowi oraz ustawić folder lokalizacji, jak widać na Rysunku 4. Jeśli zakończysz konfigurację, możesz po prostu kliknąć „Utwórz”, aby utworzyć projekt aplikacji konsolowej.

konfiguracja projektu w Visual Studio
Rysunek 4 - Konfiguracja projektu w Visual Studio

Krok 5 - Skopiuj przykładowy kod

Po utworzeniu projektu aplikacji konsolowej, teraz musisz skonfigurować przykładowy kod, który chcesz wykonać. W tym celu przewiń w górę tej strony, aby znaleźć sekcję z przykładowym kodem i zaznacz cały kod źródłowy, jak pokazuje to Rysunek 5. Następnie naciśnij Ctrl+C na klawiaturze, aby skopiować kod źródłowy.

kopiowanie kodu ze strony internetowej
Rysunek 5 - Kopiowanie kodu ze strony internetowej

Krok 6 - Wklej kod źródłowy do swojego projektu

W Visual Studio utworzony projekt zawiera początkowy plik źródłowy Program.cs. W tym momencie jest to plik, którego musisz użyć, aby wykonać przykładowy program. Najpierw zaznacz kod w tym pliku i usuń go. Następnie, jak pokazuje to Rysunek 6, naciśnij Ctrl+V na klawiaturze, aby wkleić przykładowy kod do pliku Program.cs. Teraz projekt jest gotowy do użycia.

wklejanie kodu do Visual Studio
Rysunek 6 - Wklejanie kodu do Visual Studio

Krok 7 - Wykonaj przykładowy projekt

Ostatnim krokiem tego przewodnika jest wykonanie przykładowego programu. W Visual Studio jest to dość proste, wystarczy kliknąć przycisk Uruchom, jak widać na Rysunku 7. Po uruchomieniu programu pojawi się okno konsoli, które wyświetli żądanie HTTP wysłane przez program do Bramki SMS. Pokazuje również odpowiedź z Bramki SMS, która informuje, czy dostarczenie SMS-a zakończyło się sukcesem.

kompilowanie i uruchamianie kodu w Visual Studio
Rysunek 7 - Kompilowanie i uruchamianie kodu w Visual Studio

Krok 8 - Sprawdź wynik wysyłki w dzienniku Ozeki

W Ozeki 10 SMS Gateway możesz łatwo sprawdzić, jakie wiadomości zostały wysłane przez Twoją aplikację, ponieważ usługa HTTP API rejestruje każde zdarzenie, które wystąpiło podczas jej działania. Więc jeśli otworzysz Bramkę SMS i wybierzesz szczegóły usługi HTTP API, będziesz mógł zobaczyć zdarzenia. Jak widać na Rysunku 8, usługa zarejestrowała zdarzenie, gdy przykładowy program w C# wysłał żądanie HTTP do usługi.

sprawdź dzienniki usługi HTTP API
Rysunek 8 - Sprawdź dzienniki usługi HTTP API

Proces wysyłania wiadomości można również prześledzić za pomocą zdarzeń. W tym celu otwórz połączenie użytkownika HTTP API, które musiałeś wcześniej skonfigurować. Rysunek 9 pokazuje, jak połączenie obsługuje żądanie HTTP i wysyła wiadomość do odbiorcy, którego określiłeś w swoim programie w C#.

sprawdź dzienniki użytkownika HTTP API
Rysunek 9 - Sprawdź dzienniki użytkownika HTTP API

Podsumowanie

Ten przewodnik dostarczył wszystkich niezbędnych informacji na temat wysyłania SMS-ów do dowolnego odbiorcy z Twojego komputera. To rozwiązanie wykorzystuje połączenie C# i Bramki SMS Ozeki, która działa w każdym kraju i może wysyłać oraz odbierać SMS-y przez różne połączenia mobilne. To znacznie ułatwi komunikację z Twoimi współpracownikami i klientami Twojej organizacji.

Bramka SMS Ozeki to narzędzie, które można kontrolować za pomocą żądań HTTP. Aby dowiedzieć się więcej na ich temat, odwiedź artykuł o odbieraniu SMS-ów przy użyciu C# HTTP SMS API, lub uzyskaj informacje o innych obsługiwanych językach, takich jak PHP.

Wszystko, co musisz zrobić, to pobrać Bramkę SMS Ozeki i zacząć budować swoje rozwiązanie już teraz!

More information