Cписок телефонов в международном формате, разделенных
запятыми или пробелами, например +7916123456,89161234568 (можно ограничиться только одним номером телефона)
message
Текст сообщения
Необязательные параметры:
format
Формат возвращяемых данных:
xml - в XML (по умолчанию)
serialize - в виде упакованного php функцией serialize() массива.
rus
Если rus=1, то сообщение будет передано без изменений , если rus=0, то оно будет транслитерировано и передано в латинице. По умолчанию, rus=1.
originator
Отправитель сообщения, как он будет выглядеть на телефоне получателя.
Отправитель может быть цифровым, в этом случае его длина ограничена 5-15 символами (номер телефона, например, для получения ответов по SMS), или буквенно-цифровым, в этом случае длина ограничена 11-ю символами (например, название вашей компании)
Если отправитель не задан, рассылка будет поизведена через GSM модем.
max_parts
Максимальное количество частей, на которые будет при необходимости разбит текст сообщения. Если текст сообщения разбивается при отправке, то длина одной части сообщения будет 153 символа для латиницы и 67 для кириллицы. По умолчанию max_parts=0 - без ограничения на количество частей.
individual_messages=1
Если необходимо отправить индивидуальное сообщение каждому абоненту, можно передать дополнительный параметр individual_messages=1, поле message оставить пустым, а в поле phones передать список телефонов и сообщений в формате:
телефон1 сообщение1
телефон2 сообщение2
телефон3 сообщение3
телефон4 сообщение4
……
validity
Время жизни в минутах
send_to_night=1
Отправлять смс ночью. По умолчанию смс в ночное время автоматически переносятся на утро. Часовой пояс абонента вычисляется по номеру телефона.
В качестве ответа скрипт отдает XML (по умолчанию) с результатом постановки сообщений в очередь. Пример ответа скрипта об успешной постановке в очередь одного сообщения:
В случае успеха поле result содержит строку “OK”, code=0, а description сообщает о количестве сообщений, успешно поставленных в очередь.
В случае какой-либо ошибки result=ERROR, code>0, description содержит описание ошибки (например, “authentication failed”).
Если необходимо получить информацию об идентификаторах, присвоенных каждому сообщению (они понадобятся при проверке доставки сообщения), нужно передать скрипту этот параметр. Тогда ответный XML будет содержать информацию о каждом телефоне и идентификаторе, присвоенном соответствующему сообщению. Например:
Проверка статусов
Для проверки статуса отправленного сообщения вызывается тот же скрипт с параметрами:
login
Ваш логин
password
Ваш пароль
operation=status
Операция - проверка статусов
sms_id
Идентификатор сообщения, полученный при отправке
или
phones
Номера телефонов через пробел или запятую. В этом случае будет произведен запрос статусов для указанных номеров.
В качестве ответа скрипт отдает XML с информацией о статусе сообщения. Например:
Ключ status принимает следующие значения:
DeliveryOK
Доставлено
DeliveryFailed
Не доставлено. Абонент не доступен
SendingOK
Отправляется
SendingOKNoReport
Отправлено. Статус доставки не известен.
SendingError
Ошибка отправки
Автоматическое получение статусов
Также можно автоматически получать от нас статусы сообщений после каждого изменения статуса. Для этого вам нужно установить на своем web-сервере скрипт и прислать его URL через форму обратной связи. Этот скипт должен принимать методом POST следующие параметры:
sms_id
Идентификатор сообщения, полученный при отправке
status
Статус доставки
send_date
Дата изменения статуса по московскому времени в формате YYYY-MM-DD hh:mm:ss
md5
Хеш вычисляемый следующим образом md5(date+sms_id+PARTNER_HASH)
Пример обрабатывающего скрипта для php:
Проверка счета
Для проверки баланса на своем счете вызывается тот же скрипт с параметрами:
login
Ваш логин
password
Ваш пароль
operation=account
Операция - проверка баланса
В качестве ответа скрипт отдает XML с информацией о балансе. Например,
