SMPP API – Často kladené otázky

Následující FAQ pokrývá nejčastější dotazy, které dostáváme na podpoře Ozeki v souvislosti s SMPP API nabízeným Ozeki SMS Gateway.

Short Message Peer-to-Peer (SMPP) API je výkonný protokol pro SMS komunikaci, který umožňuje bezproblémovou výměnu zpráv mezi aplikacemi a mobilními sítěmi prostřednictvím Short Message Service Center (SMSC). Ozeki SMS Gateway integruje SMPP API a poskytuje robustní on-premise platformu pro odesílání a příjem SMS, podporující verze 3.3, 3.4 a 5.0. Tento obsáhlý FAQ se věnuje 100 klíčovým otázkám, sestaveným na základě webových poznatků a praktických případů užití, a pokrývá nastavení, konfiguraci, programování, zabezpečení, GDPR compliance, řešení problémů a pokročilé funkce. Ať už jste vývojář nebo firma implementující SMS řešení, tyto odpovědi vás provedou efektivním využitím SMPP API s Ozeki SMS Gateway.

Obsah

Základy SMPP API

1. Co je SMPP API a jak funguje s Ozeki SMS Gateway?

SMPP API je protokol pro výměnu SMS zpráv mezi aplikacemi a SMSC pomocí Protocol Data Units (PDU). Ozeki SMS Gateway funguje jako SMPP klient nebo server, podporuje verze 3.3, 3.4 a 5.0, umožňuje uživatelům konfigurovat připojení, odesílat/přijímat zprávy a integrovat se s databázemi nebo aplikacemi pro efektivní SMS komunikaci.

2. Jaké hlavní verze SMPP protokolu podporuje Ozeki SMS Gateway?

Ozeki SMS Gateway podporuje SMPP v3.3 (samostatné linky pro odesílání a příjem), v3.4 (transceiver mód pro efektivitu jedné linky) a v5.0 (TLV pole, omezené přijetí). SMPP v3.4 je nejpoužívanější díky své efektivitě a široké kompatibilitě.

3. Jaký je rozdíl mezi SMPP v3.3, v3.4 a v5.0?

SMPP v3.3 (1997) používá samostatné linky pro odesílání a příjem. SMPP v3.4 zavádí transceiver mód pro jednu TCP/IP linku, což zlepšuje efektivitu. SMPP v5.0 (2003) přidává pole Type-Length-Value (TLV) a vysílání do buněk, ale má omezené přijetí. Ozeki podporuje všechny tři, s v3.4 jako výchozí.

4. Co jsou SMPP PDU a proč jsou důležité?

Protocol Data Units (PDU) jsou strukturované zprávy v SMPP API, jako bind_transceiver, submit_sm a deliver_sm, používané pro navázání spojení, odesílání a příjem zpráv. Zajišťují spolehlivou komunikaci mezi Ozeki SMS Gateway a SMSC.

5. Jakou roli má PDU bind_transceiver v SMPP API?

PDU bind_transceiver ověřuje a navazuje jednu TCP/IP spojení pro odesílání i příjem SMS a doručovacích zpráv. V Ozeki ji nakonfigurujte s přihlašovacími údaji SMSC pro zahájení relace.

6. Jak funguje PDU deliver_sm v SMPP API?

PDU deliver_sm doručuje příchozí SMS nebo doručovací zprávy z SMSC do Ozeki SMS Gateway. Obsahuje čísla odesílatele/příjemce, text zprávy a stav (např. „DELIVRD“). Ozeki tyto zprávy směruje do aplikací nebo databází.

7. K čemu se používá PDU enquire_link v SMPP API?

PDU enquire_link kontroluje stav spojení mezi Ozeki a SMSC, čímž zabraňuje odpojení kvůli nečinnosti. V Ozeki povolte „Odesílat keepalive pakety“ pro periodické odesílání (např. každých 30 sekund).

8. Může Ozeki SMS Gateway fungovat jako SMPP klient i server?

Ano, Ozeki SMS Gateway může fungovat jako SMPP klient (připojení k SMSC) nebo server (přijímání spojení od jiných klientů), což umožňuje flexibilní směrování SMS pro jednoduché i složité nastavení.

