СМС рассылки профессионально!

Обновлена программа WebAPI для ProfiSMS.

Обновление было связано с устранением ошибки выгрузки смс на сайты (сбивался порядковый номер последней выгруженной смс). Текущая версия 1.2.3

Скачать WebAPI 1.2.3

WebAPI это программа, которая устанавливается на Ваш локальный компьютер, имеющий доступ в Интернет. Но Вы должны учитывать, что на сайте должна быть и база данных, в которой будут храниться смс. И скрипты, которые будет вызывать WebAPI.

Здесь и в дальнейшем мы будем опираться на пример реализации на PHP+MySQL. В примерах есть скрипты:
1. smsout.php – скрипт для работы с отправляемыми с сайта смс
2. smsin.php – скрипт для работы с принятыми ProfiSMS и передачи их на сайт
3. proc_db.php – подключаемый скрипт, содержащий конфигурационную информацию (имя БД, логин и пароль для доступа к БД и т.д.)

Начнем с отправки смс с сайта. Для начала Вам потребуется создать базу данных, состоящую из таблицы (назовем ее SMSOUT), для хранения информации об отправляемых смс.

Поле	Тип	Комментарии
id	bigint(20)	id смс (автоинкремент)
nom	varchar(35)	номер получателя
txtmsg	varchar(600)	текст смс
status	tinyint(4)	статус смс (0-ожидает обработки, 1-отправляется, 2-отправлена, 9-ошибка отправки)

Получение c Веб-сайта сообщений для отправки.

Запрос на веб-сервер:

<SmsOutRequest>

<AuthCode>myAuthCode</AuthCode>

<Oper>GetOutNewSMS</Oper>

<MaxOutSMS>5</MaxOutSMS> необязательный параметр

</SmsOutRequest>

Ответ от веб-сервера:

<SmsOutResponse>

<SmsDetail> <!—данные для передачи смс #1 –>

<SmsId>уникальный номер смс</SmsId>

<NomAbon>номер телефона получателя</NomAbon>

<TxtMsg>текст смс сообщения</TxtMsg>

</SmsDetail>

…

<SmsDetail> <!—данные для передачи смс #NN –>
… данные для отправки смс #NN …
</SmsDetail>
</SmsOutResponse>

myAuthCode – это пароль доступа к скрипту
GetOutNewSMS – название операции, в данном случае это операция получения с сайта новых смс
MaxOutSMS – максимальное количество смс в пакете. Оно также может задаваться и на самом сайте, но приоритет имеет именно переданное значение.
SmsId – уникальный номер смс. Это поле ID из базы данных на сайте.
NomAbon – номер получателя в международном формате, без «+» (например 79135220928)
TxtMsg – текст сообщения. Не более 600 символов, в кодировке win-1251.

Чтобы на сайте можно было контролировать состояние отправки смс, скрипт должен уметь обрабатывать:

Отчеты на Веб-сайт об успешной загрузке сообщений для отправки.

Запрос на веб-сервер:

<SmsOutRequest>

<AuthCode>myAuthCode</AuthCode>

<Oper>ReportOutNewSMS</Oper>

<SmsIdLists>12,13,14,15,25</SmsIdLists>

</SmsOutRequest>

Ответ от веб-сервера:

<SmsOutResponse>

<Result>OK</Result>

</SmsOutResponse>

Отчеты на Веб-сайт об успешной отправке сообщений.

Запрос на веб-сервер:

<SmsOutRequest>

<AuthCode>myAuthCode</AuthCode>

<Oper>ReportOutSendSMS</Oper>

<SmsIdLists>12,13,14,15,25</SmsIdLists>

</SmsOutRequest>

Ответ от веб-сервера:

<SmsOutResponse>

<Result>OK</Result>

</SmsOutResponse>

Отчеты на Веб-сайт о неудачной отправке сообщений.

Запрос на веб-сервер:

<SmsOutRequest>

<AuthCode>myAuthCode</AuthCode>

<Oper>ReportOutErrSMS</Oper>

<SmsIdLists>12,13,14,15,25</SmsIdLists>

</SmsOutRequest>

Ответ от веб-сервера:

<SmsOutResponse>

<Result>OK</Result>

</SmsOutResponse>

SmsIdLists – ID смс, как они заданы на сайте (поле ID в таблице SMSOUT).

Вы можете взять за основу те скрипты, что идут с WebAPI в качестве примеров. Это позволит быстро все настроить и запустить в работу.

Продолжение читайте в документации, которая идет непосредственно с самой программой WebAPI…

Перейдите на вкладку «Главная» и нажмите «Пуск» :

На картинке Вы видите ход работы программы. Одновременно это записывается в лог-файл, расположенный в папке программы.

Для удобства программу можно свернуть в трей.

Запустите ProfiSMS WebAPI. Для начала нам потребуется настроить программу:

Для начала нужно указать, где расположена база ProfiSMS. Что это и как, Вы уже знаете, т.к. настраивали это и в клиентской и в серверной части программы ProsiSMS. ВАЖНО! Данный пользователь должен быть заведен в роли ОПЕРАТОР!

Далее укажите, где находится база WebAPI. Изначально эти поля будут заполнены по умолчанию. Проконтролируйте правильность введенных данных, нажав на кнопки «тест и применить».

