SMPP API Često Postavljana Pitanja

Sljedeća lista često postavljanih pitanja pokriva najčešća pitanja koja dobivamo u Ozeki podršci u vezi s SMPP API-jem koji nudi Ozeki SMS Gateway.

Short Message Peer-to-Peer (SMPP) API je moćan protokol za SMS komunikaciju, omogućavajući nesmetanu razmjenu poruka između aplikacija i mobilnih mreža putem centara za usluge kratkih poruka (SMSC). Ozeki SMS Gateway integrira SMPP API kako bi pružio robusnu, lokalnu platformu za slanje i primanje SMS-ova, podržavajući verzije 3.3, 3.4 i 5.0. Ovaj opsežni FAQ rješava 100 ključnih pitanja, sastavljenih iz web uvida i praktičnih primjera, pokrivajući postavljanje, konfiguraciju, programiranje, sigurnost, usklađenost s GDPR-om, rješavanje problema i napredne značajke. Bilo da ste programer ili tvrtka koja implementira SMS rješenja, ovi odgovori će vas usmjeriti u učinkovitom korištenju SMPP API-ja s Ozeki SMS Gateway-om.

Sadržaj

Osnove SMPP API-ja

1. Što je SMPP API i kako radi s Ozeki SMS Gatewayem?

SMPP API je protokol za razmjenu SMS poruka između aplikacija i SMSC-a korištenjem Protocol Data Units (PDU). Ozeki SMS Gateway služi kao SMPP klijent ili poslužitelj, podržava verzije 3.3, 3.4 i 5.0, omogućujući korisnicima konfiguriranje veza, slanje/primanje poruka i integraciju s bazama podataka ili aplikacijama za učinkovitu SMS komunikaciju.

2. Koje su glavne verzije SMPP protokola koje podržava Ozeki SMS Gateway?

Ozeki SMS Gateway podržava SMPP v3.3 (odvojeni odašiljač/primatelj), v3.4 (transceiver mod za učinkovitost s jednom vezom) i v5.0 (TLV polja, ograničena primjena). SMPP v3.4 je najčešće korišten zbog svoje učinkovitosti i široke kompatibilnosti.

3. Koja je razlika između SMPP v3.3, v3.4 i v5.0?

SMPP v3.3 (1997.) koristi odvojene veze za slanje i primanje. SMPP v3.4 uvodi transceiver mod za jednu TCP/IP vezu, poboljšavajući učinkovitost. SMPP v5.0 (2003.) dodaje Type-Length-Value (TLV) polja i emitiranje ćelija, ali ima ograničenu primjenu. Ozeki podržava sve tri verzije, s v3.4 kao zadanom.

4. Što su SMPP PDU-i i zašto su važni?

Protocol Data Units (PDU) su strukturirane poruke u SMPP API-ju, poput bind_transceiver, submit_sm i deliver_sm, korištene za uspostavu veze, slanje i primanje poruka. Osiguravaju pouzdanu komunikaciju između Ozeki SMS Gatewaya i SMSC-a.

5. Koja je uloga bind_transceiver PDU-a u SMPP API-ju?

bind_transceiver PDU autentificira i uspostavlja jednu TCP/IP vezu za slanje i primanje SMS poruka i izvješća o isporuci. U Ozekiju, konfigurirajte ga s vjerodajnicama SMSC-a za pokretanje sesije.

6. Kako radi deliver_sm PDU u SMPP API-ju?

deliver_sm PDU isporučuje dolazne SMS poruke ili izvješća o isporuci s SMSC-a na Ozeki SMS Gateway. Uključuje brojeve pošiljatelja/primatelja, tekst poruke i status (npr. "DELIVRD"). Ozeki usmjerava ove podatke na aplikacije ili baze podataka.

7. Za što se koristi enquire_link PDU u SMPP API-ju?

enquire_link PDU provjerava status veze između Ozekija i SMSC-a, sprječavajući prekid zbog neaktivnosti. Omogućite "Slanje keepalive paketa" u Ozekiju za periodično slanje (npr. svakih 30 sekundi).

8. Može li Ozeki SMS Gateway djelovati i kao SMPP klijent i poslužitelj?

