Pagpatuman sa SMS Messaging 1.0

Mga detalye

• Ngalan sa Produkto: LINK Giya sa Pagpatuman sa Mobility SMS Messaging
  1.0
• Tighatag: LINK Mobility
• Functionality: Paghatud sa mensahe, micro nga pagbayad, base sa lokasyon
  serbisyo
• Pagkaangay: PC, mobile phone, PDA
• Legal nga Impormasyon: Bugtong kabtangan ug copyright sa Netsize

Mga Instruksyon sa Paggamit sa Produkto

Nagamit nga Kapinview

Ang sistema sa LINK Mobility naghatag ug sukaranang gamit para sa SMS
mga mensahe. Ang SMS Messaging API gipahinungod sa pagpadala nga sumbanan
i-rate ang MT SMS nga mga mensahe nga asynchronously.

Pagpadala usa ka Mensahe sa SMS

Para magpadala ug SMS nga mensahe gamit ang LINK Mobility system, sunda
kini nga mga lakang:

1. Sumpaysumpaya ang serbisyo gamit ang gihatag nga API.
2. Isulat ang imong mensahe sumala sa GSM character tables
   gihatag.
3. Ipadala ang mensahe nga asynchronous pinaagi sa API.

Pagpadala usa ka Mensahe sa SMS sa Daghang Mga Nagdawat

Kung kinahanglan nimo magpadala usa ka mensahe sa SMS sa daghang mga nakadawat:

1. Gamita ang pagpaandar sa API alang sa pagpadala sa mga mensahe ngadto
   daghang numero dungan.
2. Siguruha nga ang numero sa matag nakadawat husto nga pagkaporma.
3. Ipadala ang mensahe sa tanan nga nakadawat nga asynchronously.

FAQ

P: Unsa ang nag-unang gamit sa LINK Mobility
sistema?

A: Ang nag-unang gamit naglakip sa pagpadala standard rate MT SMS
asynchronous nga mga mensahe.

P: Unsaon nako pagpadala ug SMS nga mensahe gamit ang LINK Mobility
sistema?

A: Makapadala ka og SMS nga mensahe pinaagi sa pagkonektar sa serbisyo
gamit ang gihatag nga API, paghimo sa imong mensahe, ug pagpadala niini
asynchronous nga.

LINK Giya sa Pagpatuman sa Mobility SMS Messaging 1.0
Ang LINK Mobility naghatag og serbisyo alang sa paghatud sa mensahe, micro nga pagbayad ug mga serbisyo nga nakabase sa lokasyon. Ang plataporma naglihok isip usa ka transparent, white-label content acquirer ug transaction router tali sa mga Service Provider ug Operators. Ang mga Service Provider nagkonektar sa serbisyo gamit ang usa ka dali nga gipatuman nga API ug ang LINK Mobility nagdumala sa tanan nga panagsama sa mga Operator. Ang interface kay independente sa tipo sa device sa Consumer. Ang aparato mahimo nga usa ka PC, mobile phone o PDA.
© LINK Mobility, Marso 10, 2021

Legal nga Impormasyon
Ang kasayuran nga gihatag sa kini nga dokumento mao ang bugtong kabtangan ug copyright sa Netsize. Kompidensyal kini ug gituyo alang sa estrikto nga paggamit sa impormasyon. Dili kini mapuslan ug mahimong mapailalom sa mga pagbag-o nga wala’y pahibalo. Ang bisan unsang dili awtorisado nga pagbutyag o paggamit maisip nga supak sa balaod.
Ang NetsizeTM ug linkmobilityTM gipanalipdan sa French, EEC ug internasyonal nga mga balaod sa intelektwal nga kabtangan.
Ang tanan nga ubang mga marka sa pamatigayon nga gikutlo mao ang bugtong kabtangan sa ilang tagsa-tagsa nga mga tag-iya.
Walay bisan unsa nga nasulod dinhi ang pagasabton nga naghatag ug bisan unsang lisensya o katungod ubos sa Netsize patent, copyright, o trademark.
NETSIZE Société anonyme au capital de 5 478 070 euros Siège social :62, avenue Emile Zola92100 Boulogne France 418 712 477 RCS Nanterre http://www.Link Mobility.com http://www.linkmobility.com

Pag-usab sa Personalized nga Komunikasyon

1

Talaan sa mga sulod
Kasangkaran sa Dokumento………………………………………………………….. 3
1. Functional Overview ………………………………………………………………… 4 1.1 Pagpadala og SMS nga mensahe …………………………………………… ………………………. 4 1.2 Pagpadala og SMS nga mensahe ngadto sa daghang mga nakadawat …………………………………………… 6
2. Pag-instalar…………………………………………………………………………………… 7 2.1 Interoperability……………………………… ……………………………………………………….. 7 2.2 Web serbisyo ………………………………………………………………………………………. 7 2.3 Seguridad……………………………………………………………………………………………… 8
3. Paghiusa sa mensahe sa SMS uban sa LINK Mobility………………………………………… 8 3.1 Pagpadala og mga mensahe sa SMS ……………………………………………………………… ……………………. 9 3.1.1 Pagkumpara sa operasyon …………………………………………………………………………… 9 3.1.2 Pagdumala sa opsyonal nga mga bili sa elemento …………… ……………………………………………. 9 3.2 Opsyonal nga mga Feature ………………………………………………………………………………………. 10 3.2.1 Pagtul-id sa MSISDN ……………………………………………………………………………………… 10 3.2.2 Pagpuli sa Karakter ……………………… ……………………………………………………….. 11 3.3 Ipadala ang hangyo ………………………………………………………………… ………………………………… 11 3.4 Ipadala ang hangyo sa text …………………………………………………………………………… …. 15 3.5 Ipadala ang tubag ……………………………………………………………………………………… 18 3.6 Mga kodigo sa pagtubag ………………… ………………………………………………………………… 19 3.7 Panahon sa pagbasa……………………………………………………… …………………………………………… 20 3.8 Pagdawat sa report sa pagpadala………………………………………………………………………… ….. 20 3.9 Pag-ila sa Service Provider………………………………………………………………………….. 23 3.10 Sulayi Pag-usab ………………………………… ………………………………………………………………… 24 3.11 Usa ka komento sa sulod sa mensahe sa SMS …………………………………………… …… 26
4. Pagpatuman examples………………………………………………………….. 27 5. GSM nga mga talaan sa karakter …………………………………………… ………………….. 28
5.1 GSM default alphabet table (7-bit) …………………………………………………………………. 28 5.2 GSM default alphabet extension table (7-bit)…………………………………………………….. 29 6. Mga acronym ug abbreviation……………………………… ………………………. 30 7. Mga Reperensya ……………………………………………………………………………………… 30

Pag-usab sa Personalized nga Komunikasyon

2

Kasangkaran sa Dokumento
Kini nga dokumento naghulagway kung giunsa pagpadala sa Service Provider ang mga mensahe sa SMS pinaagi sa LINK Mobility. Gituyo kini alang sa mga teknikal nga arkitekto ug tigdesinyo nga nagpatuman sa mga serbisyo sa Service Provider.

Pag-usab sa Personalized nga Komunikasyon

3

