SMPP API GYIK

Az alábbi GYIK az Ozeki támogatásnál leggyakrabban felmerülő kérdéseket foglalja össze az Ozeki SMS Gateway által kínált SMPP API-val kapcsolatban.

A Short Message Peer-to-Peer (SMPP) API egy hatékony protokoll SMS-kommunikációhoz, amely zökkenőmentes üzenetküldést tesz lehetővé alkalmazások és mobilhálózatok között Short Message Service Center-eken (SMSC) keresztül. Az Ozeki SMS Gateway integrálja az SMPP API-t, hogy robusztus, helyszíni platformot nyújtson SMS küldéséhez és fogadásához, támogatva a 3.3, 3.4 és 5.0 verziókat. Ez az átfogó GYIK 100 kritikus kérdést foglal magában, amelyek webes elemzésekből és gyakorlati használati esetekből származnak, és lefedik a beállítást, konfigurálást, programozást, biztonságot, GDPR megfelelőséget, hibaelhárítást és haladó funkciókat. Legyen Ön fejlesztő vagy vállalkozás, amely SMS-megoldásokat implementál, ezek a válaszok útmutatást nyújtanak az SMPP API hatékony használatához az Ozeki SMS Gateway segítségével.

Tartalomjegyzék

SMPP API alapok

1. Mi az az SMPP API, és hogyan működik az Ozeki SMS Gateway-vel?

Az SMPP API egy protokoll SMS-üzenetek cseréjére alkalmazások és SMSC-k között Protocol Data Units (PDU-k) segítségével. Az Ozeki SMS Gateway SMPP kliensként vagy szerverként működik, támogatva a 3.3, 3.4 és 5.0 verziókat, lehetővé téve a felhasználók számára a kapcsolatok konfigurálását, üzenetek küldését/fogadását, valamint az adatbázisokkal vagy alkalmazásokkal való integrálást az hatékony SMS-kommunikáció érdekében.

2. Melyek az Ozeki SMS Gateway által támogatott fő SMPP protokollverziók?

Az Ozeki SMS Gateway támogatja az SMPP v3.3-at (külön küldő/fogadó linkek), v3.4-et (transceiver mód egyetlen link hatékonyságáért) és v5.0-t (TLV mezők, korlátozott elterjedtség). Az SMPP v3.4 a legelterjedtebb a hatékonysága és a széles kompatibilitása miatt.

3. Mi a különbség az SMPP v3.3, v3.4 és v5.0 között?

Az SMPP v3.3 (1997) külön linkeket használ a küldéshez és fogadáshoz. Az SMPP v3.4 bevezeti a transceiver módot egyetlen TCP/IP linkhez, javítva a hatékonyságot. Az SMPP v5.0 (2003) Type-Length-Value (TLV) mezőket és cellás szórásokat ad hozzá, de korlátozott az elterjedtsége. Az Ozeki mindhárom verziót támogatja, a v3.4 az alapértelmezett.

4. Mik azok az SMPP PDU-k, és miért fontosak?

A Protocol Data Units (PDU-k) strukturált üzenetek az SMPP API-ban, mint például a bind_transceiver, submit_sm és deliver_sm, amelyeket kapcsolatfelállításra, üzenetküldésre és fogadásra használnak. Ezek biztosítják a megbízható kommunikációt az Ozeki SMS Gateway és az SMSC között.

5. Mi a bind_transceiver PDU szerepe az SMPP API-ban?

A bind_transceiver PDU hitelesít és létrehoz egyetlen TCP/IP kapcsolatot mind SMS küldéséhez, fogadásához, mind kézbesítési jelentésekhez. Az Ozeki-ban konfigurálja az SMSC hitelesítő adataival a munkamenet indításához.

6. Hogyan működik a deliver_sm PDU az SMPP API-ban?