Теперь зададим основные параметры работы программы. Программа обращается к сайтам с определенной периодичностью, называемой «Интервал проверки», задается в секундах. При загрузке с сайта смс, это происходит «пакетом» (блоком). Укажите максимальное количество загружаемых смс за одно обращение к сайту. А также и при выгрузке на сайт принятых смс. Для сохранения нажмите «применить».

Теперь нужно добавить сайт в список обслуживаемых сайтов. Для этого наведите мышкой на поле списка сайтов и нажмите на правую кнопку мышки – выпадет меню:

Выберите «Добавить сайт» и откроется окно для внесения данных:

Задайте название сайта.

Если Вам нужно загружать с сайта смс для отправки, то поставьте соответствующую галочку и впишите полный URL скрипта, выдающего тексты смс.

Если Вам нужно передавать на сайт смс, которые приняты ProfiSMS, то поставьте соответствующую галочку и впишите полный URL скрипта, принимающего тексты смс на сайт. А также Вам надо выбрать все ли принятые смс передавать на сайт или по какому-либо признаку. И надо установить начальный номер для выгрузки смс на сайт – рядом жирным указана цифра, на картинке это 1013 – это номер последней принятой смс в базу ProfiSMS.

И также, для дополнительной безопасности, Вы можете установить пароль для вызова php-скриптов сайта. Этот пароль будет проверяться на самом сайте.

Теперь нажмите «Сохранить».

На этом настройку можно считать законченной и перейти к работе с программой.

ProfiSMS WebAPI это отдельная программа, позволяющая организовать двухстороннюю связь между программой ProfiSMS и одним или несколькими Интернет-сайтами. С этих сайтов можно будет как отправлять смс, так и показывать на сайтах полученные смс.

Ниже Вы можете увидеть графическое представление:

Как Вы знаете, программный комплекс ProfiSMS состоит из трех элементов:
1) Серверная часть, отвечающая за непосредственную работу с сотовым телефоном или GSM-модемом
2) Клиентская часть, через которую пользователи могут создавать и редактировать смс, рассылки, вести справочники клиентов и т.п.
3) База данных, под управлением СУБД Firebird. В ней хранятся все данные.

На рисунке выше, Вы видите, что ProfiSMS WebAPI (далее просто WebAPI) работает напрямую с базой данных ProfiSMS и организует связь с одним или несколькими сайтами в Интернет. Программа WebAPI устанавливается на локальный компьютер, с которого имеется доступ и к базе данных ProfiSMS и к сети Интернет.

Принцип работы очень прост. WebAPI с заданной периодичностью обращается к указанным сайтам, вызывая php-скрипты. И если скрипт выдает программе список смс для отправки, то WebAPI записывает эти смс в базу ProfiSMS. После этого WebAPI уведомляет сайт о том, что смс загружены и ждут отправки. После того, как серверная часть ProfiSMS отправит смс, WebAPI передает на сайт отчеты об отправке смс. Также WebAPI передает на указанные сайты и принятые смс программой ProfiSMS.

WebAPI имеет и свою базу данных, которая хранит промежуточные данные для обработки.

С WebAPI идут примеры php-скриптов для приема-выдачи смс с сайта. А также пример структуры базы данных для хранения смс на сайте (MySQL).

Далее мы рассмотрим интерфейс программы, а затем подробно рассмотрим работу WebAPI с точки зрения программиста (это нужно для того, чтобы легко интегрировать в Ваши существующие сайты).

Разработан и готов к применению специальный программный модуль, позволяющий осуществить интеграцию программы ProfiSMS и Ваших сайтов. Название программы WebAPI ProfiSMS.

Вкратце об этом модуле.

ProfiSMS WebAPI это отдельная программа, позволяющая организовать двухстороннюю связь между программой ProfiSMS и одним или несколькими Интернет-сайтами. С этих сайтов можно будет как отправлять смс, так и показывать на сайтах полученные смс.

Ниже Вы можете увидеть графическое представление:

Как Вы знаете, программный комплекс ProfiSMS состоит из трех элементов:
1) Серверная часть, отвечающая за непосредственную работу с сотовым телефоном или GSM-модемом
2) Клиентская часть, через которую пользователи могут создавать и редактировать смс, рассылки, вести справочники клиентов и т.п.
3) База данных, под управлением СУБД Firebird. В ней хранятся все данные.

На рисунке выше, Вы видите, что ProfiSMS WebAPI (далее просто WebAPI) работает напрямую с базой данных ProfiSMS и организует связь с одним или несколькими сайтами в Интернет. Программа WebAPI устанавливается на локальный компьютер, с которого имеется доступ и к базе данных ProfiSMS и к сети Интернет.

Принцип работы очень прост. WebAPI с заданной периодичностью обращается к указанным сайтам, вызывая php-скрипты. И если скрипт выдает программе список смс для отправки, то WebAPI записывает эти смс в базу ProfiSMS. После этого WebAPI уведомляет сайт о том, что смс загружены и ждут отправки. После того, как серверная часть ProfiSMS отправит смс, WebAPI передает на сайт отчеты об отправке смс. Также WebAPI передает на указанные сайты и принятые смс программой ProfiSMS.

WebAPI имеет и свою базу данных, которая хранит промежуточные данные для обработки.

С WebAPI идут примеры php-скриптов для приема-выдачи смс с сайта. А также пример структуры базы данных для хранения смс на сайте (MySQL). Также в комплекте идет полное описание работы с модулем и подробнейшее руководство для разработчиков.

Чуть позже на сайте будет полное описание.

Скачать WebAPI ProfiSMS