1. Functional Overview
Ang sistema sa LINK Mobility naghatag sa mosunod nga batakang kagamitan alang sa mga mensahe sa SMS:
· Pagpadala sa Mobile Terminated (MT) SMS nga mga mensahe, sama sa text o binary (eg WAP Push) premium ug standard rate nga mga mensahe.
· Pagdawat sa mga taho sa pagpadala alang sa gisumite nga mga mensahe sa MT. · Pagdawat sa Mobile Originated (MO) SMS nga mga mensahe, premium ug standard
rate.
Ang SMS Messaging API gipahinungod sa pagpadala sa standard rate MT SMS nga mga mensahe. Ang API nagpadala sa tanang mga mensahe sa SMS nga asynchronous, nga makapahimo sa mga feature sama sa:
· "Pagsunog-ug-kalimti" ang Service Provider gusto nga adunay mas matag-an nga mga oras sa pagtubag ug dili gusto nga maghulat sa resulta gikan sa Operator.
· Sulayi pag-usab ang LINK Mobility ipadala pag-usab ang mensahe kung ang Operator adunay temporaryo nga mga problema.
Ang dugang nga impormasyon bahin sa pagdawat sa MO SMS nga mga mensahe o pagpadala sa premium nga MT SMS nga mga mensahe makita dinhi. Anaa usab ang usa ka utility SMS API, nga adunay daghang gipasimple nga operasyon sa pagpadala sa mga mensahe sa SMS, pananglitan sa WAP push.
Ang dugang nga impormasyon bahin niini nga mga API gihatag sa LINK Mobility nga suporta kung gihangyo.
1.1 Pagpadala ug SMS nga mensahe

Tighatag sa Serbisyo

Netsize

1. Ipadala ang MT nga mensahe

Konsyumer

2. Ibalik ang message ID

3. Isumite ang SMS nga mensahe

4. Ihatag ang report sa paghatod

5. Ipadala ang report sa pagpadala

Pag-usab sa Personalized nga Komunikasyon

4

Ang sukaranan nga dagan sa pagpadala sa mga mensahe sa SMS gihulagway ingon sa mosunod:
1. Ang Service Provider mohimo ug hangyo nga magpadala ug SMS nga mensahe ngadto sa nakadawat pinaagi sa LINK Mobility system.
2. Usa ka ID sa mensahe ang gibalik sa Service Provider. Kini nga ID mahimong gamiton alang sa pananglitan sa pag-correlate sa mensahe sa husto nga report sa paghatud.
3. Ang LINK Mobility nagdumala sa ruta ug naghatud sa mensahe sa SMS ngadto sa gitumong nga Konsyumer.
Ang Lakang 4 ug 5 ipatuman kung ang Service Provider nangayo ug report sa pagpadala sa lakang 1.
4. Usa ka report sa paghatud ang ma-trigger, pananglitan kung ang mensahe sa SMS ipadala sa aparato sa Consumer.
5. Ang report sa paghatod ipadala ngadto sa Service Provider. Ang report adunay parehas nga ID sa mensahe nga gibalik sa lakang 2.
Alternatibong dagan: Dili balido nga hangyo
Kung ang gihatag nga mga parameter o mga kredensyal sa tiggamit sa hangyo (lakang 1) dili balido usa ka sayup ang ibalik sa Service Provider. Ang sayup nagpakita sa hinungdan sa pagsalikway ug ang pag-agos natapos. Walay message ID nga gibalik.

Pag-usab sa Personalized nga Komunikasyon

5

1.2 Pagpadala ug SMS nga mensahe sa daghang mga nakadawat

Tighatag sa Serbisyo

Netsize

1. Ipadala ang MT nga mensahe

Konsyumer

2. Ibalik ang mga ID sa mensahe

3.1. Isumite ang SMS nga mensahe #1

3.2. Isumite ang SMS nga mensahe #2

3.n. Isumite ang SMS nga mensahe #n

5.1. Ipadala ang report sa pagpadala #1 5.2. Ipadala ang delivery report #2 5.n. Ipadala ang delivery report #n

4.1. Ihatag ang report sa paghatud #1 4.2. Ihatag ang report sa paghatod #2 4.n. Ihatag ang report sa paghatud #n

Ang sistema sa LINK Mobility nagsuporta sa pagpadala sa usa ka standard rate nga mensahe sa SMS ngadto sa daghang mga nakadawat sa usa ka lista sa pag-apod-apod. Ang sukaranan nga dagan gihulagway ingon sa mosunod:
1. Ang Service Provider mohimo ug hangyo nga magpadala ug standard rate nga SMS nga mensahe ngadto sa daghang mga nakadawat pinaagi sa LINK Mobility system.
2. Ang LINK Mobility system nag-validate sa SMS message syntax, ang mga nakadawat ug mga rota sa matag SMS message sa dili pa ibalik ang message IDs ngadto sa Service Provider.
3. Ang LINK Mobility nagsumite ug usa ka mensahe sa SMS sa matag usa sa gitumong nga mga Konsyumer. Ang sistema sa LINK Mobility mosulay sa pagpadala pag-usab sa mensahe sa SMS kung makadawat og tubag sa sayup nga giklasipikar nga temporaryo. Ang LINK Mobility mosulay sa pagpadala pag-usab sa SMS nga mensahe hangtod nga kini mo-expire o ang LINK Mobility maximum retry limit naabot na.
Ang Lakang 4 ug 5 ipatuman kung ang Service Provider nangayo ug report sa pagpadala sa lakang 1.
4. Usa ka report sa pagpadala ang ma-trigger, pananglitan kung ang mensahe sa SMS ipadala sa mobile station sa Consumer.

Pag-usab sa Personalized nga Komunikasyon

6

5. Ang report sa paghatud gipadala ngadto sa Service Provider, nga adunay parehas nga ID sa mensahe nga gibalik sa lakang 2.
Girekomendar pag-ayo ang paghangyo sa mga taho sa pagpadala aron mapamatud-an nga ang mga Konsyumer nakadawat sa ilang mensahe sa SMS nga malampuson.
2. Pag-instalar
Ang LINK Mobility naghatag ug API nga gibutyag isip a web serbisyo nga adunay SOAP interfaceii. Ang SOAP protocol ug ang Link Mobility server kay independente sa plataporma nga gigamit sa Service Provider, bisan tuod ang pag-instalar sa SOAP tools mahimong lahi. Ang web service API gihulagway sa WSDLiii.
Para sa mga dili pamilyar web mga serbisyo, ang LINK Mobility naghatag usab usa ka set sa mga klase sa Java nga namugna gikan sa web serbisyo WSDL paghulagway. Kini nga mga klase gihatag sa suporta sa Link Mobility kung gihangyo.
2.1 Interoperability
Bisan pa web Ang mga serbisyo mahimong interoperable sa lainlaing mga platform sa teorya, usahay mahitabo nga ang balangkas sa server ug balangkas sa kliyente dili magkatugma. Aron masiguro ang interoperability sa mga platform, LINK Mobility web ang mga serbisyo gitukod ug gipamatud-an sumala sa mga rekomendasyon sa Web Services Interoperability Organization, WS-Iiv.
WS-Ako nagkinahanglan sa usa ka web serbisyo sa pagsuporta sa UTF-8 ug UTF-16-character set. Gisuportahan sa Link Mobility ang duha, apan girekomenda nga gamiton ang UTF-8.
Tanan nga LINK Mobility web ang mga serbisyo napamatud-an sa mga mosunud nga plataporma:
· Java · .NET · PHP · Perl · ASP · Ruby · Python
2.2 Web serbisyo

Pag-usab sa Personalized nga Komunikasyon

7

Ang web serbisyo URL ug ang nahimutangan sa WSDL file gihatag sa suporta sa LINK Mobility kung gihangyo.
2.3 Seguridad
Nagpadala mga hangyo
Para sa authentication, ang user ID ug password sa Service Provider gisumite sa matag web pag-ampo sa serbisyo. Responsibilidad sa Service Provider ang paghupot niining user ID ug password nga protektado.
Alang sa seguridad sa koneksyon, ang LINK Mobility kusganong nagrekomenda sa paggamit sa HTTPS kung nag-access sa LINL Mobility web serbisyo. Ang sertipiko sa LINK Mobility server gipirmahan sa Thawte Server CA.
Dugang pa, girekomenda nga gamiton ang LINK Mobility firewall alang sa pagbabag sa wala mailhi nga mga adres sa IP gikan sa pag-access sa account sa Service Provider. Kontaka ang LINK Mobility nga suporta alang sa dugang nga impormasyon.
Palihug timan-i nga ang HTTP gisuportahan alang sa atrasado nga mga hinungdan sa pagkaangay lamang ug tangtangon sa umaabot.
Pagdawat sa mga taho sa pagpadala
Para sa authentication, girekomendar nga ang Service Provider mogamit: · Basic authentication para sa access ngadto sa ilang web server. · Usa ka firewall, pagsiguro nga ang mga hangyo lamang gikan sa LINK Mobility ang gitugotan.
Para sa seguridad sa koneksyon, girekomendar nga ang Service Provider mogamit: · HTTPS para sa access ngadto sa ilang web server.
Ang HTTPS sa lugar sa Service Provider mahimong magamit nga hapsay, nga naghatag nga ang sertipiko sa web server gipirmahan sa usa ka gamut CA certificate nga gilakip sa listahan sa kasaligan nga CA certificatesv.
3. SMS message integration uban sa LINK Mobility