Da, Ozeki SMS Gateway može funkcionirati kao SMPP klijent (povezivanje na SMSC) ili poslužitelj (prihvaćanje veza od drugih klijenata), omogućujući fleksibilno usmjeravanje SMS poruka za pojedinačne ili više aplikacija.

9. Koje vrste aplikacija imaju koristi od SMPP API-ja?

SMPP API je idealan za aplikacije koje zahtijevaju masovne SMS poruke, dvosmjernu komunikaciju ili praćenje isporuke, poput marketinških kampanja, dvofaktorske autentifikacije, obavijesti i sustava korisničke podrške.

10. Zašto je SMPP v3.4 najčešće korištena verzija?

SMPP v3.4 transceiver mod koristi jednu TCP/IP vezu za slanje i primanje, smanjujući korištenje resursa i pojednostavljujući upravljanje vezama. Njegova široka primjena i kompatibilnost čine ga standardom za Ozeki i većinu SMSC-a.

Postavljanje i konfiguracija

11. Kako postaviti SMPP API klijentsku vezu u Ozeki SMS Gatewayu?

U Ozekijevoj Management Console, idite na "Connections", odaberite "Add new connection" > "SMPP client" i unesite SMSC-ov host (npr. "192.168.1.1"), port (npr. 9500), korisničko ime, lozinku i SMPP v3.4. Omogućite "Connect automatically" i "Send keepalive packets", zatim kliknite "Connect".

12. Kako konfigurirati Ozeki SMS Gateway kao SMPP poslužitelj?

U Management Console, odaberite "Add new connection" > "SMPP server". Odredite port (npr. 9500), definirajte korisničke vjerodajnice i postavite bind mod (preporuča se transceiver). Omogućite bilježenje i konfigurirajte usmjeravanje za prosljeđivanje poruka aplikacijama ili drugim vezama.

13. Koje su vjerodajnice potrebne za SMPP API klijentsku vezu?

Potrebni su SMSC-ov host name/IP, port, korisničko ime (System ID), lozinka, te opcionalno System Type i Address Range, koje osigurava vaš SMS servisni pružatelj. Unesite ove podatke u Ozekijeve SMPP klijentske postavke.

14. Kako omogućiti izvješća o isporuci u Ozeki SMS Gatewayu?

Na kartici "Advanced" SMPP klijenta, označite "Request delivery report" kako biste uputili SMSC da šalje potvrde o isporuci putem deliver_sm PDU-a. Provjerite podržava li vaš SMSC izvješća o isporuci.

15. Kako postaviti virtualni broj za primanje SMS poruka u Ozekiju?

Nabavite virtualni broj (IMSI) od svog SMSC pružatelja i unesite ga u polje "Address Range" SMPP klijenta. Konfigurirajte Ozeki da usmjerava dolazne deliver_sm PDU-e u bazu podataka ili aplikaciju.

16. Mogu li koristiti više SMPP veza u Ozeki SMS Gatewayu?

Da, Ozeki podržava više SMPP klijentskih veza za balansiranje opterećenja ili različite pružatelje. Dodajte svaku vezu u panel "Connections" s jedinstvenim vjerodajnicama i konfigurirajte pravila usmjeravanja.

17. Kako konfigurirati Ozeki za pohranjivanje SMS poruka u bazu podataka?

Kreirajte korisnika baze podataka u Ozekijevoj Management Console, odredite vezu s bazom podataka (npr. MySQL) i definirajte SQL upite (npr. INSERT INTO ozekimessagein (sender, receiver, msg) VALUES (?, ?, ?)) za pohranjivanje dolaznih SMS poruka i izvješća o isporuci.

18. Koji je zadani port za SMPP API veze?

Zadani SMPP port je 2775, ali mnogi pružatelji, uključujući one kompatibilne s Ozekijem, koriste prilagođene portove poput 9500 za standardne veze ili 9501 za SMPPS. Potvrdite sa svojim SMSC pružateljem.

19. Kako omogućiti bilježenje SMPP PDU-a u Ozekiju?

