SMS API,SMPP API MS Scheduler API
Gabay sa Gumagamit
SMS API,SMPP API MS Scheduler API
| Binago: | 6/24/2025 |
| Bersyon: | 1.7 |
| May-akda: | Kenny Colander Norden, KCN |
Ang dokumentong ito ay para lamang sa itinalagang tatanggap at maaaring maglaman ng pribilehiyo, pagmamay-ari, o kung hindi man ay pribadong impormasyon. Kung natanggap mo ito sa pagkakamali, mangyaring abisuhan kaagad ang nagpadala at tanggalin ang orihinal. Ang anumang iba pang paggamit mo ng dokumento ay ipinagbabawal.
Kasaysayan ng pagbabago
| Sinabi ni Rev | Petsa | By | Mga pagbabago mula sa nakaraang release |
| 1.0 | 2010-03-16 | KCN | Nilikha |
| 1. | 2019-06-11 | TPE | Na-update na mga logo ng LINK |
| 1. | 2019-09-27 | PNI | Nagdagdag ng reference sa SMPP 3.4 na detalye |
| 1. | 2019-10-31 | EP | Pagmamasid tungkol sa panahon ng bisa tag |
| 1. | 2020-08-28 | KCN | Nagdagdag ng impormasyon tungkol sa mga sinusuportahang bersyon ng TLS |
| 2. | 2022-01-10 | KCN | Added additional information regarding delivery reports Updated information regarding TLS 1.3 |
| 2. | 2025-06-03 | GM | Added result code 2108 |
| 2. | 2025-06-24 | AK | Added quota |
Panimula
Ang LINK Mobility ay isang SMS distributor mula noong 2001 at may maraming karanasan sa pakikipagtulungan sa parehong mga operator at mga aggregator ng koneksyon. Idinisenyo ang platform na ito upang pangasiwaan ang malalaking dami ng trapiko, mapanatili ang mataas na kakayahang magamit at gawing madali ang ruta ng trapiko sa pamamagitan ng maraming koneksyon.
This is document describes the SMPP interface to the SMSC-platform and which parameters and commands that are required and which parameters are supported.
This document will not handle specific use cases as concatenated messages, WAPpush, Flash SMS, etc. More information about those cases can be provided by contacting support.
Mga suportadong utos
Ang server ng LINK Mobility ay dapat ituring bilang SMPP 3.4. Ang opisyal na detalye ay matatagpuan sa https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Ang lahat ng mga pamamaraan ay hindi suportado, at ang lahat ng mga pagkakaiba ay tinukoy sa ibaba.
4.1 Magbigkis
Ang mga sumusunod na utos ng bind ay sinusuportahan.
- Tagapaghatid
- transciever
- Tagatanggap
Mga kinakailangang parameter:
- system_id – nakuha mula sa suporta
- password – nakuha mula sa suporta
Opsyonal na mga parameter:
- addr_ton – default na halaga kung ang TON ay nakatakda sa Hindi Alam sa panahon ng pagsusumite.
- addr_npi – default na halaga kung ang NPI ay nakatakda sa Hindi Alam sa panahon ng pagsusumite.
Mga hindi sinusuportahang parameter:
- address_range
4.2 Alisin ang pagkakatali
Ang unbind command ay sinusuportahan.
4.3 Magtanong ng link
Ang inquire link command ay suportado at dapat na tawagan tuwing 60 segundo.
4.4 Isumite
Ang paraan ng pagsusumite ay dapat gamitin para sa paghahatid ng mga mensahe.
Mga kinakailangang parameter:
- source_addr_ton
- source_addr_npi
- source_addr
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_class
- data_coding
- sm_length
- maikling mensahe
Mga hindi sinusuportahang parameter:
- service_type
- protocol_id
- priority_flag
- schedule_delivery_time
- replace_if_present_flag
- sm_default_msg_id
Tandaan na ang payload tag ay hindi suportado at isang SMS lamang ang maaaring maihatid sa bawat tawag at inirerekomenda na ang validity_period tag ay may halaga na 15 minuto ang haba ng hindi bababa sa.
4.4.1 Inirerekomenda ang TON at NPI
Ang sumusunod na TON at NPI ay dapat gamitin kapag nagpapadala ng mga mensahe gamit ang submit command.
4.4.1.1 Pinagmulan
The following TON and NPI combinations are supported for source address. All other combinations will be treated as invalid. The default TON from bind command will be used if TON is set to Unknown (0). The default NPI from bind command will be used if NPI is set to Unknown (0).
| TON | NPI | Paglalarawan |
| Alphanumeric (5) | Hindi alam (0) ISDN (1) |
Ituturing bilang Alphanumeric na text ng nagpadala |
| International (1) | Hindi alam (0) ISDN (1) |
Ituturing na MSISDN |
| Pambansa (2) Network specific (3) Subscriber number (4) Abbreviated (6) |
Hindi alam (0) ISDN (1) Pambansa (8) |
Ituturing bilang maikling numero na partikular sa bansa. |
4.4.1.2 Patutunguhan
Ang mga sumusunod na kumbinasyon ng TON at NPI ay sinusuportahan para sa patutunguhang address. Ang lahat ng iba pang kumbinasyon ay ituturing na hindi wasto. Ang default na TON mula sa bind command ay gagamitin kung ang TON ay nakatakda sa Unknown (0). Ang default na NPI mula sa bind command ay gagamitin kung ang NPI ay nakatakda sa Unknown (0).
| TON | NPI | Paglalarawan |
| International (1) | Hindi alam (0) ISDN (1) |
Ituturing na MSISDN |
4.4.2 Mga suportadong encoding
Ang mga sumusunod na pag-encode ay sinusuportahan. Ang X ay maaaring maglaman ng anumang halaga.
| DCS | Encoding |
| 0xX0 | Default na GSM Alphabet na may extension |
| 0xX2 | 8-bit na binary |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
Quota
5.1 Quota Overview
A quota defines the maximum number of SMS messages that can be sent within a specified time interval (such as per day, week, month, or indefinitely). Each quota is uniquely identified by a quotaId (UUID) and is reset according to the customer’s time zone. Quotas can be assigned at the country, region, or default level through a Quota Profile. Quota can also be dynamically assigned using Quota Mapping. This maps a parent QuotaId (UUID) and a unique quota Key (e.g., sender or user) to a specific quotaId.
A quota is set in accordance with your local support, your assigned account manager or by default if nothing is specified.
5.2 Status 106 – Quota Exceeded
An SMS message may be blocked with status code 106 (“quota exceeded”) when:
- The message exceeds the defined limit for its corresponding quotaId within the current interval.
- The destination country or region has no quota assigned (i.e., is explicitly blocked with a null quota mapping in the profile).
- There is no matching quota and no default quota is defined, resulting in rejection.
In these cases, the system prevents further message processing to enforce customer or destination-based limits and avoid misuse.
Ulat sa paghahatid
Wala lang o panghuling paghahatid na may resultang matagumpay/kabiguan ang sinusuportahan.
Format sa ulat ng paghahatid: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx tapos na petsa: yyMMddHHmm stat:
Mga available na value sa status:
- DELIVRD
- EXPIRED
- TINANGGIHAN
- UNDELIV
- NABURA
6.1 Pinahabang format ng ulat sa paghahatid
Ang pinalawak na impormasyon sa mga ulat sa paghahatid ay maaaring hilingin sa pakikipag-ugnayan sa iyong sales representative.
Format on delivery report: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 submit date:
yyMMddHHmm done date: yyMMddHHmm stat: <status> err: <error code> text:
Mga available na value sa status:
- DELIVRD
- EXPIRED
- TINANGGIHAN
- UNDELIV
- NABURA
Palaging itatakda sa 000 ang mga field na "sub" at "dlvrd", at palaging walang laman ang field na "text".
Tingnan ang kabanata Mga error code para sa mga halaga para sa field na “err”.
Mga sinusuportahang bersyon ng TLS
Kinakailangan ang TLS 1.2 o TLS 1.3 para sa lahat ng TLS na koneksyon sa SMPP.
Ang suporta para sa TLS 1.0 at 1.1 ay itinigil mula noong 2020-11-15. Ang mga bersyon 1.0 at 1.1 ng TLS ay mga mas lumang protocol na hindi na ginagamit at itinuturing na mga panganib sa seguridad sa komunidad ng Internet.
Lubos na inirerekomenda ng LINK na gumamit ng TLS kung ang mga hindi naka-encrypt na koneksyon sa SMPP ay ginagamit ngayon. Ang mga hindi naka-encrypt na koneksyon sa SMPP ay hindi na ginagamit noong 2020-09-01 ng LINK, at aalisin sa hinaharap. Ang petsa para sa pag-alis ng mga hindi naka-encrypt na koneksyon ay hindi pa napagpasyahan.
Ang mga koneksyon patungo sa SMPP server para sa TLS ay nasa port 3601 sa halip na hindi naka-encrypt sa port 3600.
Maaari mo pa ring gamitin ang TLS kahit na ang iyong pagpapatupad ng SMPP ay hindi sumusuporta sa TLS gamit ang stunnel, tingnan https://www.stunnel.org/
Mga error code
Ang mga sumusunod na error code ay maaaring masagot sa err field kung ang field ay pinagana.
| Error code | Paglalarawan |
| 0 | Hindi kilalang error |
| 1 | Pansamantalang error sa pagruruta |
| 2 | Permanenteng error sa pagruruta |
| 3 | Lumampas sa maximum throttling |
| 4 | Timeout |
| 5 | Hindi kilalang error ang operator |
| 6 | Error sa operator |
| 100 | Ang serbisyo ay hindi mahanap |
| 101 | Hindi nahanap ang user |
| 102 | hindi mahanap ang account |
| 103 | Di wastong password |
| 104 | Error sa configuration |
| 105 | Panloob na error |
| 106 | Quota exceeded |
| 200 | OK |
| 1000 | Ipinadala |
| 1001 | Naihatid |
| 1002 | Nag-expire na |
| 1003 | Tinanggal |
| 1004 | Puno ang mobile |
| 1005 | Nakapila |
| 1006 | Hindi naihatid |
| 1007 | Naihatid, naantala ang pagsingil |
| 1008 | Siningil, hindi naipadala ang mensahe |
| 1009 | Siningil, hindi naihatid ang mensahe |
| 1010 | Nag-expire na, kawalan ng ulat sa paghahatid ng operator |
| 1011 | Siningil, ipinadala ang mensahe (sa operator) |
| 1012 | Malayong nakapila |
| 1013 | Ipinadala ang mensahe sa operator, naantala ang pagsingil |
| 2000 | Di-wastong numero ng pinagmulan |
| 2001 | Ang maikling numero ay hindi sinusuportahan bilang pinagmulan |
| 2002 | Hindi sinusuportahan ang Alpha bilang pinagmulan |
| 2003 | Hindi sinusuportahan ang MSISDN bilang source number |
| 2100 | Ang maikling numero ay hindi sinusuportahan bilang destinasyon |
| 2101 | Hindi sinusuportahan ang Alpha bilang destinasyon |
| 2102 | Ang MSISDN ay hindi suportado bilang destinasyon |
| 2103 | Na-block ang operasyon |
| 2104 | Hindi kilalang subscriber |
| 2105 | Na-block ang destinasyon |
| 2106 | Error sa numero |
| 2107 | Pansamantalang na-block ang destinasyon |
| 2108 | Invalid destination |
| 2200 | Error sa pag-charge |
| 2201 | Ang subscriber ay may mababang balanse |
|
2202 |
Subscriber barred for overcharged (premium)
mga mensahe |
|
2203 |
Subscriber too young (for this particular
nilalaman) |
| 2204 | Hindi pinapayagan ang prepaid na subscriber |
| 2205 | Tinanggihan ng subscriber ang serbisyo |
| 2206 | Hindi nakarehistro ang subscriber sa sistema ng pagbabayad |
| 2207 | Naabot ng subscriber ang max na balanse |
| 2208 | Kailangan ng kumpirmasyon ng end user |
| 2300 | Na-refund |
|
2301 |
Could not refund due to illegal or missing
MSISDN |
| 2302 | Hindi ma-refund dahil sa nawawalang messageId |
| 2303 | Nakapila para sa refund |
| 2304 | Timeout ng refund |
| 2305 | Kabiguan sa pag-refund |
| 3000 | Hindi suportado ang GSM encoding |
| 3001 | Ang pag-encode ng UCS2 ay hindi suportado |
| 3002 | Hindi sinusuportahan ang binary encoding |
| 4000 | Ang ulat sa paghahatid ay hindi suportado |
| 4001 | Di-wastong nilalaman ng mensahe |
| 4002 | Di-wastong taripa |
| 4003 | Di-wastong data ng user |
| 4004 | Di-wastong header ng data ng user |
| 4005 | Di-wastong data coding |
| 4006 | Di-wastong VAT |
| 4007 | Hindi sinusuportahang content para sa destinasyon |
Mga Dokumento / Mga Mapagkukunan
 |
link mobility SMS API,SMPP API MS Scheduler API [pdf] Gabay sa Gumagamit SMS API SMPP API MS Scheduler API, SMS API SMPP API, MS Scheduler API, Scheduler API, API |