SMS API, SMPP API MS Scheduler API
ការណែនាំអ្នកប្រើប្រាស់
SMS API, SMPP API MS Scheduler API
| កែប្រែ៖ | ១០/១០/២០២៣ |
| កំណែ៖ | 1.7 |
| អ្នកនិពន្ធ៖ | Kenny Colander Norden, KCN |
ឯកសារនេះគឺសម្រាប់អ្នកទទួលដែលបានកំណត់តែប៉ុណ្ណោះ ហើយអាចមានព័ត៌មានឯកជន កម្មសិទ្ធិ ឬបើមិនដូច្នេះទេ ។ ប្រសិនបើអ្នកបានទទួលវាដោយកំហុស សូមជូនដំណឹងដល់អ្នកផ្ញើភ្លាមៗ ហើយលុបដើម។ ការប្រើប្រាស់ឯកសារផ្សេងទៀតដោយអ្នកត្រូវបានហាមឃាត់។
ផ្លាស់ប្តូរប្រវត្តិ
| Rev | កាលបរិច្ឆេទ | By | ការផ្លាស់ប្តូរពីការចេញផ្សាយមុន។ |
| 1.0 | ៨៦៦-៤៤៧-២១៩៤ | ខេ.ស៊ី.អិន | បានបង្កើត |
| 1. | ៨៦៦-៤៤៧-២១៩៤ | TPE | បានធ្វើបច្ចុប្បន្នភាពឡូហ្គោ LINK |
| 1. | ៨៦៦-៤៤៧-២១៩៤ | PNI | បានបន្ថែមសេចក្តីយោងទៅការបញ្ជាក់ SMPP 3.4 |
| 1. | ៨៦៦-៤៤៧-២១៩៤ | EP | ការសង្កេតអំពីរយៈពេលសុពលភាព tag |
| 1. | ៨៦៦-៤៤៧-២១៩៤ | ខេ.ស៊ី.អិន | បានបន្ថែមព័ត៌មានទាក់ទងនឹងកំណែ TLS ដែលគាំទ្រ |
| 2. | ៨៦៦-៤៤៧-២១៩៤ | ខេ.ស៊ី.អិន | បានបន្ថែមព័ត៌មានបន្ថែមទាក់ទងនឹងរបាយការណ៍ដឹកជញ្ជូន បានធ្វើបច្ចុប្បន្នភាពព័ត៌មានទាក់ទងនឹង TLS 1.3 |
| 2. | ៨៦៦-៤៤៧-២១៩៤ | GM | បានបន្ថែមលេខកូដលទ្ធផល 2108 |
| 2. | ៨៦៦-៤៤៧-២១៩៤ | AK | បានបន្ថែមកូតា |
សេចក្តីផ្តើម
LINK Mobility គឺជាអ្នកចែកចាយសារ SMS តាំងពីឆ្នាំ 2001 ហើយមានបទពិសោធន៍ជាច្រើនក្នុងការធ្វើការជាមួយទាំងប្រតិបត្តិករ និងអ្នកប្រមូលផ្តុំការតភ្ជាប់។ វេទិកានេះត្រូវបានរចនាឡើងដើម្បីគ្រប់គ្រងបរិមាណចរាចរណ៍ធំ រក្សាភាពអាចរកបានខ្ពស់ និងធ្វើឱ្យវាងាយស្រួលក្នុងការបញ្ជូនចរាចរណ៍តាមរយៈការតភ្ជាប់ច្រើន។
នេះគឺជាឯកសារពិពណ៌នាអំពីចំណុចប្រទាក់ SMPP ទៅវេទិកា SMSC និងប៉ារ៉ាម៉ែត្រ និងពាក្យបញ្ជាណាមួយដែលត្រូវការ និងប៉ារ៉ាម៉ែត្រណាមួយត្រូវបានគាំទ្រ។
ឯកសារនេះនឹងមិនដោះស្រាយករណីប្រើប្រាស់ជាក់លាក់ដូចជាសារភ្ជាប់ WAPPush, Flash SMS ជាដើម។ ព័ត៌មានបន្ថែមអំពីករណីទាំងនោះអាចត្រូវបានផ្តល់ជូនដោយការទាក់ទងផ្នែកជំនួយ។
ពាក្យបញ្ជាដែលបានគាំទ្រ
ម៉ាស៊ីនមេរបស់ LINK Mobility គួរតែត្រូវបានចាត់ទុកជា SMPP 3.4។ ការបញ្ជាក់ជាផ្លូវការអាចរកបាននៅ https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
វិធីសាស្រ្តទាំងអស់មិនត្រូវបានគាំទ្រទេ ហើយភាពខុសគ្នាទាំងអស់ត្រូវបានបញ្ជាក់ខាងក្រោម។
4.1 ចង
ពាក្យបញ្ជាចងខាងក្រោមត្រូវបានគាំទ្រ។
- ឧបករណ៍បញ្ជូន
- ឆ្លងកាត់
- អ្នកទទួល
ប៉ារ៉ាម៉ែត្រដែលត្រូវការ៖
- system_id - ទទួលបានពីការគាំទ្រ
- ពាក្យសម្ងាត់ - ទទួលបានពីការគាំទ្រ
ប៉ារ៉ាម៉ែត្រស្រេចចិត្ត៖
- addr_ton – តម្លៃលំនាំដើមប្រសិនបើ TON ត្រូវបានកំណត់ទៅជា Unknown កំឡុងពេលបញ្ជូន។
- addr_npi – តម្លៃលំនាំដើមប្រសិនបើ NPI ត្រូវបានកំណត់ទៅជា Unknown កំឡុងពេលបញ្ជូន។
ប៉ារ៉ាម៉ែត្រមិនគាំទ្រ៖
- ជួរអាសយដ្ឋាន
4.2 ស្រាយចំណង
ពាក្យបញ្ជា unbind ត្រូវបានគាំទ្រ។
4.3 តំណភ្ជាប់សួរ
ពាក្យបញ្ជាតំណសួរត្រូវបានគាំទ្រ ហើយគួរតែត្រូវបានហៅរៀងរាល់ 60 វិនាទី។
4.4 ដាក់ស្នើ
វិធីសាស្ត្របញ្ជូនគួរតែត្រូវបានប្រើសម្រាប់ការបញ្ជូនសារ។
ប៉ារ៉ាម៉ែត្រដែលត្រូវការ៖
- ប្រភព_addr_ton
- ប្រភព_addr_npi
- ប្រភព_addr
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_class
- data_coding
- sm_ប្រវែង
- សារខ្លី
ប៉ារ៉ាម៉ែត្រមិនគាំទ្រ៖
- ប្រភេទសេវាកម្ម
- protocol_id
- អាទិភាព_ទង់
- schedule_delivery_time
- ជំនួស_if_present_flag
- sm_default_msg_id
ចំណាំ ថាបន្ទុក tag មិនត្រូវបានគាំទ្រទេ ហើយមានតែសារ SMS មួយប៉ុណ្ណោះអាចនឹងត្រូវបានផ្ញើក្នុងមួយការហៅទូរសព្ទ ហើយវាត្រូវបានផ្ដល់អនុសាសន៍ថា validity_period tag មានតម្លៃយ៉ាងហោចណាស់ 15 នាទី។
4.4.1 បានណែនាំ TON និង NPI
TON និង NPI ខាងក្រោមគួរតែត្រូវបានប្រើនៅពេលផ្ញើសារដោយប្រើពាក្យបញ្ជាបញ្ជូន។
4.4.1.1 ប្រភព
បន្សំ TON និង NPI ខាងក្រោមត្រូវបានគាំទ្រសម្រាប់អាសយដ្ឋានប្រភព។ បន្សំផ្សេងទៀតទាំងអស់នឹងត្រូវបានចាត់ទុកថាមិនត្រឹមត្រូវ។ TON លំនាំដើមពីពាក្យបញ្ជាចងនឹងត្រូវបានប្រើប្រសិនបើ TON ត្រូវបានកំណត់ទៅជាមិនស្គាល់ (0) ។ NPI លំនាំដើមពីពាក្យបញ្ជាចងនឹងត្រូវបានប្រើប្រសិនបើ NPI ត្រូវបានកំណត់ទៅជាមិនស្គាល់ (0) ។
| តោន | NPI | ការពិពណ៌នា |
| អក្សរក្រមលេខ (5) | មិនស្គាល់ (0) ISDN (1) |
នឹងត្រូវបានចាត់ទុកជាអក្សរអ្នកផ្ញើជាអក្សរក្រមលេខ |
| អន្តរជាតិ (1) | មិនស្គាល់ (0) ISDN (1) |
នឹងត្រូវបានចាត់ទុកជា MSISDN |
| ជាតិ (2) បណ្តាញជាក់លាក់ (3) លេខអតិថិជន (4) អក្សរកាត់ (6) |
មិនស្គាល់ (0) ISDN (1) ជាតិ (8) |
នឹងត្រូវបានចាត់ទុកជាលេខខ្លីជាក់លាក់របស់ប្រទេស។ |
4.4.1.2 ទិសដៅ
បន្សំ TON និង NPI ខាងក្រោមត្រូវបានគាំទ្រសម្រាប់អាសយដ្ឋានគោលដៅ។ បន្សំផ្សេងទៀតទាំងអស់នឹងត្រូវបានចាត់ទុកថាមិនត្រឹមត្រូវ។ TON លំនាំដើមពីពាក្យបញ្ជាចងនឹងត្រូវបានប្រើប្រសិនបើ TON ត្រូវបានកំណត់ទៅជាមិនស្គាល់ (0) ។ NPI លំនាំដើមពីពាក្យបញ្ជាចងនឹងត្រូវបានប្រើប្រសិនបើ NPI ត្រូវបានកំណត់ទៅជាមិនស្គាល់ (0) ។
| តោន | NPI | ការពិពណ៌នា |
| អន្តរជាតិ (1) | មិនស្គាល់ (0) ISDN (1) |
នឹងត្រូវបានចាត់ទុកជា MSISDN |
4.4.2 ការអ៊ិនកូដដែលគាំទ្រ
ការអ៊ិនកូដខាងក្រោមត្រូវបានគាំទ្រ។ X អាចមានតម្លៃណាមួយ។
| DCS | ការអ៊ិនកូដ |
| 0xX0 | អក្ខរក្រម GSM លំនាំដើមជាមួយផ្នែកបន្ថែម |
| 0xX2 | គោលពីរ 8 ប៊ីត |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
កូតា
5.1 លើសកូតាview
កូតាកំណត់ចំនួនអតិបរមានៃសារ SMS ដែលអាចត្រូវបានផ្ញើក្នុងចន្លោះពេលជាក់លាក់មួយ (ដូចជាក្នុងមួយថ្ងៃ សប្តាហ៍ ខែ ឬមិនកំណត់)។ កូតានីមួយៗត្រូវបានកំណត់អត្តសញ្ញាណដោយ quotaId (UUID) ហើយត្រូវបានកំណត់ឡើងវិញតាមតំបន់ពេលវេលារបស់អតិថិជន។ កូតាអាចត្រូវបានកំណត់នៅក្នុងប្រទេស តំបន់ ឬកម្រិតលំនាំដើមតាមរយៈ Quota Profile. កូតាក៏អាចត្រូវបានកំណត់ថាមវន្តដោយប្រើ Quota Mapping ផងដែរ។ វាគូសផែនទី QuotaId មាតាបិតា (UUID) និងកូដកូតាតែមួយគត់ (ឧ. អ្នកផ្ញើ ឬអ្នកប្រើប្រាស់) ទៅកាន់ quotaId ជាក់លាក់មួយ។
កូតាត្រូវបានកំណត់ស្របតាមការគាំទ្រក្នុងតំបន់របស់អ្នក អ្នកគ្រប់គ្រងគណនីដែលបានចាត់តាំងរបស់អ្នក ឬតាមលំនាំដើម ប្រសិនបើគ្មានអ្វីត្រូវបានបញ្ជាក់។
5.2 ស្ថានភាព 106 – លើសកូតា
សារ SMS អាចត្រូវបានរារាំងដោយលេខកូដស្ថានភាព 106 (“លើសកូតា”) នៅពេល៖
- សារលើសពីដែនកំណត់ដែលបានកំណត់សម្រាប់ quotaId ដែលត្រូវគ្នារបស់វាក្នុងចន្លោះពេលបច្ចុប្បន្ន។
- ប្រទេស ឬតំបន់គោលដៅមិនមានកូតាដែលបានកំណត់ទេ (ឧ. ត្រូវបានទប់ស្កាត់យ៉ាងច្បាស់ជាមួយនឹងការគូសផែនទីកូតាទុកជាមោឃៈនៅក្នុងប្រូfile).
- មិនមានកូតាដែលត្រូវគ្នាទេ ហើយក៏គ្មានកូតាលំនាំដើមត្រូវបានកំណត់ដែរ ដែលនាំឱ្យមានការបដិសេធ។
នៅក្នុងករណីទាំងនេះ ប្រព័ន្ធការពារការដំណើរការសារបន្ថែមទៀត ដើម្បីអនុវត្តដែនកំណត់ផ្អែកលើអតិថិជន ឬគោលដៅ និងជៀសវាងការប្រើប្រាស់ខុស។
របាយការណ៍ដឹកជញ្ជូន
មានតែការចែកចាយណាមួយ ឬចុងក្រោយជាមួយនឹងលទ្ធផលជោគជ័យ/បរាជ័យប៉ុណ្ណោះដែលត្រូវបានគាំទ្រ។
ទម្រង់បែបបទនៅលើរបាយការណ៍ចែកចាយ៖ លេខសម្គាល់៖ xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx កាលបរិច្ឆេទរួចរាល់៖ yyMMddHHmm stat:
តម្លៃដែលមាននៅក្នុងស្ថានភាព៖
- បញ្ជូន
- ផុតកំណត់
- បដិសេធ
- UNDELIV
- បានលុប
6.1 ទម្រង់របាយការណ៍ចែកចាយបន្ថែម
ព័ត៌មានបន្ថែមនៅក្នុងរបាយការណ៍ចែកចាយអាចត្រូវបានស្នើសុំដោយទាក់ទងជាមួយតំណាងផ្នែកលក់របស់អ្នក។
ទម្រង់នៅលើរបាយការណ៍ចែកចាយ៖ លេខសម្គាល់៖ xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub: 000 dlvrd: 000 កាលបរិច្ឆេទដាក់ស្នើ៖
yyMMddHHmm កាលបរិច្ឆេទធ្វើរួច៖ ស្ថានភាព yyMMddHHmm៖ កំហុស៖ អត្ថបទ៖
តម្លៃដែលមាននៅក្នុងស្ថានភាព៖
- បញ្ជូន
- ផុតកំណត់
- បដិសេធ
- 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 | លើសកូតា |
| 200 | OK |
| 1000 | បានផ្ញើ |
| 1001 | ចែកចាយ |
| 1002 | ផុតកំណត់ |
| 1003 | បានលុប |
| 1004 | ចល័តពេញ |
| 1005 | បានតម្រង់ជួរ |
| 1006 | មិនបានបញ្ជូន |
| 1007 | ដឹកជញ្ជូន គិតថ្លៃពន្យារពេល |
| 1008 | គិតថ្លៃ សារមិនត្រូវបានផ្ញើទេ។ |
| 1009 | គិតថ្លៃ សារមិនត្រូវបានបញ្ជូនទេ។ |
| 1010 | ផុតកំណត់ អវត្តមាននៃរបាយការណ៍ដឹកជញ្ជូនរបស់ប្រតិបត្តិករ |
| 1011 | គិតថ្លៃ សារបានផ្ញើ (ទៅប្រតិបត្តិករ) |
| 1012 | តម្រង់ជួរពីចម្ងាយ |
| 1013 | សារបានផ្ញើទៅប្រតិបត្តិករ ការសាកថ្មបានពន្យារពេល |
| 2000 | លេខប្រភពមិនត្រឹមត្រូវ |
| 2001 | លេខខ្លីមិនត្រូវបានគាំទ្រជាប្រភពទេ។ |
| 2002 | អាល់ហ្វាមិនត្រូវបានគាំទ្រជាប្រភពទេ។ |
| 2003 | MSISDN មិនត្រូវបានគាំទ្រជាលេខប្រភពទេ។ |
| 2100 | លេខខ្លីមិនត្រូវបានគាំទ្រជាគោលដៅទេ។ |
| 2101 | អាល់ហ្វាមិនត្រូវបានគាំទ្រជាទិសដៅទេ។ |
| 2102 | MSISDN មិនត្រូវបានគាំទ្រជាគោលដៅទេ។ |
| 2103 | ប្រតិបត្តិការត្រូវបានរារាំង |
| 2104 | អ្នកជាវមិនស្គាល់ |
| 2105 | គោលដៅត្រូវបានរារាំង |
| 2106 | កំហុសលេខ |
| 2107 | គោលដៅត្រូវបានរារាំងជាបណ្តោះអាសន្ន |
| 2108 | ទិសដៅមិនត្រឹមត្រូវ |
| 2200 | កំហុសក្នុងការសាកថ្ម |
| 2201 | អ្នកជាវមានសមតុល្យទាប |
|
2202 |
អតិថិជនត្រូវបានហាមឃាត់សម្រាប់ការគិតថ្លៃលើស (បុព្វលាភ)
សារ |
|
2203 |
អតិថិជននៅក្មេងពេក (សម្រាប់ពិសេសនេះ។
ខ្លឹមសារ) |
| 2204 | អតិថិជនបង់ប្រាក់ជាមុនមិនត្រូវបានអនុញ្ញាតទេ។ |
| 2205 | សេវាកម្មត្រូវបានបដិសេធដោយអតិថិជន |
| 2206 | អតិថិជនមិនបានចុះឈ្មោះក្នុងប្រព័ន្ធទូទាត់ទេ។ |
| 2207 | អ្នកជាវបានឈានដល់សមតុល្យអតិបរមា |
| 2208 | ត្រូវការការបញ្ជាក់អ្នកប្រើប្រាស់ចុងក្រោយ |
| 2300 | សងប្រាក់វិញ។ |
|
2301 |
មិនអាចសងប្រាក់វិញបានដោយសារតែខុសច្បាប់ ឬបាត់
MSISDN |
| 2302 | មិនអាចសងប្រាក់វិញបានទេដោយសារបាត់ messageId |
| 2303 | បានតម្រង់ជួរសម្រាប់ការសងប្រាក់វិញ។ |
| 2304 | អស់ពេលសងប្រាក់វិញ។ |
| 2305 | បរាជ័យក្នុងការសងប្រាក់វិញ។ |
| 3000 | ការអ៊ិនកូដ GSM មិនត្រូវបានគាំទ្រទេ។ |
| 3001 | ការអ៊ិនកូដ UCS2 មិនត្រូវបានគាំទ្រទេ។ |
| 3002 | ការអ៊ិនកូដគោលពីរមិនត្រូវបានគាំទ្រទេ។ |
| 4000 | របាយការណ៍ដឹកជញ្ជូនមិនត្រូវបានគាំទ្រទេ។ |
| 4001 | ខ្លឹមសារសារមិនត្រឹមត្រូវ |
| 4002 | ពន្ធមិនត្រឹមត្រូវ។ |
| 4003 | ទិន្នន័យអ្នកប្រើប្រាស់មិនត្រឹមត្រូវ |
| 4004 | បឋមកថាទិន្នន័យអ្នកប្រើប្រាស់មិនត្រឹមត្រូវ |
| 4005 | ការសរសេរកូដទិន្នន័យមិនត្រឹមត្រូវ |
| 4006 | អាករលើតម្លៃបន្ថែមមិនត្រឹមត្រូវ |
| 4007 | មាតិកាដែលមិនគាំទ្រសម្រាប់គោលដៅ |
ឯកសារ/ធនធាន
 |
តំណភ្ជាប់ការចល័ត 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 |