Kako primiti SMS koristeći SMPP API

Short Message Peer-to-Peer (SMPP) protokol je moćan, industrijski standardni protokol dizajniran za olakšavanje razmjene SMS poruka između External Short Message Entities (ESMEs) i Short Message Service Centers (SMSCs). Za programere i tvrtke koji koriste SMPP API s Ozeki SMS Gatewayom kao svojom primarnom platformom, razumijevanje niskonivo operacija protokola ključno je za izgradnju robusnih SMS rješenja. Ovaj članak pruža sveobuhvatan vodič o tome kako primiti SMS poruke koristeći SMPP API, fokusirajući se na interakcije na razini protokola i specifične Protocol Data Units (PDUs) uključene u postavljanje, održavanje i korištenje SMPP API klijentske veze s Ozeki SMS Gatewayom.

Uvod u SMPP API i Ozeki SMS Gateway

SMPP API se široko koristi u telekomunikacijskoj industriji zbog svoje učinkovitosti u rukovanju masovnim SMS porukama preko TCP/IP veza. Ozeki SMS Gateway, svestrani SMPP softver, služi i kao SMPP klijent i poslužitelj, što ga čini idealnom platformom za slanje i primanje SMS poruka. Implementacijom SMPP protokola (verzije 3.3 i 3.4, s podrškom za 5.0 u Ozeki 10 SMS Gatewayu), Ozeki omogućuje besprijekornu povezanost s SMSC-ovima, podržavajući aplikacije kao što su marketinške kampanje, dvofaktorska autentifikacija i sustavi obavijesti. Ovaj članak se fokusira na primanje SMS poruka, detaljno opisujući SMPP PDU-e potrebne za postavljanje veze, održavanje i primanje poruka.

Razumijevanje SMPP PDU-a

SMPP radi razmjenom Protocol Data Units (PDUs) između SMPP klijenta (npr. Ozeki SMS Gateway) i SMPP poslužitelja (npr. SMSC). Svaki PDU je strukturirana poruka koja nosi specifične upute ili podatke, kao što su autentifikacijski podaci, sadržaj SMS-a ili upiti o statusu veze. Da bi primio SMS poruke koristeći SMPP API, klijent mora uspostaviti vezu, održavati je i obraditi dolazne poruke. Ključni PDU-i uključeni su:

  • bind_transceiver: Uspostavlja vezu za slanje i primanje SMS-a.
  • enquire_link: Održava vezu provjeravanjem njenog statusa.
  • deliver_sm: Dostavlja dolazne SMS poruke od SMSC-a klijentu.
  • unbind: Prekida SMPP sesiju.

U nastavku ćemo detaljno istražiti svaki PDU, uključujući njihovu strukturu, konfiguraciju u Ozeki SMS Gatewayu i njihovu ulogu u primanju SMS poruka putem SMPP API-ja.

Postavljanje SMPP API klijentske veze

Za primanje SMS poruka, prvi korak je uspostava stabilne SMPP API klijentske veze s SMSC-om. Ozeki SMS Gateway pojednostavljuje ovaj proces svojim intuitivnim sučeljem, ali razumijevanje operacija na razini protokola ključno je za napredne korisnike.

1. Konfiguriranje SMPP klijenta u Ozeki SMS Gateway

Za postavljanje SMPP API klijentske veze u Ozeki SMS Gateway, slijedite ove korake:

  1. Prijava u Upravljačku konzolu: Pristupite web sučelju Ozeki SMS Gateway koristeći administratorski račun (zadano korisničko ime: "admin").
  2. Dodavanje nove veze: Idite na panel "Veze", kliknite "Dodaj novu vezu" i odaberite "SMPP klijent" iz odjeljka "IP SMS veze".
  3. Konfiguriranje SMPP postavki: Unesite sljedeće podatke, koje obično daje vaš SMS usluga davatelj:
    • Naziv hosta: IP adresa ili naziv hosta SMSC-a (npr. "192.168.1.1").
    • Broj porta: TCP/IP port za SMPP komunikaciju (zadano je 9500, ali provjerite kod svog davatelja).
    • Korisničko ime (System ID): Vaš identifikator računa za SMSC.
    • Lozinka: Lozinka povezana s System ID-om.
    • SMPP verzija: Odaberite v3.4 za transceiver podršku (preporučeno za slanje i primanje).
    • Vrsta sustava: Opcionalno, često "SMPP", kako je navedeno od strane davatelja.
    • Adresa pošiljatelja: Zadani telefonski broj za odlazne SMS poruke (npr. "+1234567890").
    • Raspon adresa: Opcionalno, koristi se za primanje poruka s više brojeva.
  4. Način povezivanja: Odaberite "Transceiver" kako biste omogućili i slanje i primanje SMS poruka preko jedne veze.
  5. Napredne postavke: Omogućite "Automatsko povezivanje pri pokretanju" za bezprobleman ponovni spoj i označite "Slanje keepalive paketa" za održavanje veze.
  6. Omogućavanje bilježenja: Na kartici "Napredno", omogućite "Bilježenje komunikacijskih događaja" za snimanje SMPP PDU-ova za otklanjanje grešaka.
  7. Spremanje i povezivanje: Kliknite "OK" za spremanje konfiguracije, zatim "Poveži" za pokretanje veze.

