SMS API,SMPP API MS Scheduler API
Torolàlana ho an'ny mpampiasa
SMS API,SMPP API MS Scheduler API
| Ovaina: | 6/24/2025 |
| Version: | 1.7 |
| Mpanoratra: | Kenny Colander Norden, KCN |
Ity antontan-taratasy ity dia natao ho an'ny mpandray voatendry ihany ary mety misy fampahalalana manokana, manokana, na manokana. Raha diso ianao nahazo azy dia ampahafantaro avy hatrany ny mpandefa ary vonoy ny tany am-boalohany. Ny fampiasanao ny antontan-taratasy hafa rehetra dia voarara.
Ovao ny tantara
| Apk | Daty | By | Fanovana tamin'ny famoahana teo aloha |
| 1.0 | 2010-03-16 | KCN | NAMORONA NY |
| 1. | 2019-06-11 | TPE | Logos LINK nohavaozina |
| 1. | 2019-09-27 | PNI | Nampiana fanondroana SMPP 3.4 |
| 1. | 2019-10-31 | EP | Fandinihana momba ny fe-potoana manan-kery tag |
| 1. | 2020-08-28 | KCN | Fanampiana fanampiny momba ny dikan-teny TLS tohanana |
| 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 |
Sava lalana
LINK Mobility dia mpaninjara SMS nanomboka tamin'ny taona 2001 ary manana traikefa betsaka amin'ny fiaraha-miasa amin'ireo mpandraharaha sy mpanangona fifandraisana. Ity sehatra ity dia natao hifehezana ny habetsaky ny fifamoivoizana, hitazonana ny fahafaha-manao avo lenta ary hanamora ny fitaterana ny fifamoivoizana amin'ny alàlan'ny fifandraisana maro.
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.
Baiko tohanana
Ny mpizara LINK Mobility dia tokony ho raisina ho SMPP 3.4. Ny famaritana ofisialy dia azo jerena ao amin'ny https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Ny fomba rehetra dia tsy tohanana, ary ny fahasamihafana rehetra dia voalaza etsy ambany.
4.1 Mamatotra
Tohanana ireto baiko mamatotra manaraka ireto.
- fitaovana fandefasam-peo
- Transciever
- Mpandray
Paramètre ilaina:
- system_id – azo avy amin'ny fanohanana
- tenimiafina - azo avy amin'ny fanohanana
Fehezan-dalàna tsy voatery:
- addr_ton - sanda default raha apetraka amin'ny Unknown ny TON mandritra ny fandefasana.
- addr_npi - sanda default raha toa ka napetraka amin'ny Unknown ny NPI mandritra ny fandefasana.
Paramètre tsy tohanana:
- adiresy_faritra
4.2 Esory ny fatorana
Ny baiko unbond dia tohanana.
4.3 Manontany rohy
Ny baiko rohy manontany dia tohanana ary tokony hantsoina isaky ny 60 segondra.
4.4 Alefaso
Ny fomba fandefasana dia tokony hampiasaina amin'ny fandefasana hafatra.
Paramètre ilaina:
- source_addr_ton
- source_addr_npi
- source_addr
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_class
- data_coding
- sm_length
- hafatra_fohy
Paramètre tsy tohanana:
- service_type
- protocol_id
- priority_flag
- fandaharam-potoana_fanaterana_fotoana
- replace_if_present_flag
- sm_default_msg_id
Fanamarihana hoe ny payload tag dia tsy tohanana ary SMS iray ihany no azo alefa isaky ny antso ary asaina ny fe-potoana_valiny tag manana sanda maharitra 15 minitra farafahakeliny.
4.4.1 Tolotra TON sy NPI
Ity TON sy NPI manaraka ity dia tokony hampiasaina rehefa mandefa hafatra amin'ny alàlan'ny baiko fandefasana.
4.4.1.1 Loharano
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).
| taonina | NPI | Description |
| Alfanumerika (5) | Tsy fantatra (0) ISDN (1) |
Ho raisina ho toy ny lahatsoratra mpandefa alphanumeric |
| iraisam-pirenena (1) | Tsy fantatra (0) ISDN (1) |
Ho raisina ho MSISDN |
| nasionaly (2) Network specific (3) Subscriber number (4) Abbreviated (6) |
Tsy fantatra (0) ISDN (1) nasionaly (8) |
Ho raisina ho laharana fohy manokana amin'ny firenena. |
4.4.1.2 Toerana
Ireto fitambarana TON sy NPI manaraka ireto dia tohana ho an'ny adiresin'ny toerana haleha. Ny fitambarana hafa rehetra dia horaisina ho tsy manan-kery. Ny TON default avy amin'ny baikon'ny bind dia hampiasaina raha apetraka amin'ny Unknown (0) ny TON. Ny NPI default avy amin'ny baiko mamatotra dia ampiasaina raha toa ka napetraka amin'ny Unknown (0) ny NPI.
| taonina | NPI | Description |
| iraisam-pirenena (1) | Tsy fantatra (0) ISDN (1) |
Ho raisina ho MSISDN |
4.4.2 Fanodinana tohana
Tohanana ireto encoding manaraka ireto. X dia mety misy sanda rehetra.
| DCS | Encoding |
| 0xX0 | Default GSM Alphabet miaraka amin'ny fanitarana |
| 0xX2 | 8-bit binary |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
izay anjara-fanompoana
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.
Tatitra fanaterana
Tsy misy na fanaterana farany misy valiny mahomby/tsy fahombiazana ihany no tohanana.
Ny endrika momba ny tatitra momba ny fanaterana: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx daty vita: yyMMddHHmm stat:
Sanda misy amin'ny sata:
- MANATERA
- niala aina
- TSIA
- UNDELIV
- nofafana
6.1 Endriky ny tatitra fanaterana miitatra
Ny fampahalalana fanampiny amin'ny tatitra momba ny fandefasana dia azo angatahina amin'ny fifandraisana amin'ny solontenan'ny varotra anao.
Format on delivery report: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 submit date:
yyMMddHHmm done date: yyMMddHHmm stat: <status> err: <error code> text:
Sanda misy amin'ny sata:
- MANATERA
- niala aina
- TSIA
- UNDELIV
- nofafana
Ny saha "sub" sy "dlvrd" dia hapetraka amin'ny 000 foana, ary ny saha "text" dia ho foana foana.
Jereo ny toko Kaody hadisoana momba ny soatoavina ho an'ny saha "err".
Dika TLS tohanana
TLS 1.2 na TLS 1.3 dia takiana amin'ny fifandraisana TLS rehetra amin'ny SMPP.
Ny fanohanana ny TLS 1.0 sy 1.1 dia natsahatra nanomboka tamin'ny 2020-11-15. Ny dikan-teny 1.0 sy 1.1 an'ny TLS dia protocole tranainy efa lany tamingana ary heverina ho loza mitatao amin'ny fiarahamonina Internet.
LINK dia manoro hevitra mafy ny hampiasa TLS raha misy fifandraisana SMPP tsy misy miafina ampiasaina ankehitriny. Ny fifandraisana SMPP tsy voasokajy dia lany tamin'ny 2020-09-01 nataon'i LINK, ary hesorina amin'ny ho avy. Mbola tsy voafaritra ny daty hanesorana ireo fifandraisana tsy voafehy.
Ny fifandraisana mankany amin'ny mpizara SMPP ho an'ny TLS dia ao amin'ny seranan-tsambo 3601 fa tsy ao amin'ny seranana 3600 tsy voafehy.
Mbola afaka mampiasa TLS ianao na dia tsy mahazaka TLS mampiasa stunnel aza ny fampiharana SMPP anao, jereo https://www.stunnel.org/
Kaody diso
Ireto kaody hadisoana manaraka ireto dia azo valiana ao amin'ny saha diso raha toa ka alefa ny saha.
| Kaody diso | Description |
| 0 | Error tsy fantatra |
| 1 | Fahadisoan-dàlana vonjimaika |
| 2 | Hadisoana lalana maharitra |
| 3 | Nihoatra ny fanetehana ambony indrindra |
| 4 | Fotoana dila |
| 5 | Error tsy fantatra ny mpandraharaha |
| 6 | Error operator |
| 100 | Tsy hita ny serivisy |
| 101 | Tsy hita ny mpampiasa |
| 102 | Kaonty tsy hita |
| 103 | Tenimiafina tsy mety |
| 104 | Error config |
| 105 | Fahadisoana anatiny |
| 106 | Quota exceeded |
| 200 | OK |
| 1000 | Nalefa |
| 1001 | Nafahana |
| 1002 | niala aina |
| 1003 | nofafana |
| 1004 | Feno finday |
| 1005 | nilahatra |
| 1006 | Tsy naterina |
| 1007 | Naterina, tara ny fiampangana |
| 1008 | Voaloa, tsy nalefa ny hafatra |
| 1009 | Voaloa, tsy voaray ny hafatra |
| 1010 | Lany daty, tsy fisian'ny tatitry ny fanaterana mpandraharaha |
| 1011 | Voaloa, nalefa ny hafatra (amin'ny mpandraharaha) |
| 1012 | Nilahatra lavitra |
| 1013 | Hafatra nalefa tany amin'ny mpandraharaha, nahemotra ny fiampangana |
| 2000 | Laharana loharano tsy mety |
| 2001 | Ny laharana fohy dia tsy tohanana ho loharano |
| 2002 | Alpha dia tsy tohanana ho loharano |
| 2003 | MSISDN dia tsy tohanana ho laharan'ny loharano |
| 2100 | Ny laharana fohy dia tsy tohana ho toerana haleha |
| 2101 | Alfa dia tsy tohanana ho toerana haleha |
| 2102 | MSISDN dia tsy tohanana ho toerana haleha |
| 2103 | Voasakana ny fandidiana |
| 2104 | Mpanoratra tsy fantatra |
| 2105 | Voasakana ny toerana haleha |
| 2106 | Error isa |
| 2107 | Voasakana vonjimaika ny toerana haleha |
| 2108 | Invalid destination |
| 2200 | Error chargeur |
| 2201 | Latsa-danja ny mpanjifa |
|
2202 |
Subscriber barred for overcharged (premium)
hafatra |
|
2203 |
Subscriber too young (for this particular
atiny) |
| 2204 | Tsy azo atao ny misoratra anarana mialoha |
| 2205 | Tolotra nolavin'ny mpanjifa |
| 2206 | Mpanoratra tsy voasoratra ao amin'ny rafitra fandoavam-bola |
| 2207 | Nahatratra ny fifandanjana ambony indrindra ny mpanjifa |
| 2208 | Ilaina ny fanamafisana ny mpampiasa farany |
| 2300 | nahaloa |
|
2301 |
Could not refund due to illegal or missing
MSISDN |
| 2302 | Tsy afaka naverina noho ny messageId tsy hita |
| 2303 | Nilahatra hamerenana |
| 2304 | Tapitra ny famerenam-potoana |
| 2305 | Famerenana tsy fahombiazana |
| 3000 | Tsy tohanana ny famandrihana GSM |
| 3001 | UCS2 encoding dia tsy tohanana |
| 3002 | Tsy tohana ny encoding binary |
| 4000 | Tsy tohana ny tatitra fanaterana |
| 4001 | Hafatra tsy mety |
| 4002 | Tarifa tsy mety |
| 4003 | Data mpampiasa tsy mety |
| 4004 | Lohatenin'ny angona mpampiasa tsy mety |
| 4005 | Kaody data tsy mety |
| 4006 | VAT tsy mety |
| 4007 | Votoaty tsy tohana ho an'ny toerana haleha |
Documents / Loharano
 |
link mobility SMS API,SMPP API MS Scheduler API [pdf] Torolàlana ho an'ny mpampiasa SMS API SMPP API MS Scheduler API, SMS API SMPP API, MS Scheduler API, Scheduler API, API |