Webcom Mobi API Документация
EN
Search
⌃K
Links
Comment on page

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

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

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

Параметр
Тип данных
Описание
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 modified 3mo ago