SMS API,SMPP API MS Scheduler API
Gid itilizatè
SMS API,SMPP API MS Scheduler API
| Modifye: | 6/24/2025 |
| Vèsyon: | 1.7 |
| Otè: | Kenny Colander Norden, KCN |
Dokiman sa a se pou moun k ap resevwa deziyen an sèlman epi li ka genyen enfòmasyon prive, prive oswa prive. Si ou te resevwa li nan erè, tanpri notifye moun k la imedyatman epi efase orijinal la. Nenpòt lòt itilizasyon dokiman an pa ou entèdi.
Chanje istwa
| Rev | Dat | By | Chanjman nan vèsyon anvan yo |
| 1.0 | 2010-03-16 | KCN | Kreye |
| 1. | 2019-06-11 | TPE | Mete ajou logo LINK yo |
| 1. | 2019-09-27 | PNI | Te ajoute referans a spesifikasyon SMPP 3.4 |
| 1. | 2019-10-31 | EP | Obsèvasyon sou peryòd validite a tag |
| 1. | 2020-08-28 | KCN | Te ajoute enfòmasyon konsènan vèsyon TLS ki sipòte yo |
| 2. | 2022-01-10 | KCN | Te ajoute plis enfòmasyon konsènan rapò livrezon yo Enfòmasyon mete ajou konsènan TLS 1.3 |
| 2. | 2025-06-03 | GM | Kòd rezilta 2108 te ajoute |
| 2. | 2025-06-24 | AK | Kota ajoute |
Entwodiksyon
LINK Mobility se yon distribitè SMS depi 2001 e li gen anpil eksperyans nan travay ak tou de operatè ak agrégateur koneksyon. Platfòm sa a fèt pou jere volim trafik gwo, kenbe yon disponiblite segondè epi fè li fasil wout trafik atravè koneksyon miltip.
Dokiman sa a dekri koòdone SMPP pou platfòm SMSC a, paramèt ak kòmand ki nesesè e ki paramèt ki sipòte.
Dokiman sa a p ap okipe ka itilizasyon espesifik tankou mesaj konekte, WAPpush, Flash SMS, elatriye. Ou ka jwenn plis enfòmasyon sou ka sa yo lè w kontakte sipò teknik la.
Kòmandman sipòte
Sèvè LINK Mobility ta dwe trete kòm SMPP 3.4. Ou ka jwenn spesifikasyon ofisyèl la nan https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Tout metòd yo pa sipòte, epi tout diferans yo espesifye anba a.
4.1 Mare
Yo sipòte kòmandman lyen sa yo.
- Transmetè
- Transciever
- Reseptè
Paramèt obligatwa:
- system_id - jwenn nan sipò
- modpas - jwenn nan sipò
Paramèt opsyonèl:
- addr_ton - valè default si TON mete sou Unknown pandan soumèt.
- addr_npi – valè default si NPI mete sou Unknown pandan soumèt.
Paramèt ki pa sipòte:
- address_range
4.2 Demare
Se kòmandman an dekonekte sipòte.
4.3 Mande lyen
Yo sipòte kòmandman lyen rechèch la epi yo ta dwe rele chak 60 segonn.
4.4 Soumèt
Metòd soumèt yo ta dwe itilize pou livrezon mesaj yo.
Paramèt obligatwa:
- source_addr_ton
- source_addr_npi
- adr_sous
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_class
- done_coding
- sm_length
- mesaj_kout
Paramèt ki pa sipòte:
- service_type
- protocol_id
- priyorite_drapo
- schedule_delivery_time
- ranplase_si_prezan_drapo
- sm_default_msg_id
Remak ke chaj la tag pa sipòte epi sèlman yon sèl SMS ka delivre pou chak apèl epi li rekòmande ke validity_period la tag gen yon valè de 15 minit pou pi piti.
4.4.1 TON ak NPI rekòmande
TON ak NPI sa yo ta dwe itilize lè w ap voye mesaj lè l sèvi avèk lòd soumèt.
4.4.1.1 Sous
Konbinezon TON ak NPI sa yo sipòte pou adrès sous la. Tout lòt konbinezon yo pral trete kòm envalid. TON pa defo ki soti nan kòmand bind lan pral itilize si TON mete sou Enkoni (0). NPI pa defo ki soti nan kòmand bind lan pral itilize si NPI mete sou Enkoni (0).
| TON | NPI | Deskripsyon |
| Alfanumerik (5) | Enkoni (0) ISDN (1) |
Yo pral trete kòm tèks alfanumerik emèt |
| Entènasyonal (1) | Enkoni (0) ISDN (1) |
Yo pral trete kòm MSISDN |
| nasyonal (2) Espesifik rezo (3) Nimewo abònen (4) Abreje (6) |
Enkoni (0) ISDN (1) nasyonal (8) |
Yo pral trete kòm nimewo kout espesifik nan peyi a. |
4.4.1.2 Destinasyon
Konbinezon TON ak NPI sa yo sipòte pou adrès destinasyon an. Tout lòt konbinezon yo pral trete kòm envalid. Yo pral itilize TON default ki soti nan lòd lye si TON mete sou Unknown (0). NPI defo ki soti nan lòd lyen yo pral itilize si NPI mete sou Unknown (0).
| TON | NPI | Deskripsyon |
| Entènasyonal (1) | Enkoni (0) ISDN (1) |
Yo pral trete kòm MSISDN |
4.4.2 Sipòte kodaj
Kodaj sa yo sipòte. X ka genyen nenpòt valè.
| DCS | Kodaj |
| 0xX0 | Default GSM Alfabèt ak ekstansyon |
| 0xX2 | 8-bit binè |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
Kota
5.1 Kota Depaseview
Yon kota defini kantite maksimòm mesaj SMS ki ka voye nan yon entèval tan espesifik (tankou pa jou, semèn, mwa, oswa endefiniman). Chak kota idantifye inikman pa yon quotaId (UUID) epi li retabli selon zòn tan kliyan an. Kota yo ka asiyen nan nivo peyi a, rejyon an, oswa nivo pa defo atravè yon Quota Pro.fileYo kapab tou asiyen kota dinamikman lè l sèvi avèk Map Kota. Sa a mete yon QuotaId paran (UUID) ak yon Kle kota inik (pa egzanp, moun k ap voye a oswa itilizatè a) sou yon quotaId espesifik.
Yo fikse yon kota dapre sipò lokal ou a, responsab kont ki asiyen ba ou a, oubyen pa default si pa gen anyen ki espesifye.
5.2 Sitiyasyon 106 – Kota Depase
Yo ka bloke yon mesaj SMS avèk kòd estati 106 ("kota depase") lè:
- Mesaj la depase limit ki defini pou quotaId korespondan li a nan entèval aktyèl la.
- Peyi oswa rejyon destinasyon an pa gen okenn kota ki asiyen (sa vle di, li bloke eksplisitman ak yon map kota nil nan pwogram nan).file).
- Pa gen kota ki koresponn e pa gen kota pa default ki defini, sa ki lakòz rejte.
Nan ka sa yo, sistèm nan anpeche plis tretman mesaj pou aplike limit ki baze sou kliyan oswa destinasyon epi evite move itilizasyon.
Rapò livrezon
Sèlman pa gen okenn oswa livrezon final ak rezilta siksè/echèk yo sipòte.
Fòma sou rapò livrezon: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx dat fè: yyMMddHHmm stat:
Valè ki disponib nan estati:
- DELIVRD
- EKSPIRE
- REJTED
- UNELIV
- Efase
6.1 Fòma rapò livrezon pwolonje
Yo ka mande enfòmasyon pwolonje nan rapò livrezon an kontak ak reprezantan lavant ou.
Fòma sou rapò livrezon an: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 dat soumèt:
aaMMjjHHmm dat fini: aaMMjjHHmm stats: erè: tèks:
Valè ki disponib nan estati:
- DELIVRD
- EKSPIRE
- REJTED
- UNELIV
- Efase
Jaden "sub" ak "dlvrd" ap toujou mete sou 000, ak jaden "tèks" ap toujou vid.
Gade chapit Kòd erè pou valè pou jaden "err".
Sipòte vèsyon TLS
TLS 1.2 oswa TLS 1.3 obligatwa pou tout koneksyon TLS sou SMPP.
Sipò pou TLS 1.0 ak 1.1 sispann depi 2020-11-15. Vèsyon 1.0 ak 1.1 nan TLS yo se ansyen pwotokòl ki te depreche epi yo konsidere kòm risk sekirite nan kominote entènèt la.
LINK rekòmande anpil pou itilize TLS si yo itilize koneksyon SMPP ki pa chiffres jodi a. Koneksyon SMPP ki pa kode yo demode apati 2020-09-01 pa LINK, epi yo pral retire nan lavni. Dat pou retire koneksyon ki pa chiffres poko deside.
Koneksyon anvè sèvè SMPP pou TLS se nan pò 3601 olye pou yo pa chifre nan pò 3600.
Ou ka toujou itilize TLS menm si aplikasyon SMPP ou a pa sipòte TLS lè l sèvi avèk stunnel, gade https://www.stunnel.org/
Kòd erè
Kòd erè sa yo ka reponn nan jaden an erè si jaden an pèmèt.
| Kòd erè | Deskripsyon |
| 0 | Erè enkoni |
| 1 | Erè routage tanporè |
| 2 | Erè wout pèmanan |
| 3 | Maksimòm throttling depase |
| 4 | Delè |
| 5 | Operatè enkoni erè |
| 6 | Erè operatè |
| 100 | Sèvis pa jwenn |
| 101 | Itilizatè pa jwenn |
| 102 | Kont pa jwenn |
| 103 | Modpas valab |
| 104 | Erè konfigirasyon |
| 105 | Erè entèn |
| 106 | Kota depase |
| 200 | OK |
| 1000 | Voye |
| 1001 | Livre |
| 1002 | Ekspire |
| 1003 | Efase |
| 1004 | Mobile plen |
| 1005 | Nan keu |
| 1006 | Pa delivre |
| 1007 | Livre, chaj an reta |
| 1008 | Chaje, mesaj pa voye |
| 1009 | Chaje, mesaj pa delivre |
| 1010 | Ekspire, absans rapò livrezon operatè |
| 1011 | Chaje, mesaj voye (bay operatè) |
| 1012 | Adistans nan keu |
| 1013 | Mesaj voye bay operatè a, chaje reta |
| 2000 | Nimewo sous envalid |
| 2001 | Nimewo kout pa sipòte kòm sous |
| 2002 | Alpha pa sipòte kòm sous |
| 2003 | MSISDN pa sipòte kòm nimewo sous |
| 2100 | Nimewo kout pa sipòte kòm destinasyon |
| 2101 | Alpha pa sipòte kòm destinasyon |
| 2102 | MSISDN pa sipòte kòm destinasyon |
| 2103 | Operasyon bloke |
| 2104 | Enkoni abònen |
| 2105 | Destinasyon bloke |
| 2106 | Erè nimewo |
| 2107 | Destinasyon bloke tanporèman |
| 2108 | Destinasyon ki pa valab |
| 2200 | Erè chaje |
| 2201 | Abònen gen balans ki ba |
|
2202 |
Abòne entèdi pou twòp chaj (prim)
mesaj |
|
2203 |
Abòne twò jèn (pou patikilye sa a)
kontni) |
| 2204 | Abònen prépayé pa pèmèt |
| 2205 | Sèvis rejte pa abònen |
| 2206 | Abònen pa anrejistre nan sistèm peman |
| 2207 | Abònen rive nan balans maksimòm |
| 2208 | Konfimasyon itilizatè fen bezwen |
| 2300 | Ranbouse |
|
2301 |
Pa t kapab ranbouse akòz ilegal oswa manke
MSISDN |
| 2302 | Pa t 'kapab ranbousman akòz manke mesajId |
| 2303 | Nan keu pou ranbousman |
| 2304 | Delè ranbousman |
| 2305 | Echèk ranbousman |
| 3000 | GSM kodaj pa sipòte |
| 3001 | UCS2 kodaj pa sipòte |
| 3002 | Binè kodaj pa sipòte |
| 4000 | Rapò livrezon pa sipòte |
| 4001 | Kontni mesaj ki pa valab |
| 4002 | Tarif ki pa valab |
| 4003 | Done itilizatè ki pa valab |
| 4004 | Tèt done itilizatè ki pa valab |
| 4005 | Kodaj done ki pa valab |
| 4006 | VAT envalid |
| 4007 | Kontni ki pa sipòte pou destinasyon |
Dokiman / Resous
 |
lyen mobilite SMS API,SMPP API MS Scheduler API [pdfGid Itilizatè SMS API SMPP API MS Scheduler API, SMS API SMPP API, MS Scheduler API, Scheduler API, API |