Рассылка SMS при помощи SMTP
Техническое описание
V
Рассылка SMS при помощи электронной почты (SMTP)
Для того чтобы осуществить рассылку при помощи почты определенным образом оформленное письмо.
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=, ,
Внимание! Знак "+" перед номером ставить не надо. Используйте только международный формат. Переносы недопустимы.
groups – id группы в телефонной книге.
groups =12345
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) письма можно не указывать, он не обрабатывается системой.
Каждый параметр должен быть на отдельной строке.
Пример текста письма для отправки одного текста сообщения
В случае если необходимо разослать несколько смс разного содержания, это можно сделать также в одном письме. Для этого номер и текст сообщения указываются в параметре sms через запятую.
sms=, Здравствуйте, Василий
sms=, Здравствуйте, Петр
Параметр (или параметры) sms в теле письма должен быть последним.
Пример текста письма для отправки разных текстов сообщения
В случае возникновения ошибки при обработке письма сервер websms может возвращать код ошибки.
Коды ошибок
код | значение | описание |
0 | ok | Данные приняты системой |
1 | error login, password | Неверный логин, пароль |
2 | blocked user | Доступ заблокирован |
3 | insufficient funds | На счете недостаточно средств |
4 | blocked ip | IP адрес заблокирован |
5 | http not enabled | Персональные настройки запрещают отправку по HTTP |
6 | this server ip not enabled | IP-адрес не указан в персональных настройках |
7 | email sending not enabled | Персональные настройки запрещают отправку по smpp (ошибка возвращается только при отправке через smtp) |
8 | this email not enabled | Персональные настройки запрещают отправку по smtp (ошибка возвращается только при отправке через smtp) |
9 | blocked moderator ID | Доступ модератору закрыт (при наличии назначенного дополнительного доступа) |
10 | error manual phone list | Недопустимые символы в адресатах - phone_list |
11 | empty message text | Не задан текст сообщения - message |
12 | empty phone list | Не заданы адресаты - phone_list (из переданных номеров удаляются дубликаты и заблокированные) |
13 | stop service | Сервис временно недоступен |
14 | error format date | Неверный формат даты - send_on |
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 | Недозволительное имя отправителя |
