Отправка SMS, Viber, Flash SMS, WAP-Push

POST http://lk.mysmpp.ru/xml

Headers

Name Type Description

Name	Type	Description
Content-type*	String	`text/xml; charset=utf-8;`

Content-type*

String

text/xml; charset=utf-8;

Request Body

Name Type Description

Name	Type	Description
login.value*	String	Ваш логин в системе
message.address.region	String	Область для vCard
message.address.city	String	Город для vCard
message.address.street	String	Улица для vCard
message.address.post_office_box	Int	Абонентский ящик для vCard
message.organization	String	Организация для vCard
message.position	String	Должность контакта для vCard
message.email	String	E-mail для vCard
message.phone.fax	Int	Номер факса для vCard
message.phone.work	Int	Номер рабочего телефона для vCard
message.phone.cell	Int	Номер телефона для vCard
message.name	String	Имя для vCard
message.url	String	Ссылка для WAP Push или vCard
message.abonent.time_send	date	Дата и время отправки в формате: YYYY-MM-DD HH:MM где, YYYY-год, MM-месяц, DD-день, HH-часы, MM-минуты ! Если не задано, то Viber сообщение имеет максимальный срок жизни (один день)
message.abonent.client_id_sms	String	Число присваиваемое клиентом ! Необязательный параметр, позволяет избежать повторной отправки. Если раннее с этого аккаунта уже было отправлено SMS с таким номером, то повторная отправка не производится, а возвращается номер ранее отправленного SMS
message.abonent.number_sms	Int	Номер сообщения в пределах отправляемого XML документа
message.image_viber	String	Адрес картинки для Viber сообщения
message.action_viber	String	Ссылка для кнопки Viber сообщения
message.button_viber	String	Текст кнопки Viber сообщения
message.text_viber*	String	Текст Viber сообщения
message.sender_viber*	String	Отправитель Viber сообщения
message.type	String	Тип SMS сообщения: - flashsms – Flash SMS - silence – невидимые SMS (для проверки статуса абонента) - sms – обычная SMS - wappush – WAP-Push - vcard – визитная карточка (vCard)
message.type_send_2	String	Тип досылаемого сообщения, в случае если отправляемое сообщение не будет доставлено (`viber` или `sms`)
message.type_send_1*	String	Тип отправляемого сообщения (`viber` или `sms`)
token.value*	String	Вместо логина и пароля можно использовать секретный ключ. Для его получения обратитесь к менеджеру.
password.value*	String	Ваш пароль в системе
message.sender*	String	Отправитель SMS сообщения ! Именно это значение будет выводиться на телефоне абонента в поле от кого SMS
message.text*	String	Текст SMS сообщения
abonent.phone*	Int	Номер абонента, которому адресована SMS
message.additional	String	Дополнительная информация для vCard
message.address.country	String	Страна для vCard
message.address.postal_code	Int	Индекс для vCard

String

Ваш логин в системе

message.address.region

String

Область для vCard

message.address.city

String

Город для vCard

message.address.street

String

Улица для vCard

message.address.post_office_box

Int

Абонентский ящик для vCard

message.organization

String

Организация для vCard

message.position

String

Должность контакта для vCard

message.email

String

E-mail для vCard

message.phone.fax

Int

Номер факса для vCard

message.phone.work

Int

Номер рабочего телефона для vCard

message.phone.cell

Int

Номер телефона для vCard

message.name

String

Имя для vCard

message.url

String

Ссылка для WAP Push или vCard

message.abonent.time_send

date

Дата и время отправки в формате:

YYYY-MM-DD HH:MM

где, YYYY-год, MM-месяц, DD-день, HH-часы,

MM-минуты

! Если не задано, то Viber сообщение имеет максимальный срок жизни (один день)

message.abonent.client_id_sms

String

Число присваиваемое клиентом

! Необязательный параметр, позволяет избежать повторной отправки. Если раннее с этого аккаунта уже было отправлено SMS с таким номером, то повторная отправка не производится, а возвращается номер ранее отправленного SMS

message.abonent.number_sms

Int

Номер сообщения в пределах отправляемого XML документа

message.image_viber

String

Адрес картинки для Viber сообщения

message.action_viber

String

Ссылка для кнопки Viber сообщения

message.button_viber

String

Текст кнопки Viber сообщения

message.text_viber*

String

Текст Viber сообщения

message.sender_viber*

String

Отправитель Viber сообщения

message.type

String

Тип SMS сообщения: - flashsms – Flash SMS

- silence – невидимые SMS (для проверки статуса абонента)

- sms – обычная SMS

- wappush – WAP-Push

- vcard – визитная карточка (vCard)

message.type_send_2

String

Тип досылаемого сообщения, в случае если отправляемое сообщение не будет доставлено (viber или sms)

message.type_send_1*

String

Тип отправляемого сообщения (viber или sms)

token.value*

String

Вместо логина и пароля можно использовать секретный ключ. Для его получения обратитесь к менеджеру.

password.value*

String

Ваш пароль в системе

message.sender*

String

Отправитель SMS сообщения

! Именно это значение будет выводиться на телефоне абонента в поле от кого SMS

message.text*

String

Текст SMS сообщения

abonent.phone*

Int

Номер абонента, которому адресована SMS

message.additional

String

