Jak odesílat SMS pomocí SMPP API na úrovni protokolu

Protokol Short Message Peer-to-Peer (SMPP) API je široce používaný protokol pro výměnu SMS zpráv mezi entitami, jako jsou ESME (External Short Message Entities) a SMSC (Short Message Service Centers). Pro uživatele platformy Ozeki SMS Gateway je porozumění interakcím na úrovni SMPP protokolu klíčové pro optimalizaci výkonu, ladění a vlastní integrace. Tato příručka vysvětluje SMPP PDU (Protocol Data Units) potřebné k navázání, udržování a používání připojení SMPP API pro odesílání SMS zpráv.

Navázání připojení SMPP API

Pro odesílání SMS přes SMPP API musíte nejprve navázat spojení mezi klientem a serverem Ozeki SMS Gateway. Existují tři typy vazeb: bind_transmitter, bind_receiver a bind_transceiver. Každý z nich definuje směr toku zpráv.

Klíčová PDU pro navázání spojení

PDU Směr Účel Klíčové parametry
bind_transmitter ESME → SMSC Iniciuje připojení pro odesílání SMS
  • system_id: Uživatelské jméno klienta
  • password: Autentizační údaj
  • system_type: Identifikátor ESME
bind_receiver ESME → SMSC Nastavuje připojení pro příjem SMS Stejné jako bind_transmitter
bind_transceiver ESME → SMSC Umožňuje obousměrnou komunikaci Stejné jako bind_transmitter

Po úspěšném navázání spojení Ozeki gateway odpoví PDU bind_resp obsahujícím potvrzení system_id. Pokud autentizace selže, vrátí chybový kód jako ESME_RINVPASWD.

Udržování připojení SMPP API

SMPP připojení vyžadují periodické keep-alive signály, aby nedošlo k timeoutu. Použijte PDU enquire_link:

PDU Směr Účel
enquire_link ESME ↔ SMSC Kontroluje, zda je připojení aktivní
enquire_link_resp ESME ↔ SMSC Potvrzuje živost připojení

Doporučený postup: Odesílejte enquire_link každých 30-60 sekund. Ozeki SMS Gateway standardně ukončuje nečinná připojení po 5 minutách.

Odesílání SMS přes SMPP API

PDU submit_sm se používá k odeslání jedné SMS. Její struktura zahrnuje zdrojové/cílové adresy a obsah zprávy:

Parametr Popis Příklad
service_type Typ služby (volitelné) “” (prázdné)
source_addr Adresa odesílatele SMS “12345”
destination_addr Telefonní číslo příjemce “+1234567890”
short_message Obsah zprávy (UTF-8 nebo GSM-7) “Ahoj světe”

Příklad workflow submit_sm

  1. ESME odešle submit_sm na Ozeki SMS Gateway.
  2. Gateway odpoví submit_sm_resp obsahujícím message_id.
  3. Gateway odešle deliver_sm pro doručovací zprávy (pokud jsou povoleny).
  4. ESME odpoví deliver_sm_resp.

Zpracování odpovědí a chyb SMPP API

Ozeki SMS Gateway používá tyto odpovědní PDU:

PDU Účel Kritická pole
submit_sm_resp Potvrzuje submit_sm message_id, command_status
generic_nack Indikuje chybný/neplatný PDU command_status (např. ESME_RINVMSGLEN)

Závěr

Ovládnutí PDU SMPP API jako bind_transmitter, enquire_link a submit_sm zajišťuje spolehlivé odesílání SMS přes Ozeki SMS Gateway. Implementací robustního zpracování chyb a keep-alive rutin mohou vývojáři vytvářet škálovatelná SMS řešení s minimálními výpadky.

More information