Ove postavke pripremaju Ozeki SMS Gateway za uspostavu SMPP API veze koristeći bind_transceiver PDU.

2. bind_transceiver PDU

bind_transceiver PDU je prvi PDU koji šalje SMPP klijent za autentifikaciju i uspostavu veze s SMSC-om. Omogućuje i slanje i primanje SMS poruka preko jedne TCP/IP veze, što ga čini idealnim za većinu SMPP API aplikacija.

Struktura bind_transceiver PDU

Duljina naredbe: 4 bajta (ukupna duljina PDU-a)
ID naredbe: 0x00000009 (bind_transceiver)
Status naredbe: 0x00000000 (postavljeno na 0 za zahtjeve)
Broj sekvence: Jedinstveni identifikator za PDU
System ID: Korisničko ime za autentifikaciju (npr. "smppuser")
Lozinka: Lozinka za autentifikaciju (npr. "password123")
Vrsta sustava: Opcionalno, često "SMPP"
Verzija sučelja: SMPP verzija (npr. 0x34 za v3.4)
Raspon adresa: Opcionalno, za primanje poruka s određenih brojeva

Primjer bind_transceiver PDU (heksadecimalno):

0000002F 00000009 00000000 00000001 736D70707573657200 70617373776F726431323300 534D505000 34 00

Objašnjenje:

  • Duljina naredbe (0000002F): Ukupna duljina PDU-a (47 bajtova).
  • ID naredbe (00000009): Identificira PDU kao bind_transceiver.
  • Status naredbe (00000000): Postavljeno na 0 za zahtjev.
  • Broj sekvence (00000001): Jedinstveni ID za praćenje PDU-a.
  • System ID (736D70707573657200): ASCII za "smppuser" s null terminatorom.
  • Lozinka (70617373776F726431323300): ASCII za "password123" s null terminatorom.
  • Vrsta sustava (534D505000): ASCII za "SMPP" s null terminatorom.
  • Verzija sučelja (34): Označava SMPP v3.4.
  • Raspon adresa (00): Null, jer je opcionalno.

Nakon primanja bind_transceiver PDU-a, SMSC provjerava vjerodajnice. Ako je uspješno, odgovara s bind_transceiver_resp PDU-om sa statusom naredbe 0x00000000, što označava uspješnu vezu. Ozeki SMS Gateway bilježi ovu interakciju, koja se može pregledati u "Komunikacijskim događajima".

Održavanje SMPP API veze

Nakon uspostave veze, ona se mora održavati kako bi se osigurao kontinuirani primitak SMS poruka. SMPP protokol koristi enquire_link PDU za provjeru statusa veze i sprječavanje prekida zbog neaktivnosti.

enquire_link PDU

enquire_link PDU je lagana poruka koja se periodično šalje od SMPP klijenta SMSC-u kako bi se potvrdilo da je veza aktivna. Ovo je posebno važno za održavanje dugotrajnih veza, jer proxy poslužitelji ili SMSC-ovi mogu prekinuti neaktivne veze.

Struktura enquire_link PDU

Duljina naredbe: 0x00000010 (16 bajtova)
ID naredbe: 0x00000015 (enquire_link)
Status naredbe: 0x00000000 (postavljeno na 0 za zahtjeve)
Broj sekvence: Jedinstveni identifikator za PDU

Primjer enquire_link PDU (heksadecimalno):

