Маркетолог

Как настроить SMPP-подключение черeз Stunnel

Как настроить SMPP-подключение черeз IPsec

Требования к отправке сообщений

Ошибки при отправке

Как установить Stunnel

Как настроить SMPP-подключение черeз Stunnel

1. Напишите нам в поддержку на supmarketolog@mts.ru, чтобы мы добавили ваш IP-адрес в разрешённые.
   
   Тема письма: Cетевой доступ для SMPP, ИНН организации
   В письме: название организации и ИНН, логин от SMPP-подключения, IP-адрес, до которого нужно открыть доступ.
    
2. Установите stunnel на компьютер и запустите его. Инструкция по установке на разные ОС есть в конце статьи.
3. При подключении командой bind_transceiver, используйте ip-адрес stunnel 127.0.0.1 и порт 3800. Если stunnel и SMPP клиент находятся на разных хостах, укажите ip-адрес хоста, на котором установлен stunnel.
4. При запуске сессии командой bind_ установите в PDU параметры:
   system_id — логин, который вы получили при создании SMPP-подключения в кабинете МТС Маркетолога
   password — пароль, оттуда же
5. Как запустите сессию — можно отправлять SMS командой submit_sm.

 Подробнее о команды bind_* и submit_sm — в спецификации SMPP 3.4

Как настроить SMPP-подключение черeз IPsec

После настроек на стороне МТС:

1. Настройте L2L сеть через IPsec.
2. Поднимите SMPP-подключение:

2. 1. При подключении командой bind_transceiver, используйте ip-адрес 10.241.88.195, порт 3700. Либо URL prov.omnichannel.vas.mts.ru:3700

2. 2. При запуске сессии командой bind_ установите в PDU параметры:
system_id — логин, который вы получили при создании SMPP-подключения в кабинете МТС Маркетолога
password — пароль, оттуда же.

2. 3. Как запустите сессию — можно отправлять SMS командой submit_sm.

Подробнее о команды bind_* и submit_sm — в спецификации SMPP 3.4

Требования к отправке сообщений

• Протокол взаимодействия с SMSC — SMPP v3.4
• Сервис работает в синхронном и асинхронном режимах. Размер окна — 99, пропускная способность — 10 SMS в секунду.
• Для обмена SMS между оборудованием и SMSC может использоваться любой из типов подключения: transmitter, receiver, transceiver — в зависимости от направления трафика: на Пользователя, от Пользователя, на и от Пользователя.
• Если SMPP- и TCP-сессии оборвутся, ожидайте 1,5 минуты — после установите новую TCP-сессию и отправьте в сторону SMSC PDU команду bind_transceiver/ bind_transmitter / bind_receiver. Если соединение оборвётся, увеличьте ожидание до 2 минут.
• При отправке PDU bind_transceiver выставите значения полей

Address TON (addr_ton) = 0
Address NPI (addr_npi) = 0
Address Range (address_range) = NULL

• Номер получателя в формате 79ххххххххх должен иметь:

 destination_addr_ton = 1 и destination_addr_npi = 1

 Буквенно-цифровой номер отправителя (alphanumeric) должен иметь:

 source_addr_ton = 5, source_addr_npi = 0

• Оборудование должно отправлять на каждый полученный от SMSC PDU deliver_sm (data_sm) подтверждение deliver_sm_resp (data_sm_resp) со статусом 0 (OK). Отправка PDU generic_nack запрещена
• Оборудование должно отправлять PDU enquire_link каждые 30 секунд вне зависимости от наличия или отсутствия трафика в SMPP-соединении.
• SMS из более чем из одного сегмента, отправленные со стороны контент-провайдера, должны содержать UDH или SAR параметры — чтобы корректно соединить части сообщения абонентским терминалом Пользователя
• В одной части составного SMS можно передавать не более 67 символов в кириллице и 153 в латинице.
• Если SMSC получает от Оборудования составное SMS, то отправляет ответ в PDU submit_sm_resp — каждый раз, когда получает часть SMS. При этом Оборудование должно передать все части составного SMS за период не более 60 секунд. Если не соблюдать требование, SMSC не отправит полученные от Оборудования части составного SMS и отправит на Оборудование PDU deliver_sm с отчётом о доставке delivery report, содержащим код ошибки 0x00000384 (ESME_RCNCTTIMEOUT).
• Используйте схему кодировки DCS 0х03 (HEX) для текста на латинице и DCS 0х08 (HEX) для текста на кириллице — в соответствии со спецификациями SMPP v3.4/v.5.0, 3GPP TS 23.038.
• Значение параметра validity_period не должно быть меньше 60 секунд. Если значение будет меньше — оно принудительно изменится на 60.
• Кодировка поля destination_addr должна быть в ASCII (символы между 36 (0x24) и 126 (0x7E)).
• Значение поля protocol_id должно быть = 0.
• Контролируйте равномерность скорости отправки SMS. Например, если установлено ограничение 100 SMS в секунду — отправляйте SMS каждые 10 миллисекунд, а не 100 SMS за первые 100 миллисекунд.
• Если при разрыве TCP-сессии со стороны SMSC в сторону Оборудования отправляется TCP-пакет с флагом FIN, то в ответ Оборудование должно отправить пакет FIN (FIN, ACK). Любой другой ответ запрещён.
• Чтобы отслеживать правильность взаимодействия SMSC и Оборудования по протоколам TCP и SMPP, рекомендуем использовать протокольный анализатор — например, Wireshark. Если возникнут проблемы в работе сервиса следует провести анализ tcpdump, описать проблему и направить tcpdump на supmarketolog@mts.ru

Ошибки при отправке

Как установить stunnel

Нужна версия  5.56+
 

sudo apt-get install stunnel4

sudo nano /etc/stunnel/stunnel.conf

[smpp]
client = yes
accept = 0.0.0.0:3800
connect = smpp.marketolog.mts.ru:3800

sudo systemctl start stunnel
sudo systemctl enable stunnel

wget https://www.stunnel.org/downloads/stunnel-5.XX.tar.gz

tar -xvf stunnel-5.XX.tar.gz

cd stunnel-5.XX
./configure
make
make install

sudo vim /etc/stunnel/stunnel.conf

[smpp]
client = yes
accept = 0.0.0.0:3800
connect = smpp.marketolog.mts.ru:3800

stunnel /etc/stunnel/stunnel.conf

sudo docker run -d -e STUNNEL_CLIENT=yes -e STUNNEL_ACCEPT=0.0.0.0:3800 -e STUNNEL_CONNECT=smpp.marketolog.mts.ru:3800 -e STUNNEL_SERVICE=smpp -p 3800:3800 dweomer/stunnel