SMS услуга

Вие разглеждате по-стара версия на тази страница. Вижтетекущата версия.

Общо описание на документа

Речник на термините

Доставчикът на съдържание е партньорска компания, предоставяща SMS услуга за клетъчни абонати.

Агрегатор – CJSC Svyaznoy Gruzka, който осигурява получаването и / или изпращането на SMS съобщения до абонати чрез собствена връзка към SMS центъра на оператора, обслужващ този абонат.

Оператор - мобилен оператор, предоставящ комуникационни услуги на територията на България.

Кратък номер – SNNN, използван от Агрегатора от номерационния капацитет на Оператора въз основа на споразумение с Оператора за предоставяне на Услуги за съдържание. Номер, определен от набор от четири цифри и достъпен за изпращане на кратки съобщения до него от всеки абонат на Оператора.

Ключова дума (Регулярен израз) – думата, изпратена от абоната в SMS съобщение, се използва за идентифициране на партньора и за получаване на съдържание от SMS услугата от абоната.

Регулярен израз – разширяване на ключови думи – специално създаден шаблон за съпоставяне на символни низове на заявка. Синтаксисът за регулярните изрази е описан на http://java.sun.com/developer/technicalArticles/releases/1.4regex/index.html. Тук и по-долу регулярните изрази се използват за разпознаване на ключова дума със синоними.

Протокол – описание на последователността от действия и формата на предаваните данни за предаване на заявка на абонат от Доставчика на съдържание към Агрегатора и обратно.

MO-съобщение - SMS съобщение от абоната.

MT-съобщение - SMS съобщение, изпратено до абоната.

Общо описание на услугата SMS

Чрез SMS услугаКомпанията Доставчик на съдържание може да продава SMS услуги чрез краткия номер на компанията Агрегатор.

Компанията доставчик на съдържание не прехвърля съдържанието на Компанията към Агрегатора.

Агрегаторът изпълнява следните функции:

получава SMS съобщения от абонати;
избира SMS съобщения, които съдържат ключовата дума на компанията на Доставчика на съдържание или трябва да бъдат прехвърлени към Доставчика на съдържание като част от функционалността на сесията (вижте по-нататък в документа);
прехвърля фирмените SMS съобщения, получени от абонати, към Доставчика на съдържание чрез протокола;
получава съдържанието от компанията на Доставчика на съдържание съгласно протокола за изпращане до абоната;
изпраща съдържанието на абоната.

Обслужвани оператори

Доставчикът на съдържание може да работи чрез Агрегатора с абонати на следните оператори:

Оперативна процедура

Абонатът изпраща SMS със заявка на кратък номер на Агрегатора.
Агрегаторът изпраща получения SMS до Доставчика на съдържание.
Доставчикът на съдържание изпраща SMS до Агрегатора за изпращане до абоната (това може да е SMS отговор на заявката на абоната или SMS, който не е свързан с заявката на абоната).
Агрегаторът изпраща SMS на абоната.

Ако не бъде получен отговор от Доставчика на съдържание в рамките на определено време на изчакване, на абоната се изпраща съобщение за временната недостъпност на услугата с искане да повтори заявката по-късно.

В отговор на заявка от един абонат могат да бъдат изпратени няколко отделни SMS-а.

В отговор на заявка на абонат не може да бъде изпратен нито един SMS в предвидените от логиката на услугата случаи.

Повторна обработка на съобщенията в случай на деактивиране на услугата на Доставчика на съдържание

Ако услугата на Доставчика на съдържание не отговори на обаждането на Агрегатора:

продължавапреместване на всички съобщения, предназначени за тази услуга, в опашката за отложени.
Услуга, която не отговаря, се маркира като „не работи“ и за нея се задава време, през което всички съобщения, получени от Агрегатора от Оператора и предназначени за тази услуга, се поставят в опашката „Отложено“. Времето, за което дадена услуга ще бъде маркирана като "изключена", може да бъде зададено индивидуално за всяка услуга и е 20 секунди по подразбиране.
Всички абонати, които са кандидатствали за неработеща услуга, получават съобщение за недостъпност на услугата и забавяне на предоставянето на услуги (ако има такава настройка за услугата). Текстът на съобщението по подразбиране е „Услугата е временно недостъпна. Моля опитайте по-късно."
В края на времето за прекъсване на връзката Агрегаторът се опитва да изпрати съобщения от опашката „Отложено“ до услугата на Доставчика на съдържание. Ако услугата отново не е достъпна, тя отново се маркира като "не работи".
За всяко съобщение се правят максимум 200 опита за изпращане, след което съобщението се премахва от опашката.