A deliver_sm PDU kézbesíti a bejövő SMS-eket vagy kézbesítési jelentéseket az SMSC-től az Ozeki SMS Gateway-nek. Tartalmazza a küldő/fogadó számokat, az üzenet szövegét és az állapotot (pl. "DELIVRD"). Az Ozeki ezeket alkalmazásokhoz vagy adatbázisokhoz irányítja.

7. Mire használják az enquire_link PDU-t az SMPP API-ban?

Az enquire_link PDU ellenőrzi a kapcsolat állapotát az Ozeki és az SMSC között, megelőzve az inaktivitás miatti kapcsolatbontást. Engedélyezze az "Életben tartó csomagok küldése" opciót az Ozeki-ban, hogy periodikusan küldje (pl. 30 másodpercenként).

8. Az Ozeki SMS Gateway működhet SMPP kliensként és szerverként is?

Igen, az Ozeki SMS Gateway SMPP kliensként (kapcsolódva egy SMSC-hez) vagy szerverként (elfogadva kapcsolatokat más kliensektől) is működhet, lehetővé téve a rugalmas SMS-útválasztást egy vagy több alkalmazás beállításához.

9. Milyen típusú alkalmazások profitálnak az SMPP API-ból?

Az SMPP API ideális olyan alkalmazásokhoz, amelyek tömeges SMS-t, kétirányú üzenetküldést vagy kézbesítési nyomon követést igényelnek, mint például marketingkampányok, kétlépcsős hitelesítés, értesítések és ügyfélszolgálati rendszerek.

10. Miért az SMPP v3.4 a legelterjedtebb verzió?

Az SMPP v3.4 transceiver módja egyetlen TCP/IP linket használ a küldéshez és fogadáshoz, csökkentve az erőforrás-használatot és egyszerűsítve a kapcsolatkezelést. Széles elterjedtsége és kompatibilitása miatt ez az Ozeki és a legtöbb SMSC szabványa.

Beállítás és konfigurálás

11. Hogyan állíthatok be egy SMPP API klienskapcsolatot az Ozeki SMS Gateway-ben?

Az Ozeki Management Console-ban lépjen a "Connections" menüpontba, válassza az "Add new connection" > "SMPP client" lehetőséget, és adja meg az SMSC hosztját (pl. "192.168.1.1"), portját (pl. 9500), felhasználónevét, jelszavát és az SMPP v3.4-et. Engedélyezze az "Automatikus csatlakozás" és az "Életben tartó csomagok küldése" opciókat, majd kattintson a "Connect" gombra.

12. Hogyan konfigurálhatom az Ozeki SMS Gateway-t SMPP szerverként?

A Management Console-ban válassza az "Add new connection" > "SMPP server" lehetőséget. Adjon meg egy portot (pl. 9500), határozza meg a felhasználói hitelesítő adatokat, és állítsa be a bind módot (ajánlott a transceiver). Engedélyezze a naplózást és konfigurálja az útválasztást az üzenetek továbbításához alkalmazásokhoz vagy más kapcsolatokhoz.

13. Milyen hitelesítő adatok szükségesek egy SMPP API klienskapcsolathoz?

Szüksége lesz az SMSC hosztnevére/IP-címére, portjára, felhasználónevére (System ID), jelszavára, és opcionálisan System Type-ra és Address Range-re, amelyet az SMS-szolgáltató biztosít. Adja meg ezeket az Ozeki SMPP kliens beállításaiban.

14. Hogyan engedélyezhetem a kézbesítési jelentéseket az Ozeki SMS Gateway-ben?

Az SMPP kliens "Advanced" lapján jelölje be a "Kézbesítési jelentések kérése" opciót, hogy utasítsa az SMSC-t a kézbesítési visszaigazolások küldésére deliver_sm PDU-kon keresztül. Győződjön meg róla, hogy az SMSC támogatja a kézbesítési jelentéseket.

15. Hogyan állíthatok be egy virtuális számot SMS fogadásához az Ozeki-ban?