Na kartici "Advanced" SMPP klijenta, omogućite "Log Communication Events" za bilježenje PDU-a poput bind_transceiver i deliver_sm. Pregledajte zapisnike u panelu "Events" za otklanjanje grešaka.

20. Kako testirati SMPP vezu prije puštanja u rad?

Koristite SMSC simulator (npr. Melrose Labs) za testiranje SMPP API-ja. Konfigurirajte Ozeki s simulatorovim hostom/portom, pošaljite/primitite testne poruke i provjerite zapisnike kako biste potvrdili razmjenu PDU-a prije povezivanja na živu SMSC.

21. Mogu li koristiti SMPP API bez SMSC pružatelja?

Ne, SMPP API zahtijeva SMSC za usmjeravanje poruka na mobilne mreže. Ozeki SMS Gateway povezuje se na SMSC kao klijent ili djeluje kao SMSC poslužitelj za druge klijente.

22. Kako konfigurirati Ozeki za SMPP veze visoke dostupnosti?

Konfigurirajte više SMPP klijentskih veza na različite SMSC-e za redundanciju. Omogućite "Connect automatically on startup" i pratite status veze u Ozekijevom panelu "Connections" kako biste osigurali prebacivanje.

23. Što je polje System Type u konfiguraciji SMPP API-ja?

System Type je opcionalno polje u bind_transceiver PDU-u, često postavljeno na "SMPP" ili vrijednost specifičnu za pružatelja. Identificira svrhu klijenta i konfigurira se u Ozekijevim SMPP klijentskim postavkama.

24. Kako upravljati više SMSC pružatelja u Ozekiju?

Dodajte odvojene SMPP klijentske veze za svaki SMSC u Ozekijev panel "Connections". Koristite pravila usmjeravanja za prioritet pružatelja na temelju troškova, pouzdanosti ili regije za učinkovitu isporuku poruka.

25. Kako konfigurirati Ozeki za rukovanje zahtjevima za odjavu?

Konfigurirajte korisnika baze podataka za otkrivanje dolaznih "STOP" poruka putem deliver_sm PDU-a. Koristite SQL upit (npr. UPDATE consent_log SET status='opt-out' WHERE msg='STOP') za ažuriranje zapisa o pristanku.

26. Mogu li koristiti Ozeki SMS Gateway s proxy poslužiteljem?

Ozeki ne podržava izravno proxy poslužitelje za SMPP veze. Konfigurirajte svoju mrežu kako bi dopuštala izravan TCP/IP pristup SMSC-ovom hostu i portu, osiguravajući da pravila vatrozida dopuštaju odlazne veze.

27. Kako postaviti SMPP API za dvosmjernu komunikaciju?

Koristite transceiver mod s bind_transceiver za slanje i primanje SMS poruka. Konfigurirajte Ozeki da usmjerava dolazne deliver_sm PDU-e na aplikaciju ili bazu podataka za obradu odgovora, omogućujući dvosmjernu komunikaciju.

28. Kako konfigurirati Ozeki za masovne SMS kampanje?

Konfigurirajte SMPP klijentsku vezu, koristite bazu podataka za pohranjivanje popisa primatelja i šaljite poruke putem Ozekijevog panela "Messages" ili API-ja. Implementirajte ograničenje brzine kako biste izbjegli usporavanje i osigurajte da su izvješća o isporuci omogućena.

29. Što je polje Address Range u konfiguraciji SMPP API-ja?

Polje Address Range u bind_transceiver PDU-u određuje brojeve za primanje SMS poruka. U Ozekiju, postavite ga na virtualni broj ili uzorak (npr. "+123*") koji osigurava vaš SMSC za filtriranje dolaznih poruka.

30. Kako ažurirati Ozeki SMS Gateway na najnoviju verziju?

Preuzmite najnoviju verziju (Ozeki SMS Gateway) s Ozeki SMS Gateway stranice za preuzimanje, sigurnosno kopirajte svoj direktorij s podacima (C:\Program Files\Ozeki\Data) i slijedite vodič za instalaciju za nadogradnju, osiguravajući kompatibilnost s SMPP API značajkama.

Programiranje s SMPP API-jem

31. Kako poslati SMS koristeći SMPP API s Pythonom?

