Библиотеки и примеры кода

Содержание

  1. Библиотеки с API-функциями
  2. Модули и скрипты для интернет-сервисов
  3. Пример формы для отправки SMS-сообщений
  4. Пример формы для подтверждения номера телефона
  5. Пример формы для подтверждения адреса электронной почты
  6. Шаблон для проверки номеров телефонов
  7. Шаблон для определения тарифной зоны
  8. Проверка/генерация md5 хеш пароля

Библиотеки с API-функциями

Для работы с нашим сервисом по протоколам HTTP/HTTPS или SMTP вам достаточно подключить файл соответствующей библиотеки, после чего вы сможете отправлять SMS-сообщения или проверять статус вызовом одной команды.

Библиотеки (HTTP и SMTP):


Библиотеки (SMPP):


Примеры работы для SOAP протокола


Модули и скрипты для интернет-сервисов

В данном разделе приведены модули и скрипты для различных интернет-сервисов, расширяющие возможности данных сервисов по отправке различных видов уведомлений посредством SMS-сообщений.

Скрипт для OCStore

Скачать скрипт для OCStore 1.5.3.1 (1 Кб)

Скрипт позволяет отправлять уведомления о поступлении нового заказа на указанный список телефонов.

Для настройки уведомлений необходимо проделать следующие шаги:
  1. Скопируйте файл smsc.php в каталог <Корневой_каталог_установки_OCStore>/system/smsgate/.
  2. В административной панели управления перейдите в пункт СистемаНастройки.
  3. На странице Управление магазинами для выбранного магазина справа в колонке Действие нажмите ссылку Изменить.
  4. На странице Настройки выберите закладку SMS.

    Настройки

  5. В пункте Сервис отправки SMS выберите SMS-шлюз smsc.
  6. В поле Псевдоним отправителя укажите имя отправителя (Sender ID), от которого будут приходить сообщения (имя отправителя должно быть предварительно зарегистрировано в личном кабинете на данной странице).
  7. В поле Номер телефона получателя укажите номер телефона получателя уведомлений о новом заказе. В поле Дополнительные номера можно указать список номеров, на которые также будут отправляться уведомления.
  8. В пункте Текст сообщения укажите текст отправляемого уведомления. При составлении текста сообщения можно использовать соответствующие макросы.
  9. В поле Логин на SMS шлюз укажите логин, а в поле Пароль на SMS шлюз – пароль, указанные при регистрации.
  10. В пункте Включить SMS уведомления выберите Да.
  11. Справа в верхней части страницы нажмите кнопку Сохранить.

Модуль для OpenCart

Скачать модуль для версии 1.x OpenCart 1.x v2.8 (15 Кб), для версии 2.x OpenCart 2.x v1.2 (18 Кб)

Модуль позволяет отправлять SMS-уведомления администратору системы при регистрации нового пользователя, поступлении нового заказа, поступлении нового письма через контактную форму. Также модуль позволяет настроить отправку уведомлений покупателю при оформлении нового заказа, успешном завершении регистрации и при изменении статуса заказа (при установленной возможности оповещения покупателя). При настройке текстов уведомлений можно использовать набор макросов для подстановки различных значений с базы данных. Имеется возможность указания разных текстов сообщений для различных статусов заказа.

