Внедрение SMS-связи в Ваши приложения

Персональный SMS Сервер может быть использован сторонними приложениями как для отправки, так и для получения SMS-сообщений. Он предоставляет следующие интерфейсы:

• COM-интерфейс - для интеграции с Windows-приложениями, скриптами, а также системой 1С;
• HTTP-интерфейс - для интеграции с веб-сайтом;
• Интерфейс командной строки - для интеграции с базами данных и Windows скриптами.

Для просмотра инструкций и примеров для конкретных платформ и языков программирования - выберите в верхнем меню раздел "Программисту".

Интеграция Персонального SMS-сервера с Windows-приложениями

Описание COM-интерфейса находится в соответствующем разделе помощи к Персональному SMS Серверу (Пуск - Программы - SMS-Система Хедвинд - Персональный SMS Сервер - Помощь).

Перейти к описанию COM-интерфейса >>

Пример COM-приложения (на VB.NET) находится в дистрибутиве Персонального SMS Сервера.

Получение SMS и отчетов о доставке. Обработчик SMS

Обработчик SMS - это действие, которое необходимо произвести при получении SMS или отчета о доставке. Обработчик - это команда DOS или HTTP GET запрос, принимающий следующие переменные:

• Событие "получение":
  _FROM_ (номер телефона отправителя);
  _BODY_ (тело сообщения).
  
  
• События "отправка" и "доставка":
  _TO_ (номер телефона получателя);
  _BODY_ (тело сообщения);
  _CUSTOM_ (идентификатор, переданный источником SMS, см. следующий подраздел);
  _STATUS_ (статус сообщения: sent, failed, delivered, undelivered).

Для создания обработчика SMS необходимо:

• открыть панель управления Персонального SMS Сервера;
• зайти во вкладку "Обработчики" и выбрать "Добавить";
• указать тип события и тип обработчика;
• указать путь или URL, включающие вышеуказанные параметры в качестве параметров или значений CGI-переменных;
• пометить обработчик активным, при необходимости отладки - установить соответствующий флажок.

Отправка SMS. Источник SMS

Отправка SMS из Desktop- или веб-приложений осуществляется с помощью интерфейса источников SMS. Источник SMS - это команда DOS или HTTP GET запрос, периодически (раз в несколько секунд) вызываемый Персональным SMS Сервером с последующей отправкой SMS-сообщений, возвращаемых источником SMS.

Источник SMS должен возвращать текст в формате XML:

<?xml version="1.0" encoding="windows-1251"?> <messages> <message msisdn="79111992948">Это тестовое сообщение из источника SMS</message> <message msisdn="79111992948">Это еще одно тестовое сообщение</message> </messages>

Тег <message> может содержать следующие атрибуты:

• msisdn - номер телефона получателя в международном формате, без +;
• report - может принимать значение 1, если требуется отчет о доставке, 0 - если не требуется;
• custom - пользовательский идентификатор сообщения (используется при идентификации отчетов об отправке и доставке.

Для установки источника SMS необходимо:

• открыть панель управления Персонального SMS Сервера;
• зайти во вкладку "Источники" и выбрать "Добавить";
• выбрать тип источника (URL, файл или командная строка);
• настроить путь или URL.

Будьте внимательны, кодировка XML-файла по умолчанию - UTF-8!

Где найти примеры и инструкции по интеграции?

Если вам нужно...

... записать полученные SMS в базу данных или в файл, отправить SMS, записанные в базу данных другой программой, или разослать SMS из файла - Вам сюда! >>>

... интегрировать Персональный SMS Сервер с веб-сайтом - Вам сюда! >>>

... внедрить SMS-связь в 1C - Вам сюда! >>>

 Как отлаживать?

И обработчики SMS, и источники SMS имеют два флажка для отладки. Для установки флажков зайдите во вкладку "Обработчики" или, соответственно, "Источники", выделите нужную команду, и нажмите "Изменить".

Источник (обработчик) SMS активен - снимите этот флажок, если Вы хотите временно отключить источник или обработчик SMS, но не хотите удалять его.

Выводить результат в журнал - поставив этот флажок, можно смотреть в журнале SMS Сервера, что выведет обработчик или источник в стандартный вывод. Для просмотра журнала - перейдите во вкладку "SMS" и нажмите кнопку "Журнал" справа внизу. Будьте внимательны - команды DOS выводят русские буквы в кодировке DOS и в журнале они могут отобразиться неверно.

Режим эмуляции

Режим эмуляции позволяет отлаживать приложение, не отправляя реальные SMS-сообщения, что экономит деньги на разработку. Для включения режима эмуляции дважды щелкните мышкой на иконку Персонального SMS Сервера в окошке задач в углу экрана, выберите вкладку "Приложение" и поставьте галочку "Эмуляция". Затем щелкните правой кнопкой мыши на иконку Персонального SMS Сервера, выберите "Выход", и потом снова запустите программу.

Для эмуляции отправки SMS щелкните правой кнопкой мыши на иконку Персонального SMS Сервера и выберите "Отправить SMS".

Для эмуляции получения SMS в окне отправки SMS наберите текст SEND [number] [SMS], например, SEND 79111992948 Test Message будет эмулировать получение SMS с текстом Test Message с номера 79111992948.

Перейти сюда, если вас интересует SMS сервис или вот сюда, если вам интересно оперативное СМС оповещение.

На этой странице информация о программах для отправки SMS.

Обратитесь к нам за помощью

Если у Вас возникли проблемы с интеграцией - пожалуйста, обратитесь к нам за помощью. Обязательно укажите e-mail для обратной связи, и по возможности полно опишите проблему. При необходимости вставьте в форму обратной связи журнал Персонального SMS Сервера.

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