Szerezzen be egy virtuális számot (IMSI) az SMSC szolgáltatótól, és adja meg az SMPP kliens "Address Range" mezőjében. Konfigurálja az Ozeki-t, hogy a bejövő deliver_sm PDU-kat egy adatbázisba vagy alkalmazásba irányítsa.

16. Használhatok több SMPP kapcsolatot az Ozeki SMS Gateway-ben?

Igen, az Ozeki támogatja több SMPP klienskapcsolatot terheléselosztáshoz vagy különböző szolgáltatókhoz. Adjon hozzá minden kapcsolatot a "Connections" panelen egyedi hitelesítő adatokkal, és konfigurálja az útválasztási szabályokat.

17. Hogyan konfigurálhatom az Ozeki-t SMS-ek adatbázisban történő tárolására?

Hozzon létre egy adatbázis felhasználót az Ozeki Management Console-ban, adjon meg egy adatbázis kapcsolatot (pl. MySQL), és határozza meg az SQL lekérdezéseket (pl. INSERT INTO ozekimessagein (sender, receiver, msg) VALUES (?, ?, ?)) a bejövő SMS-ek és kézbesítési jelentések tárolásához.

18. Mi az SMPP API kapcsolatok alapértelmezett portja?

Az alapértelmezett SMPP port 2775, de sok szolgáltató, beleértve az Ozeki-kompatibiliseket, egyéni portokat használ, mint például 9500 a szabványos kapcsolatokhoz vagy 9501 az SMPPS-hez. Ellenőrizze az SMSC szolgáltatónál.

19. Hogyan engedélyezhetem az SMPP PDU-k naplózását az Ozeki-ban?

Az SMPP kliens "Advanced" lapján engedélyezze a "Kommunikációs események naplózása" opciót a bind_transceiver és deliver_sm PDU-k rögzítéséhez. A naplókat az "Events" panelen tekintheti meg hibakereséshez.

20. Hogyan tesztelhetek egy SMPP kapcsolatot éles üzem előtt?

Használjon egy SMSC szimulátort (pl. Melrose Labs) az SMPP API teszteléséhez. Konfigurálja az Ozeki-t a szimulátor hosztjával/portjával, küldjön/fogadjon teszt üzeneteket, és ellenőrizze a naplókat a PDU cserék ellenőrzéséhez, mielőtt egy élő SMSC-hez csatlakozna.

21. Használhatom az SMPP API-t SMSC szolgáltató nélkül?

Nem, az SMPP API-hoz SMSC szükséges az üzenetek mobilhálózatokhoz történő továbbításához. Az Ozeki SMS Gateway SMSC-hez csatlakozik kliensként, vagy SMSC szerverként működik más kliensek számára.

22. Hogyan konfigurálhatom az Ozeki-t magas rendelkezésre állású SMPP kapcsolatokhoz?

Konfiguráljon több SMPP klienskapcsolatot különböző SMSC-khez redundancia érdekében. Engedélyezze az "Automatikus csatlakozás indításkor" opciót, és figyelje a kapcsolat állapotát az Ozeki "Connections" paneljén a feladatátvétel biztosításához.

23. Mi a System Type mező az SMPP API konfigurációban?

A System Type egy opcionális mező a bind_transceiver PDU-ban, gyakran "SMPP"-re vagy szolgáltató-specifikus értékre állítva. Azonosítja a kliens célját, és az Ozeki SMPP kliens beállításaiban konfigurálható.

24. Hogyan kezelhetek több SMSC szolgáltatót az Ozeki-ban?

Adjon hozzá külön SMPP klienskapcsolatokat minden SMSC-hez az Ozeki "Connections" paneljén. Használjon útválasztási szabályokat a szolgáltatók prioritizálásához költség, megbízhatóság vagy régió alapján az hatékony üzenetkézbesítés érdekében.

25. Hogyan konfigurálhatom az Ozeki-t a leiratkozási kérések kezelésére?