Для установки модуля необходимо выполнить следующие действия:
  1. Установите OpenCart.
  2. Скопируйте файлы соответствующего модуля smsc_opencart в указанные каталоги.
  3. Для версии 1.x установите модуль vQmod 2.x (http://code.google.com/p/vqmod/downloads/list). Для версии 2.x в пункте "Установка расширений" загрузите модификацию smsc.ocmod.xml (После установки не забудьте в пункте "Модификаторы" очистить кеш нажав кнопку "Обновить").
Для настройки уведомлений необходимо проделать следующие шаги:
  1. В административной панели управления перейдите в пункт ДополненияМодули.

    Модули

  2. На странице Модули выберите модуль SMSC и справа в колонке Действия нажмите ссылку Установить.
  3. После установки модуля выберите действие Изменить.
  4. На странице модуля SMSC во вкладке Подключение в поле Логин укажите логин, а в поле Пароль – пароль, указанные при регистрации в сервисе. В поле Имя отправителя укажите имя, от которого будут приходить уведомления. Имя отправителя прежде должно быть зарегистрировано в личном кабинете на данной странице.

    Подключение

  5. Во вкладке Администратор установите галочки для отправки соответствующих уведомлений администратору системы и укажите номер телефона администратора. При составлении текста уведомления о новом заказе можно использовать специальные макросы.

    Администратор

  6. Во вкладке Покупатель укажите, какие уведомления будут отправляться покупателю.

    Покупатель

  7. После установки настроек справа от названия модуля SMSC нажмите кнопку Сохранить.
  8. Для отправки уведомлений покупателю об изменении статуса заказа необходимо в настройках заказа установить соответствующую галочку, активирующую отправку оповещения покупателю. Для этого перейдите в пункт ПродажиЗаказы, выберите требуемый заказ и в колонке Действия нажмите ссылку Просмотр.
  9. На странице Заказы выберите вкладку История заказа, затем установите требуемый статус заказа и галочку Уведомить покупателя. После этого нажмите кнопку Добавить историю.

    Статус заказа


Модуль для IP.Board

Данная разработка позволяет расширить возможности стандартной формы регистрации нового пользователя, добавив в нее дополнительную проверку принадлежности номера телефона пользователю посредством ввода SMS-кода. Модуль был протестирован для базовой версии 3.4.6, но с большой долей вероятности будет работать и на других версиях форума.

Для установки модуля необходимо выполнить следующие действия:
  1. Скопируйте файл send_code.php из папки upload архива ipboard_3.zip и файл библиотеки smsc_api.php в корневой каталог установки форума.
  2. В файле smsc_api.php установите константы SMSC_LOGIN и SMSC_PASSWORD в значения, соответствующие логину и паролю, указанные при регистрации в сервисе, а константу SMSC_CHARSET в значение utf-8.
  3. Установите хук smsc.xml из архива ipboard_3.zip. Для этого в админцентре форума выберите последовательно пункты меню СистемаПриложенияУправление хуками, нажмите кнопку Установить хук и выберите требуемый файл.
Для защиты от автоматических рассылок кода подтверждения телефона используется общая картинка (captcha), которая обновляется после каждой отправки кода.

Модуль для Prestashop

Скачать модуль для Prestashop (8 Кб)

Модуль позволяет отправлять SMS – уведомления с информацией о заказе покупателям и уведомлять администратора магазина о поступившем заказе.

Для установки модуля необходимо выполнить следующие действия:
  1. Установите Prestashop версии 1.3 или выше
  2. В административной панели магазина перейдите на страницу Модули. Нажмите Добавить новый модуль и выберите архив с модулем.
  3. Выберите из списка модуль SMSC и нажмите Установить. После установки откроется страница с настройками.
Настройка модуля:
  1. В поле Логин введите логин, в поле Пароль - пароль, указанные при регистрации в сервисе. В поле Телефон введите телефон администратора, на который необходимо отправлять уведомления о поступивших заказах.

    prestashop

  2. В полях Сообщение администратору и Сообщение покупателю можно указать тексты SMS – сообщений, которые будут отправляться. При составлении текста можно использовать макросы, как показано на рисунке. Все доступные макросы и их значение можно увидеть справа.
  3. Установите опции Отправлять администратору и/или Отправлять покупателю и нажмите кнопку Сохранить.

Плагин для WordPress WooCommerce

Плагин позволяет настроить отправку SMS уведомлений клиентам с информацией о заказе, а также информировать администратора магазина о поступлении нового заказа и смене его статуса.

Скачать плагин для WordPress WooCommerce (6 Кб)

Обратите внимание, что для работы плагина требуется плагин WooCommerce! Скачать его можно здесь.

Установка плагина:
  1. В административной панели перейдите на страницу Плагины и нажмите Добавить новый.
  2. Перейдите на вкладку Загрузить, нажмите Обзор и выберите архив с плагином.
  3. Нажмите Установить. После того, как плагин будет установлен, нажмите Активировать плагин.

Настройка плагина:
  1. Наведите курсор на пункт меню WooCommerce и выберите SMS оповещения
  2. В форме Настройки шлюза укажите Ваш логин, пароль и телефон, на который необходимо отправлять уведомления. Также Вы можете указать имя отправителя.
  3. В форме Шаблоны сообщений укажите шаблоны для отправки сообщений при наступлении событий Новый заказ и Статус заказа изменен. При заполнении шаблонов допускается использование макросов (допустимые макросы указаны справа).
  4. Установите опции для отправки уведомлений администратору и/или клиентам.

Скрипт для R-Keeper (UCS)

Скачать описание протокола обмена для программы R-Keeper (12 Кб)

Для возможности отправки и получения статусов SMS-сообщений по протоколу программы R-Keeper (UCS) необходимо вызвать скрипт: http://billing.smstraf.ru/sys/rkeeper_api.php
и передать ему соответствующий XML документ. После принятия и обработки данных Сервер возвращает Клиенту подтверждение с указанием результата обработки.

Пример формы для отправки SMS-сообщений

Для отправки SMS-сообщений со своего сайта можно воспользоваться примером HTML-формы и соответствующего PHP-скрипта, обрабатывающего данные этой формы.

Форма и скрипт для отправки сообщений

Пример формы для подтверждения номера телефона

Для подтверждения номера мобильного телефона, например, при активации новой учетной записи на сайте можно использовать пример специальной HTML-формы и PHP-скрипта обработчика.

Форма и скрипт для подтверждения номера телефона

Пример формы для подтверждения адреса электронной почты

Для подтверждения адреса электронной почты, например, при активации новой учетной записи на сайте можно использовать пример специальной HTML-формы и PHP-скрипта обработчика.

Форма и скрипт для подтверждения адреса электронной почты

Шаблон для проверки номеров телефонов

Для проверки формата номеров телефонов на стороне Клиента возможно использование регулярных выражений, перечисленных ниже.

По всем странам:
По СНГ:

Шаблон для определения тарифной зоны

Для определения тарифной зоны на стороне Клиента возможно использование следующих регулярных выражений:

Проверка/генерация md5 хеш пароля

Данный инструмент позволяет быстро зашифровать (кодировать) абсолютно любой введенный текст при помощи md5 шифрования.


MD5-хеш: Пароль не введен



Повышение тарифов на выполнение HLR-запросов
10.07.2017
С 15 июля повышаются тарифы сервиса на выполнение HLR-запросов. Тариф становится единым для всех стран и операторов. Подробные тарифы указаны на странице Тарифы HLR. Повышение вызвано изменением закупочной цены оператором, предоставляющим данную услугу.