Koristite Python SMPP biblioteku poput smpp.py. Povežite se na SMSC putem Ozekijevog SMPP poslužiteljskog porta, pošaljite submit_sm PDU s pošiljateljem, primateljem i tekstom poruke te rukujte odgovorima. Ozekijev HTTP API također se može koristiti za jednostavniju integraciju.

32. Kako poslati SMS koristeći SMPP API s Javom?

Koristite Java SMPP biblioteku poput JSMPP. Konfigurirajte vezu na Ozekijev SMPP poslužitelj ili SMSC, kreirajte submit_sm PDU i odredite parametre poruke. Ozekijeva API dokumentacija pruža primjere koda za integraciju.

33. Kako poslati SMS koristeći SMPP API s C#-om?

Koristite C# SMPP biblioteku ili Ozekijev .NET API. Povežite se na SMSC ili Ozekijev SMPP poslužitelj, konstruirajte submit_sm PDU i šaljite poruke s ispravnim kodiranjem. Provjerite Ozekijevu dokumentaciju za C# primjere.

34. Kako poslati SMS koristeći SMPP API s PHP-om?

Koristite PHP SMPP biblioteku poput PHP-SMPP. Povežite se na Ozekijev SMPP poslužitelj, autentificirajte se s bind_transceiver i šaljite submit_sm PDU-e. Alternativno, koristite Ozekijev HTTP API za jednostavnije slanje SMS poruka.

35. Kako poslati SMS koristeći SMPP API s JavaScriptom/Node.js-om?

Koristite node-smpp biblioteku. Povežite se na Ozekijev SMPP poslužitelj, autentificirajte se i šaljite submit_sm PDU-e. Ozekijev HTTP API je alternativa za Node.js aplikacije, pojednostavljujući integraciju.

36. Kako poslati SMS koristeći SMPP API s C++-om?

Koristite C++ SMPP biblioteku ili izgradite prilagođenog klijenta za povezivanje na Ozekijev SMPP poslužitelj. Konstruirajte submit_sm PDU-e s detaljima poruke. Ozekijeva dokumentacija pruža C++ primjere za integraciju SMPP API-ja.

37. Kako primiti SMS koristeći SMPP API u Pythonu?

Koristite smpp.py za povezivanje kao transceiver i slušanje deliver_sm PDU-a. Parsirajte polje short_message PDU-a za sadržaj SMS poruke i usmjerite ga putem Ozekijeve integracije s bazom podataka ili aplikacijom.

38. Kako primiti izvješća o isporuci koristeći SMPP API u Javi?

S JSMPP-om, povežite se kao transceiver i rukujte deliver_sm PDU-ima s ESM Class 0x04. Izvucite ID potvrde i status (npr. "DELIVRD") te ih pohranite putem Ozekijeve integracije s bazom podataka.

39. Kako programski rukovati dugim SMS porukama?

Podijelite duge poruke na dijelove (153 znaka za GSM 7-bit, 67 za UCS2), dodajte User Data Header (UDH) za spajanje i pošaljite putem submit_sm PDU-a. Ozeki automatski rukuje spajanjem ako je konfigurirano u SMPP klijentskim postavkama.

40. Kako implementirati asinkrone SMPP API operacije u Ozekiju?

Konfigurirajte Ozekijev SMPP klijent za asinkroni mod na kartici "Advanced", postavljajući veličinu prozora (npr. 10) za nepotvrđene PDU-e. Koristite biblioteke poput JSMPP ili node-smpp za slanje više submit_sm PDU-a bez čekanja na odgovore.

41. Kako parsirati formate potvrda o isporuci u Pythonu?

Parsirajte polje short_message deliver_sm PDU-a koristeći regex za izvlačenje polja poput id, stat i err. Pohranite rezultate u Ozekijevu bazu podataka koristeći Python skriptu integriranu s Ozekijevim API-jem.

42. Mogu li koristiti Ozekijev HTTP API umjesto SMPP-a za programiranje?

Da, Ozekijev HTTP API pojednostavljuje slanje/primanje SMS poruka bez izravnog rukovanja SMPP PDU-ima. Koristite REST krajnje točke (npr. /api?action=sendmessage) za integraciju s programskim jezicima poput Pythona ili PHP-a.

