SMTP протокол
Рассылка sms через SMTP протокол возможна, как непосредственно из собственных приложений, так и используя специальные решения для работы с E-mail сообщениями, например, Bat.
Метод рассылки через SMTP sms сообщений еще называют e-mail2sms, по сути это отправка sms через e-mail.
Для настройки API через smtp протокол необходимо зарегистрироваться в системе SigmaSMS или обратиться к нашим специалистам любым удобным способом.
Содержание
Протокол SMTP и его дополнительные возможности, задействованные в системе, описаны в следующих документах:
1. Параметры
- Адрес сервера: api.sigmasms.ru
- Порт: 2525
- Тип авторизации: PLAIN (открытым текстом)
- Шифрованный канал SSL: опционально через команду STARTTLS
- Кодировка сообщений: любая, совместимая с MIME 1.0
- Максимальная длина сообщений: 480 символов.
2. Трактовка адресов отправителя и получателя
Домен получателя может принимать значения:
- api.sigmasms.ru: отправка текстовых сообщений на мобильные телефоны (SMS).
Адрес получателя трактуется следующими способами:
- В противном случае, при отсылке на XXXXX@…, XXXXX воспринимается как номер телефона. Символы '(',')','-' игнорируются.
Адрес отправителя почтового e-mail сообщения используется только в тех случаях, когда отправка идет на номер телефона, и преобразуется в имя отправителя сообщения на мобильный телефон. Преобразование производится по следующему алгоритму:
- Если email отправитель зарегистрирован как псевдоним отправителя телефонного сообщения, то используется соответствующий ему отправитель телефонного сообщения.
- Если email начинается с 'default@', то используется отправитель по умолчанию для агента.
- В остальных случаях за отправителя принимается текст до знака '@', а домен - игнорируется.
3. Специальные расширения протокола
В протоколе SMTP реализована возможность сверки статуса отосланных сообщений. После приема сообщения по команде «DATA» SMTP сервер выдает следующий статус:
S: 250 <id> message accepted, где
<id> - идентификатор сообщения. В последствии статус сообщения можно узнать командой «STATUS»:
C: STATUS <id>
S: 250 <id> <res_count> <closed> <status_code> any text , где
- <id> - идентификатор сообщения;
- <res_count> - количество единиц ресурса. Для SMS сообщений - количество кусков. Передается как вещественное число (например, «1.0»).
- <closed> - [0,1] - признак закрытия процессинга сообщения;
- <status_code> - код статуса, где «0» - сообщение находится в процессе доставки; «1» - сообщение принято оператором, но статус доставки неизвестен; «2» - сообщение доставлено; «3» - время попыток доставить сообщение оператором истекло; «5» - сообщение не может быть доставлено (ошибка в номере, номер не существует и т.д.); «8» - сообщение не принято оператором; «20» - отправка была отменена пользователей; «21» - ошибка системы; «22» - оператор не сообщил о состоянии сообщения за отведенное время.
Ознакомьтесь с примерами использования:
4. Пример сеанса отправки SMS
5. Пример настройки программы thebat
4. Пример сеанса отправки SMS
S: 220 Message gateway
C: EHLO mycomputer
S: 250-SMTP Server
S: 250-8BITMIME
S: 250-STARTTLS
S: 250-AUTH LOGIN PLAIN
S: 250 Ok
C: AUTH PLAIN
S: 334 Ok
C: ADMAZnJlZXRlc3Q=
S: 235 Authentication successful.
C: MAIL FROM:
S: 250 Ok
C: RCPT TO:<89061234567@api.sigmasms.ru>
S: 250 Ok
C: DATA
S: 354 End data with .
C: From: SMSGW
C: To: 89061234567@api.sigmasms.ru
C: MIME-Version: 1.0
C: Content-Type: text/plain; charset=windows-1251
C: Content-Transfer-Encoding: quoted-printable
C:
C: Privet !
C: .
C: 377
S: 250 33 message accepted.
C: STATUS 4418
S: 250 4418 1 0 0 Message is accepted for delivery
C: RSET
S: 250 Ok
C: QUIT
S: 221 Bye
5. Пример настройки программы thebat
Создайте новый почтовый ящик.

Впишите E-mail отправителя согласно правилам из раздела «Трактовка адресов отправителя и получателя».

Укажите SMTP сервер исходящей почты и пометьте флажок «SMTP сервер требует аутентификацию».

Впишите ваши имя пользователя и пароль.


После создания ящика вызовите его свойства и исправьте порт исходящего SMTP сервера с 25 на 2525.

Настройки закончены. Можно рассылать SMS.
