API для SMS шлюза
Интеграция SMS-сообщений в ваши продукты.
Систему SMS-рассылок можно интегрировать в вашу клиентскую систему или Web-сайт с помощью SMS шлюза. Список применений интеграции довольно обширен. Так, например, можно уведомлять пользователей вашего сайта о каких-то событиях и акциях по мере их поступления в автоматическом режиме.
SMS шлюз является быстрым и удобным сервисом, позволяющим автоматизировать работу по взаимодействию с клиентом и подходит для компаний крупного, среднего и малого бизнеса.
Помимо этого, выбрав для работы SMS шлюз, можно наладить обратную связь с персоналом компании. Например, на сайте клуба можно сделать заказ зоны в клубе и тогда при отправке заявки с сайта менеджер клуба получит заявку моментально на свой мобильный телефон в виде SMS. Это особенно актуально для "горячих" сфер деятельности, где быстрое реагирование на заявку носит обязательный и имиджевый характер.
Как это работает
| Ваш сайт, CRM-система или другой продукт | Формирование запроса, проверка баланса, проверка подписи | Шлюз SMS Aero | Отправка сообщений | Клиенты |
 |
 |
 |
|
 |
Мы разработали API для работы с SMS-шлюзом SMS Aero. Ниже приводятся команды, которые программисты могут использовать в своих продуктах, для взаимодействия с SMS-шлюзом SMS Aero.
-
Передача сообщения
GET запрос на сервер, вида:
http://gate.smsaero.ru/send/?to=71234567890&text=test
Параметр Статус Описание user Обязательно Логин в системе password Обязательно Пароль (md5) to Обязательно Номер телефона получателя, в формате 71234567890 text Обязательно Текст сообщения, в UTF-8 кодировке from Обязательно Подпись отправителя (например TEST) date Дата для отложенной отправки сообщения (количество секунд с 1 января 1970 года) При успешной авторизации, в ответ сервис должен вернуть plain/text ответ вида:
123456=acceptedгде до знака «=» сервис выдает идентификатор сообщения, а после знака «=» ответ сервиса о статусе сообщения. Возможные ответы сервера:
Параметр Описание accepted Сообщение принято сервисом empty field. reject. Не все обязательные поля заполнены incorrect user or password. reject Ошибка авторизации no credits Недостаточно sms на балансе incorrect sender name. reject Неверная (незарегистрированная) подпись отправителя incorrect destination adress. reject Неверно задан номер тефона (формат 71234567890) incorrect date. reject Неправильный формат даты Проверка состояния отправленного сообщения
GET запрос на сервер, вида:
http://gate.smsaero.ru/status/?id=123456
Параметр Статус Описание user Обязательно Логин в системе password Обязательно Пароль (md5) id Обязательно Идентификатор сообщения, который вернул сервис при отправке сообщения При успешной авторизации, в ответ сервис должен вернуть plain/text ответ вида:
123456=delivery successгде до знака «=» сервис выдает идентификатор сообщения, а после знака «=» ответ сервиса о статусе сообщения:
Параметр Описание delivery success Сообщение доставлено delivery failure Ошибка доставки SMS (абонент в течение времени доставки находился вне зоны действия сети или номер абонента заблокирован) smsc submit Сообщение доставлено в SMSC smsc reject отвергнуто SMSC queue Ожидает отправки wait status Ожидание статуса (запросите позднее) incorrect id. reject Неверный идентификатор сообщения empty field. reject. Не все обязательные поля заполнены incorrect user or password. reject Ошибка авторизации Проверка состояния счета
GET запрос на сервер, вида:
http://gate.smsaero.ru/balance/
Параметр Статус Описание user Обязательно Логин в системе password Обязательно Пароль (md5) При успешной авторизации, в ответ сервис должен вернуть plain/text ответ вида:
balance=12345где цифра, это количество доступных SMS на балансе.
Список доступных подписей отправителя
GET запрос на сервер, вида:
http://gate.smsaero.ru/senders/
Параметр Статус Описание user Обязательно Логин в системе password Обязательно Пароль (md5) При успешной авторизации, в ответ сервис должен вернуть plain/text ответ вида:
Sender_one
Sender_two
Sender_threeгде выводится список доступных подписей по одной в каждой строке.
