Как настроить интеграцию по SMPP

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

1. Перейдите на stunnel.org и загрузите файл stunnel-5.XX-win64-installer.exe. Вместо XX должен быть номер актуальной версии

2. Щёлкните дважды по скачанному .exe-файлу, чтобы начать установку

3. Следуйте инструкциям мастера установки. Рекомендуется оставить все параметры по умолчанию

4. После установки нажмите на ярлык Stunnel на рабочем столе, чтобы запустить приложение

5. Откройте файл конфигурации. В главном окне программы выберите Configuration > Edit Configuration

6. Откроется файл конфигурации. Удалите из него всё и внесите новые данные:

7. Сохраните файл и перезапустите приложение через меню Configuration > Reload Configuration или полностью закройте и запустите заново

Ubuntu 20.04 и выше

1. Установите Stunnel:

sudo apt-get install stunnel4

2.  Создайте файл conf и сконфигурируйте коннект:

sudo nano /etc/stunnel/stunnel.conf
[smpp]
client = yes
accept = 0.0.0.0:3800
connect = smpp.marketolog.mts.ru:3800

3. Запустите Stunnel:

sudo systemctl start stunnel
sudo systemctl enable stunnel

CentOS 7 и ниже

1. Скачайте Stunnel, вместо XX нужно указать доступную версию:

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

2. Распакуйте:

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

3. Соберите и установите. В процессе сборки могут потребоваться дополнительные пакеты в системе, их нужно будет доставить:

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

4. Создайте файл conf и сконфигурируйте коннект:

sudo vim /etc/stunnel/stunnel.conf
[smpp]
client = yes
accept = 0.0.0.0:3800
connect = smpp.marketolog.mts.ru:3800

5. Запустите Stunnel:

stunnel /etc/stunnel/stunnel.conf

Из Docker

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

• SMSC — SMS-центр
• Пользователь — вы
• Оборудование — например, ваш сервер
• Абонент — получатель SMS

• Протокол взаимодействия с 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

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

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

Если SMS не отправилось, SMSC может передать код ответа в PDU submit_sm_resp, так и в PDU deliver_sm в виде отчёта о доставке. Даже если SMS принято к отправке — это не значит, что оно точно будет доставлено.

Код ошибки 903 SMSC delivery timeout (ESME_RDLVRTIMEOUT) формируется, если через 72 часа после принятия SMS к отправке, если от SMSC не получен pdu deliver_sm c delivery_report. Либо после истечения срока, который задан в pdu submit_sm (validity period).

1. Проверьте, что у вас подключён подходящий тариф 
2. Проверьте, что имя отправителя подключено на всех нужных операторов
3. Если на вашей стороне нет проблем, напишите нам supmarketolog@mts.ru. Укажите в письме подробности, чтобы мы могли помочь быстрее:

• название компании
• system_id — логин для подключения к платформе
• описание проблемы
• пример сообщения — дата, время, system_id, имя отправителя, номер получателя, message_id, коды ошибок
• tcpdump, логи с ошибкой, статистика по ошибке