Pag-usab sa Personalized nga Komunikasyon

8

3.1 Pagpadala sa mga mensahe sa SMS
Ang Service Provider makapadala ug mga mensahe sa SMS ngadto sa ilang mga Konsyumer pinaagi sa LINK Mobility, gamit ang SMS web service API sama sa gihulagway niini nga kapitulo.
Pagpatuman exampAng mga leksyon kung unsaon pag-integrate sa LINK Mobility sa lain-laing mga programming language makita sa kapitulo 4.
3.1.1 Pagtandi sa operasyon
Ang SMS Messaging API naghubit sa duha ka lainlaing mga operasyon: usa ka hangyo sa pagpadala ug usa ka hangyo sa pagpadala sa text. Kini nga subseksiyon naghatag ug labawview sa pagpaandar nga gihatag sa duha ka mga operasyon ug mga high-light importante nga mga kalainan.
Ang hangyo sa pagpadala gitumong ngadto sa mas abante nga mga kaso sa paggamit diin ang Service Provider adunay kinatibuk-ang kontrol sa pag-format sa mensahe lakip na ang user data header. Gisuportahan niini ang GSM Default, Unicode, ug binary Data Coding Schemes. Ang Service Provider makapadala ug concatenated nga mga mensahe, apan ang pag-andam sa user data ug user data header kinahanglan nga himoon sa Service Provider ug ang mensahe kinahanglang ipadala pinaagi sa multiple send requests ngadto sa LINK Mobility.
Ang hangyo sa pagpadala sa text nagtuo nga ang teksto sa mensahe adunay mga karakter gikan sa default nga alpabeto sa GSM lakip ang lamesa sa extension o alpabeto sa Unicode. Ang Data Coding Scheme awtomatik nga makita sa LINK Mobility pinaagi sa pagsusi sa sulod sa text message. Awtomatikong paghugpong sa usa ka mensahe ngadto sa daghang mga mensahe gisuportahan hangtod sa gitakda sa Service Provider nga maximum limit.
Mahimong gikinahanglan ang pagdugtong kung ang gitas-on sa text sa mensahe molapas sa maximum nga gitas-on nga gisuportahan sa Data Coding Scheme nga gigamit sa text sa mensahe.
3.1.2Pagdumala sa opsyonal nga mga bili sa elemento
Palihog obserbahan nga para sa interoperability nga mga katuyoan, ang tanang XML nga mga elemento sa mga hangyo ug mga tubag kay mandatory sumala sa XML nga kahulugan, ie kinahanglan nga anaa. Ang notasyon alang sa pagtino sa usa ka opsyonal nga bili mao ang:
· Para sa integer nga kantidad: -1

Pag-usab sa Personalized nga Komunikasyon

9

· Para sa string values: #NULL#
Mahinungdanon nga timan-an nga ang mga kantidad sa wala gibalewala nga mga elemento kinahanglan nga itakda sa mga kantidad nga gipahayag sa katugbang nga komento hangtod ang elemento gisuportahan. Kini aron masiguro ang pagpahiuyon sa unahan sa LINK Mobility.

3.2 Opsyonal nga mga Feature 3.2.1MSISDN Correction
Ang pagtul-id sa MSISDN usa ka opsyonal nga bahin nga mahimo pinaagi sa suporta sa LINK Mobility kung gihangyo.

