http://websms.ru Рассылка SMS при помощи SMTP Техническое описание V1.5 25.01.2013 http://websms.ru Рассылка SMS при помощи электронной почты (SMTP) Для того чтобы осуществить рассылку при помощи почты, необходимо послать на адрес post@websms.ru определенным образом оформленное письмо. 1. Формат письма (кодировка). Письмо должно быть в текстовом виде (Content-Type: text/plain;). Письма в формате HTML обрабатываться будут, но гарантии корректного распознавания в этом случае нет. Если в сообщении содержится текст на русском языке, то указанная в заголовке кодировка должна совпадать с той, что реально содержится в письме. Если в заголовке кодировка не указана, то по умолчанию принимается KOI8-R ВНИМАНИЕ!: при генерации письма программным способом необходимо указать тип содержимого MIME – текстовый (например, Content-Type: text/plain; для MIME-Version: 1.0). 2. Поля, указываемые в сообщении Обязательные: user, pass, mess, tels Необязательные: id, date, fromphone, valid_period user – имя пользователя (логин). Указывается именно тот логин, под которым Вы входите в свой раздел на сайте WebSMS. Если логин неверен, то сообщение не будет принято к обработке. user=MyLogin pass – Пароль пользователя заданный в личном кабинете, в разделе «Персональные настройки – Смена пароля - Смена пароля доступа по HTTP, SMTP, SMPP» pass=mypassword mess –текст сообщения. Пишется в одну строчку. Если сообщение написано русскими буквами, то его максимальная длина 70 символов, если латинскими – 160. Если сообщение превосходит эту длину, то оно будет разбито на несколько сообщений, которые на телефоне абонента будут склеены в одно. Оплата за каждую из частей сообщения взимается отдельно. mess=Текст сообщения Внимание! Некоторые почтовые клиенты автоматически разбивают длинные строки на несколько частей. Такое форматирование недопустимо – сообщение должно быть написано в одну строку, иначе будет передана только та часть текста, которая находится в первой строке. Если нужно сделать перенос строки, то вместо него в текст вставляются символы «\n» tels – список телефонов получателей. Телефон может быть один или несколько, в приведенном примере они разделяются запятыми. tels=79161234567, 70951234567, 79031234567 Внимание! Знак "+" перед номером ставить не надо. Используйте только международный формат. Переносы недопустимы. groups – id группы в телефонной книге. groups =12345 http://websms.ru id – уникальный идентификатор сообщения. Задается отправителем. Значением его может быть любое целое число. id=12345 date – дата и время желаемой отправки (по умолчанию немедленно). date=30.09.02 14:30 Внимание! Формат даты dd.mm.yy hh:nn fromphone – идентификатор отправителя (имя отправителя), т.е. то что увидит получатель на своем телефоне вместо номера отправителя. fromphone =Magazin Внимание! Параметр fromphone может содержать только латинские буквы, цифры, пробел и знаки препинания. Длина этого поля не должна превышать 11 знаков с использованием символов или 15 знаков с использованием только цифр. valid_period - Время жизни смс-сообщений в минутах. По умолчанию значение 1440 (сутки). Максимальное значение 1440. Заголовок (subject) письма можно не указывать, он не обрабатывается системой. Каждый параметр должен быть на отдельной строке. Пример текста письма для отправки одного текста сообщения http://websms.ru В случае если необходимо разослать несколько смс разного содержания, это можно сделать также в одном письме. Для этого номер и текст сообщения указываются в параметре sms через запятую. sms=7123456789, Здравствуйте, Василий sms=79877656443, Здравствуйте, Петр Параметр (или параметры) sms в теле письма должен быть последним. Пример текста письма для отправки разных текстов сообщения В случае возникновения ошибки при обработке письма сервер websms может возвращать код ошибки. http://websms.ru Коды ошибок код значение 0 ok 1 error login, password 2 blocked user 3 insufficient funds 4 blocked ip 5 http not enabled 6 this server ip not enabled 7 email sending not enabled 8 this email not enabled 9 blocked moderator ID 10 error manual phone list Недопустимые символы в адресатахphone_list empty message text Не задан текст сообщения - message 11 описание Данные приняты системой Неверный логин, пароль Доступ заблокирован На счете недостаточно средств IP адрес заблокирован Персональные настройки запрещают отправку по HTTP IP-адрес не указан в персональных настройках Персональные настройки запрещают отправку по smpp (ошибка возвращается только при отправке через smtp) Персональные настройки запрещают отправку по smtp (ошибка возвращается только при отправке через smtp) Доступ модератору закрыт (при наличии назначенного дополнительного доступа) Не заданы адресаты - phone_list (из переданных номеров удаляются дубликаты и заблокированные) 12 empty phone list 13 stop service 14 error format date 15 double sent from web interface Повторная отправка допускается через 10 секунд (только для web-интерфейса) 16 error dealer off Сервисы недоступны (только для дилеров) 17 error multiaccess 20 Incorrect Group Неверный формат параметра - Group 21 empty password Не указан пароль -http_password 22 empty login Не указан логин - http_username 23 Invalid FromPhone Сервис временно недоступен Неверный формат даты - send_on Процедура отправки занята Недозволительное имя отправителя