9. Jaké typy aplikací těží z SMPP API?

SMPP API je ideální pro aplikace vyžadující hromadné SMS, obousměrnou komunikaci nebo sledování doručení, jako jsou marketingové kampaně, dvoufaktorová autentizace, oznámení a systémy zákaznické podpory.

10. Proč je SMPP v3.4 nejpoužívanější verzí?

SMPP v3.4 s transceiver módem používá jednu TCP/IP linku pro odesílání i příjem, což snižuje spotřebu zdrojů a zjednodušuje správu spojení. Jeho široké přijetí a kompatibilita z něj činí standard pro Ozeki a většinu SMSC.

Nastavení a konfigurace

11. Jak nastavím SMPP API klienta v Ozeki SMS Gateway?

V Ozeki Management Console přejděte na „Connections“, vyberte „Add new connection“ > „SMPP client“ a zadejte údaje SMSC (např. host „192.168.1.1“, port 9500, uživatelské jméno, heslo a SMPP v3.4). Povolte „Connect automatically“ a „Send keepalive packets“ a klikněte na „Connect“.

12. Jak nakonfiguruji Ozeki SMS Gateway jako SMPP server?

V Management Console vyberte „Add new connection“ > „SMPP server“. Zadejte port (např. 9500), definujte přihlašovací údaje a nastavte bind mód (doporučeno transceiver). Povolte logování a nakonfigurujte směrování pro přesměrování zpráv do aplikací nebo jiných spojení.

13. Jaké přihlašovací údaje jsou potřeba pro SMPP API klienta?

Potřebujete hostname/IP SMSC, port, uživatelské jméno (System ID), heslo a volitelně System Type a Address Range, které poskytne váš SMS poskytovatel. Tyto údaje zadejte v nastavení SMPP klienta v Ozeki.

14. Jak povolím doručovací zprávy v Ozeki SMS Gateway?

V záložce „Advanced“ SMPP klienta zaškrtněte „Request delivery report“, aby SMSC posílal potvrzení o doručení přes PDU deliver_sm. Ujistěte se, že váš SMSC podporuje doručovací zprávy.

15. Jak nastavím virtuální číslo pro příjem SMS v Ozeki?

Získejte virtuální číslo (IMSI) od poskytovatele SMSC a zadejte jej do pole „Address Range“ SMPP klienta. Nakonfigurujte Ozeki pro směrování příchozích PDU deliver_sm do databáze nebo aplikace.

16. Mohu použít více SMPP spojení v Ozeki SMS Gateway?

Ano, Ozeki podporuje více SMPP klientů pro vyrovnávání zátěže nebo různé poskytovatele. Přidejte každé spojení v panelu „Connections“ s unikátními přihlašovacími údaji a nakonfigurujte pravidla směrování.

17. Jak nakonfiguruji Ozeki pro ukládání SMS do databáze?

Vytvořte databázového uživatele v Management Console, specifikujte databázové spojení (např. MySQL) a definujte SQL dotazy (např. INSERT INTO ozekimessagein (sender, receiver, msg) VALUES (?, ?, ?)) pro ukládání příchozích SMS a doručovacích zpráv.

18. Jaký je výchozí port pro SMPP API spojení?

Výchozí SMPP port je 2775, ale mnoho poskytovatelů, včetně těch kompatibilních s Ozeki, používá vlastní porty jako 9500 pro standardní spojení nebo 9501 pro SMPPS. Ověřte u svého poskytovatele SMSC.

19. Jak povolím logování SMPP PDU v Ozeki?

V záložce „Advanced“ SMPP klienta povolte „Log Communication Events“ pro zachycení PDU jako bind_transceiver a deliver_sm. Prohlížejte logy v panelu „Events“ pro ladění.

20. Jak otestuji SMPP spojení před nasazením?

Použijte simulátor SMSC (např. Melrose Labs) k otestování SMPP API. Nakonfigurujte Ozeki s hostem/portem simulátoru, odešlete/přijměte testovací zprávy a zkontrolujte logy pro ověření výměny PDU před připojením k živému SMSC.

21. Mohu použít SMPP API bez poskytovatele SMSC?