00000010 00000015 00000000 00000002

Objašnjenje:

  • Duljina naredbe (00000010): Ukupna duljina (16 bajtova).
  • ID naredbe (00000015): Identificira PDU kao enquire_link.
  • Status naredbe (00000000): Postavljeno na 0 za zahtjev.
  • Broj sekvence (00000002): Jedinstveni ID za praćenje PDU-a.

SMSC odgovara s enquire_link_resp PDU-om, potvrđujući status veze. U Ozeki SMS Gateway, omogućavanje opcije "Slanje keepalive paketa" na kartici "Komunikacija" osigurava da se enquire_link PDU-ovi automatski šalju u redovitim intervalima (npr. svakih 30 sekundi). Ova postavka je ključna za održavanje stabilne SMPP API veze, posebno prilikom povremenog primanja SMS poruka.

Primanje SMS poruka putem SMPP API-ja

Nakon što je veza uspostavljena i održana, SMPP API klijent može primati SMS poruke putem deliver_sm PDU-a. Ovaj PDU šalje SMSC klijentu kada je dostupna dolazna SMS poruka ili izvješće o isporuci.

deliver_sm PDU

deliver_sm PDU nosi sadržaj dolazne SMS poruke ili izvješća o isporuci. Za primanje SMS-a, PDU sadrži telefonski broj pošiljatelja, broj primatelja (virtualni broj dodijeljen od strane pružatelja usluge) i tekst poruke.

Struktura deliver_sm PDU-a

Duljina naredbe: Varijabilna (ovisno o duljini poruke)
ID naredbe: 0x00000005 (deliver_sm) 
Status naredbe: 0x00000000 (postavljeno na 0 za zahtjeve) 
Broj sekvence: Jedinstveni identifikator za PDU 
Vrsta usluge: Opcionalno, često null 
TON izvorne adrese: Vrsta broja za pošiljatelja 
NPI izvorne adrese: Indikator plana numeracije za pošiljatelja 
Izvorna adresa: Telefonski broj pošiljatelja (npr., "+1234567890") 
TON odredišne adrese: Vrsta broja za primatelja 
NPI odredišne adrese: Indikator plana numeracije za primatelja 
Odredišna adresa: Telefonski broj primatelja (npr., virtualni broj) 
ESM klasa: Vrsta poruke (npr., 0x04 za SMS) 
Kodiranje podataka: Kodiranje znakova (npr., 0x00 za GSM 7-bitno) 
Kratka poruka: Tekst poruke (do 160 znakova za GSM)

Primjer deliver_sm PDU-a (heksadecimalno):

0000005F 00000005 00000000 00000003 00 01 01 2B3132333435363738393000 01 01 2B3938373635343332313000 00 00 00 00 00 48656C6C6F2C207468697320697320616E20534D5321

Objašnjenje:

  • Duljina naredbe (0000005F): Ukupna duljina (95 bajtova).
  • ID naredbe (00000005): Identificira PDU kao deliver_sm.
  • Status naredbe (00000000): Postavljeno na 0 za zahtjev.
  • Broj sekvence (00000003): Jedinstveni ID za praćenje PDU-a.
  • Vrsta usluge (00): Null, jer je opcionalno.
  • TON izvorne adrese (01): Međunarodni broj.
  • NPI izvorne adrese (01): ISDN/telefonski plan numeracije.
  • Izvorna adresa (2B3132333435363738393000): ASCII za "+1234567890".
  • TON odredišne adrese (01): Međunarodni broj.
  • NPI odredišne adrese (01): ISDN/telefonski plan numeracije.
  • Odredišna adresa (2B3938373635343332313000): ASCII za "+9876543210".
  • ESM klasa (00): Označava standardni SMS.
  • Kodiranje podataka (00): GSM 7-bitno kodiranje.
  • Kratka poruka (48656C6C6F2C207468697320697320616E20534D5321): ASCII za "Hello, this is an SMS!".

Nakon primanja deliver_sm PDU-a, Ozeki SMS Gateway obrađuje poruku i usmjerava je u konfiguriranu aplikaciju ili bazu podataka. Klijent mora odgovoriti s deliver_sm_resp PDU-om kako bi potvrdio primitak, osiguravajući pouzdanu isporuku. U Ozekiju, ovaj odgovor se automatski obrađuje, a poruka se bilježi u panelu "Poruke" ili pohranjuje u bazu podataka ako je konfigurirano.