Konfiguráljon egy adatbázis felhasználót a bejövő "STOP" üzenetek észlelésére deliver_sm PDU-kon keresztül. Használjon egy SQL lekérdezést (pl. UPDATE consent_log SET status='opt-out' WHERE msg='STOP') a beleegyezési nyilvántartások frissítéséhez.

26. Használhatom az Ozeki SMS Gateway-t proxy szerverrel?

Az Ozeki nem támogatja közvetlenül a proxy szervereket SMPP kapcsolatokhoz. Konfigurálja a hálózatot, hogy engedélyezze a közvetlen TCP/IP hozzáférést az SMSC hosztjához és portjához, biztosítva, hogy a tűzfal szabályok engedélyezik a kimenő kapcsolatokat.

27. Hogyan állíthatom be az SMPP API-t kétirányú üzenetküldéshez?

Használja a transceiver módot bind_transceiver-rel az SMS küldéséhez és fogadásához. Konfigurálja az Ozeki-t, hogy a bejövő deliver_sm PDU-kat egy alkalmazásba vagy adatbázisba irányítsa a válaszok feldolgozásához, lehetővé téve a kétirányú kommunikációt.

28. Hogyan konfigurálhatom az Ozeki-t tömeges SMS kampányokhoz?

Konfiguráljon egy SMPP klienskapcsolatot, használjon egy adatbázist a címzettek listájának tárolásához, és küldjön üzeneteket az Ozeki "Messages" paneljén vagy API-n keresztül. Implementáljon sebességkorlátozást a szabályozás elkerüléséhez, és győződjön meg róla, hogy a kézbesítési jelentések engedélyezve vannak.

29. Mi az Address Range mező az SMPP API konfigurációban?

Az Address Range mező a bind_transceiver PDU-ban határozza meg a fogadó számokat SMS fogadásához. Az Ozeki-ban állítsa be egy virtuális számra vagy mintára (pl. "+123*"), amelyet az SMSC szolgáltató biztosít a bejövő üzenetek szűréséhez.

30. Hogyan frissíthetem az Ozeki SMS Gateway-t a legújabb verzióra?

Töltse le a legújabb verziót (Ozeki SMS Gateway) az Ozeki SMS Gateway letöltési oldaláról, készítsen biztonsági másolatot az adatkönyvtáráról (C:\Program Files\Ozeki\Data), és kövesse a telepítési útmutatót a frissítéshez, biztosítva az SMPP API funkciók kompatibilitását.

Programozás az SMPP API-val

31. Hogyan küldhetek SMS-t az SMPP API-val Pythonban?

Használjon egy Python SMPP könyvtárat, mint például a smpp.py. Kapcsolódjon az SMSC-hez az Ozeki SMPP szerver portján keresztül, küldjön egy submit_sm PDU-t küldővel, címzettel és üzenettel, és kezelje a válaszokat. Az Ozeki HTTP API is használható egyszerűbb integrációhoz.

32. Hogyan küldhetek SMS-t az SMPP API-val Javaban?

Használjon egy Java SMPP könyvtárat, mint például a JSMPP. Konfiguráljon egy kapcsolatot az Ozeki SMPP szerverhez vagy egy SMSC-hez, hozzon létre egy submit_sm PDU-t, és adja meg az üzenet paramétereit. Az Ozeki API dokumentációja mintakódot biztosít az integrációhoz.

33. Hogyan küldhetek SMS-t az SMPP API-val C#-ban?

Használjon egy C# SMPP könyvtárat vagy az Ozeki .NET API-t. Kapcsolódjon az SMSC-hez vagy az Ozeki SMPP szerverhez, készítsen egy submit_sm PDU-t, és küldjön üzeneteket megfelelő kódolással. Ellenőrizze az Ozeki dokumentációját C# példákért.

34. Hogyan küldhetek SMS-t az SMPP API-val PHP-ban?

Használjon egy PHP SMPP könyvtárat, mint például a PHP-SMPP. Kapcsolódjon az Ozeki SMPP szerverhez, hitelesítkezzen bind_transceiver-rel, és küldjön submit_sm PDU-kat. Alternatívaként használja az Ozeki HTTP API-t az egyszerűbb SMS küldéshez.