Ne, SMPP API vyžaduje SMSC pro směrování zpráv do mobilních sítí. Ozeki SMS Gateway se připojuje k SMSC jako klient nebo funguje jako SMSC server pro jiné klienty.

22. Jak nakonfiguruji Ozeki pro vysoce dostupné SMPP spojení?

Nakonfigurujte více SMPP klientů k různým SMSC pro redundanci. Povolte „Connect automatically on startup“ a sledujte stav spojení v panelu „Connections“ pro zajištění převzetí služeb při selhání.

23. Co je pole System Type v konfiguraci SMPP API?

System Type je volitelné pole v PDU bind_transceiver, často nastavené na „SMPP“ nebo hodnotu specifickou pro poskytovatele. Identifikuje účel klienta a je konfigurováno v nastavení SMPP klienta v Ozeki.

24. Jak pracuji s více poskytovateli SMSC v Ozeki?

Přidejte samostatná SMPP spojení pro každého poskytovatele v panelu „Connections“. Použijte pravidla směrování pro priorizaci poskytovatelů podle ceny, spolehlivosti nebo regionu pro efektivní doručování zpráv.

25. Jak nakonfiguruji Ozeki pro zpracování žádostí o odhlášení?

Nakonfigurujte databázového uživatele pro detekci příchozích zpráv „STOP“ přes PDU deliver_sm. Použijte SQL dotaz (např. UPDATE consent_log SET status='opt-out' WHERE msg='STOP') pro aktualizaci záznamů o souhlasu.

26. Mohu použít Ozeki SMS Gateway s proxy serverem?

Ozeki přímo nepodporuje proxy servery pro SMPP spojení. Nakonfigurujte síť pro přímý TCP/IP přístup k hostu/portu SMSC a ujistěte se, že pravidla firewallu povolují odchozí spojení.

27. Jak nastavím SMPP API pro obousměrnou komunikaci?

Použijte transceiver mód s PDU bind_transceiver pro odesílání a příjem SMS. Nakonfigurujte Ozeki pro směrování příchozích PDU deliver_sm do aplikace nebo databáze pro zpracování odpovědí, čímž umožníte obousměrnou komunikaci.

28. Jak nakonfiguruji Ozeki pro hromadné SMS kampaně?

Nakonfigurujte SMPP klienta, použijte databázi pro ukládání seznamů příjemců a posílejte zprávy přes panel „Messages“ nebo API. Implementujte omezení rychlosti pro zabránění omezení a ujistěte se, že jsou povoleny doručovací zprávy.

29. Co je pole Address Range v konfiguraci SMPP API?

Pole Address Range v PDU bind_transceiver specifikuje čísla pro příjem SMS. V Ozeki nastavte virtuální číslo nebo vzor (např. „+123*“) poskytnutý vaším SMSC pro filtrování příchozích zpráv.

30. Jak aktualizuji Ozeki SMS Gateway na nejnovější verzi?

Stáhněte si nejnovější verzi (Ozeki SMS Gateway) z stránky pro stažení Ozeki SMS Gateway, zazálohujte datový adresář (C:\Program Files\Ozeki\Data) a postupujte podle průvodce instalací pro upgrade, čímž zajistíte kompatibilitu s funkcemi SMPP API.

Programování s SMPP API

31. Jak odeslat SMS pomocí SMPP API v Pythonu?

Použijte knihovnu SMPP pro Python jako smpp.py. Připojte se k SMSC přes port SMPP serveru Ozeki, odešlete PDU submit_sm s odesílatelem, příjemcem a textem zprávy a zpracujte odpovědi. Pro jednodušší integraci lze použít HTTP API Ozeki.

32. Jak odeslat SMS pomocí SMPP API v Javě?

Použijte knihovnu SMPP pro Javu jako JSMPP. Nakonfigurujte spojení s SMPP serverem Ozeki nebo SMSC, vytvořte PDU submit_sm a specifikujte parametry zprávy. Dokumentace API Ozeki poskytuje ukázkový kód pro integraci.

33. Jak odeslat SMS pomocí SMPP API v C#?