Kini nga bahin magtul-id sa mga adres sa destinasyon ug ipahiangay kini sa gikinahanglan nga E.164 format. Dugang sa pagkorihir sa pormat, ang sistema mahimo usab nga mopahigayon sa espesipikong merkado sama sa paghubad sa internasyonal nga French nga mga numero aron matul-id ang DOM-TOM (départements et territoires d'outre-mer) nga mga numero kung magamit.

Sa ubos adunay daghang mga exampmga pagkorihir:

Gisumite nga Destinasyon nga Address +46(0)702233445 (0046)72233445 +460702233445 46(0)702233445 46070-2233445 0046702233445 +46 +0 +702233445

Gitul-id nga Address sa Destinasyon 46702233445 46702233445 46702233445 46702233445 46702233445 46702233445 46702233445 2626005199999 XNUMX XNUMX XNUMX XNUMX

Dugang pa, posible nga tugutan ang nasyonal nga mga numero sa telepono alang sa usa ka pinili nga merkado. Sa diha nga kini nga bahin mahimo nga bisan unsa nga internasyonal nga mga numero alang sa ubang mga merkado kinahanglan nga ipadala uban sa usa ka inisyal nga `+' ilhanan aron sa pag-ila kanila gikan sa pinili nga merkado.

Sa ubos adunay daghang mga exampmga pagkorihir nga gihimo sa paggamit sa Sweden (country code 46) isip default nga merkado alang sa nasudnong mga numero.

Gisumite nga Destinasyon nga Address 0702233445 070-2233 445 070.2233.4455 460702233445 +460702233445 +458022334455 45802233445

Gitul-id nga Address sa Destinasyon 46702233445 46702233445 46702233445 46702233445 46702233445 458022334455 Dili balido tungod kay nawala ang karatula nga `+'

Pag-usab sa Personalized nga Komunikasyon

10

Timan-i nga ang gitul-id nga MSISDN gamiton sa LINK Mobility ug kini ibalik sa mga report sa paghatud.
Palihug kontaka ang LINK Mobility nga suporta alang sa dugang nga impormasyon.
3.2.2 Pagpuli sa Karakter
Ang pagpuli sa karakter usa ka opsyonal nga bahin nga mahimo pinaagi sa suporta sa LINK Mobility kung gihangyo.
Kini nga feature maghubad sa dili-GSM alphabet nga mga karakter sa user data (SMS text) ngadto sa katumbas nga GSM alphabet characters kon ang DCS itakda sa “GSM” (17). Kay example “Seqüência de teste em Português” hubaron sa “Seqüencia de teste em Portugues”.
Palihug kontaka ang LINK Mobility nga suporta alang sa dugang nga impormasyon.
3.3 Ipadala ang hangyo
Ang elemento sa hangyo sa pagpadala giporma sama sa mosunod:

Pag-usab sa Personalized nga Komunikasyon

11

Ang send request child nga mga elemento gidumala sa LINK Mobility sama sa mosunod:

Element correlationId
gigikanan ngaAddress

Type String
String

M/O/I* Default nga Bili^

O

­

O

Ang sistema itakda

bili kon

gi-configure ug

gisuportahan.

Max nga gitas-on 100
16

Deskripsyon
Correlation ID aron masubay ang mga hangyo ug tubag sa SOAP, sumala sa rekomendasyon sa WS-I. Gipalanog sa server ang gihatag nga kantidad. Dugang pa, ang correlation ID mahimong gamiton isip external ID tungod kay iapil kini sa DR ug tipigan uban sa datos sa transaksyon. Timan-i nga ang pagdili bahin sa gitugotan nga mga karakter mahimong magamit. Ang gigikanan nga adres alang sa mogawas nga mensahe sa SMS. Ang tipo sa gigikanan nga adres gihubit sa parameter sa orginatorTON. Mubo nga numero max nga gitas-on mao ang 16. Ang alpha numeric sender limitado sa GSM default nga Alphabet nga adunay max nga gitas-on nga 11 ka karakter.

Pag-usab sa Personalized nga Komunikasyon

12

tagmugnaTON

Integer O

destinasyonAddress String

M

userData userDataHeader

String

O

String

O

DCS

integer O

PID

integer O

relativeValidityTime integer O

oras sa pagpadala

String

O

Ang sistema magbutang og bili kung gi-configure ug gisuportahan.
­
Walay sulod nga mensahe Walay user data header 17 0 172800 (48 ka oras) Diha-diha dayon

1
40(*)
280 280 3 3 9 25

Ang max nga gitas-on sa nagpadala sa MSISDN mao ang 15 (gamit ang parehas nga format sa elemento sa destinationAddress). Mahimong itakda sa #NULL# kung ang originatingAddress ug originatingTON gipili sa sistema. Kini nga function nagsalig sa merkado ug configuration. Para sa dugang nga impormasyon, palihog kontaka ang LINK Mobility nga suporta. Mahimong magkalainlain ang pamatasan sa mga integrasyon sa Operator. Ang tipo sa numero sa gigikanan nga adres (TON): 0 Mubo nga numero 1 Alpha numeric (maximum nga gitas-on 11) 2 MSISDN Mahimong itakda sa -1 kung kanus-a ang gigikananAddress ug gigikanan ngaTON ang pilion sa sistema. Kini nga function nagsalig sa merkado ug configuration. Para sa dugang nga impormasyon, palihog kontaka ang LINK Mobility nga suporta. Mahimong magkalainlain ang pamatasan sa mga integrasyon sa Operator. Ang MSISDN diin ang mensahe sa SMS kinahanglan ipadala, sugod sa code sa nasud. Example: 46762050312. Alang sa pipila ka mga merkado (diin ang Consumer MSISDN kinahanglan nga obfuscated) kini nga bili mahimo usab nga usa ka alphanumeric alias, prefixed sa "#".
Ang pagpadala sa mensahe sa SMS ngadto sa daghang nakadawat gisuportahan pinaagi sa paghatag og listahan sa pag-apod-apod sa semi-colon nga gibulag nga mga MSISDN (eg 46762050312;46762050313). Ang mga nakadawat kinahanglan nga talagsaon sa sulod sa usa ka lista ug ang lista sa pag-apod-apod limitado sa 1000 nga mga entri. (*) Ang kantidad sa max nga gitas-on dili magamit alang sa mga lista sa pag-apod-apod. Ang sulod sa mensahe sa SMS. Ang Ulohan sa Data sa Gumagamit kauban ang Data sa Gumagamit mahimong adunay hangtod sa 140, ie 280 kung gi-encode ang hex, mga octet. Kini nga parameter kanunay nga hex-encoded. Data coding scheme. Mahimong magkalainlain ang pamatasan sa mga integrasyon sa Operator. Protocol ID. Mahimong magkalainlain ang pamatasan sa mga integrasyon sa Operator. Relatibo nga oras sa balido sa mga segundo (relasyon sa oras sa pagsumite sa LINK Mobility). Mahimong magkalainlain ang pamatasan sa mga integrasyon sa Operator. Ang mensahe sa SMS mahimong ipadala sa nalangan nga oras sa pagpadala. Format: yyyy-MM-dd HH:mm:ss Z, example: 2000-01-01 01:01:01 ­0000.

Pag-usab sa Personalized nga Komunikasyon

13

statusReportFlags

integer O

0

Ngalan sa account

String

O

Sumala sa

asoy

configuration

referenceId serviceMetaData

String

O

­

String

O

Walay value set

campaignName

String

O

­

username

String

M

­

password

String

M

­

* M = Mandatory, O = Opsyonal, I = Wala tagda.

1
50
150 1000 50 64 64

Mahimong magkalainlain ang pamatasan sa mga integrasyon sa Operator. Ihatag ang hangyo sa report: 0 Walay delivery report 1 Delivery report gihangyo 9 Server delivery report gihangyo (LINK Mobility dili ipasa ang report ngadto sa Service Provider apan gihimo kini nga anaa sa mga report ug uban pa) Kini nga field nagtugot sa LINK Mobility sa pagruta sa mga mensahe sa SMS sa usa ka flexible paagi, nga mahimo o dili espesipiko sa Service Provider. Alang sa normal nga paggamit, ang #NULL# kinahanglan ihatag. Mubo nga sulat: Ang paggamit niini nga natad kinahanglang itagana sa LINK Mobility. Alang niini nga API kasagaran usa ka message ID sa a web opt-in pag-order sa MO SMS nga mensahe. Ang serbisyo sa meta data. Ibutang sa #NULL# kung wala gigamit o wala gisuportahan sa merkado. Kini ang piho nga impormasyon sa merkado. Para sa dugang nga impormasyon, palihog kontaka ang LINK Mobility nga suporta. Ang mga transaksyon sa LINK Mobility mao ang tagged uban niini nga ngalan. Gigamit kini sa paggrupo sa mga transaksyon sa mga taho sa LINK Mobility. Ibutang sa #NULL# kung wala gigamit. Ang username sa Service Provider, nga gihatag sa LINK Mobility. Ang password sa Service Provider, nga gihatag sa LINK Mobility.

^ Ang default nga kantidad gigamit kung ang usa ka elemento nga kantidad gibutang sa null.

Pag-usab sa Personalized nga Komunikasyon

14

3.4 Ipadala ang hangyo sa text
Ang elemento sa hangyo sa pagpadala giporma sama sa mosunod:

Ang Send text request child nga mga elemento gidumala sa LINK Mobility sama sa mosunod:

Element correlationId

Type String

originatingAddress String

M/O/I* Default nga Bili^

O

­

O

Ang sistema itakda

bili kon

gi-configure ug

gisuportahan.

Max nga gitas-on 100
16

Deskripsyon
Correlation ID aron masubay ang mga hangyo ug tubag sa SOAP, sumala sa rekomendasyon sa WS-I. Gipalanog sa server ang gihatag nga kantidad. Dugang pa, ang correlation ID mahimong gamiton isip external ID tungod kay iapil kini sa DR ug tipigan uban sa datos sa transaksyon. Timan-i nga ang pagdili bahin sa gitugotan nga mga karakter mahimong magamit. Ang gigikanan nga adres alang sa mogawas nga mensahe sa SMS. Ang tipo sa gigikanan nga adres gihubit sa parameter sa orginatorTON.

Pag-usab sa Personalized nga Komunikasyon

15

tagmugnaTON

Integer O

destinasyonAddress String

M

mensaheText

String

M

maxConcatenatedM integer O essages

PID

integer O

relativeValidityTime integer O

Ang sistema magbutang og bili kung gi-configure ug gisuportahan.
­
Walay sulod nga mensahe 3 0 172800 (48 ka oras)

1
40(*)
39015 3 3 9

Mubo nga numero max nga gitas-on mao ang 16. Ang alpha numeric sender limitado sa GSM default nga Alphabet nga adunay max nga gitas-on nga 11 ka karakter. Ang max nga gitas-on sa nagpadala sa MSISDN mao ang 15 (gamit ang parehas nga format sa elemento sa destinationAddress). Mahimong itakda sa #NULL# kung ang originatingAddress ug originatingTON gipili sa sistema. Kini nga function nagsalig sa merkado ug configuration. Para sa dugang nga impormasyon, palihog kontaka ang LINK Mobility nga suporta. Mahimong magkalainlain ang pamatasan sa mga integrasyon sa Operator. Ang tipo sa numero sa gigikanan nga adres (TON): 0 Mubo nga numero 1 Alpha numeric (maximum nga gitas-on 11) 2 MSISDN Mahimong itakda sa -1 kung kanus-a ang gigikananAddress ug gigikanan ngaTON ang pilion sa sistema. Kini nga function nagsalig sa merkado ug configuration. Para sa dugang nga impormasyon, palihog kontaka ang LINK Mobility nga suporta. Mahimong magkalainlain ang pamatasan sa mga integrasyon sa Operator. Ang MSISDN diin ang mensahe sa SMS kinahanglan ipadala, sugod sa code sa nasud. Example: 46762050312. Alang sa pipila ka mga merkado (diin ang Consumer MSISDN kinahanglan nga obfuscated) kini nga bili mahimo usab nga usa ka alphanumeric alias, prefixed sa "#".
Ang pagpadala sa mensahe sa SMS ngadto sa daghang nakadawat gisuportahan pinaagi sa paghatag og listahan sa pag-apod-apod sa semi-colon nga gibulag nga mga MSISDN (eg 46762050312;46762050313). Ang mga nakadawat kinahanglan nga talagsaon sa sulod sa usa ka lista ug ang lista sa pag-apod-apod limitado sa 1000 nga mga entri. (*) Ang kantidad sa max nga gitas-on dili magamit alang sa mga lista sa pag-apod-apod. Ang sulod sa mensahe sa SMS. Ang Data Coding Scheme kay auto detected. Gisuportahan nga mga laraw mao ang GSM 7-bit, o UCS-2. Usa ka bili tali sa 1 ug 255 diin ang bili naghubit kon pila ka gidugtong nga mga mensahe ang madawat. Kung ang gidaghanon sa mga concatenated nga mga mensahe molapas niini nga kantidad ang hangyo mapakyas. Protocol ID. Mahimong magkalainlain ang pamatasan sa mga integrasyon sa Operator. Relatibo nga oras sa balido sa mga segundo (relasyon sa oras sa pagsumite sa LINK Mobility).

Pag-usab sa Personalized nga Komunikasyon

16

oras sa pagpadala

String

O

Diha-diha dayon

statusReportFlags

Integer O

0

Ngalan sa account

String

O

Sumala sa configuration sa account

referenceId serviceMetaData

String

O

String

O

Walay value set

campaignName

String

O

­

username

String

M

­

password

String

M

­

* M = Mandatory, O = Opsyonal, I = Wala tagda.

25
1
50
150 1000 50 64 64

Mahimong magkalainlain ang pamatasan sa mga integrasyon sa Operator. Ang mensahe sa SMS mahimong ipadala sa nalangan nga oras sa pagpadala. Format: yyyy-MM-dd HH:mm:ss Z, example: 2000-01-01 01:01:01 0000. Ang pamatasan mahimong magkalainlain sa mga integrasyon sa Operator. Ihatag ang hangyo sa report: 0 Walay delivery report 1 Delivery report gihangyo 9 Server delivery report gihangyo (LINK Mobility dili ipasa ang report ngadto sa Service Provider apan gihimo kini nga anaa sa mga report ug uban pa) Kini nga field nagtugot sa LINK Mobility sa pagruta sa mga mensahe sa SMS sa usa ka flexible paagi, nga mahimo o dili espesipiko sa Service Provider. Alang sa normal nga paggamit, ang #NULL# kinahanglan ihatag. Mubo nga sulat: Ang paggamit niini nga natad kinahanglang itagana sa LINK Mobility. Alang niini nga API kasagaran usa ka message ID sa a web opt-in pag-order sa MO SMS nga mensahe. Ang serbisyo sa meta data. Ibutang sa #NULL# kung wala gigamit o wala gisuportahan sa merkado. Kini ang piho nga impormasyon sa merkado. Para sa dugang nga impormasyon, palihog kontaka ang LINK Mobility nga suporta. Ang mga transaksyon sa LINK Mobility mao ang tagged uban niini nga ngalan. Gigamit kini sa paggrupo sa mga transaksyon sa mga taho sa Link Mobility. Ibutang sa #NULL# kung dili gamiton. Ang username sa Service Provider, nga gihatag sa LINK Mobility. Ang password sa Service Provider, nga gihatag sa LINK Mobility.

^ Ang default nga kantidad gigamit kung ang usa ka elemento nga kantidad gibutang sa null.

Pag-usab sa Personalized nga Komunikasyon

17

3.5 Ipadala ang tubag
Ang elemento sa pagpadala tubag giporma sama sa mosunod:

Ang tubag sa pagpadala gigamit alang sa hangyo sa pagpadala ug hangyo sa pagpadala sa text.

Ang send response child nga mga elemento gidumala sa LINK Mobility sama sa mosunod:

Element correlationId messageDetails
tubagCode

Type
string list sa messa geDetai l integer

M/O/I* OM
M

Default nga Bili ^
­

Max gitas-on 100 1000 elemento
5

tubagMensahe string M

­

200

* M = Mandatory, O = Opsyonal, I = Wala tagda. ^ Ang default nga kantidad gigamit kung ang usa ka elemento nga kantidad gibutang sa null.

Deskripsyon
Gipalanog nga hangyo sa correlation ID. Listahan sa LINK Mobility talagsaon nga message ID ug response code alang sa malampuson o partial nga malampuson nga transaksyon, walay sulod nga listahan sa kapakyasan. LINK Ang kodigo sa pagtubag sa Mobility 0 nagpaila sa malampuson nga transaksyon. Ang kodigo sa tubag 50 nagpaila sa usa ka bahin nga malampuson nga transaksyon; labing menos usa ka mensahe ang gipadala sa usa ka nakadawat, tan-awa ang Mga Detalye sa mensahe alang sa indibidwal nga mga code sa tubag matag nakadawat. Ang bisan unsang ubang error code nagpaila sa hingpit nga kapakyasan sa pagpadala. Tan-awa ang separado nga lamesa para sa kompleto nga lista sa mga response code. Deskripsyon sa teksto sa tubag, pananglitan sa sayup nga teksto.

Pag-usab sa Personalized nga Komunikasyon

18

Ang messageDetail nga mga elemento sa bata gidumala sa LINK Mobility sama sa mosunod:

elemento
destinasyonAddress messageIds

Type
hilo nga hilo

M/O/I*
Si MM

Default nga Bili ^
­ ­

tubagCode

integer nga M

­

tubagMensahe

String

M

­

* M = Mandatory, O = Opsyonal, I = Wala tagda.

Max nga gitas-on 40 5864
5
200

Deskripsyon
Gipalanog nga hangyo nga destinasyonAddress. LINK Mobility talagsaon nga mensahe ID alang sa malampuson nga transaksyon, walay sulod nga pisi sa kapakyasan. Daghang mga ID sa mensahe ang gibalik kung ang mensahe gidugtong. Ang mga ID sa mensahe kay semi-colon nga gibulag. Alang sa pipila ka mga kahimtang sa sayup usa ka walay sulod nga lista ang gibalik. LINK Ang kodigo sa pagtubag sa Mobility 0 nagpaila sa malampuson nga transaksyon. Tan-awa ang separado nga lamesa para sa kompleto nga lista sa mga response code. PAHINUMDOM: Ang tubag nga kodigo 0 nagpakita nga ang mensahe gikatakda alang sa paghatod, dili kay ang malampusong paghatod nahimo. Deskripsyon sa teksto sa tubag, pananglitan sa sayup nga teksto.

^ Ang default nga kantidad gigamit kung ang usa ka elemento nga kantidad gibutang sa null.

3.6 Mga kodigo sa pagtubag
Ang mosunod nga mga kodigo sa tubag mahimong ibalik sa tubag sa pagpadala:

Kodigo 0 1 2 3 4 5 6 7 8 9

Kalamposan sa Teksto Dili balido nga pag-login o dili awtorisado nga paggamit sa API Gibabagan ang konsumedor sa Link Mobility Ang operasyon wala gihatag sa Link Mobility Ang konsumedor wala mailhi sa Link Mobility Consumer gibabagan kini nga serbisyo sa Link Mobility Ang gigikanan nga adres wala gisuportahan nga gigikanan sa Alpha nga adres nga wala gisuportahan sa account MSISDN gigikanan nga adres dili suportado GSM gipalugway dili suportado

Deskripsyon Malampusong gipatuman. Ang sayop nga username o password o Service Provider gidid-an sa LINK Mobility. Ang Consumer gibabagan sa LINK Mobility.
Ang operasyon gibabagan para sa Service Provider.
Ang Consumer wala mailhi sa LINK Mobility. O kung gigamit ang alyas sa hangyo; wala makit-an ang alyas. Gibabagan sa Consumer kini nga serbisyo sa Link Mobility.
Ang gigikanan nga adres wala gisuportahan.
Ang alpha nga gigikanan nga adres wala gisuportahan sa account.
Dili suportado ang gigikanang adres sa MSISDN.
GSM extended dili suportado.

Pag-usab sa Personalized nga Komunikasyon

19

10

Unicode dili suportado

Unicode dili suportado.

11

Ang taho sa kahimtang wala gisuportahan

Ang taho sa kahimtang wala gisuportahan.

12

Gikinahanglan nga kapabilidad dili

Ang gikinahanglan nga kapabilidad (gawas sa naa sa ibabaw) para sa pagpadala sa mensahe

gisuportahan

wala gisuportahan.

13

Ang content provider max

Ang Service Provider nagpadala usab sa mga mensahe sa SMS ngadto sa LINK Mobility

nalapas na ang throttling rate

paspas.

14

Protocol ID dili suportado sa

Ang Protocol ID wala gisuportahan.

asoy

15

Limitasyon sa pagdugtong sa mensahe

Ang gidaghanon sa mga gisumpay-sumpay nga mga mensahe milapas sa max nga gidaghanon

milapas

gihangyo.

16

Dili madala ang mensahe

Ang LINK Mobility wala makahimo sa pagruta sa mensahe.

17

Gidili nga yugto sa panahon

Dili tugotan nga magpadala og mensahe sa panahon

18

Ubos kaayo nga balanse sa serbisyo

Ang service provider gibabagan tungod sa Sobra low balance

account sa provider

50

Partial nga kalampusan

Partial nga kalampusan kung magpadala usa ka mensahe sa SMS sa daghang mga nakadawat.

99

Sayop sa internal nga server

Uban pang sayup sa LINK Mobility, kontaka ang suporta sa LINK Mobility alang sa dugang

impormasyon.

100

Dili balido nga adres sa destinasyon

Ang destinasyon nga adres (MSISDN, o alyas) dili balido.

102

Dili balido nga reference (nalambigit) ID

Ang reference ID dili balido, tingali ang reference ID gigamit na, usab

tigulang o wala mailhi.

103

Dili balido nga ngalan sa account

Ang ngalan sa account dili balido.

105

Dili balido nga meta data sa serbisyo

Ang meta data sa serbisyo dili balido.

106

Dili balido nga gigikanan nga adres

Ang gigikanan nga adres dili balido.

107

Dili balido nga gigikanan sa alphanumeric Ang gigikanan nga adres nga alphanumeric dili balido.

adres

108

Dili balido nga panahon

Ang balido nga oras dili balido.

109

Dili balido nga oras sa pagpadala

Ang oras sa pagpadala dili balido.

110

Dili balido nga sulud sa mensahe / tiggamit

Ang data sa tiggamit, ie ang mensahe sa SMS, dili balido.

datos

111

Dili balido ang gitas-on sa mensahe

Dili balido ang gitas-on sa mensahe sa SMS.

112

Dili balido nga header sa datos sa tiggamit

Ang header sa data sa tiggamit dili balido.

113

Dili balido nga data coding scheme

Ang DCS dili balido.

114

Dili balido nga protocol ID

Ang PID dili balido.

115

Dili balido nga mga bandera sa report sa status

Ang mga bandera sa status report dili balido.

116

Dili balido nga TON

Ang nagmugna nga TON dili balido.

117

Dili balido campaign ngalan

Ang campAng ngalan sa aign dili balido.

120

Dili balido nga limitasyon sa maximum

Dili balido ang kinatas-an nga gidaghanon sa mga gidugtong nga mensahe.

gidaghanon sa concatenated

mga mensahe

121

Dili balido nga msisdn nga gigikanan

Dili balido ang gigikanang adres sa MSISDN.

adres

122

Dili balido nga correlation ID

Ang correlation ID dili balido.

3.7 Basaha ang timeout
Tungod kay ang mga invocation sa Link Mobility APIs kasagarang moresulta sa LINK Mobility nga nag-invoke sa ubang external system, sama sa Operator payment systems ug SMSCs, girekomendar nga ang Service Provider mogamit ug medyo taas nga read timeout. Gitambagan ang usa ka timeout sa pagbasa nga 10 minuto alang sa mga hangyo sa HTTP. Ang paggamit niini nga timeout magdumala bisan sa labing kadaghan nga mga kaso sa oras sa pagbasa.

3.8 Pagdawat sa report sa pagpadala
Ang Service Provider mahimo, kon mahatag, makapangayo ug SMS message delivery reports o delivery notifications para sa MT messages nga gipadala. Kini nga mga taho gi-trigger sa

Pag-usab sa Personalized nga Komunikasyon

20

Operator SMSC kung ang MT nga mensahe ihatud sa gipunting nga Konsyumer o gitangtang, pananglitan na-expire o, tungod sa pipila ka hinungdan, dili ma-ruta. Katapusan ra nga kahimtang sa mensahe sa SMS ang gitaho sa Service Provider, ie gihatud o gitangtang. Usa ra ka taho matag mensahe sa MT ang nahimo. Uban sa natangtang nga status, ang usa ka rason nga code mahimong magamit. Kini nga rason nga code nagtino sa rason sa SMS nga mensahe nga wala ipadala.

Ang mga taho gipaagi sa Link Mobility ug gipadala sa Service Provider gamit ang HTTP protocol.

Aron makadawat og mga taho, ang Service Provider kinahanglan nga ipatuman alang sa exampusa ka Java Servlet o usa ka panid sa ASP.NET. Ang duha niini makadawat sa HTTP GET o POST nga mga hangyo.

Parameter

Ang hangyo naglakip sa mosunod nga mga parameter:

Parameter MessageId DestinationAddress StatusCode
Ang TimeStamp
Operator
RasonCode

I-type ang string string integer
hilo
hilo
integer

M/O /I*

Default nga Bili

Max nga gitas-on

Deskripsyon

M

­

22

Ang message ID sa mensahe sa MT

nga kini nga report katumbas sa.

M

­

40

Ang MSISDN sa Konsyumer, ie ang

destinasyon nga adres sa orihinal nga MT

mensahe.

M

1

Ang status code nagpakita sa status sa

MT nga mensahe.

Ang mga magamit nga status code mao ang:

0 Gihatud

2 – Gitangtang (rason code magamit)

M

­

20

Ang oras nga nagpakita kung kanus-a ang paghatud

report nadawat sa LINK Mobility.

Ang time zone sa orasamp mao ang CET

o CEST (nga adunay panahon sa ting-init sama sa gipasabut

alang sa EU).

Format: yyyyMMdd HH:mm:ss.

M

­

100

Ang ngalan sa Operator gigamit sa dihang

pagpadala sa mensahe sa SMS o sa

ngalan sa account nga gigamit sa pagpadala sa

SMS nga mensahe.

Usa ka lista sa magamit nga mga Operator gihatag

pinaagi sa LINK Mobility nga suporta.

O

­

3

Ang kodigo sa rason nagpakita ngano nga ang

mensahe natapos sa status

gipapas.

Ang magamit nga mga kodigo sa rason mao ang:
100 Na-expire 101 Gisalikway 102 Nasayop sa format 103 Ubang sayop 110 Wala mailhi ang subscriber 111 Gidili ang subscriber 112 Wala gi-provision ang subscriber 113 Dili magamit ang subscriber 120 Napakyas ang SMSC

Pag-usab sa Personalized nga Komunikasyon

21

OperatorTimeStamp

hilo

O

­

StatusText

hilo

O

­

CorrelationId

hilo

O

­

OperatorNetworkCode

integer O

­

* M = Mandatory, O = Opsyonal, I = Wala tagda.

121 SMSC kahuot

122 SMSC roaming

130 Kasaypanan sa handset

131 Milapas ang handset memory

Ang pamatasan mahimong magkalainlain sa Operator

mga panagsama.

20

Ang oras nga nagpakita kung kanus-a ang taho

na-trigger sa SMSC sa Operator

(kung gihatag sa Operator).

Ang time zone sa orasamp mao ang CET

o CEST (nga adunay panahon sa ting-init sama sa gipasabut

alang sa EU).

Format: yyyyMMdd HH:mm:ss.

255

Placeholder alang sa dugang nga impormasyon

gikan sa Operator, pananglitan tin-aw nga teksto

paghulagway sa kahimtang/rason.

Ang pamatasan mahimong magkalainlain sa Operator

mga panagsama.

100

Ang correlation ID nga gihatag sa

SendRequest o SendTextRequest.

6

Ang Mobile Network Code (MCC +

MNC) sa Operator.

Ang Service Provider kinahanglan maghatag LINK Mobility sa target URL alang sa mga taho sa paghatod (opsyonal nga naglakip sa mga kredensyal alang sa HTTP nga batakang pag-ila).

Makapili ang Service Provider kung unsa ang gusto nga pamaagi sa HTTP nga gamiton:

· HTTP POST (girekomenda) · HTTP GET.

Exampgamit ang HTTP GET (malampuson nga gihatag):
https://user:password@www.serviceprovider.com/receivereport? MessageId=122&DestinationAddress=46762050312&Operator=Vodafone&TimeSt amp=20100401%2007%3A47%3A44&StatusCode=0
Exampgamit ang HTTP GET (wala gihatod, ang Operator naghatag ug timestamp para sa panghitabo):
https://user:password@www.serviceprovider.com/receivereport?MessageId=123 &DestinationAddress=46762050312&Operator=Vodafone&OperatorTimeStamp=2 0100401%2007%3A47%3A59&TimeStamp=20100401%2007%3A47%3A51&Status Code=2&StatusText=Delivery%20failed&ReasonCode=10

Pag-usab sa Personalized nga Komunikasyon

22

Ang mga parameter mao ang URL gi-encodevi.
Pag-encode sa karakter:
Makapili ang Service Provider kung unsang gusto nga pag-encode sa karakter ang gamiton: · UTF-8 (girekomenda) · ISO-8859-1.
3.9 Pag-ila sa Taghatag sa Serbisyo
Kinahanglang ilhon sa Service Provider ang matag report sa paghatod. Ang pag-ila mahimong positibo, ie ang report sa pagpadala malampuson nga nadawat, o negatibo, ie kapakyasan.
Palihug timan-i: Ang LINK Mobility adunay timeout sa pagbasa alang sa mga pag-ila nga 30 segundos alang sa mga taho sa pagpadala. Ang usa ka timeout magpahinabog usa ka pagsulay pag-usab sa pagpadala (kon sulayan pag-usab ang mahimo) o usa ka pagkansela sa paghatod (kon sulayan pag-usab ang dili mahimo). Kini nagpasabut nga ang aplikasyon sa Service Provider kinahanglan nga masiguro ang dali nga mga oras sa pagtubag, labi na sa panahon sa taas nga load.
Girekomendar kaayo ang pag-ila sa report sa paghatud ngadto sa LINK Mobility sa dili pa kini iproseso.
Ang lagda alang sa positibo ug negatibo nga pag-ila gihulagway ingon sa mosunod:
Positibo nga pag-ila, ACK, report sa paghatod nga gihatag: HTTP 200 range response code inubanan sa mosunod nga XML formatted content:
Negatibo nga pag-ila, NAK, report sa paghatud wala gihatag: Bisan unsang tubag gawas sa positibo nga pag-ila, alang sa exampUg, usa ka negatibo nga pag-ila ang ma-trigger sa bisan unsang HTTP error code o sa mosunod nga XML nga sulud:
Ang sulud sa XML mahimong magamit alang sa pagkontrol sa mekanismo sa pagsulay pag-usab sa Link Mobility. Ang NAK magpahinabo sa pagsulay pag-usab, kung mahimo. Para sa mga Service Provider nga wala ma-configure para sa mekanismo sa pagsulay pag-usab, opsyonal ang XML content.
Sa ubos usa ka HTTP POST nga hangyo ug tubag exampAng usa ka report sa pagpadala nga gihatag sa usa ka Service Provider:

Pag-usab sa Personalized nga Komunikasyon

23

HTTP Request: POST /context/app HTTP/1.1 Content-Type: application/x-www-form-urlgi-encode;charset=utf-8 Host: server:port Content-Length: xx
MessageId=213123213&DestinationAddress=46762050312&Operator=Telia & OperatorTimeStamp=20130607%2010%3A45%3A00&TimeStamp=20130607 %2010%3A45%3A02&StatusCode=0
HTTP Response: HTTP/1.1 200 OK Content-Type: text/plain

3.10 Sulayi pag-usab
Ang sistema sa LINK Mobility makahimo sa pagsulay pag-usab alang sa napakyas, ie wala giila, paghatod sa report sa paghatod. Ang Service Provider makapili sa gusto nga sulayan pag-usab nga kinaiya:
· Wala’y pagsulay pag-usab (default) – ang mensahe isalikway kung mapakyas ang pagsulay sa koneksyon, pagbasa sa time-out o alang sa bisan unsang HTTP error code.
· Sulayi pag-usab – ang mensahe isukna alang sa matag matang sa problema sa koneksyon, pagbasa sa time-out, o negatibo nga pag-ila.
Kung gi-enable ang pagsulay pag-usab alang sa NAK, importante nga masabtan kung unsang mga senaryo ang makamugna og pagsulay pag-usab gikan sa LINK Mobility ug kung giunsa ang pagsulay pag-usab.
Ang matag Service Provider adunay kaugalingong retry queue, diin ang mga mensahe gi-order sumala sa message timesamp. Ang LINK Mobility kanunay nga mosulay sa paghatod sa daan nga mga mensahe una, bisan pa nga ang indibidwal nga han-ay sa mga mensahe nga gipadala ngadto sa Service Provider dili garantiya.
Ang nag-unang rason sa mga mensahe nga gilabay gikan sa retry queue mao ang usa sa duha ka rason: ang mensahe TTL matapos o (theoretically) ang retry queue mahimong puno. Ang TTL kay Operator ug nagsalig sa account, ie mahimong magkalainlain depende sa Operator ug o tipo sa mensahe, eg premium SMS o standard rate nga mensahe sa SMS.

Pag-usab sa Personalized nga Komunikasyon

24

Ang usa ka Service Provider nga adunay retry enabled kinahanglang magsusi sa talagsaong ID sa MT nga mensahe aron masiguro nga ang mensahe wala pa madawat.

Pag-usab sa Personalized nga Komunikasyon

25

Importante alang sa Service Provider nga mosunod niining yano nga mga lagda kung adunay usa ka sayup nga mahitabo sa panahon sa pagproseso sa usa ka report sa pagpadala kung ang hinungdan sa sayup mao ang:

1. Temporaryo, pananglitan dili magamit ang database, kinahanglan ibalik ang NAK. Ang LINK Mobility mopadala pag-usab sa mensahe.
2. Permanente ug usa ka pagsulay pag-usab lagmit nga hinungdan sa parehas nga klase sa problema, usa ka ACK kinahanglan ibalik. Kay example, kung ang mensahe dili ma-parse sa husto o hinungdan sa usa ka wala damha nga runtime error.
Ang paglihok sumala niini magsiguro nga wala’y pagbara o pagkadaot sa throughput nga gipahinabo tungod sa usa ka taho sa pagpadala nga gibalikbalik nga gibalikbalik.

3.11 Usa ka komento sa sulod sa mensahe sa SMS
Ang sulud sa mensahe sa SMS, ie ang parameter sa data sa gumagamit, girepresentahan sa lainlaing mga alpabeto depende sa kantidad sa DCS. Ang mga sukaranan gihulagway sa lamesa sa ubos. Dugang nga impormasyon bahin sa SMS alphabets makita sa ETSI specification para sa SMSvii.

Alpabeto
GSM default alphabet GSM extended alphabet

Example (DCS / User data) 17 / abc@()/
17 / {}[]

UCS2 Binary

25 / ©¼ë® 21 / 42696e61727921

Max nga gitas-on 160 <160
70 280

Deskripsyon
Normal nga text message gamit ang GSM default alphabet, tan-awa ang kapitulo 5.1. Text message gamit ang GSM default alphabet ug extension table, tan-awa ang kapitulo 5.2. Tungod kay ang matag karakter gikan sa extension table girepresentahan sa duha ka karakter ang aktuwal nga kinatas-an nga gitas-on dinamikong kalkulado ingon nga: 160 k, diin ang k mao ang gidaghanon sa gipalapdan nga mga karakter nga gigamit sa mensahe. Unicode (16 bit), ISO/IEC 10646 character nga lamesa. 8-bit data binary nga mensahe. Ang matag byte girepresentahan isip hex value gamit ang duha ka karakter matag byte. Ang kinatas-ang gitas-on sa mensahe kay 140 bytes, ie 280 ka mga karakter kon hexcoded.

Ang kinatas-an nga gitas-on sa mensahe sa SMS mokunhod samtang ang gitas-on sa header motaas kung magpadala sa mga mensahe sa SMS nga adunay gipiho nga header sa data sa gumagamit.

Ang suporta alang sa lainlaing mga alpabeto mahimong magkalainlain sa mga panagsama sa Operator.

Pag-usab sa Personalized nga Komunikasyon

26

Palihug, timan-i nga ang pipila ka mga karakter sa C0 range (kontrol nga mga karakter sa 0x00000x001F interval) dili mahimong representahan sa XML tungod sa usa ka limitasyon sa XML 1.0. Usa niining dili suportadong mga karakter mao ang , nga gilakip sa GSM alphabet extension table. Aron mahimo nga posible nga ipadala ang mga sulud sa mensahe lakip ang ingon nga mga karakter, pananglitan, vCards, ang LINK Mobility nagsuporta sa Unicode escape syntax.
Ang LINK Mobility Unicode escape syntax parehas sa escape syntax nga gigamit sa Java Language Specificationviii. Pagsunod sa escape character u nga gisundan sa upat ka hexadecimal digit nga nagrepresentar sa UTF-16 nga bili sa karakter, uxxxx.
Ang uban moikyas examples:
· u000a – Line feed · u000c – Form feed · u000d – Carriage return · u2603 Snowman
4. Pagpatuman examples
Ang SOAP naghimo sa solusyon nga independente sa programming language nga gigamit sa Service Provider nga bahin sa kliyente.
Ang web serbisyo alang sa SMS Messaging API susama kaayo sa web serbisyo nga gigamit sa SMS API. Ang code exampAng mga makit-an sa giya sa SMS API dali nga mabag-o alang sa paggamit niini nga API.

Pag-usab sa Personalized nga Komunikasyon

27

5. Mga lamesa sa karakter sa GSM

5.1 GSM default alphabet table (7-bit)
Kini nga lamesa nagpakita sa mga karakter nga mahimong ipakita sa tanang GSM mobile phones.

b7 0

Binary

b6 0

b5 0

Dis

0

b4 b3 b2 b1

Hex 0

0 0 0 0 0 0 0 0 0 1 0 1 0 1 0 1 1 0

0

0

0

0

@

0

1

1

1

£

1

0

2

2

$

1

1

3

3

¥

0

0

4

4

è

0

1

5

5

é

1

0

6

6

ù

1

1

7

7

ì

0

0

8

8

ò

1 0

0

1

9

9

Ç

1 0

1

0

10 A

LF

1 0

1

1

11 B

Ø

1 1

0

0

12 C

ø

1 1

0

1

13 D

CR

1 1

1

0

14 E

Å

1 1

1

1

15 F

å

Kay example, ang letra nga "A" adunay mosunod

bili:

1) Kini nga code usa ka pag-ikyas sa usa ka extension sa

