Внедрение 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:
Тег <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 для обратной связи, и по возможности полно опишите задачу.