Použijte knihovnu SMPP pro C# nebo .NET API Ozeki. Připojte se k SMSC nebo SMPP serveru Ozeki, sestavte PDU submit_sm a posílejte zprávy s příslušným kódováním. Pro C# příklady se podívejte do dokumentace Ozeki.

34. Jak odeslat SMS pomocí SMPP API v PHP?

Použijte knihovnu SMPP pro PHP jako PHP-SMPP. Připojte se k SMPP serveru Ozeki, ověřte se pomocí PDU bind_transceiver a posílejte PDU submit_sm. Alternativně použijte HTTP API Ozeki pro jednodušší odesílání SMS.

35. Jak odeslat SMS pomocí SMPP API v JavaScriptu/Node.js?

Použijte knihovnu node-smpp. Připojte se k SMPP serveru Ozeki, ověřte se a posílejte PDU submit_sm. Pro aplikace Node.js je alternativou HTTP API Ozeki, které zjednodušuje integraci.

36. Jak odeslat SMS pomocí SMPP API v C++?

Použijte knihovnu SMPP pro C++ nebo vytvořte vlastního klienta pro připojení k SMPP serveru Ozeki. Sestavte PDU submit_sm s detaily zprávy. Dokumentace Ozeki poskytuje příklady v C++ pro integraci SMPP API.

37. Jak přijímat SMS pomocí SMPP API v Pythonu?

Použijte smpp.py pro navázání spojení jako transceiver a naslouchejte PDU deliver_sm. Analyzujte pole short_message PDU pro obsah SMS a směrujte jej přes integraci Ozeki s databází nebo aplikací.

38. Jak přijímat doručovací zprávy pomocí SMPP API v Javě?

S JSMPP se navážte jako transceiver a zpracujte PDU deliver_sm s ESM Class 0x04. Extrahujte ID zprávy a stav (např. „DELIVRD“) a uložte je přes integraci Ozeki s databází.

39. Jak programově zpracovat dlouhé SMS zprávy?

Rozdělte dlouhé zprávy na části (153 znaků pro GSM 7-bit, 67 pro UCS2), přidejte User Data Header (UDH) pro spojování a posílejte přes PDU submit_sm. Ozeki automaticky zpracovává spojování, pokud je nakonfigurováno v nastavení SMPP klienta.

40. Jak implementovat asynchronní operace SMPP API v Ozeki?

Nakonfigurujte SMPP klienta Ozeki pro asynchronní mód v záložce „Advanced“, nastavte velikost okna (např. 10) pro nepotvrzené PDU. Použijte knihovny jako JSMPP nebo node-smpp pro odesílání více PDU submit_sm bez čekání na odpovědi.

41. Jak analyzovat formáty doručovacích zpráv v Pythonu?

Analyzujte pole short_message PDU deliver_sm pomocí regex pro extrakci polí jako id, stat a err. Uložte výsledky do databáze Ozeki pomocí skriptu v Pythonu integrovaného s API Ozeki.

42. Mohu použít HTTP API Ozeki místo SMPP pro programování?

Ano, HTTP API Ozeki zjednodušuje odesílání/příjem SMS bez přímé manipulace s PDU. Použijte REST endpointy (např. /api?action=sendmessage) pro integraci s programovacími jazyky jako Python nebo PHP.

43. Jak zpracovat Unicode zprávy v programování SMPP API?

Nastavte Data Coding Scheme (DCS) na 8 pro kódování UCS2 v PDU submit_sm. Rozdělte dlouhé Unicode zprávy na části po 67 znacích s UDH. Nakonfigurujte SMPP klienta Ozeki pro podporu UCS2 v záložce „Advanced“.

44. Jak implementovat logiku opakování pro neúspěšné zprávy SMPP API?

Sledujte PDU submit_sm_resp pro chybové kódy (např. ESME_RTHROTTLED). Implementujte logiku opakování s exponenciálním backoffem a nakonfigurujte Ozeki pro logování neúspěšných pokusů k analýze.

45. Jak integrovat SMPP API s webovou aplikací?

Použijte HTTP API Ozeki pro odesílání/příjem SMS z webové aplikace nebo se připojte přímo k SMPP serveru Ozeki pomocí knihovny jako node-smpp. Směrujte příchozí zprávy do vaší aplikace přes databázi Ozeki nebo webhooky.

