Рассылка SMS при помощи SMTP

http://websms.ru
Рассылка SMS при помощи SMTP
Техническое описание
V1.5 25.01.2013
http://websms.ru
Рассылка SMS при помощи электронной почты (SMTP)
Для того чтобы осуществить рассылку при помощи почты, необходимо послать на
адрес [email protected] определенным образом оформленное письмо.
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
Процедура отправки занята
Недозволительное имя отправителя