Az SMS küldése SMPP API segítségével protokoll szinten

A Short Message Peer-to-Peer (SMPP) API egy széles körben elterjedt protokoll SMS-üzenetek cseréjére olyan SMS entitások között, mint az ESME-k (External Short Message Entities) és az SMSC-k (Short Message Service Centers). Az Ozeki SMS Gateway platform felhasználói számára az SMPP protokoll szintű interakcióinak megértése kulcsfontosságú a teljesítmény optimalizálásához, hibakereséshez és egyedi integrációkhoz. Ez a útmutató azokat az SMPP PDU-kat (Protocol Data Units) ismerteti, amelyek szükségesek egy SMPP API kapcsolat létrehozásához, karbantartásához és SMS-üzenetek küldéséhez.

SMPP API kapcsolat létrehozása

Az SMS SMPP API-n keresztüli küldéséhez először kötést kell létrehozni az ügyfél és az Ozeki SMS Gateway szerver között. Háromféle kötés létezik: bind_transmitter, bind_receiver és bind_transceiver. Mindegyik meghatározza az üzenetek irányát.

Kulcsfontosságú PDU-k a kapcsolatfelépítéshez

PDU Irány Cél Kulcsfontosságú paraméterek
bind_transmitter ESME → SMSC Kapcsolat létrehozása SMS küldéséhez
  • system_id: Ügyfél felhasználónév
  • password: Hitelesítő adat
  • system_type: Azonosító az ESME-hez
bind_receiver ESME → SMSC Kapcsolat létrehozása SMS fogadásához Ugyanaz, mint a bind_transmitter
bind_transceiver ESME → SMSC Kétirányú üzenetküldés engedélyezése Ugyanaz, mint a bind_transmitter

Sikeres kötés esetén az Ozeki gateway egy bind_resp PDU-val válaszol, amely tartalmaz egy system_id nyugtát. Ha a hitelesítés sikertelen, egy hibakódot ad vissza, például ESME_RINVPASWD.

Az SMPP API kapcsolat karbantartása

Az SMPP kapcsolatok időszakos keep-alive jeleket igényelnek az időtúllépés elkerüléséhez. Használja a enquire_link PDU-t:

PDU Irány Cél
enquire_link ESME ↔ SMSC Ellenőrzi, hogy a kapcsolat aktív-e
enquire_link_resp ESME ↔ SMSC Megerősíti az életképességet

Ajánlott eljárás: Küldjön enquire_link jelet 30-60 másodpercenként. Az Ozeki SMS Gateway alapértelmezés szerint 5 perc inaktivitás után megszakítja a kapcsolatot.

SMS küldése SMPP API-n keresztül

A submit_sm PDU-t használják egyetlen SMS küldéséhez. Szerkezete tartalmazza a forrás/cél címeket és az üzenet tartalmát:

Paraméter Leírás Példa
service_type Szolgáltatás típusa (opcionális) “” (üres)
source_addr SMS feladó címe “12345”
destination_addr Címzett telefonszáma “+1234567890”
short_message Üzenet tartalma (UTF-8 vagy GSM-7) “Hello World”

Példa submit_sm munkafolyamatra

  1. Az ESME elküldi a submit_sm PDU-t az Ozeki SMS Gateway-nek.
  2. A gateway válaszol egy submit_sm_resp PDU-val, amely tartalmaz egy message_id-t.
  3. A gateway deliver_sm PDU-t küld a kézbesítési jelentésekhez (ha engedélyezve van).
  4. Az ESME válaszol egy deliver_sm_resp PDU-val.

SMPP API válaszok és hibák kezelése

Az Ozeki SMS Gateway a következő válasz PDU-kat használja:

PDU Cél Kritikus mezők
submit_sm_resp Nyugtázza a submit_sm PDU-t message_id, command_status
generic_nack Hibás/érvénytelen PDU-t jelez command_status (pl. ESME_RINVMSGLEN)

Összegzés

Az SMPP API PDU-k, mint a bind_transmitter, enquire_link és submit_sm elsajátítása biztosítja a megbízható SMS kézbesítést az Ozeki SMS Gateway-en keresztül. A robusztus hibakezelés és keep-alive rutinok implementálásával a fejlesztők skálázható SMS megoldásokat építhetnek minimális állásidővel.

More information