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 | דערהייַנטיקט לינק לאָגאָס |
| 1. | 2019-09-27 | פּני | צוגעגעבן רעפֿערענץ צו 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 מאָביליטי איז געווען אַ 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 איז באַשטימט צו אומבאַקאַנט בעשאַס פאָרלייגן.
- addr_npi - פעליקייַט ווערט אויב NPI איז באַשטימט צו אומבאַקאַנט בעשאַס פאָרלייגן.
ניט-געשטיצט פּאַראַמעטערס:
- אַדרעס_ראַנגע
4.2 ונבינד
די ונבינד באַפֿעל איז געשטיצט.
4.3 אָנפרעג לינק
דער אָנפרעג לינק באַפֿעל איז געשטיצט און זאָל זיין גערופן יעדער 60 סעקונדעס.
4.4 פאָרלייגן
דער פאָרלייגן אופֿן זאָל זיין געניצט פֿאַר דיליווערינג אַרטיקלען.
פארלאנגט פּאַראַמעטערס:
- source_addr_ton
- source_addr_npi
- source_addr
- דעסט_אַדדר_טאָן
- dest_addr_npi
- דעסט_אַדדר
- esm_class
- דאַטן_קאָדינג
- sm_length
- קורץ_מעסעדזש
ניט-געשטיצט פּאַראַמעטערס:
- service_type
- פּראָטאָקאָל_יד
- priority_flag
- סקעדזשול_דעליווערי_טיים
- replace_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).
| TON | נפּי | באַשרייַבונג |
| אַלפאַנומעריק (5) | אומבאַקאַנט (0) איי-עס-ען (1) |
וועט זיין באהאנדלט ווי אַלפאַנומעריק סענדער טעקסט |
| אינטערנאציאנאלע (1) | אומבאַקאַנט (0) איי-עס-ען (1) |
וועט זיין באהאנדלט ווי MSISDN |
| נאַציאָנאַלער (2) נעץ ספּעציפֿיש (3) אַבאָנענט נומער (4) אַבריוויייטיד (6) |
אומבאַקאַנט (0) איי-עס-ען (1) נאַציאָנאַלער (8) |
וועט זיין באהאנדלט ווי מדינה ספּעציפיש קורץ נומער. |
4.4.1.2 דעסטיניישאַן
די פאלגענדע TON און NPI קאַמבאַניישאַנז זענען געשטיצט פֿאַר דעסטיניישאַן אַדרעס. אַלע אנדערע קאַמבאַניישאַנז וועט זיין באהאנדלט ווי פאַרקריפּלט. די פעליקייַט TON פֿון בינדן באַפֿעל וועט זיין געוויינט אויב TON איז באַשטימט צו Unknown (0). די פעליקייַט NPI פֿון בינדן באַפֿעל וועט זיין געוויינט אויב NPI איז באַשטימט צו Unknown (0).
| TON | נפּי | באַשרייַבונג |
| אינטערנאציאנאלע (1) | אומבאַקאַנט (0) איי-עס-ען (1) |
וועט זיין באהאנדלט ווי MSISDN |
4.4.2 שטיצט ענקאָדינגס
די פאלגענדע ענקאָדינגס זענען געשטיצט. X קען אַנטהאַלטן קיין ווערט.
| דקס | קאָדירונג |
| 0xX0 | פעליקייַט גסם אלפאבעט מיט פאַרלענגערונג |
| 0xX2 | 8-ביסל ביינערי |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
קוואָטע
5.1 קוואָטע איבערview
א קוואָטע דעפינירט די מאַקסימום צאָל SMS מעסעדזשעס וואָס קענען געשיקט ווערן אין אַ באַשטימטן צייט אינטערוואַל (אַזאַ ווי פּער טאָג, וואָך, חודש, אָדער אומבאַגרענעצט). יעדע קוואָטע איז יינציק אידענטיפיצירט דורך אַ קוואָטעId (UUID) און ווערט איבערגעשטעלט לויט דער קונה'ס צייט זאָנע. קוואָטעס קענען צוגעטיילט ווערן אויף לאַנד, ראַיאָן, אָדער פעליקייַט מדרגה דורך אַ קוואָטע פּראָ.fileקוואָטע קען אויך דינאַמיש צוגעטיילט ווערן ניצנדיק קוואָטע מאַפּינג. דאָס מאַפּט אַ פאָטער קוואָטאַאיד (UUID) און אַ יינציק קוואָטע שליסל (למשל, שיקער אָדער באַניצער) צו אַ ספּעציפֿיש קוואָטעאיד.
א קוואָטע ווערט באַשטימט לויט אייער לאָקאַלער שטיצע, אייער באַשטימטער אַקאַונט מאַנאַדזשער אָדער דורך פעליקייַט אויב גאָרנישט איז ספּעסיפיצירט.
5.2 סטאַטוס 106 – קוואָטע איבערגעשטיגן
אן SMS מעסעדזש קען ווערן בלאקירט מיטן סטאטוס קאוד 106 ("קוואטע איבערגעשטיגן") ווען:
- די מעסעדזש גייט אריבער דעם דעפינירטן לימיט פאר איר קארעספאנדירנדיקן קוואָטעId אינעם איצטיקן אינטערוואַל.
- די ציל לאַנד אָדער געגנט האט נישט קיין קוואָטע צוגעטיילט (ד"ה, איז עקספּליציט בלאָקירט מיט אַ נול קוואָטע מאַפּינג אין די פּראָfile).
- עס איז נישטאָ קיין פּאַסיקע קוואָטע און קיין פעליקייט קוואָטע איז נישט דעפינירט, וואָס רעזולטירט אין אָפּוואַרפן.
אין די פעלער, פארמיידט די סיסטעם ווייטערדיגע מעסעדזש באארבעטונג צו פארשטארקן קונה אדער דעסטינאציע-באזירטע לימיטן און פארמיידן מיסברויך.
עקספּרעס באַריכט
בלויז גאָרניט אָדער לעצט עקספּרעס מיט געראָטן / דורכפאַל רעזולטאַט זענען געשטיצט.
פֿאָרמאַט אויף עקספּרעס מעלדונג: שייַן: קסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקסקססקס טאטע:ייממדדהםם סטאַט:
בנימצא וואַלועס אין סטאַטוס:
- DELIVRD
- אויסגעגאנגען
- אפגעווארפן
- UNDELIV
- אויסגעמעקט
6.1 עקסטענדעד עקספּרעס באַריכט פֿאָרמאַט
עקסטענדעד אינפֿאָרמאַציע אין עקספּרעס ריפּאָרץ קען זיין געבעטן אין קאָנטאַקט מיט דיין סאַלעס פארשטייער.
פֿאָרמאַט אויף ליפֿערונג באַריכט: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 submit date:
ייממדדהההממ געענדיגט דאטום: ייממדדהההממ סטאט: טעות: טעקסט:
בנימצא וואַלועס אין סטאַטוס:
- DELIVRD
- אויסגעגאנגען
- אפגעווארפן
- UNDELIV
- אויסגעמעקט
"סוב" און "dlvrd" פעלדער וועט שטענדיק זיין באַשטימט צו 000, און "טעקסט" פעלד וועט שטענדיק זיין ליידיק.
זען קאַפּיטל טעות קאָודז פֿאַר וואַלועס פֿאַר די "טעות" פעלד.
שטיצט 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 ניצן סטאַננעל, זען 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 | קען נישט צוריקצאָל ווייַל פון פעלנדיק אָנזאָג |
| 2303 | קוועועד פֿאַר צוריקצאָל |
| 2304 | צוריקצאָל צייט |
| 2305 | צוריקצאָל דורכפאַל |
| 3000 | GSM קאָדירונג איז נישט געשטיצט |
| 3001 | UCS2 קאָדירונג איז נישט געשטיצט |
| 3002 | ביינערי קאָדירונג איז נישט געשטיצט |
| 4000 | עקספּרעס באַריכט איז נישט געשטיצט |
| 4001 | אומגילטיק אָנזאָג אינהאַלט |
| 4002 | פאַרקריפּלט צאָל |
| 4003 | אומגילטיק באַניצער דאַטן |
| 4004 | אומגילטיק באַניצער דאַטן כעדער |
| 4005 | אומגילטיק דאַטן קאָדירונג |
| 4006 | אומגילטיק וואַט |
| 4007 | ניט געשטיצט אינהאַלט פֿאַר דעסטיניישאַן |
דאָקומענטן / רעסאָורסעס
 |
לינק מאָביליטי SMS אַפּי, SMPP API MS Scheduler API [pdfבאַניצער גייד SMS API SMPP API MS Scheduler API, SMS API SMPP API, MS Scheduler API, Scheduler API, API |