35. Hogyan küldhetek SMS-t az SMPP API-val JavaScript/Node.js-ben?

Használja a node-smpp könyvtárat. Kapcsolódjon az Ozeki SMPP szerverhez, hitelesítkezzen, és küldjön submit_sm PDU-kat. Az Ozeki HTTP API alternatíva Node.js alkalmazásokhoz, egyszerűsítve az integrációt.

36. Hogyan küldhetek SMS-t az SMPP API-val C++-ban?

Használjon egy C++ SMPP könyvtárat, vagy készítsen egy egyéni klienst az Ozeki SMPP szerverhez való kapcsolódáshoz. Készítsen submit_sm PDU-kat az üzenet részleteivel. Az Ozeki dokumentációja C++ példákat biztosít az SMPP API integrációhoz.

37. Hogyan fogadhatok SMS-t az SMPP API-val Pythonban?

Használja a smpp.py-t transceiverként való kötéshez és figyelje a deliver_sm PDU-kat. Elemezze a PDU short_message mezőjét az SMS tartalomért, és irányítsa az Ozeki adatbázis vagy alkalmazás integrációján keresztül.

38. Hogyan fogadhatok kézbesítési jelentéseket az SMPP API-val Javaban?

A JSMPP-vel kötődjön transceiverként, és kezelje a deliver_sm PDU-kat 0x04 ESM Class-szal. Kinyeri a visszaigazolás üzenetazonosítóját és állapotát (pl. "DELIVRD"), és tárolja azokat az Ozeki adatbázis integrációján keresztül.

39. Hogyan kezelhetem a hosszú SMS üzeneteket programozottan?

Ossza fel a hosszú üzeneteket részekre (153 karakter GSM 7-bithez, 67 UCS2-höz), adjon hozzá User Data Header (UDH)-t összefűzéshez, és küldje submit_sm PDU-kon keresztül. Az Ozeki automatikusan kezeli az összefűzést, ha az SMPP kliens beállításaiban konfigurálva van.

40. Hogyan implementálhatok aszinkron SMPP API műveleteket az Ozeki-ban?

Konfigurálja az Ozeki SMPP klienst aszinkron módra az "Advanced" lapon, beállítva egy ablakméretet (pl. 10) a nem visszaigazolt PDU-khoz. Használjon könyvtárakat, mint a JSMPP vagy node-smpp több submit_sm PDU küldéséhez válaszokra várás nélkül.

41. Hogyan elemezhetem a kézbesítési visszaigazolás formátumokat Pythonban?

Elemezze a deliver_sm PDU short_message mezőjét regex segítségével a id, stat és err mezők kinyeréséhez. Tárolja az eredményeket az Ozeki adatbázisában egy Python szkript segítségével, amely integrálva van az Ozeki API-val.

42. Használhatom az Ozeki HTTP API-t az SMPP helyett programozáshoz?

Igen, az Ozeki HTTP API leegyszerűsíti az SMS küldését/fogadását közvetlen SMPP PDU kezelés nélkül. Használjon REST végpontokat (pl. /api?action=sendmessage) olyan programozási nyelvekkel való integrációhoz, mint a Python vagy PHP.

43. Hogyan kezelhetem az Unicode üzeneteket az SMPP API programozásban?

Állítsa a Data Coding Scheme (DCS)-t 8-ra UCS2 kódoláshoz a submit_sm PDU-ban. Ossza fel a hosszú Unicode üzeneteket 67 karakteres részekre UDH-val. Konfigurálja az Ozeki SMPP klienst UCS2 támogatására az "Advanced" lapon.

44. Hogyan implementálhatok újrapróbálkozási logikát sikertelen SMPP API üzenetekhez?