ang 7-bit nga default nga alpabeto.

0

0

0

1

1

1

1

0

1

1

0

0

1

1

1

0

1

0

1

0

1

16 32 48 64 80 96 112

10 20 30 40 50 60 70

SP 0

¡

P ¿ p

_

!

1 AQa q

”

2

BR b

r

#

3

C

S

c

s

¤

4

D

T

d

t

%5

E

U

e

u

&

6

F

V

f

v

'

7 G Wg w

(

8 HXh x

)

9 ako

Y i

y

*

:

JZ j

z

1) + ;

KÄk ä

Æ,

< L Öl

ö

æ –

= MÑ mñ

ß .

> NÜn ü

É /

?

O §

o

à

Numero base sa Decimal Hexadecimal Binary

Pagkalkula 64 + 1 40 + 1 b1–b7

Bili 65 41 1000001

Pag-usab sa Personalized nga Komunikasyon

28

5.2 GSM default alphabet extension table (7-bit)
Kini nga talaan nagpakita sa gipalapdan nga mga karakter sa GSM default nga alpabeto.

b7 0

0

0

0

1

1

1

1

Binary

b6 0

0

1

1

0

0

1

1

b5 0

1

0

1

0

1

0

1

Dis

0

16 32 48 64 80 96 112

b4 b3 b2 b1