Съобщения за филтър за измами

По желание филтър за измами за входящи съобщения от абонат може да бъде активиран за доставчика на съдържание. Тази настройка може да е необходима, за да се намали броят на прецедентите, когато абонатът, изпращащ SMS, премине в "минус". В този случай Агрегаторът не получава плащане за SMS от Оператора и в резултат на това не плаща за тези SMS на Доставчика на съдържание.

Описание на функционалността на сесията на услугата SMS

Общо описание на функционалността на сесията

Функционалността на сесията позволява на абоната да използва SMS услугата, без да ограничава обработваните SMS по ключови думи.

За да отвори сесия, абонатът трябва да изпрати ключова дума на кратък номер. За абонатзададения кратък номер, сесията ще се отвори. Сесията е открита за определен период от време.

Ако абонатът изпрати SMS съобщение до кратък номер и попадне във времевия интервал, когато сесията на този кратък номер е активна, описаната в документа услуга ще му отговори, независимо какъв текст е изпратил в SMS съобщението.

Откриваща сесия

Сесията се отваря, когато абонатът изпрати SMS съобщение с ключова дума за отваряне на сесията на кратък номер. Ако абонатът е изпратил правилната ключова дума, тогава за него се отваря сесия на кратък номер. Времевият интервал на активната сесия е посочен в конфигурацията на SMS услугата. През този интервал от време всички съобщения, изпратени до този кратък номер от абоната, ще бъдат обработени от сесийната SMS услуга.

Всички SMS-съобщения с кодова дума или SMS-съобщения, които са влезли в сесията, се предават на Доставчика на съдържание чрез описания по-долу протокол. В отговор на абоната се изпраща и текстът, предоставен от Доставчика на съдържание.

Удължаване на времето на сесията

Удължаването на времето за сесия става, ако абонатът има активна сесия на краткия номер към момента на изпращане на SMS съобщението. В този момент SMS съобщението може да съдържа всякакъв текст, с изключение на командата за излизане от сесията. Сесията се удължава за времето за активност на сесията, зададено в конфигурацията на услугата.

Закриване на сесията

Времето за активна сесия на абоната изтича, ако той не е изпратил никакви SMS съобщения до краткия номер през периода на сесията. Когато времето за активност на сесията изтече, абонатът получава SMS с известие, че времето за сесията е изтекло и сесията е затворена. Съобщение, уведомяващо абоната, че сесията е изтекла, може да не дойде до абоната, този параметърможе да се персонализира.

Абонатът може самостоятелно да затвори сесията. За да направи това, той трябва да изпрати ключовата дума за изход от сесията на кратък номер. В отговор абонатът ще получи SMS-съобщение, потвърждаващо затварянето на сесията, и сесията е затворена.

Данни, необходими за стартиране на SMS услугата

Данни, които Доставчикът на съдържание трябва да предостави на агрегатора, за да стартира SMS услугата

За да стартира услугата, компанията Доставчик на съдържание трябва да предостави на Агрегатора следните данни:

Данни, които Доставчикът на съдържание трябва да предостави на агрегатора, за да стартира SMS услугата за сесия

За да стартира SMS услугата за сесия, Доставчикът на съдържание трябва да предостави на Агрегатора следните данни:

Данни, предоставени на Доставчика на съдържание за стартиране на SMS услугата

За да може да изпраща SMS съобщения в рамките на SMS услугата, Доставчикът на съдържание получава следните данни от Агрегатора:

Хост адрес и порт – данни за връзка.
system_id – уникален идентификатор на партньора. Параметърът се издава веднъж, при свързване на първата услуга.
парола – парола за достъп до услугата на Агрегатора. Параметърът се издава веднъж, при свързване на първата услуга.
serviceId – уникален идентификатор на услугата. Параметърът се издава при свързване на услуги.

Предаване на операторски кодове

Агрегаторът предоставя на Доставчика на съдържание възможност за работа с повече от 30 клетъчни оператора по стандарт GSM в цяла България. Агрегаторът предоставя на Доставчика на съдържание списък с SMS центрове на GSM оператори и съответните им кодове.

Предаването се осъществява чрез параметъра на протокола "Код на оператора".

