SMS API, SMPP API MS Scheduler API
მომხმარებლის სახელმძღვანელო
SMS API, SMPP API MS Scheduler API
| შეცვლილია: | 6/24/2025 |
| ვერსია: | 1.7 |
| ავტორი: | კენი კოლანდერ ნორდენი, 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 | დამატებულია დამატებითი ინფორმაცია მიწოდების ანგარიშებთან დაკავშირებით განახლებული ინფორმაცია TLS 1.3-ის შესახებ |
| 2. | 2025-06-03 | GM | დამატებულია შედეგის კოდი 2108 |
| 2. | 2025-06-24 | 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 შეკვრა
შემდეგი bind ბრძანებები მხარდაჭერილია.
- გადამცემი
- გადამცემი
- მიმღები
საჭირო პარამეტრები:
- system_id – მიღებული მხარდაჭერისგან
- პაროლი - მიღებული მხარდაჭერისგან
არჩევითი პარამეტრები:
- addr_ton – ნაგულისხმევი მნიშვნელობა, თუ გაგზავნის დროს TON დაყენებულია უცნობია.
- addr_npi – ნაგულისხმევი მნიშვნელობა, თუ NPI დაყენებულია უცნობია გაგზავნის დროს.
მხარდაუჭერელი პარამეტრები:
- მისამართი_დიაპაზონი
4.2 Unbind
unbind ბრძანება მხარდაჭერილია.
4.3 გამოკითხვის ბმული
შეკითხვის ბმული ბრძანება მხარდაჭერილია და უნდა გამოიძახოთ ყოველ 60 წამში.
4.4 გაგზავნა
გაგზავნის მეთოდი უნდა იყოს გამოყენებული შეტყობინებების მიწოდებისთვის.
საჭირო პარამეტრები:
- source_addr_ton
- source_addr_npi
- source_addr
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_class
- მონაცემთა_კოდირება
- სმ_სიგრძე
- მოკლე შეტყობინება
მხარდაუჭერელი პარამეტრები:
- სერვისის ტიპი
- protocol_id
- პრიორიტეტული_დროშა
- განრიგი_მიწოდების_დრო
- შეცვლის_თუ_აწმყო_დროშა
- sm_default_msg_id
შენიშვნა რომ ტვირთამწეობა tag არ არის მხარდაჭერილი და შესაძლებელია მხოლოდ ერთი SMS მიწოდება თითო ზარზე და რეკომენდებულია validity_period tag აქვს მინიმუმ 15 წუთის ღირებულება.
4.4.1 რეკომენდებული TON და NPI
გაგზავნის ბრძანების გამოყენებით შეტყობინებების გაგზავნისას გამოყენებული უნდა იყოს შემდეგი TON და NPI.
4.4.1.1 წყარო
წყაროს მისამართისთვის მხარდაჭერილია შემდეგი TON და NPI კომბინაციები. ყველა სხვა კომბინაცია ჩაითვლება არასწორად. თუ TON დაყენებულია უცნობზე (0), გამოყენებული იქნება ნაგულისხმევი TON bind ბრძანებიდან. თუ NPI დაყენებულია უცნობზე (0), გამოყენებული იქნება ნაგულისხმევი NPI bind ბრძანებიდან.
| TON | 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 from bind ბრძანება გამოყენებული იქნება, თუ TON დაყენებულია უცნობი (0). ნაგულისხმევი NPI bind ბრძანებიდან გამოყენებული იქნება, თუ NPI დაყენებულია უცნობი (0).
| TON | 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 Pro-ს მეშვეობით.fileკვოტის დინამიურად მინიჭება ასევე შესაძლებელია კვოტის შესაბამისობის გამოყენებით. ეს კონკრეტულ კვოტის იდენტიფიკაციას (UUID) და უნიკალურ კვოტის გასაღებს (მაგ., გამგზავნს ან მომხმარებელს) აკავშირებს.
კვოტა დგინდება თქვენი ადგილობრივი მხარდაჭერის სამსახურის, თქვენთვის დანიშნული ანგარიშის მენეჯერის შესაბამისად ან ნაგულისხმევად, თუ არაფერია მითითებული.
5.2 სტატუსი 106 – კვოტა გადაჭარბებულია
SMS შეტყობინება შეიძლება დაბლოკილი იყოს სტატუსის კოდით 106 („კვოტა გადაჭარბებულია“), როდესაც:
- შეტყობინება მიმდინარე ინტერვალში შესაბამისი quotaId-ისთვის განსაზღვრულ ლიმიტს აჭარბებს.
- დანიშნულების ქვეყანას ან რეგიონს არ აქვს მინიჭებული კვოტა (ანუ, პროში აშკარად დაბლოკილია ნულოვანი კვოტების შესაბამისობით)file).
- შესაბამისი კვოტა და ნაგულისხმევი კვოტა არ არის განსაზღვრული, რაც უარყოფას იწვევს.
ამ შემთხვევებში, სისტემა ხელს უშლის შეტყობინებების შემდგომ დამუშავებას, რათა უზრუნველყოს მომხმარებლის ან დანიშნულების ადგილის მიხედვით ლიმიტები და თავიდან აიცილოს ბოროტად გამოყენება.
Მიწოდების ანგარიში
მხარდაჭერილია მხოლოდ არცერთი ან საბოლოო მიწოდება წარმატებული/წარუმატებელი შედეგით.
ფორმატის მიწოდების შესახებ ანგარიში: ID: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX DODE DATE: YYMMDDHHHMM STAT:
ხელმისაწვდომი მნიშვნელობები სტატუსში:
- DELIVRD
- ვადა გაუვიდა
- უარყო
- UNELIV
- წაშლილია
6.1 გაფართოებული მიწოდების ანგარიშის ფორმატი
გაფართოებული ინფორმაცია მიწოდების ანგარიშებში შეიძლება მოითხოვოთ თქვენს გაყიდვების წარმომადგენელთან კონტაქტში.
მიწოდების ანგარიშის ფორმატი: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 გაგზავნის თარიღი:
yyMMddHHmm დასრულების თარიღი: yyMMddHHmm სტატისტიკა: შეცდომა: ტექსტი:
ხელმისაწვდომი მნიშვნელობები სტატუსში:
- DELIVRD
- ვადა გაუვიდა
- უარყო
- UNELIV
- წაშლილია
"sub" და "dlvrd" ველები ყოველთვის დაყენებული იქნება 000-ზე, ხოლო "ტექსტის" ველი ყოველთვის ცარიელი იქნება.
იხილეთ თავი შეცდომის კოდები მნიშვნელობებისთვის „err“ ველისთვის.
მხარდაჭერილი TLS ვერსიები
TLS 1.2 ან TLS 1.3 საჭიროა ყველა TLS კავშირისთვის SMPP-ზე.
TLS 1.0-ისა და 1.1-ის მხარდაჭერა შეწყვეტილია 2020-11-15 წლიდან. TLS-ის 1.0 და 1.1 ვერსიები უფრო ძველი პროტოკოლებია, რომლებიც მოძველებულია და განიხილება როგორც უსაფრთხოების რისკები ინტერნეტ საზოგადოებაში.
LINK მკაცრად გირჩევთ გამოიყენოთ TLS, თუ დღეს გამოიყენება დაუშიფრავი SMPP კავშირები. დაშიფრული SMPP კავშირები მოძველებულია 2020-09-01-დან LINK-ით და მომავალში წაიშლება. დაშიფრული კავშირების ამოღების თარიღი ჯერ არ არის გადაწყვეტილი.
SMPP სერვერთან კავშირები TLS-ისთვის არის 3601 პორტში და არა დაშიფრული 3600 პორტში.
თქვენ კვლავ შეგიძლიათ გამოიყენოთ TLS, მაშინაც კი, თუ თქვენი SMPP განხორციელება არ უჭერს მხარს TLS-ს stunnel-ის გამოყენებით, იხ https://www.stunnel.org/
შეცდომის კოდები
შემდეგ შეცდომის კოდებს შეიძლება უპასუხოთ შეცდომის ველში, თუ ველი ჩართულია.
| შეცდომის კოდი | აღწერა |
| 0 | Უცნობი შეცდომა |
| 1 | მარშრუტიზაციის დროებითი შეცდომა |
| 2 | მარშრუტიზაციის მუდმივი შეცდომა |
| 3 | მაქსიმალური throttling გადააჭარბა |
| 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 | Alpha არ არის მხარდაჭერილი, როგორც წყარო |
| 2003 | MSISDN არ არის მხარდაჭერილი, როგორც წყაროს ნომერი |
| 2100 | მოკლე ნომერი არ არის მხარდაჭერილი, როგორც დანიშნულების ადგილი |
| 2101 | Alpha არ არის მხარდაჭერილი, როგორც დანიშნულების ადგილი |
| 2102 | MSISDN არ არის მხარდაჭერილი, როგორც დანიშნულების ადგილი |
| 2103 | ოპერაცია დაბლოკილია |
| 2104 | უცნობი აბონენტი |
| 2105 | დანიშნულება დაბლოკილია |
| 2106 | ნომრის შეცდომა |
| 2107 | დანიშნულების ადგილი დროებით დაბლოკილია |
| 2108 | არასწორი დანიშნულების ადგილი |
| 2200 | დატენვის შეცდომა |
| 2201 | აბონენტს აქვს დაბალი ბალანსი |
|
2202 |
აბონენტი დაიბლოკა ზედმეტად გადახდილი (პრემიუმი) გადასახადის გამო
შეტყობინებები |
|
2203 |
აბონენტი ძალიან ახალგაზრდაა (ამ კონკრეტულისთვის)
შინაარსი) |
| 2204 | წინასწარი გადახდის აბონენტი დაუშვებელია |
| 2205 | სერვისი უარყოფილია აბონენტის მიერ |
| 2206 | აბონენტი არ არის რეგისტრირებული გადახდის სისტემაში |
| 2207 | აბონენტმა მიაღწია მაქსიმალურ ბალანსს |
| 2208 | საჭიროა საბოლოო მომხმარებლის დადასტურება |
| 2300 | თანხის დაბრუნება |
|
2301 |
თანხის დაბრუნება შეუძლებელია უკანონო ან დაკარგული ნივთის გამო
MSISDN |
| 2302 | თანხის დაბრუნება ვერ მოხერხდა გამოტოვებული შეტყობინების ID-ის გამო |
| 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 |