Hex 0

10 20 30 40 50 60 70

0 0

0

0

0

0

|

0 0

0

1

1

1

0 0

1

0

2

2

0 0

1

1

3

3

0 1

0

0

4

4

^

0 1

0

1

5

5

0 1

1

0

6

6

0 1

1

1

7

7

1 0

0

0

8

8

{

1 0

0

1

9

9

}

1 0

1

0

10 A

FF

1 0

1

1

11 B

1 1

0

0

12 C

[

1 1

0

1

13 D

~

1 1

1

0

14 E

]

1 1

1

1

15 F

Pag-usab sa Personalized nga Komunikasyon

29

6. Mga akronim ug pagmubo
Ang tanang acronym ug abbreviation gilista sa Glossaryix.
7. Mga pakisayran
i LINK Giya sa Pagpatuman sa Mobility, SMS 5.2, 22/155 19- FGC 101 0169 Uen ii SOAP, http://www.w3.org/TR/SOAP/ iii WSDL, http://www.w3.org/TR/ wsdl iv WS-I, http://www.ws-i.org/ v LINK Mobility Implementation Guide, Trusted CA Certificates, 11/155 19-FGC 101 0169 Uen vi Uniform Resource Identifiers, http://www.ietf. org/rfc/rfc2396.txt vii ETSI TS 100 900 V7.2.0 (GSM 03.38 nga bersiyon 7.2.0), Mga alpabeto ug impormasyon nga espesipiko sa pinulongan viii LINK Giya sa Pagpatuman sa Kalihokan Apendise, Pagpahibalo sa Pagsingil, 10/155 19-F101GC 0169en LINK Giya sa Pagpatuman sa Mobility Appendix, Glossary, 36/155 19-FGC 101 0169 Uen

Pag-usab sa Personalized nga Komunikasyon

30

Mga Dokumento / Mga Kapanguhaan

link sa paglihok Pagpatuman sa SMS Messaging 1.0 [pdf] Giya sa Gumagamit 1.0, Pagpatuman sa SMS Messaging 1.0, SMS Messaging 1.0, Messaging 1.0

Mga pakisayran

• Manwal sa Gumagamit