Для отправки одиночного SMS сообщения следует вызвать скрипт http://www.virtualofficetools.ru/api/sms.task.once.api.php и передать методом POST следующие параметры:
| Имя Поля | Тип | Описание |
| username* | Text | Имя пользователя в системе VirtualOfficeTools |
| password* | Text | MD5 хэш пароля пользователя в системе VirtualOfficeTools |
| sender* | Text | Имя отправителя - строка латинских букв или цифр не более 11 символов |
| phone* | Text | Телефон в формате: <10-значный номер абонента> либо <10-значный номер абонента>, например, 9111234567; отправка СМС за переделы РФ не производится. |
| smstext* | Text | Текст сообщения |
| starttime | Text | Дата отправки сообщения например: 2011-05-05 17:30. |
* - параметр является обязательным
В ответе сгенерирует XML сообщение следущего вида:
1. В случае успешной постановки задачи:
<?xml version="1.0"?>
<response>
<error code="0" message="" details="" />
<data>
<item id="766869" phonenumber="88123350515" jobstatus="0" errorcode="" jobcompletetime="" addinfo="" now="2011-05-05 15:40:35" />
</data>
</response>
Где:
| Имя Поля | Тип |
| id | уникальный идентификатор задачи |
| phonenumber | номер телефона на который будет отправленно сообщение |
| jobstatus | статус выполнения 0 -- задача находится в процессе обработки |
2. Если же в процессе постановки задачи (либо в полученных данных) была ошибка то:
<?xml version="1.0"?>
<response>
<error code="4" message="Имя отправителя строка латинских букв и цифр длиной не более 11 символов" details="Error: sender is invalid length" />
</response>
Для отправки множественной СМС рассылки следует вызвать скрипт http://www.virtualofficetools.ru/api/sms.task.api.php и передать методом POST следующие параметры:
| Имя Поля | Тип | Описание |
| username* | Text | Имя пользователя в системе VirtualOfficeTools |
| password* | Text | MD5 хэш пароля пользователя в системе VirtualOfficeTools |
| sender* | Text | Имя отправителя - строка латинских букв или цифр не более 11 символов |
| smstext* | Text | Текст сообщения |
| starttime | Text | Дата отправки сообщения например: 2011-05-05 17:30. |
| FLIST* | file | Файл с номерами для отправки Формат файла CSV (Comma Separated Values) вида: 88121112233 84952223344 84993334455 |
* - параметр является обязательным
В ответе сгенерирует XML сообщение аналогичное случаю отправки одиночного СМС, с единственным отличием что в случае успеха количество элементов item в ответе будет соответствовать количеству поставленных задач.
Внимание! Существует возможность отправить персонифицированную рассылку для этого в тексте сообщения в нужных местах укажите подстановочные переменные в виде {%}.
Например:
«Здравствуйте, {%}! Ваша задолженность составляет {%}. Просим погасить задолженность до 15.12.11»
Создайте файл с номерами получателей сообщений и значениями для подстановочных переменных. Файл должен соответствовать формату CSV. Номера и значения переменных должны разделяться точкой с запятой.
Например:
89218887766;Иван Иванович;352,60 руб
89115554433;Иван Петрович;1034,00 руб
Дата добавления: 2015-09-11; просмотров: 92 | Поможем написать вашу работу | Нарушение авторских прав |