Figyelje a submit_sm_resp PDU-kat hibakódokért (pl. ESME_RTHROTTLED). Implementáljon újrapróbálkozási logikát a kódban exponenciális visszalépéssel, és konfigurálja az Ozeki-t a sikertelen kísérletek naplózására elemzéshez.

45. Hogyan integrálhatom az SMPP API-t egy webalkalmazással?

Használja az Ozeki HTTP API-t SMS küldéséhez/fogadásához egy webalkalmazásból, vagy kapcsolódjon közvetlenül az Ozeki SMPP szerverhez egy könyvtár segítségével, mint a node-smpp. Irányítsa a bejövő üzeneteket az alkalmazáshoz az Ozeki adatbázis vagy webhookok segítségével.

46. Hogyan küldhetek flash SMS-t az SMPP API-val?

Állítsa az ESM Class-t a submit_sm PDU-ban 0x10-re flash SMS-hez (közvetlenül megjelenik a címzett képén). Konfigurálja az Ozeki SMPP klienst ennek támogatására az "Advanced" lapon, ha az SMSC engedélyezi.

47. Hogyan kezelhetem a bináris SMS üzeneteket az SMPP API-val?

Használjon DCS 4-et bináris üzenetekhez a submit_sm PDU-ban. Kódolja az üzenetet bináris formátumba (pl. WAP push-hoz), és konfigurálja az Ozeki-t a bináris tartalom feldolgozására az SMPP kliens beállításaiban.

48. Hogyan figyelhetem az SMPP API forgalmat programozottan?

Engedélyezze a PDU naplózást az Ozeki "Advanced" lapján, és elemezze a naplókat egy szkript segítségével (pl. Python) a PDU részletek kinyeréséhez. Alternatívaként használjon egy könyvtárat, mint a JSMPP valós idejű SMPP forgalom rögzítéséhez és elemzéséhez.

49. Hogyan implementálhatok üzenetsorolást az SMPP API alkalmazásokban?

Használjon egy üzenetsort (pl. RabbitMQ) az üzenetek puffereléséhez az Ozeki SMPP kliense általi küldés előtt. Konfigurálja az Ozeki-t az üzenetek kihúzására az üzenetsorból adatbázis vagy API integráció segítségével a kontrollált kézbesítés érdekében.

50. Hogyan kezelhetem a többnyelvű SMS üzeneteket?

Használjon UCS2 kódolást (DCS 8) nem latin nyelvekhez (pl. arab, kínai). Konfigurálja az Ozeki SMPP klienst UCS2 támogatására, és tesztelje az üzeneteket a címzett eszközökön való megfelelő megjelenés biztosításához.

Biztonság és megfelelőség

51. Hogyan biztosíthatom a GDPR megfelelőséget az Ozeki SMS Gateway-vel?

Szerezzen be kifejezett beleegyezést opt-in űrlapokon keresztül, tartalmazzon opt-out lehetőségeket (pl. "Válaszolj STOP"), és tárolja a beleegyezési nyilvántartásokat egy adatbázisban. Használjon SMPPS-t titkosításhoz, biztosítsa az Ozeki szervert, és tároljon minimális adatot korlátozott ideig (pl. 30 nap).

52. Hogyan engedélyezhetem az SMPPS-t (SMPP SSL/TLS felett) az Ozeki-ban?

Az SMPP kliens beállításaiban adja meg az SMSC biztonságos portját (pl. 9501), és engedélyezze az SSL-t az "Advanced" lapon. Győződjön meg róla, hogy az SMSC támogatja az SMPPS-t a titkosított adatátvitelhez.

53. Hogyan biztosíthatom az Ozeki webes felületét?

Változtassa meg az alapértelmezett admin jelszót (admin/abc123), engedélyezze a HTTPS-t (port 443), és korlátozza a hozzáférést megbízható IP-kre a "Server preferences" menüben. Használjon tűzfalszabályokat a http://127.0.0.1:9501 hozzáférés korlátozásához.

54. Hogyan megakadályozhatom az SMPP API kapcsolatok jogosulatlan hozzáférését?

More information