Руководство по взаимодействию с сервисом коротких сообщений (SMS) на основе HTTPS протокола, методом GET.
Запросы необходимо отправлять в UTF-8 кодировке. Не стоит использовать URL длиной более 2,000 символов. Но этот параметр зависит от многих факторов и может различаться в большую или меньшую сторону.
Данные отправляются на адрес:
| Code Block |
|---|
https://clk2.prontosms.ru/sendsms.php |
методом GET.При этом используются
Для отправки SMS сообщений:
Используются следующие переменные:
user - пользователь
pwd - пароль
type_send_1 – тип отправляемого сообщения (viber или sms) по умолчанию sms
type_send_2 – тип досылаемого сообщения, в случае если отправляемое сообщение не будет доставлено (viber или sms)
sadr - отправитель SMS. Именно это значение будет выводиться на телефоне абонента в поле от кого SMS;
text - текст смс;
dadr - номер абонента, которому адресована SMS. Можно несколько телефонов через запятую. Номера в международном формате, например:
79000000001 (для России);
380442589632 (для Украины);
Пример запроса:
| Code Block |
|---|
https://clk2.prontosms.ru/sendsms.php?user=ваш_логин_в_нашей_системе&pwd=пароль&sadr=от_кого_придет_СМС&dadr=номер_телефона_получателя_смс&text=текст смс |
Для
...
type_send_1=sms
...
sadr - адрес отправителя
...
text - текст смс
отправки Viber сообщений:
Используются следующие переменные:
user - пользователь
pwd - пароль
sender_viber – отправитель Viber сообщения
dadr - номер абонента, которому адресована SMS. Можно несколько телефонов через запятую. Номера в международном формате, например:
79000000001 (для России);
380442589632 (для Украины);
text_viber - текст Viber сообщения
button_viber - текст кнопки Viber сообщения
action_viber - ссылка для кнопки Viber сообщения
image_viber - адрес картинки для Viber сообщения
Пример запроса:
...
| Code Block |
|---|
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. Пример:
| Code Block |
|---|
1179038981 |
В случае отправки на несколько номеров возвращается ID SMS через запятую в plaintText. Пример:
| Code Block |
|---|
1178440060,1178440061 |
В случае не успешной отправки сообщения
...
:
Возвращается текст ошибки в plainText.
Возможные варианты
...
:
typephone_send_1=viber
sender_viber – отправитель Viber сообщения
text_viber - текст Viber сообщения
button_viber - текст кнопки Viber сообщения
action_viber - ссылка для кнопки Viber сообщения
image_viber - адрес картинки для Viber сообщения
в ответ выводится ID SMS.
Проверка статуса
| Code Block |
|---|
https://clk2.prontosms.ru/sendsms.php?user=пользователь&pwd=пароль&smsid=ID SMS |
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
Пример запросаДанные отправляются на адрес:
| Code Block |
|---|
https://clk2.prontosms.ru/sendsms.php?user |
...
=пользователь |
...
&pwd |
...
=пароль |
...
&smsid |
...
=ID SMS |
В случае
...
успешной отправки запроса:
В случае успешного запроса успешной отправки запроса на получение статуса сообщения возвращается статус SMS сообщения в plainText:●
«send» - статус сообщения еще не получен.
...
«not_deliver» - сообщение не было доставлено. Конечный статус (не меняется со временем).
...
«expired» - абонент находился не в сети в те моменты, когда
...
производились попытки доставки. Конечный статус (не меняется со временем).
...
«deliver» - сообщение доставлено. Конечный статус (не меняется со временем).
...
«partly_deliver» - сообщение было отправлено, но статус так и не был получен
...
Входящие СМС
...
date - дата получения смс yyyy-mm-dd HH:mm:ss
...
text - текст смс
...
smsid - ID СМС
...
sender - отправитель смс
. Конечный статус (не меняется со временем). В этом случае для разъяснения причин отсутствия статуса необходимо связаться со службой тех. поддержки.
В случае не успешной отправки запроса:
Возвращается пустой ответ сервера. Проверьте корректность указанных данных и попробуйте еще раз.
...