Ako posielať SMS pomocou SMPP API na úrovni protokolu

Short Message Peer-to-Peer (SMPP) API je široko používaný protokol na výmenu SMS správ medzi SMS entitami, ako sú ESME (External Short Message Entities) a SMSC (Short Message Service Centers). Pre používateľov platformy Ozeki SMS Gateway je pochopenie interakcií na úrovni SMPP protokolu kritické pre optimalizáciu výkonu, ladenie a vlastné integrácie. Tento sprievodca vysvetľuje SMPP PDU (Protocol Data Units), ktoré sú potrebné na vytvorenie, udržanie a použitie SMPP API pripojenia na odosielanie SMS správ.

Vytvorenie pripojenia SMPP API

Na odoslanie SMS cez SMPP API musíte najprv naviazať vášho klienta na server Ozeki SMS Gateway. Existujú tri typy viazania: bind_transmitter, bind_receiver a bind_transceiver. Každý definuje smer toku správ.

Kľúčové PDU pre nastavenie pripojenia

PDU Smer Účel Kľúčové parametre
bind_transmitter ESME → SMSC Iniciuje pripojenie na odosielanie SMS
  • system_id: Používateľské meno klienta
  • password: Autentifikačné údaje
  • system_type: Identifikátor pre ESME
bind_receiver ESME → SMSC Nastaví pripojenie na prijímanie SMS Rovnaké ako bind_transmitter
bind_transceiver ESME → SMSC Umožňuje obojsmerný prenos správ Rovnaké ako bind_transmitter

Po úspešnom naviazaní Ozeki gateway odpovie s PDU bind_resp obsahujúcim potvrdenie system_id. Ak autentifikácia zlyhá, vráti chybový kód ako ESME_RINVPASWD.

Udržiavanie pripojenia SMPP API

SMPP pripojenia vyžadujú periodické keep-alive signály, aby sa predišlo timeoutu. Použite PDU enquire_link:

PDU Smer Účel
enquire_link ESME ↔ SMSC Kontroluje, či je pripojenie aktívne
enquire_link_resp ESME ↔ SMSC Potvrdzuje živé pripojenie

Dobrá prax: Odosielajte enquire_link každých 30-60 sekúnd. Ozeki SMS Gateway predvolene ukončí nečinné pripojenia po 5 minútach.

Odosielanie SMS cez SMPP API

PDU submit_sm sa používa na odoslanie jednej SMS. Jej štruktúra zahŕňa zdrojové/cieľové adresy a obsah správy:

Parameter Popis Príklad
service_type Typ služby (voliteľné) “” (prázdne)
source_addr Adresa odosielateľa SMS “12345”
destination_addr Telefónne číslo príjemcu “+1234567890”
short_message Obsah správy (UTF-8 alebo GSM-7) “Ahoj svet”

Príklad postupu submit_sm

  1. ESME odošle submit_sm na Ozeki SMS Gateway.
  2. Gateway odpovie s submit_sm_resp obsahujúcim message_id.
  3. Gateway odošle deliver_sm pre doručovacie správy (ak sú povolené).
  4. ESME odpovie s deliver_sm_resp.

Spracovanie odpovedí a chýb SMPP API

Ozeki SMS Gateway používa tieto odpovede PDU:

PDU Účel Kritické polia
submit_sm_resp Potvrdzuje submit_sm message_id, command_status
generic_nack Indikuje chybne vytvorené/neplatné PDU command_status (napr. ESME_RINVMSGLEN)

Záver

Ovládanie SMPP API PDU ako bind_transmitter, enquire_link a submit_sm zabezpečuje spoľahlivý prenos SMS správ cez Ozeki SMS Gateway. Implementáciou robustného spracovania chýb a keep-alive rutín môžu vývojári vytvoriť škálovateľné SMS riešenia s minimálnym výpadkom.

More information