SMS API,SMPP API MS Scheduler API
ຄູ່ມືຜູ້ໃຊ້
SMS API,SMPP API MS Scheduler API
| ແກ້ໄຂ: | 6/24/2025 |
| ລຸ້ນ: | 1.7 |
| ຜູ້ຂຽນ: | Kenny Colander Norden, KCN |
ເອກະສານນີ້ແມ່ນສໍາລັບຜູ້ຮັບທີ່ກໍານົດເທົ່ານັ້ນແລະອາດຈະມີຂໍ້ມູນສິດທິພິເສດ, ເປັນເຈົ້າຂອງ, ຫຼືຂໍ້ມູນສ່ວນຕົວອື່ນໆ. ຖ້າຫາກທ່ານໄດ້ຮັບມັນຄວາມຜິດພາດ, ກະລຸນາແຈ້ງໃຫ້ຜູ້ສົ່ງທັນທີແລະລຶບຕົ້ນສະບັບ. ການໃຊ້ເອກະສານອື່ນໆໂດຍທ່ານຖືກຫ້າມ.
ປະຫວັດການປ່ຽນແປງ
| ພ.ສ | ວັນທີ | By | ການປ່ຽນແປງຈາກການປ່ອຍກ່ອນຫນ້າ |
| 1.0 | 2010-03-16 | KCN | ສ້າງແລ້ວ |
| 1. | 2019-06-11 | TPE | ອັບເດດໂລໂກ້ LINK ແລ້ວ |
| 1. | 2019-09-27 | PNI | ເພີ່ມການອ້າງອີງເຖິງ SMPP 3.4 ສະເພາະ |
| 1. | 2019-10-31 | EP | ການສັງເກດການກ່ຽວກັບໄລຍະເວລາທີ່ຖືກຕ້ອງ tag |
| 1. | 2020-08-28 | KCN | ເພີ່ມຂໍ້ມູນກ່ຽວກັບລຸ້ນ 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 |
ແນະນຳ
LINK Mobility ເປັນຜູ້ຈັດຈໍາຫນ່າຍ SMS ຕັ້ງແຕ່ປີ 2001 ແລະມີປະສົບການຫຼາຍໃນການເຮັດວຽກກັບຜູ້ປະຕິບັດການແລະຜູ້ລວບລວມການເຊື່ອມຕໍ່. ແພລະຕະຟອມນີ້ຖືກອອກແບບມາເພື່ອຈັດການກັບປະລິມານການຈາລະຈອນຂະຫນາດໃຫຍ່, ຮັກສາຄວາມພ້ອມສູງແລະເຮັດໃຫ້ມັນງ່າຍຕໍ່ການນໍາທາງຜ່ານການເຊື່ອມຕໍ່ຫຼາຍ.
ນີ້ແມ່ນເອກະສານອະທິບາຍການໂຕ້ຕອບ SMPP ກັບ SMSC-platform ແລະທີ່ພາລາມິເຕີແລະຄໍາສັ່ງທີ່ຈໍາເປັນແລະຕົວກໍານົດການທີ່ໄດ້ຮັບການຮອງຮັບ.
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.
ຄໍາສັ່ງທີ່ສະຫນັບສະຫນູນ
ເຊີບເວີຂອງ LINK Mobility ຄວນຖືກປະຕິບັດເປັນ SMPP 3.4. ຂໍ້ມູນຈໍາເພາະທີ່ເປັນທາງການສາມາດພົບໄດ້ທີ່ https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
ວິທີການທັງຫມົດບໍ່ໄດ້ຮັບການສະຫນັບສະຫນູນ, ແລະຄວາມແຕກຕ່າງທັງຫມົດແມ່ນໄດ້ລະບຸໄວ້ຂ້າງລຸ່ມນີ້.
4.1 ຜູກມັດ
ຄໍາສັ່ງຜູກມັດຕໍ່ໄປນີ້ໄດ້ຮັບການສະຫນັບສະຫນູນ.
- ເຄື່ອງສົ່ງສັນຍານ
- Transciever
- ຜູ້ຮັບ
ຕົວກໍານົດການທີ່ຈໍາເປັນ:
- system_id – ໄດ້ມາຈາກການສະຫນັບສະຫນູນ
- ລະຫັດຜ່ານ – ໄດ້ມາຈາກການສະຫນັບສະຫນູນ
ຕົວກໍານົດການທາງເລືອກ:
- addr_ton – ຄ່າເລີ່ມຕົ້ນຖ້າ TON ຖືກຕັ້ງເປັນ Unknown ໃນລະຫວ່າງການສົ່ງ.
- addr_npi – ຄ່າເລີ່ມຕົ້ນຖ້າ NPI ຖືກຕັ້ງເປັນ Unknown ໃນລະຫວ່າງການສົ່ງ.
ຕົວກໍານົດການທີ່ບໍ່ຮອງຮັບ:
- ຊ່ວງທີ່ຢູ່
4.2 ຍົກເລີກການຜູກມັດ
ຄໍາສັ່ງ unbind ແມ່ນສະຫນັບສະຫນູນ.
4.3 ການເຊື່ອມຕໍ່ສອບຖາມ
ຄໍາສັ່ງການເຊື່ອມຕໍ່ສອບຖາມແມ່ນສະຫນັບສະຫນູນແລະຄວນຈະໄດ້ຮັບການເອີ້ນທຸກ 60 ວິນາທີ.
4.4 ສົ່ງ
ວິທີການສົ່ງຄວນຈະຖືກນໍາໃຊ້ສໍາລັບການສົ່ງຂໍ້ຄວາມ.
ຕົວກໍານົດການທີ່ຈໍາເປັນ:
- source_addr_ton
- source_addr_npi
- source_addr
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_class
- data_coding
- sm_length
- ຂໍ້ຄວາມສັ້ນ
ຕົວກໍານົດການທີ່ບໍ່ຮອງຮັບ:
- ປະເພດການບໍລິການ
- protocol_id
- priority_flag
- schedule_delivery_time
- ແທນທີ່_if_present_flag
- sm_default_msg_id
ໝາຍເຫດ ວ່າ payload ໄດ້ tag ບໍ່ຮອງຮັບ ແລະສາມາດສົ່ງ SMS ໜ່ວຍດຽວຕໍ່ການໂທ ແລະແນະນຳໃຫ້ໃຊ້ validity_period tag ມີມູນຄ່າ 15 ນາທີຢ່າງຫນ້ອຍ.
4.4.1 ແນະນໍາ TON ແລະ NPI
TON ແລະ NPI ຕໍ່ໄປນີ້ຄວນຖືກນໍາໃຊ້ໃນເວລາສົ່ງຂໍ້ຄວາມໂດຍໃຊ້ຄໍາສັ່ງສົ່ງ.
4.4.1.1 ແຫຼ່ງຂໍ້ມູນ
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).
| ໂຕນ | NPI | ລາຍລະອຽດ |
| ຕົວເລກອັກຂະລະ (5) | ບໍ່ຮູ້ຈັກ (0) ISDN (1) |
ຈະຖືກປະຕິບັດເປັນຂໍ້ຄວາມຂອງຜູ້ສົ່ງທີ່ເປັນຕົວເລກແລະຕົວເລກ |
| ສາກົນ (1) | ບໍ່ຮູ້ຈັກ (0) ISDN (1) |
ຈະຖືກປະຕິບັດເປັນ MSISDN |
| ແຫ່ງຊາດ (2) Network specific (3) Subscriber number (4) Abbreviated (6) |
ບໍ່ຮູ້ຈັກ (0) ISDN (1) ແຫ່ງຊາດ (8) |
ຈະຖືກປະຕິບັດເປັນຕົວເລກສັ້ນສະເພາະຂອງປະເທດ. |
4.4.1.2 ຈຸດໝາຍປາຍທາງ
ການປະສົມ TON ແລະ NPI ຕໍ່ໄປນີ້ໄດ້ຮັບການສະຫນັບສະຫນູນສໍາລັບທີ່ຢູ່ປາຍທາງ. ການປະສົມອື່ນໆທັງໝົດຈະຖືກຖືວ່າບໍ່ຖືກຕ້ອງ. ຄ່າເລີ່ມຕົ້ນ TON ຈາກຄໍາສັ່ງ bind ຈະຖືກນໍາໃຊ້ຖ້າ TON ຖືກຕັ້ງເປັນ Unknown (0). NPI ເລີ່ມຕົ້ນຈາກຄໍາສັ່ງ bind ຈະຖືກນໍາໃຊ້ຖ້າ NPI ຖືກຕັ້ງເປັນ Unknown (0).
| ໂຕນ | NPI | ລາຍລະອຽດ |
| ສາກົນ (1) | ບໍ່ຮູ້ຈັກ (0) ISDN (1) |
ຈະຖືກປະຕິບັດເປັນ MSISDN |
4.4.2 ການເຂົ້າລະຫັດທີ່ຮອງຮັບ
ຮອງຮັບການເຂົ້າລະຫັດຕໍ່ໄປນີ້. X ອາດມີຄ່າໃດໆກໍຕາມ.
| DCS | ການເຂົ້າລະຫັດ |
| 0xX0 | ຕົວອັກສອນ GSM ເລີ່ມຕົ້ນທີ່ມີການຂະຫຍາຍ |
| 0xX2 | 8-bit ໄບນາຣີ |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
ໂຄຕ້າ
5.1 ເກີນໂຄຕ້າview
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.
ໂຄຕ້າຖືກກໍານົດໃຫ້ສອດຄ່ອງກັບການຊ່ວຍເຫຼືອທ້ອງຖິ່ນຂອງທ່ານ, ຜູ້ຈັດການບັນຊີທີ່ໄດ້ຮັບມອບຫມາຍຂອງທ່ານຫຼືໂດຍຄ່າເລີ່ມຕົ້ນຖ້າບໍ່ມີຫຍັງຖືກກໍານົດ.
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.
ໃນກໍລະນີເຫຼົ່ານີ້, ລະບົບປ້ອງກັນການປະມວນຜົນຂໍ້ຄວາມເພີ່ມເຕີມເພື່ອບັງຄັບໃຫ້ລູກຄ້າຫຼືຈຸດຫມາຍປາຍທາງກໍານົດຂອບເຂດຈໍາກັດແລະຫຼີກເວັ້ນການນໍາໃຊ້ໃນທາງທີ່ຜິດ.
ບົດລາຍງານການຈັດສົ່ງ
ພຽງແຕ່ບໍ່ມີການຈັດສົ່ງຫຼືສຸດທ້າຍທີ່ມີຜົນໄດ້ຮັບສົບຜົນສໍາເລັດ / ລົ້ມເຫລວແມ່ນສະຫນັບສະຫນູນ.
ຮູບແບບໃນບົດລາຍງານການຈັດສົ່ງ: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx ວັນທີສໍາເລັດ: yyMMddHHmm stat:
ຄ່າທີ່ມີຢູ່ໃນສະຖານະ:
- ຈັດສົ່ງ
- ໝົດອາຍຸແລ້ວ
- ປະຕິເສດ
- UNDELIV
- ລຶບແລ້ວ
6.1 ຮູບແບບບົດລາຍງານການຈັດສົ່ງແບບຂະຫຍາຍ
ຂໍ້ມູນເພີ່ມເຕີມໃນບົດລາຍງານການຈັດສົ່ງອາດຈະໄດ້ຮັບການຮ້ອງຂໍໃນການຕິດຕໍ່ກັບຕົວແທນການຂາຍຂອງທ່ານ.
Format on delivery report: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 submit date:
yyMMddHHmm done date: yyMMddHHmm stat: <status> err: <error code> text:
ຄ່າທີ່ມີຢູ່ໃນສະຖານະ:
- ຈັດສົ່ງ
- ໝົດອາຍຸແລ້ວ
- ປະຕິເສດ
- UNDELIV
- ລຶບແລ້ວ
ຊ່ອງຂໍ້ມູນ "sub" ແລະ "dlvrd" ຈະຖືກຕັ້ງເປັນ 000 ສະເໝີ, ແລະຊ່ອງຂໍ້ມູນ "ຂໍ້ຄວາມ" ຈະຫວ່າງເປົ່າສະເໝີ.
ເບິ່ງລະຫັດຂໍ້ຜິດພາດຂອງບົດສໍາລັບຄ່າສໍາລັບພາກສະຫນາມ "err".
ລຸ້ນ TLS ທີ່ຮອງຮັບ
TLS 1.2 ຫຼື TLS 1.3 ແມ່ນຕ້ອງການສໍາລັບການເຊື່ອມຕໍ່ TLS ທັງໝົດຜ່ານ SMPP.
ການຮອງຮັບ TLS 1.0 ແລະ 1.1 ແມ່ນຢຸດເຊົາຕັ້ງແຕ່ 2020-11-15. ເວີຊັນ 1.0 ແລະ 1.1 ຂອງ TLS ແມ່ນໂປຣໂຕຄໍເກົ່າກວ່າທີ່ໄດ້ຖືກຍົກເລີກ ແລະຖືວ່າເປັນຄວາມສ່ຽງດ້ານຄວາມປອດໄພໃນຊຸມຊົນອິນເຕີເນັດ.
LINK ແນະນໍາໃຫ້ໃຊ້ TLS ຖ້າການເຊື່ອມຕໍ່ SMPP ທີ່ບໍ່ໄດ້ເຂົ້າລະຫັດຖືກໃຊ້ໃນມື້ນີ້. ການເຊື່ອມຕໍ່ SMPP ທີ່ບໍ່ໄດ້ເຂົ້າລະຫັດຖືກຍົກເລີກຕັ້ງແຕ່ວັນທີ 2020-09-01 ໂດຍ LINK, ແລະຈະຖືກລຶບອອກໃນອະນາຄົດ. ວັນທີສໍາລັບການຖອນການເຊື່ອມຕໍ່ທີ່ບໍ່ໄດ້ເຂົ້າລະຫັດແມ່ນຍັງບໍ່ທັນໄດ້ຕັດສິນໃຈ.
ການເຊື່ອມຕໍ່ໄປຫາເຊີບເວີ SMPP ສໍາລັບ TLS ຢູ່ທີ່ພອດ 3601 ແທນທີ່ຈະບໍ່ໄດ້ເຂົ້າລະຫັດຢູ່ທີ່ພອດ 3600.
ທ່ານອາດຈະຍັງໃຊ້ TLS ເຖິງແມ່ນວ່າການປະຕິບັດ SMPP ຂອງທ່ານບໍ່ສະຫນັບສະຫນູນ TLS ໂດຍໃຊ້ stunnel, ເບິ່ງ https://www.stunnel.org/
ລະຫັດຂໍ້ຜິດພາດ
ລະຫັດຂໍ້ຜິດພາດຕໍ່ໄປນີ້ອາດຈະຖືກຕອບກັບໃນຊ່ອງຂໍ້ມູນຂໍ້ຜິດພາດຖ້າຊ່ອງຂໍ້ມູນຖືກເປີດໃຊ້.
| ລະຫັດຂໍ້ຜິດພາດ | ລາຍລະອຽດ |
| 0 | ຄວາມຜິດພາດທີ່ບໍ່ຮູ້ຈັກ |
| 1 | ຄວາມຜິດພາດການກຳນົດເສັ້ນທາງຊົ່ວຄາວ |
| 2 | ຄວາມຜິດພາດການກໍານົດເສັ້ນທາງຖາວອນ |
| 3 | ເກີນການປິດກັ້ນສູງສຸດ |
| 4 | ໝົດເວລາ |
| 5 | ຄວາມຜິດພາດທີ່ບໍ່ຮູ້ຈັກຜູ້ປະຕິບັດງານ |
| 6 | ຜູ້ປະຕິບັດງານຜິດພາດ |
| 100 | ບໍ່ພົບການບໍລິການ |
| 101 | ບໍ່ພົບຜູ້ໃຊ້ |
| 102 | ບໍ່ພົບບັນຊີ |
| 103 | ລະຫັດຜ່ານບໍ່ຖືກຕ້ອງ |
| 104 | ການຕັ້ງຄ່າຜິດພາດ |
| 105 | ຄວາມຜິດພາດພາຍໃນ |
| 106 | Quota exceeded |
| 200 | OK |
| 1000 | ສົ່ງແລ້ວ |
| 1001 | ຈັດສົ່ງແລ້ວ |
| 1002 | ໝົດອາຍຸແລ້ວ |
| 1003 | ລຶບແລ້ວ |
| 1004 | ມືຖືເຕັມ |
| 1005 | ຄິວ |
| 1006 | ບໍ່ໄດ້ຈັດສົ່ງ |
| 1007 | ຈັດສົ່ງແລ້ວ, ຄ່າບໍລິການຊັກຊ້າ |
| 1008 | ຖືກຄິດຄ່າ, ຂໍ້ຄວາມບໍ່ໄດ້ຖືກສົ່ງໄປ |
| 1009 | ຮຽກເກັບເງິນແລ້ວ, ຂໍ້ຄວາມບໍ່ຖືກຈັດສົ່ງ |
| 1010 | ໝົດອາຍຸ, ບໍ່ມີລາຍງານການຈັດສົ່ງຜູ້ປະກອບການ |
| 1011 | ຖືກຄິດຄ່າ, ສົ່ງຂໍ້ຄວາມ (ໄປຫາຜູ້ປະກອບການ) |
| 1012 | ຄິວໄລຍະໄກ |
| 1013 | ຂໍ້ຄວາມຖືກສົ່ງໄປຫາຜູ້ປະກອບການ, ການສາກໄຟຊັກຊ້າ |
| 2000 | ໝາຍເລກແຫຼ່ງບໍ່ຖືກຕ້ອງ |
| 2001 | ບໍ່ຮອງຮັບຕົວເລກສັ້ນເປັນແຫຼ່ງ |
| 2002 | ບໍ່ຮອງຮັບ Alpha ເປັນແຫຼ່ງທີ່ມາ |
| 2003 | MSISDN ບໍ່ຮອງຮັບເປັນໝາຍເລກແຫຼ່ງ |
| 2100 | ບໍ່ຮອງຮັບຕົວເລກສັ້ນເປັນປາຍທາງ |
| 2101 | ບໍ່ຮອງຮັບ Alpha ເປັນປາຍທາງ |
| 2102 | ບໍ່ຮອງຮັບ MSISDN ເປັນປາຍທາງ |
| 2103 | ການເຮັດວຽກຖືກບລັອກ |
| 2104 | ຜູ້ສະໝັກໃຊ້ທີ່ບໍ່ຮູ້ຈັກ |
| 2105 | ປາຍທາງຖືກບລັອກ |
| 2106 | ຕົວເລກຜິດພາດ |
| 2107 | ປາຍທາງຖືກບລັອກຊົ່ວຄາວ |
| 2108 | Invalid destination |
| 2200 | ການສາກໄຟຜິດພາດ |
| 2201 | ຜູ້ຈອງມີຍອດເງິນຕໍ່າ |
|
2202 |
Subscriber barred for overcharged (premium)
ຂໍ້ຄວາມ |
|
2203 |
Subscriber too young (for this particular
ເນື້ອຫາ) |
| 2204 | ບໍ່ອະນຸຍາດໃຫ້ສະໝັກສະມາຊິກແບບຈ່າຍເງິນລ່ວງໜ້າ |
| 2205 | ບໍລິການຖືກປະຕິເສດໂດຍຜູ້ຈອງ |
| 2206 | ຜູ້ຈອງບໍ່ໄດ້ລົງທະບຽນໃນລະບົບການຈ່າຍເງິນ |
| 2207 | ຜູ້ສະໝັກໃຊ້ຮອດຍອດເງິນສູງສຸດແລ້ວ |
| 2208 | ຕ້ອງການຢືນຢັນຜູ້ໃຊ້ສຸດທ້າຍ |
| 2300 | ສົ່ງເງິນຄືນແລ້ວ |
|
2301 |
Could not refund due to illegal or missing
MSISDN |
| 2302 | ບໍ່ສາມາດຄືນເງິນໄດ້ເນື່ອງຈາກບໍ່ມີ messageId |
| 2303 | ລໍຖ້າການຄືນເງິນ |
| 2304 | ໝົດເວລາຄືນເງິນ |
| 2305 | ການຄືນເງິນລົ້ມເຫລວ |
| 3000 | ບໍ່ຮອງຮັບການເຂົ້າລະຫັດ GSM |
| 3001 | ບໍ່ຮອງຮັບການເຂົ້າລະຫັດ UCS2 |
| 3002 | ບໍ່ຮອງຮັບການເຂົ້າລະຫັດຖານສອງ |
| 4000 | ບໍ່ຮອງຮັບລາຍງານການຈັດສົ່ງ |
| 4001 | ເນື້ອໃນຂໍ້ຄວາມບໍ່ຖືກຕ້ອງ |
| 4002 | ອັດຕາພາສີບໍ່ຖືກຕ້ອງ |
| 4003 | ຂໍ້ມູນຜູ້ໃຊ້ບໍ່ຖືກຕ້ອງ |
| 4004 | ສ່ວນຫົວຂໍ້ມູນຜູ້ໃຊ້ບໍ່ຖືກຕ້ອງ |
| 4005 | ລະຫັດຂໍ້ມູນບໍ່ຖືກຕ້ອງ |
| 4006 | VAT ບໍ່ຖືກຕ້ອງ |
| 4007 | ເນື້ອຫາທີ່ບໍ່ຮອງຮັບສໍາລັບປາຍທາງ |
ເອກະສານ / ຊັບພະຍາກອນ
 |
link mobility SMS API,SMPP API MS Scheduler API [pdf] ຄູ່ມືຜູ້ໃຊ້ SMS API SMPP API MS Scheduler API, SMS API SMPP API, MS Scheduler API, Scheduler API, API |