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 మొబిలిటీ 2001 నుండి SMS పంపిణీదారుగా ఉంది మరియు ఆపరేటర్లు మరియు కనెక్షన్ అగ్రిగేటర్‌లతో పని చేయడంలో చాలా అనుభవం ఉంది. ఈ ప్లాట్‌ఫారమ్ పెద్ద ట్రాఫిక్ వాల్యూమ్‌లను నిర్వహించడానికి, అధిక లభ్యతను నిర్వహించడానికి మరియు బహుళ కనెక్షన్‌ల ద్వారా ట్రాఫిక్‌ను సులభతరం చేయడానికి రూపొందించబడింది.
This is document describes the SMPP interface to the SMSC-platform and which parameters and commands that are required and which parameters are supported.
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 మొబిలిటీ యొక్క సర్వర్ SMPP 3.4గా పరిగణించబడాలి. అధికారిక వివరణను ఇక్కడ చూడవచ్చు https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
అన్ని పద్ధతులకు మద్దతు లేదు మరియు అన్ని తేడాలు క్రింద పేర్కొనబడ్డాయి.
4.1 బైండ్
కింది బైండ్ ఆదేశాలకు మద్దతు ఉంది.
- ట్రాన్స్మిటర్
- ట్రాన్స్సీవర్
- రిసీవర్
అవసరమైన పారామితులు:
- system_id - మద్దతు నుండి పొందబడింది
- పాస్వర్డ్ - మద్దతు నుండి పొందబడింది
ఐచ్ఛిక పారామితులు:
- addr_ton – సమర్పించే సమయంలో TON తెలియనిదిగా సెట్ చేయబడితే డిఫాల్ట్ విలువ.
- addr_npi – సమర్పించే సమయంలో NPI Unknownకి సెట్ చేయబడితే డిఫాల్ట్ విలువ.
మద్దతు లేని పారామీటర్‌లు:
- చిరునామా_పరిధి
4.2 అన్‌బైండ్
అన్‌బైండ్ కమాండ్‌కు మద్దతు ఉంది.
4.3 ఎంక్వైర్ లింక్
విచారణ లింక్ కమాండ్‌కు మద్దతు ఉంది మరియు ప్రతి 60 సెకన్లకు కాల్ చేయాలి.
4.4 సమర్పించండి
సందేశాలను బట్వాడా చేయడానికి సమర్పించే పద్ధతిని ఉపయోగించాలి.
అవసరమైన పారామితులు:
- source_addr_ton
- source_addr_npi
- source_addr
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_class
- డేటా_కోడింగ్
- sm_పొడవు
- సంక్షిప్త_సందేశం
మద్దతు లేని పారామీటర్‌లు:
- సేవ_రకం
- ప్రోటోకాల్_ఐడి
- ప్రాధాన్యత_జెండా
- షెడ్యూల్_డెలివరీ_టైమ్
- ఫ్లాగ్_ప్రస్తుతం_ఉంటే
- sm_default_msg_id
గమనిక పేలోడ్ అని tag మద్దతు లేదు మరియు ఒక్కో కాల్‌కి ఒక SMS మాత్రమే బట్వాడా చేయబడవచ్చు మరియు ఇది Validity_period అని సిఫార్సు చేయబడింది tag కనీసం 15 నిమిషాల నిడివిని కలిగి ఉంటుంది.
4.4.1 సిఫార్సు చేయబడిన TON మరియు NPI
submit కమాండ్‌ని ఉపయోగించి సందేశాలను పంపేటప్పుడు క్రింది 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 తెలియని (0)కి సెట్ చేయబడితే బైండ్ కమాండ్ నుండి డిఫాల్ట్ TON ఉపయోగించబడుతుంది. NPI తెలియని (0)కి సెట్ చేయబడితే బైండ్ కమాండ్ నుండి డిఫాల్ట్ NPI ఉపయోగించబడుతుంది.
| టన్ | NPI | వివరణ |
| అంతర్జాతీయ (1) | తెలియని (0) ISDN (1) |
MSISDNగా పరిగణించబడుతుంది |
4.4.2 మద్దతు గల ఎన్‌కోడింగ్‌లు
కింది ఎన్‌కోడింగ్‌లకు మద్దతు ఉంది. X ఏదైనా విలువను కలిగి ఉండవచ్చు.
| DCS | ఎన్కోడింగ్ |
| 0xX0 | పొడిగింపుతో డిఫాల్ట్ GSM ఆల్ఫాబెట్ |
| 0xX2 | 8-బిట్ బైనరీ |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
కోటా
5.1 Quota Overview
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.
A quota is set in accordance with your local support, your assigned account manager or by default if nothing is specified.
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.
In these cases, the system prevents further message processing to enforce customer or destination-based limits and avoid misuse.
విడుదల నివేదిక
విజయవంతమైన/విఫలమైన ఫలితంతో ఏదీ లేదా చివరి డెలివరీకి మాత్రమే మద్దతు ఉంది.
డెలివరీ నివేదికపై ఫార్మాట్: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx పూర్తి చేసిన తేదీ: yyMMddHHmm గణాంకాలు:
స్థితిలో అందుబాటులో ఉన్న విలువలు:
- డెలివర్డ్
- గడువు ముగిసింది
- తిరస్కరించబడింది
- 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కి సెట్ చేయబడతాయి మరియు "టెక్స్ట్" ఫీల్డ్ ఎల్లప్పుడూ ఖాళీగా ఉంటుంది.
"తప్పు" ఫీల్డ్ కోసం విలువల కోసం చాప్టర్ ఎర్రర్ కోడ్‌లను చూడండి.
మద్దతు ఉన్న TLS సంస్కరణలు
SMPP ద్వారా అన్ని TLS కనెక్షన్‌లకు TLS 1.2 లేదా TLS 1.3 అవసరం.
TLS 1.0 మరియు 1.1కి మద్దతు 2020-11-15 నుండి నిలిపివేయబడింది. TLS యొక్క 1.0 మరియు 1.1 సంస్కరణలు పాత ప్రోటోకాల్‌లు, అవి నిలిపివేయబడ్డాయి మరియు ఇంటర్నెట్ కమ్యూనిటీలో భద్రతా ప్రమాదాలుగా పరిగణించబడతాయి.
ఈరోజు ఎన్‌క్రిప్ట్ చేయని SMPP కనెక్షన్‌లు ఉపయోగించబడుతుంటే TLSని ఉపయోగించమని LINK గట్టిగా సిఫార్సు చేస్తోంది. ఎన్‌క్రిప్ట్ చేయని SMPP కనెక్షన్‌లు 2020-09-01 నాటికి LINK ద్వారా నిలిపివేయబడ్డాయి మరియు భవిష్యత్తులో తీసివేయబడతాయి. ఎన్‌క్రిప్ట్ చేయని కనెక్షన్‌ల తొలగింపు తేదీ ఇంకా నిర్ణయించబడలేదు.
TLS కోసం SMPP సర్వర్‌కు సంబంధించిన కనెక్షన్‌లు పోర్ట్ 3601 వద్ద ఎన్‌క్రిప్ట్ చేయబడకుండా పోర్ట్ 3600 వద్ద ఉన్నాయి.
స్టన్నెల్‌ని ఉపయోగించి మీ SMPP అమలు TLSకి మద్దతు ఇవ్వకపోయినా మీరు ఇప్పటికీ TLSని ఉపయోగించవచ్చు, చూడండి 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 | మూలాధారంగా ఆల్ఫాకు మద్దతు లేదు |
| 2003 | MSISDNకి సోర్స్ నంబర్‌గా మద్దతు లేదు |
| 2100 | సంక్షిప్త సంఖ్యకు గమ్యస్థానంగా మద్దతు లేదు |
| 2101 | గమ్యస్థానంగా ఆల్ఫాకు మద్దతు లేదు |
| 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 తెలుగు in లో |
| 2302 | మెసేజ్ ఐడి మిస్ అయినందున రీఫండ్ చేయడం సాధ్యపడలేదు |
| 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 |