Hogyan küldjünk SMS-t C#.Net-ből

Az SMS küldéséhez C#.Net-ben több lehetőség is rendelkezésre áll. Használhatod az Ozeki C# SMS API könyvtárát, vagy HTTP kéréseket is indíthatsz. A legjobb megoldás a C# projekt típusától függ. Ha webes kérések kezelésére írsz kódot, például ASP oldalon, akkor az HTTP kérések a megfelelő választás. Ha asztali alkalmazást, Windows szolgáltatást vagy mobil alkalmazást fejlesztesz Androidra vagy iPhone-ra, akkor a C# SMS API könyvtár használata javasolt. Ez az útmutató (1. ábra) kizárólag az SMS küldésre fókuszál. Ha mindkét irányban szeretnél kommunikálni (küldés és fogadás), először olvasd el a Legjobb C# SMS API 2025-ben című útmutatót.

Hogyan küldjünk SMS-t C#.Net-ből
1. ábra - Hogyan küldjünk SMS-t C#.Net-ből

A C# SMS API könyvtár letöltése (ingyenes forráskód)

A C# SMS API működő példaprogramja letölthető az alábbi linkről. Ez a kód ingyenesen használható, módosítható és terjeszthető.

Letöltés: OzekiConsole.zip (51 Kb)

Hogyan küldjünk SMS-t C# asztali alkalmazásból

Az SMS küldése asztali alkalmazásból (vagy konzolalkalmazásból, Windows szolgáltatásból) eltérő követelményekkel jár, mint weboldalról történő küldés. Az asztali alkalmazások hosszabb ideig futnak (percektől hetekig), ezért előnyös, ha tartós kapcsolatot tartunk fenn az SMS átjáróval. Az egyszeri, "tüzelj és felejtsd el" típusú HTTP kérések nem ideálisak ilyen esetekben. A tartós kapcsolat legnagyobb előnye, hogy valós idejű értesítéseket kapunk az üzenetek állapotáról, például kézbesítési jelentéseket, sikeres vagy sikertelen kézbesítéseket.

Az SMS küldéséhez C# asztali alkalmazásból kövesd az alábbi lépéseket (lásd 2. ábra):

  1. Kapcsolódj az Ozeki SMS átjáróhoz az ozx felhasználónévvel és jelszóval, amelyet az SMS átjáró felhasználói felületén hoztál létre. A kapcsolódáshoz használd a "connect hostname:port username password" parancsot.
  2. Küldd el az üzeneted. Ehhez a példakonzol alkalmazásban írd be a "send telefonszám üzenet szövege" parancsot.
  3. Várd meg az SMS beküldési és kézbesítési jelentéseket. Ezek a jelentések megjelennek a képernyőn, és ugyanazt az üzenetazonosítót tartalmazza, amelyet az SMS küldésekor kaptál.

Példa konzolalkalmazás C#.Net-ben. Az alkalmazás forráskódja elérhető a C# SMS API forráskóddal oldalon.

csharp sms api példák
2. ábra - Hogyan küldjünk SMS-t C# SMS API-ból

A fenti példa bemutatja a szükséges lépéseket. Látható, hogy először tartós kapcsolat jön létre az SMS átjáróval, majd az üzenet elküldése következik. Végül megjelenik az üzenet elfogadási és beküldési jelentése.

Az SMS küldéséhez C#-ban használd a következő forráskódot:

  • Client = new OzxClient();
  • Client.AutoReconnect = true;
  • Client.Connect("127.0.0.1", 9518, "testuser", "testpassword");
  • Client.Connect("127.0.0.1", 9518, "testuser", "testpassword");
  • Client.Send(new OzxMessage() {ToAddress="+36111111",Text="Ez az üzenet szövege, amit C#-ból küldünk"});

Ha a Client.Autoconnect tulajdonságot true-ra állítod, biztosíthatod, hogy az ügyfél újracsatlakozik az SMS átjáróhoz, még akkor is, ha az ideiglenesen megszakad a hálózati kapcsolat, vagy az SMS átjáró újraindul.

Az SMS kézbesítési jelentések fogadásához C#-ban regisztrálnod kell az alábbi eseményekre:

  • Client.OnMessageAcceptedForDelivery += Client_OnMessageAcceptedForDelivery;
  • Client.OnMessageNotAcceptedForDelivery += Client_OnMessageNotAcceptedForDelivery;
  • Client.OnMessageSubmitSuccess += Client_OnMessageSubmitSuccess;
  • Client.OnMessageSubmitFailed += Client_OnMessageSubmitFailed;
  • Client.OnMessageDeliverySuccess += Client_OnMessageDeliverySuccess;
  • Client.OnMessageDeliveryFailed += Client_OnMessageDeliveryFailed;

Ezek az események akkor aktiválódnak, amikor az SMS átjáró a megfelelő jelentéseket küldi a létrehozott tartós kapcsolaton keresztül. Ez a tartós kapcsolat legnagyobb előnye: azonnali értesítéseket kapsz ezekről az SMS kézbesítéssel kapcsolatos eseményekről. Ilyen értesítéseket nehéz elérni HTTP SMS API használatával. Ugyanakkor ezek az információk elengedhetetlenek bármely üzleti alkalmazás számára, és feldolgozásuk szükséges egy jó minőségű SMS szoftver kialakításához.

Milyen típusú SMS kézbesítési jelentéseket biztosít a C# SMS API?

A C# SMS API ötféle SMS kézbesítési jelentést küld. Ezek C# eseményekként jelennek meg. Az események: SMS elfogadás, SMS elutasítás, SMS beküldés siker, SMS beküldés hiba, SMS kézbesítés siker, SMS kézbesítés hiba.

SMS elfogadás esemény: Az SMS elfogadás esemény akkor következik be, amikor az Ozeki SMS átjáró elfogadja az SMS-t kézbesítésre, és a felhasználói fiók kimenő mappájába helyezi.

SMS elutasítás esemény: Az SMS elutasítás esemény akkor következik be, ha az Ozeki SMS átjáró nem fogadja el az SMS-t kézbesítésre. Ez történhet például, ha a felhasználó kifogyott az SMS kreditek

More information