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 כריכה
פקודות הקישור הבאות נתמכות.
- מַשׁדֵר
- משדר
- מַקְלֵט
פרמטרים נדרשים:
- system_id - מתקבל מהתמיכה
- סיסמה - מתקבלת מהתמיכה
פרמטרים אופציונליים:
- addr_ton - ערך ברירת המחדל אם TON מוגדר לא ידוע במהלך ההגשה.
- addr_npi - ערך ברירת מחדל אם NPI מוגדר כבלתי ידוע במהלך ההגשה.
פרמטרים לא נתמכים:
- כתובת_טווח
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
- קידוד_נתונים
- sm_length
- הודעה קצרה
פרמטרים לא נתמכים:
- סוג שירות
- protocol_id
- דגל_עדיפות
- לוח_זמן_מסירה
- replace_if_present_flag
- sm_default_msg_id
פֶּתֶק כי המטען tag אינו נתמך וניתן לשלוח רק SMS אחד לכל שיחה ומומלץ שתקופת התוקף tag בעל ערך של 15 דקות לפחות.
4.4.1 TON ו-NPI מומלצים
יש להשתמש ב-TON וב-NPI הבאים בעת שליחת הודעות באמצעות פקודת שלח.
4.4.1.1 מקור
צירופי TON ו-NPI הבאים נתמכים עבור כתובת מקור. כל שאר הצירופים יטופלו כלא חוקיים. פקודת ברירת המחדל TON from bind תשמש אם TON מוגדרת כלא ידוע (0). פקודת ברירת המחדל NPI from bind תשמש אם 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 מ-bind תשמש אם TON מוגדר ל- Unknown (0). פקודת ברירת המחדל של NPI מ-binding תשמש אם NPI מוגדר ל-Unknown (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 Pro.fileניתן להקצות מכסה באופן דינמי גם באמצעות מיפוי מכסה. פעולה זו ממפה קוד quotaId (UUID) ומפתח מכסה ייחודי (למשל, שולח או משתמש) לקוד quotaId ספציפי.
מכסה נקבעת בהתאם לתמיכה המקומית שלך, למנהל החשבון שהוקצה לך או כברירת מחדל אם לא צוין דבר.
5.2 סטטוס 106 – חריגה מהמכסה
הודעת SMS עשויה להיחסם עם קוד סטטוס 106 ("חריגה מהמכסה") כאשר:
- ההודעה חורגת מהמגבלה שהוגדרה עבור ה-quotaId המתאים לה בתוך המרווח הנוכחי.
- למדינת או אזור היעד לא הוקצתה מכסה (כלומר, חסום במפורש עם מיפוי מכסה ריק בפרו).file).
- אין מכסת תואמת ולא מוגדרת מכסת ברירת מחדל, מה שגורם לדחייה.
במקרים אלה, המערכת מונעת עיבוד נוסף של הודעות כדי לאכוף מגבלות מבוססות לקוח או יעד ולמנוע שימוש לרעה.
דוח מסירה
רק מסירה או מסירה סופית עם תוצאה מוצלחת/כישלון נתמכת.
פורמט בדוח המסירה: מזהה: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx תאריך סיום: yyMMddHHmm סטטיסטיקה:
ערכים זמינים בסטטוס:
- DELIVRD
- פג תוקף
- נדחה
- בטל
- נמחק
6.1 פורמט דוח מסירה מורחב
ניתן לבקש מידע מורחב בדוחות מסירה ביצירת קשר עם נציג המכירות שלך.
פורמט בדוח מסירה: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 תאריך הגשה:
שנה חודש תאריך סיום: שנה חודש חודש סטטיסטיקה: לִטְעוֹת: טֶקסט:
ערכים זמינים בסטטוס:
- DELIVRD
- פג תוקף
- נדחה
- בטל
- נמחק
שדות "sub" ו-"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 API, SMPP API MS Scheduler API [pdfמדריך למשתמש SMS API SMPP API MS Scheduler API, SMS API SMPP API, MS Scheduler API, Scheduler API, API |