46. Jak odeslat flash SMS pomocí SMPP API?

Nastavte ESM Class v PDU submit_sm na 0x10 pro flash SMS (zobrazené přímo na obrazovce příjemce). Nakonfigurujte SMPP klienta Ozeki pro podporu této funkce v záložce „Advanced“, pokud to váš SMSC povoluje.

47. Jak zpracovat binární SMS zprávy pomocí SMPP API?

Použijte DCS 4 pro binární zprávy v PDU submit_sm. Zakódujte zprávu v binárním formátu (např. pro WAP push) a nakonfigurujte Ozeki pro zpracování binárního obsahu přes nastavení SMPP klienta.

48. Jak programově monitorovat provoz SMPP API?

Povolte logování PDU v záložce „Advanced“ Ozeki a analyzujte logy pomocí skriptu (např. Python) pro extrakci detailů PDU. Alternativně použijte knihovnu jako JSMPP pro zachycení a analýzu provozu SMPP v reálném čase.

49. Jak implementovat frontu zpráv v aplikacích SMPP API?

Použijte frontu zpráv (např. RabbitMQ) pro buffering zpráv před odesláním přes SMPP klienta Ozeki. Nakonfigurujte Ozeki pro načítání zpráv z fronty pomocí databáze nebo API integrace pro řízené doručování.

50. Jak zpracovat více jazyků v SMS zprávách?

Použijte kódování UCS2 (DCS 8) pro nelatinské jazyky (např. arabština, čínština). Nakonfigurujte SMPP klienta Ozeki pro podporu UCS2 a otestujte zprávy pro zajištění správného zobrazení na zařízeních příjemců.

Bezpečnost a compliance

51. Jak zajistit GDPR compliance s Ozeki SMS Gateway?

Získejte explicitní souhlas přes opt-in formuláře, zahrňte možnosti odhlášení (např. „Odpovězte STOP“) a ukládejte záznamy o souhlasu do databáze. Použijte SMPPS pro šifrování, zabezpečte server Ozeki a uchovávejte minimální data po omezenou dobu (např. 30 dní).

52. Jak povolit SMPPS (SMPP přes SSL/TLS) v Ozeki?

V nastavení SMPP klienta specifikujte zabezpečený port SMSC (např. 9501) a povolte SSL v záložce „Advanced“. Ujistěte se, že váš SMSC podporuje SMPPS pro šifrovaný přenos dat.

53. Jak zabezpečit webové rozhraní Ozeki?

Změňte výchozí heslo admina (admin/abc123), povolte HTTPS (port 443) a omezte přístup na důvěryhodné IP v menu „Server preferences“. Použijte pravidla firewallu pro omezení přístupu na http://127.0.0.1:9501.

54. Jak zabránit neoprávněnému přístupu k SMPP API spojení?

Použijte silné přihlašovací údaje SMSC, povolte SMPPS a nakonfigurujte Ozeki pro povolení spojení pouze z konkrétních IP. Sledujte logy pro neoprávněné pokusy o bind a aktualizujte Ozeki pro řešení zranitelností.

55. Jak implementovat omezení rychlosti pro příchozí SMPP spojení?

V nastavení SMPP serveru Ozeki nastavte maximální rychlost zpráv (např. 10 zpráv/sekundu) na klienta v záložce „Advanced“ pro zabránění zneužití a zajištění spravedlivého využití zdrojů.

56. Jak implementovat omezení rychlosti pro odchozí SMPP spojení?

Nakonfigurujte SMPP klienta Ozeki pro omezení odesílání zpráv (např. 50 zpráv/sekundu) v záložce „Advanced“. Sladěte s limity TPS vašeho SMSC pro zabránění chybám ESME_RTHROTTLED.

57. Jak omezit SMPP bindy pro zabránění zneužití?

V nastavení SMPP serveru Ozeki nastavte maximální počet bindů (např. 5 na klienta) v záložce „Advanced“. Sledujte aktivní bindy v panelu „Connections“ pro zabránění přetížení.

58. Jak zpracovat práva subjektů údajů podle GDPR s Ozeki?