Описание на комуникационния протокол

Общописание на протокола

Протоколът за взаимодействие между Доставчика на съдържание и Агрегатора е базиран на протокола Short Message Peer to Peer (SMPP) v3.4.

Този протокол прилага SMPP v3.4 само по отношение на свързване, получаване на обмен, изпращане на SMS и поддържане на комуникация. Не е предоставена функционалността, която изпълнява команди с множество SMS, замяна и анулиране на SMS.

Документът по-долу описва методите и термините, чието пълно описание трябва да се намери в спецификацията SMPP 3.4, която може да бъде намерена тук SMPPv3.4(RU).pdf.

Връзка

Опции за свързване

Параметрите за свързване на Доставчика на съдържание са параметрите, дадени на Доставчика на съдържание от Агрегатора, когато услугата е свързана.

Връзката се осъществява с помощта на протокол SMPP v3.4.

Команда BIND

Доставчикът на съдържание се свързва в режим на трансивър чрез изпращане на командата BIND_TRANSCEIVER към установената TCP/IP връзка SMPP. Следните полета трябва да бъдат зададени в командата

system_ >Останалите командни полета се игнорират от агрегатора и могат да имат произволна стойност.

В отговор на командата BIND_TRANSCEIVER, агрегаторът изпраща BIND_TRANSCEIVER_RESP, съдържащ една от следните стойности в полето command_status, съответстващо на резултатите от командата BIND_TRANSCEIVER:

0x0 - ESME_ROK - при успешно завършване на командата BIND_TRANSCEIVER.
0xD - ESME_RBINDFAIL - Неуспешно свързване на агрегатор вътрешна грешка, връзката не е установена, опитайте отново.
0x5 - ESME_RALYBND - Вече е в свързано състояние, доставчик на съдържание с този system_id вече е свързан.
0xF - ESME_RINVSYSID - невалиден system_id.
0xE - ESME_RINVPASWD - невалидна парола.

Екип UNBIND

Принеобходимо е прекъсване. Доставчикът на съдържание изпраща команда UNBIND. В отговор агрегаторът изпраща UNBIND_RESP и затваря връзката.

Комуникационна поддръжка между Доставчика на съдържание и Агрегатора

От доставчика на съдържание

Доставчикът на съдържание трябва редовно да проверява връзката с агрегатора чрез изпращане на командата ENQUIRE_LINK.

Интервалът за изпращане на командата ENQUIRE_LINK трябва да бъде между 60-180 секунди.

Агрегаторът трябва да отговори с ENQUIRE_LINK_RESP в рамките на 10 секунди.

Ако ENQUIRE_LINK_RESP не е получен от Агрегатора в определения период от време:

Доставчикът на съдържание трябва да изпрати командата UNBIND и да изчака 30 секунди за UNBIND_RESP;
ако UNBIND_RESP не пристигне, Доставчикът на съдържание трябва да затвори връзката, да изчака 3 минути и да опита да установи връзката отново;
ако UNBIND_RESP пристигне в рамките на посочения период, Доставчикът на съдържание не трябва да затваря връзката, но след като е изминала поне 1 (една) минута, да изпрати отново командата BIND.

От страна на агрегатора

Агрегаторът може също да изпрати ENQUIRE_LINK, за да провери дали доставчикът на съдържание работи.

Доставчикът на съдържание трябва да отговори с ENQUIRE_LINK_RESP в рамките на 10 секунди.

Ако ENQUIRE_LINK_RESP не бъде получен в рамките на определения интервал от време, тогава:

Агрегаторът затваря връзката с Доставчика на съдържание;
Доставчикът на съдържание възстановява връзката сам.

Получаване на SMS от абонат (DELIVER_SM)

SMS, изпратен от Абонатите, Агрегаторът изпраща на Доставчика на съдържание в пакета DELIVER_SM. Използват се следните опции:

Използвани параметри

Параметър Описание

Подател. Телефон на абоната.

изходен_адрес
адрес_дестинация	Получател. Служебен кратък номер.
esm_class	Режим на работа и тип съобщение
кодиране_на_данни	Схема/тип на кодиране на съобщението
съобщение_полезен товар	SMS текст в USC-2 кодировка
TLV параметри	Описано по-долу

Използвани TLV параметри

При изпращане на SMS към Доставчика на съдържание от абоната се използват следните TLV параметри.