Руководство по взаимодействию с сервисом на основе HTTPS протокола методом GET.

Запросы необходимо отправлять в UTF-8 кодировке. Не стоит использовать URL длиной более 2,000 символов. Но этот параметр зависит от многих факторов и может различаться в большую или меньшую сторону.

Данные отправляются на адрес:

https://clk2.prontosms.ru/sendsms.php

методом GET.

Для отправки SMS сообщений:

Используются следующие переменные:

• user - пользователь

• pwd - пароль

• sadr - отправитель SMS. Именно это значение будет выводиться на телефоне абонента в поле от кого SMS;

• text - текст смс;

• dadr - номер абонента, которому адресована SMS. Можно несколько телефонов через запятую. Номера в международном формате, например:

79000000001 (для России);

380442589632 (для Украины);

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

https://clk2.prontosms.ru/sendsms.php?user=ваш_логин_в_нашей_системе&pwd=пароль&sadr=от_кого_придет_СМС&dadr=номер_телефона_получателя_смс&text=текст смс

Для отправки Viber сообщений:

Используются следующие переменные:

• user - пользователь

• pwd - пароль

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

• dadr - номер абонента, которому адресована SMS. Можно несколько телефонов через запятую. Номера в международном формате, например:

79000000001 (для России);

380442589632 (для Украины);

• text_viber - текст Viber сообщения

• button_viber - текст кнопки Viber сообщения

• action_viber - ссылка для кнопки Viber сообщения

• image_viber - адрес картинки для Viber сообщения

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

https://clk2.prontosms.ru/sendsms.php?user=ваш_логин_в_нашей_системе&pwd=пароль&sender_viber=от_кого_придет_сообщение&dadr=номер_телефона_получателя_смс&text_viber=текст_Viber_сообщения&button_viber=текст_кнопки_Viber_сообщения&action_viber=ссылка_для_кнопки_Viber_сообщения&image_viber=http://адрес_картинки_для_Viber_сообщения

В случае успешной отправки сообщения:

Возвращается ID SMS в plainText. Пример:

1179038981

В случае отправки на несколько номеров возвращается ID SMS через запятую в plaintText. Пример:

1178440060,1178440061

В случае не успешной отправки сообщения:

Возвращается текст ошибки в plainText.

Возможные варианты:

• phone_code_user - закончились SMS/данное направление закрыто;

• block - аккаунт заблокирован;

• Укажите номер телефона;

• stop_phone - номер телефона присутствует в стоп-листе;

• wrong_auth - неверный логин или пароль;

• incorrect_originator - отправитель не должен превышать 15 символов для цифровых номеров и 11 символов для буквенно-числовых;

• incorrect_phone - номер телефона должен быть меньше 15 символов;

• no_text_sms - нет текста сообщения;

• not_registr_originator - такого отправителя нет/отправитель не прошел модерацию.

В случае возникновения ошибки свяжитесь со службой технической поддержки

Для проверки статуса сообщения:

Используются следующие переменные:

• user - пользователь

• pwd - пароль

• smsid - ID SMS

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

https://clk2.prontosms.ru/sendsms.php?user=пользователь&pwd=пароль&smsid=ID SMS

В случае успешной отправки запроса:

В случае успешной отправки запроса на получение статуса сообщения возвращается статус сообщения в plainText:

• «send» - статус сообщения еще не получен.

• «not_deliver» - сообщение не было доставлено. Конечный статус (не меняется со временем).

• «expired» - абонент находился не в сети в те моменты, когда производились попытки доставки. Конечный статус (не меняется со временем).

• «deliver» - сообщение доставлено. Конечный статус (не меняется со временем).

• «partly_deliver» - сообщение было отправлено, но статус так и не был получен. Конечный статус (не меняется со временем). В этом случае для разъяснения причин отсутствия статуса необходимо связаться со службой технической поддержки.

В случае не успешной отправки запроса:

Возвращается пустой ответ сервера. Проверьте корректность указанных данных и попробуйте еще раз, либо свяжитесь со службой технической поддержки.