Nakonfigurujte Ozeki pro ukládání SMS dat do databáze. Zpracujte žádosti o přístup, opravu nebo výmaz pomocí SQL dotazů (např. DELETE FROM ozekimessagein WHERE phone_number='...';) v rámci 30denní lhůty GDPR.

59. Jak zabezpečit úložiště databáze v Ozeki SMS Gateway?

Použijte šifrovanou databázi (např. MySQL s ENCRYPTION) a omezte přístup silnými přihlašovacími údaji. Nakonfigurujte databázového uživatele Ozeki pro použití zabezpečených spojovacích řetězců bez nebezpečných parametrů.

60. Jak řešit známé zranitelnosti v Ozeki SMS Gateway?

Aktualizujte na Ozeki 10, které řeší problémy jako CSV injection a zranitelnosti mazání souborů ve verzích do 4.17.6. Pravidelně kontrolujte cvedetails.com pro aktualizace.

61. Jak povolit dvoufaktorovou autentizaci pro admin rozhraní Ozeki?

Ozeki nativně nepodporuje dvoufaktorovou autentizaci (2FA). Implementujte 2FA na úrovni serveru pomocí nástrojů jako Duo nebo Authy a omezte webové rozhraní Ozeki na VPN pro dodatečné zabezpečení.

62. Jak zajistit PECR compliance pro SMS marketing?

Podle PECR získejte explicitní souhlas nebo použijte soft opt-in pro stávající zákazníky. Zahrňte instrukce pro odhlášení (např. „Odpovězte STOP“) do každé marketingové SMS a zpracujte odhlášení přes integraci Ozeki s databází.

63. Jak šifrovat zálohy SMPP API v Ozeki?

Zazálohujte datový adresář Ozeki (C:\Program Files\Ozeki\Data) a zašifrujte jej pomocí nástrojů jako VeraCrypt. Naplánujte automatizované, šifrované zálohy podle průvodce zálohováním Ozeki.

64. Jak monitorovat bezpečnostní logy SMPP API?

Povolte „Log Communication Events“ v nastavení SMPP klienta/serveru Ozeki. Prohlížejte logy v panelu „Events“ pro pokusy o bind, chyby nebo podezřelou aktivitu a exportujte je pro audity.

65. Jak dodržet politiky uchovávání dat v Ozeki?

Nakonfigurujte Ozeki pro mazání zpráv po nastavené době (např. 30 dní) v menu „Server preferences“. Použijte SQL skripty (např. DELETE FROM ozekimessagein WHERE timestamp < DATE_SUB(NOW(), INTERVAL 30 DAY)) pro automatické čištění.

66. Jak řešit úniky dat v Ozeki SMS Gateway?

Sledujte logy pro neoprávněný přístup, izolujte server a informujte postižené uživatele v rámci 72hodinové lhůty GDPR. Aktualizujte Ozeki, opravte zranitelnosti a zkontrolujte nastavení zabezpečení pro zabránění opakování.

67. Jak omezit přístup k SMPP API na konkrétní uživatele?

V nastavení SMPP serveru Ozeki definujte přihlašovací údaje uživatelů a limity bindů. Použijte whitelist IP v menu „Server preferences“ pro omezení přístupu pouze na autorizované klienty.

68. Jak implementovat auditní stopy pro aktivitu SMPP API?

Povolte logování PDU v Ozeki a ukládejte logy do databáze. Použijte SQL dotazy pro sledování odeslaných zpráv, potvrzení a pokusů o bind, čímž vytvoříte ověřitelnou auditní stopu pro compliance.

69. Jak zabezpečit SMPP API spojení přes veřejné sítě?

Použijte SMPPS s SSL/TLS a nakonfigurujte Ozeki pro připojení přes VPN nebo SSH tunel pro šifrování provozu přes veřejné sítě, č Závěr

Tato obsáhlá FAQ se zabývá klíčovými otázkami ohledně používání SMPP API s Ozeki SMS Gateway, pokrývající jeho základní funkce, nastavení, programování, bezpečnost, shodu s předpisy, řešení problémů a pokročilé integrace. Dodržováním těchto pokynů mohou vývojáři a firmy vytvářet robustní, bezpečná a škálovatelná SMS řešení.

More information