43. Kako rukovati Unicode porukama u programiranju SMPP API-ja?

Postavite Data Coding Scheme (DCS) na 8 za UCS2 kodiranje u submit_sm PDU-ima. Podijelite duge Unicode poruke na dijelove od 67 znakova s UDH-om. Konfigurirajte Ozekijev SMPP klijent za podršku UCS2 na kartici "Advanced".

44. Kako implementirati logiku ponovnog pokušaja za neuspjele SMPP API poruke?

Pratite submit_sm_resp PDU-e za kodove grešaka (npr. ESME_RTHROTTLED). Implementirajte logiku ponovnog pokušaja u svom kodu s eksponencijalnim odgađanjem i konfigurirajte Ozeki za bilježenje neuspjelih pokušaja za analizu.

45. Kako integrirati SMPP API s web aplikacijom?

Koristite Ozekijev HTTP API za slanje/primanje SMS poruka iz web aplikacije ili se izravno povežite na Ozekijev SMPP poslužitelj koristeći biblioteku poput node-smpp. Usmjerite dolazne poruke na svoju aplikaciju putem Ozekijeve baze podataka ili webhookova.

46. Kako poslati flash SMS koristeći SMPP API?

Postavite ESM Class u submit_sm PDU-u na 0x10 za flash SMS (prikazuje se izravno na ekranu primatelja). Konfigurirajte Ozekijev SMPP klijent za podršku ovoga na kartici "Advanced", ako to dopušta vaš SMSC.

47. Kako rukovati binarnim SMS porukama s SMPP API-jem?

Koristite DCS 4 za binarne poruke u submit_sm PDU-ima. Kodirajte poruku u binarnom formatu (npr. za WAP push) i konfigurirajte Ozeki za obradu binarnog sadržaja putem SMPP klijentskih postavki.

48. Kako programski pratiti promet SMPP API-ja?

Omogućite bilježenje PDU-a u Ozekiju na kartici "Advanced" i parsirajte zapisnike koristeći skriptu (npr. Python) za izvlačenje detalja PDU-a. Alternativno, koristite biblioteku poput JSMPP za hvatanje i analizu SMPP prometa u stvarnom vremenu.

49. Kako implementirati red čekanja poruka u SMPP API aplikacijama?

Koristite red poruka (npr. RabbitMQ) za međuspremanje poruka prije slanja putem Ozekijevog SMPP klijenta. Konfigurirajte Ozeki za povlačenje poruka iz reda koristeći integraciju s bazom podataka ili API-jem za kontroliranu isporuku.

50. Kako rukovati više jezika u SMS porukama?

Koristite UCS2 kodiranje (DCS 8) za nelatinske jezike (npr. arapski, kineski). Konfigurirajte Ozekijev SMPP klijent za podršku UCS2 i testirajte poruke kako biste osigurali ispravan prikaz na uređajima primatelja.

Sigurnost i usklađenost

51. Kako osigurati usklađenost s GDPR-om u Ozeki SMS Gatewayu?

Dobijte izričit pristanak putem opt-in obrazaca, uključite opcije za odjavu (npr. "Odgovorite STOP") i pohranite zapise o pristanku u bazu podataka. Koristite SMPPS za enkripciju, osigurajte Ozekijev poslužitelj i zadržavajte minimalne podatke za ograničeno razdoblje (npr. 30 dana).

52. Kako omogućiti SMPPS (SMPP preko SSL/TLS) u Ozekiju?

U postavkama SMPP klijenta, odredite sigurni port SMSC-a (npr. 9501) i omogućite SSL na kartici "Advanced". Osigurajte da vaš SMSC podržava SMPPS za enkriptirani prijenos podataka.

53. Kako osigurati Ozekijevo web sučelje?

Promijenite zadanu administratorsku lozinku (admin/abc123), omogućite HTTPS (port 443) i ograničite pristup pouzdanim IP-ovima u izborniku "Server preferences". Koristite pravila vatrozida za ograničavanje pristupa na http://127.0.0.1:9501.

