SMS API, SMPP API MS શેડ્યૂલર API
વપરાશકર્તા માર્ગદર્શિકા
SMS API, SMPP API MS શેડ્યૂલર API
| સંશોધિત: | 6/24/2025 |
| સંસ્કરણ: | 1.7 |
| લેખક: | કેની કોલન્ડર નોર્ડેન, કેસીએન |
આ દસ્તાવેજ માત્ર નિયુક્ત પ્રાપ્તકર્તા માટે છે અને તેમાં વિશેષાધિકૃત, માલિકીનું અથવા અન્યથા ખાનગી માહિતી હોઈ શકે છે. જો તમને તે ભૂલથી પ્રાપ્ત થયું હોય, તો કૃપા કરીને તરત જ મોકલનારને સૂચિત કરો અને મૂળ કાઢી નાખો. તમારા દ્વારા દસ્તાવેજનો અન્ય કોઈપણ ઉપયોગ પ્રતિબંધિત છે.
ઇતિહાસ બદલો
| રેવ | તારીખ | By | અગાઉના પ્રકાશનમાંથી ફેરફારો |
| 1.0 | 2010-03-16 | કેસીએન | બનાવ્યું |
| 1. | 2019-06-11 | TPE | અપડેટ કરેલ LINK લોગો |
| 1. | 2019-09-27 | PNI | SMPP 3.4 સ્પષ્ટીકરણનો સંદર્ભ ઉમેર્યો |
| 1. | 2019-10-31 | EP | માન્યતા અવધિ વિશે અવલોકન tag |
| 1. | 2020-08-28 | કેસીએન | સમર્થિત TLS સંસ્કરણો સંબંધિત માહિતી ઉમેરવામાં આવી છે |
| 2. | 2022-01-10 | કેસીએન | ડિલિવરી રિપોર્ટ્સ સંબંધિત વધારાની માહિતી ઉમેરી TLS 1.3 સંબંધિત અપડેટ કરેલી માહિતી |
| 2. | 2025-06-03 | GM | પરિણામ કોડ 2108 ઉમેર્યો |
| 2. | 2025-06-24 | AK | ક્વોટા ઉમેર્યો |
પરિચય
LINK મોબિલિટી 2001 થી SMS વિતરક છે અને ઓપરેટરો અને કનેક્શન એગ્રીગેટર્સ બંને સાથે કામ કરવાનો ઘણો અનુભવ ધરાવે છે. આ પ્લેટફોર્મ મોટા ટ્રાફિક વોલ્યુમને હેન્ડલ કરવા, ઉચ્ચ ઉપલબ્ધતા જાળવી રાખવા અને બહુવિધ કનેક્શન દ્વારા ટ્રાફિકને રૂટ કરવાનું સરળ બનાવવા માટે ડિઝાઇન કરવામાં આવ્યું છે.
આ દસ્તાવેજ SMSC-પ્લેટફોર્મ પર SMPP ઇન્ટરફેસનું વર્ણન કરે છે અને કયા પરિમાણો અને આદેશો જરૂરી છે અને કયા પરિમાણો સપોર્ટેડ છે તેનું વર્ણન કરે છે.
આ દસ્તાવેજ ચોક્કસ ઉપયોગના કેસોને હેન્ડલ કરશે નહીં જેમ કે સંકલિત સંદેશાઓ, WAPpush, ફ્લેશ SMS, વગેરે. તે કેસ વિશે વધુ માહિતી સપોર્ટનો સંપર્ક કરીને પ્રદાન કરી શકાય છે.
સપોર્ટેડ આદેશો
LINK મોબિલિટીના સર્વરને 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_ton
- dest_addr_npi
- dest_addr
- esm_class
- ડેટા_કોડિંગ
- sm_length
- ટૂંકો_સંદેશ
અસમર્થિત પરિમાણો:
- સેવા_પ્રકાર
- protocol_id
- અગ્રતા_ધ્વજ
- શેડ્યૂલ_ડિલિવરી_સમય
- બદલો_જો_વર્તમાન_ધ્વજ
- sm_default_msg_id
નોંધ કે પેલોડ tag સમર્થિત નથી અને કૉલ દીઠ માત્ર એક SMS વિતરિત થઈ શકે છે અને ભલામણ કરવામાં આવે છે કે માન્યતા_કાળ tag ઓછામાં ઓછા 15 મિનિટ લાંબી કિંમત ધરાવે છે.
4.4.1 ભલામણ કરેલ TON અને NPI
સબમિટ કમાન્ડનો ઉપયોગ કરીને સંદેશાઓ મોકલતી વખતે નીચેના TON અને NPIનો ઉપયોગ કરવો જોઈએ.
4.4.1.1 સ્ત્રોત
નીચેના TON અને NPI સંયોજનો સ્રોત સરનામાં માટે સમર્થિત છે. અન્ય બધા સંયોજનોને અમાન્ય ગણવામાં આવશે. જો TON Unknown (0) પર સેટ કરેલ હોય તો ડિફોલ્ટ TON from bind આદેશનો ઉપયોગ કરવામાં આવશે. જો NPI Unknown (0) પર સેટ કરેલ હોય તો ડિફોલ્ટ NPI from bind આદેશનો ઉપયોગ કરવામાં આવશે.
| ટન | NPI | વર્ણન |
| આલ્ફાન્યૂમેરિક (5) | અજ્ઞાત (0) આઇએસડીએન (1) |
આલ્ફાન્યૂમેરિક પ્રેષક ટેક્સ્ટ તરીકે ગણવામાં આવશે |
| આંતરરાષ્ટ્રીય (1) | અજ્ઞાત (0) આઇએસડીએન (1) |
MSISDN તરીકે ગણવામાં આવશે |
| રાષ્ટ્રીય (2) નેટવર્ક વિશિષ્ટ (3) સબ્સ્ક્રાઇબર નંબર (4) સંક્ષિપ્ત (6) |
અજ્ઞાત (0) આઇએસડીએન (1) રાષ્ટ્રીય (8) |
દેશ વિશિષ્ટ ટૂંકી સંખ્યા તરીકે ગણવામાં આવશે. |
4.4.1.2 ગંતવ્ય
નીચેના TON અને NPI સંયોજનો ગંતવ્ય સરનામા માટે સમર્થિત છે. અન્ય તમામ સંયોજનોને અમાન્ય ગણવામાં આવશે. જો TON અજ્ઞાત (0) પર સેટ કરેલ હોય તો bind આદેશમાંથી ડિફોલ્ટ TON નો ઉપયોગ કરવામાં આવશે. જો NPI અજ્ઞાત (0) પર સેટ કરેલ હોય તો bind કમાન્ડમાંથી ડિફોલ્ટ NPI નો ઉપયોગ કરવામાં આવશે.
| ટન | NPI | વર્ણન |
| આંતરરાષ્ટ્રીય (1) | અજ્ઞાત (0) આઇએસડીએન (1) |
MSISDN તરીકે ગણવામાં આવશે |
4.4.2 સપોર્ટેડ એન્કોડિંગ્સ
નીચેના એન્કોડિંગ્સ સપોર્ટેડ છે. X માં કોઈપણ મૂલ્ય હોઈ શકે છે.
| ડીસીએસ | એન્કોડિંગ |
| 0xX0 | એક્સ્ટેંશન સાથે ડિફોલ્ટ GSM આલ્ફાબેટ |
| 0xX2 | 8-બીટ બાઈનરી |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
ક્વોટા
૫.૧ ક્વોટા પૂરો થયોview
ક્વોટા એ નિર્ધારિત સમય અંતરાલ (જેમ કે દિવસ, સપ્તાહ, મહિનો અથવા અનિશ્ચિત સમય) માં મોકલી શકાય તેવા SMS સંદેશાઓની મહત્તમ સંખ્યાને વ્યાખ્યાયિત કરે છે. દરેક ક્વોટાને ક્વોટાઆઈડી (UUID) દ્વારા વિશિષ્ટ રીતે ઓળખવામાં આવે છે અને ગ્રાહકના સમય ઝોન અનુસાર રીસેટ કરવામાં આવે છે. ક્વોટા પ્રો દ્વારા દેશ, પ્રદેશ અથવા ડિફોલ્ટ સ્તરે ક્વોટા સોંપી શકાય છે.file. ક્વોટા મેપિંગનો ઉપયોગ કરીને ક્વોટાને ગતિશીલ રીતે પણ સોંપી શકાય છે. આ પેરેન્ટ ક્વોટાઆઈડી (UUID) અને એક અનન્ય ક્વોટા કી (દા.ત., મોકલનાર અથવા વપરાશકર્તા) ને ચોક્કસ ક્વોટાઆઈડી સાથે મેપ કરે છે.
તમારા સ્થાનિક સપોર્ટ, તમારા સોંપેલ એકાઉન્ટ મેનેજર અથવા જો કંઈ સ્પષ્ટ ન હોય તો ડિફોલ્ટ રૂપે ક્વોટા સેટ કરવામાં આવે છે.
૫.૨ સ્થિતિ ૧૦૬ – ક્વોટા ઓળંગાઈ ગયો
નીચેના કિસ્સાઓમાં સ્ટેટસ કોડ 106 ("ક્વોટા ઓળંગાઈ ગયો") સાથે SMS સંદેશ અવરોધિત થઈ શકે છે:
- સંદેશ વર્તમાન અંતરાલમાં તેના અનુરૂપ ક્વોટા આઈડી માટે નિર્ધારિત મર્યાદા કરતાં વધી ગયો છે.
- ગંતવ્ય દેશ અથવા પ્રદેશને કોઈ ક્વોટા સોંપાયેલ નથી (એટલે કે, પ્રોમાં નલ ક્વોટા મેપિંગ સાથે સ્પષ્ટપણે અવરોધિત છે).file).
- કોઈ મેળ ખાતો ક્વોટા નથી અને કોઈ ડિફોલ્ટ ક્વોટા વ્યાખ્યાયિત નથી, જેના પરિણામે અસ્વીકાર થાય છે.
આ કિસ્સાઓમાં, સિસ્ટમ ગ્રાહક અથવા ગંતવ્ય-આધારિત મર્યાદાઓ લાગુ કરવા અને દુરુપયોગ ટાળવા માટે વધુ સંદેશ પ્રક્રિયાને અટકાવે છે.
ડિલિવરી અહેવાલ
સફળ/નિષ્ફળ પરિણામ સાથે માત્ર કોઈ અથવા અંતિમ ડિલિવરી સમર્થિત નથી.
ડિલિવરી રિપોર્ટ પર ફોર્મેટ: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx પૂર્ણ તારીખ: yyMMddHHmm સ્ટેટ:
સ્થિતિમાં ઉપલબ્ધ મૂલ્યો:
- DELIVRD
- સમાપ્ત
- અસ્વીકાર
- UNDELIV
- કાઢી નાખ્યું
6.1 વિસ્તૃત ડિલિવરી રિપોર્ટ ફોર્મેટ
તમારા વેચાણ પ્રતિનિધિના સંપર્કમાં ડિલિવરી રિપોર્ટ્સમાં વિસ્તૃત માહિતીની વિનંતી કરવામાં આવી શકે છે.
ડિલિવરી રિપોર્ટ પર ફોર્મેટ: id: xx
yyMMddHHmm પૂર્ણ તારીખ: yyMMddHHmm સ્ટેટ: ભૂલ: ટેક્સ્ટ:
સ્થિતિમાં ઉપલબ્ધ મૂલ્યો:
- DELIVRD
- સમાપ્ત
- અસ્વીકાર
- UNDELIV
- કાઢી નાખ્યું
"સબ" અને "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 કનેક્શનનો ઉપયોગ કરવામાં આવી રહ્યો હોય તો LINK TLS નો ઉપયોગ કરવાની ભારપૂર્વક ભલામણ કરે છે. 2020-09-01 સુધી LINK દ્વારા અનએનક્રિપ્ટેડ SMPP કનેક્શનને નાપસંદ કરવામાં આવ્યા છે અને ભવિષ્યમાં દૂર કરવામાં આવશે. એનક્રિપ્ટેડ જોડાણો દૂર કરવાની તારીખ હજી નક્કી કરવામાં આવી નથી.
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 | ક્વોટા ઓળંગાઈ ગયો |
| 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 | અમાન્ય VAT |
| 4007 | ગંતવ્ય માટે અસમર્થિત સામગ્રી |
દસ્તાવેજો / સંસાધનો
 |
લિંક મોબિલિટી SMS API, SMPP API MS શેડ્યૂલર API [પીડીએફ] વપરાશકર્તા માર્ગદર્શિકા SMS API SMPP API MS શેડ્યૂલર API, SMS API SMPP API, MS શેડ્યૂલર API, શેડ્યૂલર API, API |