Konfiguriranje Ozeki SMS Gatewaya za primanje SMS poruka

Kako biste osigurali da Ozeki SMS Gateway može primati SMS poruke:

  1. Postavljanje virtualnog broja: Surađujte s vašim pružateljem SMS usluga kako biste dodijelili virtualni broj (IMSI) za primanje SMS-a. Ovaj broj se navodi u polju "Raspon adresa" tijekom konfiguracije.
  2. Integracija baze podataka: Konfigurirajte Ozeki za pohranu dolaznih poruka u bazu podataka izmjenom SQL SELECT izraza u konfiguraciji "Korisnik baze podataka" (npr., "SELECT id, sender, receiver, msg, msgtype FROM ozekimessagein").
  3. Bilježenje: Omogućite bilježenje SMPP PDU-a kako biste pratili dolazne deliver_sm PDU-e za potrebe otklanjanja grešaka.

Nakon konfiguracije, dolazne SMS poruke se automatski usmjeravaju u navedenu aplikaciju ili bazu podataka, čineći Ozeki SMS Gateway robusnom platformom za primanje SMS-a putem SMPP API-ja.

Prekidanje SMPP API veze

Kada SMPP API sesija više nije potrebna, klijent šalje unbind PDU kako bi graciozno prekinuo vezu.

unbind PDU

unbind PDU signalizira SMSC-u da zatvori SMPP sesiju.

Struktura unbind PDU-a

Duljina naredbe: 0x00000010 (16 bajtova) 
ID naredbe: 0x00000006 (unbind) 
Status naredbe: 0x00000000 (postavljeno na 0 za zahtjeve) 
Broj sekvence: Jedinstveni identifikator za PDU

Primjer unbind PDU-a (heksadecimalno):

00000010 00000006 00000000 00000004

Objašnjenje:

  • Duljina naredbe (00000010): Ukupna duljina (16 bajtova).
  • ID naredbe (00000006): Identificira PDU kao unbind.
  • Status naredbe (00000000): Postavljeno na 0 za zahtjev.
  • Broj sekvence (00000004): Jedinstveni ID za praćenje PDU-a.

SMSC odgovara s unbind_resp PDU-om, potvrđujući prekid sesije. U Ozeki SMS Gatewayu, ovo možete pokrenuti klikom na "Prekini vezu" u panelu "Veze".

Najbolje prakse za korisnike SMPP API-ja

Kako biste optimizirali svoju implementaciju SMPP API-ja s Ozeki SMS Gatewayem za primanje SMS-a:

  • Omogućite Keepalive pakete: Osigurajte da je opcija "Pošalji keepalive pakete" omogućena kako biste održali stabilnu vezu.
  • Pratite zapisnike: Redovito provjeravajte zapisnike SMPP PDU-a kako biste otklonili probleme s bind_transceiver, enquire_link ili deliver_sm PDU-ima.
  • Koristite transceiver mod: Preferirajte transceiver mod radi učinkovitosti, jer podržava i slanje i primanje preko jedne veze.
  • Sigurne veze: Ako vaš pružatelj podržava, koristite SMPPS (SMPP preko SSL/TLS) za šifriranu komunikaciju.
  • Obrada izvješća o isporuci: Konfigurirajte Ozeki za obradu deliver_sm PDU-a koji sadrže izvješća o isporuci kako biste pratili status poruke.
Zaključak

Primanje SMS poruka korištenjem SMPP API-ja s Ozeki SMS Gatewayom uključuje uspostavljanje veze s bind_transceiver PDU-om, održavanje veze s enquire_link PDU-ima i obradu dolaznih poruka putem deliver_sm PDU-a. Razumijevanjem ovih PDU-a i pravilnim konfiguriranjem Ozeki SMS Gatewaya, programeri mogu izgraditi pouzdane SMS aplikacije visokih performansi. Fleksibilnost SMPP API-ja i robusna implementacija Ozeki-ja čine ga izvrsnim izborom za tvrtke koje traže skalabilna SMS rješenja. Za dodatne pojedinosti, pogledajte dokumentaciju Ozeki SMS Gatewaya ili kontaktirajte svog pružatelja SMS usluga za specifične parametre konfiguracije.

More information