SMTP протокол

Рассылка sms через SMTP протокол возможна, как непосредственно из собственных приложений, так и используя специальные решения для работы с E-mail сообщениями, например, Bat.

Метод рассылки через SMTP sms сообщений еще называют e-mail2sms, по сути это отправка sms через e-mail.

Для настройки API через smtp протокол необходимо зарегистрироваться в системе SigmaSMS или обратиться к нашим специалистам любым удобным способом.

Содержание

1. Параметры

2. Трактовка адресов отправителя и получателя

3. Специальные расширения протокола

4. Пример сеанса отправки SMS

5. Пример настройки программы thebat

Смотрите также:

Протоколы

протокол HTTP
протокол SMPP
протокол XML
протокол SOAP

Справочники

Модуль для 1С

Разрешенные символы в имени отправителя

Определение длины сообщения

Использование регулярных выражений

Протокол 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