54. Kako spriječiti neovlašteni pristup SMPP API vezama?

Koristite jake vjerodajnice SMSC-a, omogućite SMPPS i konfigurirajte Ozeki da dopušta veze samo s određenih IP-ova. Pratite zapisnike za neovlaštene pokušaje povezivanja i ažurirajte Ozeki kako biste riješili ranjivosti.

55. Kako implementirati ograničenje brzine za dolazne SMPP veze?

U Ozekijevim postavkama SMPP poslužitelja, postavite maksimalnu brzinu poruka (npr. 10 poruka/sekundu) po klijentu na kartici "Advanced" kako biste spriječili zlouporabu i osigurali pravedno korištenje resursa.

56. Kako implementirati ograničenje brzine za odlazne SMPP veze?

Konfigurirajte Ozekijev SMPP klijent za ograničavanje slanja poruka (npr. 50 poruka/sekundu) na kartici "Advanced". Usuglasite s SMSC-ovim TPS ograničenjima kako biste izbjegli ESME_RTHROTTLED greške.

57. Kako ograničiti SMPP povezivanja kako biste spriječili zlouporabu?

U Ozekijevim postavkama SMPP poslužitelja, postavite maksimalni broj povezivanja (npr. 5 po klijentu) na kartici "Advanced". Pratite aktivna povezivanja u panelu "Connections" kako biste spriječili preopterećenje.

58. Kako rukovati pravima subjekata podataka prema GDPR-u u Ozekiju?

Konfigurirajte Ozeki za pohranjivanje SMS podataka u bazu podataka. Rukujte zahtjevima za pristup, ispravkom ili brisanjem koristeći SQL upite (npr. DELETE FROM ozekimessagein WHERE phone_number='...';) unutar GDPR-ovog roka od 30 dana.

59. Kako osigurati pohranjivanje podataka u bazu podataka u Ozeki SMS Gatewayu?

Koristite enkriptiranu bazu podataka (npr. MySQL s ENCRYPTION) i ograničite pristup s jakim vjerodajnicama. Konfigurirajte Ozekijevog korisnika baze podataka za korištenje sigurnih nizova veze bez nesigurnih parametara.

60. Kako riješiti poznate ranjivosti u Ozeki SMS Gatewayu?

Nadogradite na Ozeki 10, koji rješava probleme poput CSV injekcije i ranjivosti brisanja datoteka u verzijama do 4.17.6. Redovito provjeravajte cvedetails.com za ažuriranja.

61. Kako omogućiti dvofaktorsku autentifikaciju za Ozekijevo administratorsko sučelje?

Ozeki ne podržava izvorno dvofaktorsku autentifikaciju (2FA). Implementirajte 2FA na razini poslužitelja koristeći alate poput Duo ili Authy i ograničite Ozekijevo web sučelje na VPN za dodatnu sigurnost.

62. Kako osigurati usklađenost s PECR-om za SMS marketing?

Prema PECR-u, dobijte izričit pristanak ili koristite soft opt-in za postojeće korisnike. Uključite upute za odjavu (npr. "Odgovorite STOP") u svaku marketinšku SMS poruku i obrađujte odjave putem Ozekijeve integracije s bazom podataka.

63. Kako enkriptirati SMPP API sigurnosne kopije u Ozekiju?

Napravite sigurnosnu kopiju Ozekijevog direktorija s podacima (C:\Program Files\Ozeki\Data) i enkriptirajte je koristeći alate poput VeraCrypt. Zakazujte automatizirane, enkriptirane sigurnosne kopije slijedeći Ozekijev vodič za sigurnosno kopiranje.

64. Kako pratiti sigurnosne zapisnike SMPP API-ja?

Omogućite "Log Communication Events Zaključak

Ovaj opsežan FAQ odgovara na ključna pitanja o korištenju SMPP API-ja s Ozeki SMS Gateway-om, pokrivajući njegovu osnovnu funkcionalnost, postavljanje, programiranje, sigurnost, usklađenost, rješavanje problema i napredne integracije. Slijedeći ove smjernice, programeri i tvrtke mogu izgraditi robusna, sigurna i skalabilna SMS rješenja.

More information