Дополнительная информация для vCard

message.address.country

String

Страна для vCard

message.address.postal_code

Int

Индекс для vCard

<?xml  version="1.0" encoding="utf-8" ?>
<response>
     <information number_sms="1" id_sms="ID SMS всистемедляпроверкистатуса" parts="2">Статус/сообщениеобошибке</information>
     <information number_sms="2" id_sms="ID SMS всистемедляпроверкистатуса" parts="2">Статус/сообщениеобошибке</information>
     <information number_sms="3" id_sms="ID SMS всистемедляпроверкистатуса" parts="2">Статус/сообщениеобошибке</information>
…
</response>

<?xml version="1.0" encoding="utf-8"?>
<response>
     <error>текст ошибки</error>
</response>

Расшифровка параметров в ответах на запрос

Параметр	Тип данных	Описание
information.number_sms	Int	Номер сообщения, указанный при отправке XML документа
information.id_sms	Int	Номер SMS сообщения. Используется для проверки статуса SMS. Если в процессе отправки SMS произошла ошибка, то id_sms не передается
information.parts	Int	Количество частей SMS
information	String	Статус сообщения («send»), если SMSбыла отправлена, или сообщение об ошибке, если в процессе отправки SMS произошла ошибка: У нас закончились SMS. Для разрешения проблемы свяжитесь с менеджером Закончились SMS Аккаунт заблокирован Укажите номер телефона Номер телефона присутствует в стоп-листе Данное направление закрыто для вас Данное направление закрыто Текст SMS отклонен модератором Нет отправителя Отправитель не должен превышать 15 символов для цифровых номеров и 11 символов для буквенно-числовых Номер телефона должен быть меньше 15 символов Нет текста сообщения Нет ссылки Укажите название контакта и хотя бы один параметр для визитной карточки Такого отправителя нет Отправитель не прошел модерацию
error	String	Текст ошибки может принимать следующие значения: Неправильный формат XML документа Ваш аккаунт заблокирован Неправильный логин или пароль POST данные отсутствуют

Параметр

Тип данных

Описание

information.number_sms

Int

Номер сообщения, указанный при отправке XML документа

information.id_sms

Int

Номер SMS сообщения. Используется для проверки статуса SMS.

Если в процессе отправки SMS произошла ошибка, то id_sms не передается

information.parts

Int

Количество частей SMS

information

String

Статус сообщения («send»), если SMSбыла отправлена, или сообщение об ошибке, если в процессе отправки SMS произошла ошибка:

У нас закончились SMS. Для разрешения проблемы свяжитесь с менеджером
Закончились SMS
Аккаунт заблокирован
Укажите номер телефона
Номер телефона присутствует в стоп-листе
Данное направление закрыто для вас
Данное направление закрыто
Текст SMS отклонен модератором
Нет отправителя
Отправитель не должен превышать 15 символов для цифровых номеров и 11 символов для буквенно-числовых
Номер телефона должен быть меньше 15 символов
Нет текста сообщения
Нет ссылки
Укажите название контакта и хотя бы один параметр для визитной карточки
Такого отправителя нет
Отправитель не прошел модерацию

error

String

Текст ошибки может принимать следующие значения:

Неправильный формат XML документа
Ваш аккаунт заблокирован
Неправильный логин или пароль
POST данные отсутствуют

Пример XML запроса

<?xml version="1.0" encoding="utf-8" ?>
<request>
  <message type_send_1="viber или sms" type_send_2="viber или sms" type="flashsms или silence или sms или wappush или vcard">
   <sender_viber>Отправитель Viber сообщения</sender_viber>
   <text_viber>Текст сообщения</text_viber>
   <button_viber>Текст кнопки</button_viber>
   <action_viber>Ссылка для кнопки</action_viber>
   <image_viber>Адрес картинки</image_viber>
   <sender>Отправитель 1</sender>
   <text>Текст сообщения 1</text>
   <url>Адрес для WAP Push или vCard</url>
   <name>Имя для vCard</name>
   <phone cell="79033256699" work="79033256699" fax="79033256699"/>
   <email>E-mail vCard</email>
   <position>Должность vCard</position>
   <organization>Организация vCard</organization>
   <address post_office_box="абонентскийящик" street="Улица" city="город" region="Область" postal_code="Индекс" country="Страна" />
   <additional>Дополнительная информация vCard</additional>
   <abonent phone="79033256699" number_sms="1" client_id_sms="101" time_send="2001-12-31 12:34:54" validity_period="2001-12-31 15:34:54" validity_period_viber="2001-12-31 15:34:54" />
   <abonent phone="79033256699" number_sms="2" client_id_sms="102" time_send="2001-12-31 12:35:54" />
     ...
   <abonent phone="79033256699" number_sms="10" client_id_sms="110" time_send="" />
 </message>
 <message>
   <sender>Отправитель 2</sender>
   <text>Текстсообщения 2</text>
   <abonent phone="79033256699" number_sms="11" client_id_sms="111" />
   <abonent phone="79033256699" number_sms="12" client_id_sms="112" />
   ...
   <abonent phone="79033256699" number_sms="20" client_id_sms="120" />
</message>
 ...
<security>
   <login value="логин" />
   <password value="пароль" />
</security>
</request>

Last updated 1 year ago