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

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

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

Headers

Name
Type
Description

Content-type*

String

text/xml; charset=utf-8;

Request Body

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

<?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>

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

Параметр
Тип данных
Описание

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