Инструкция по работе с SMSC

Введение

Сервис SMSC предназначен для передачи SMS-сообщений. Сервис работает на основе протокола SMPP 3.4.

Для работы по протоколу SMPP требуется клиент. Для большинства популярных языков программирования имеются свободно распространяемые SMPP-клиенты, реализованные в виде специализированных библиотек.

В последующих разделах приводятся инструкции и рекомендации по работе с SMSC i-Digital.

Параметры SMPP

В таблице ниже указаны обязательные параметры, необходимые для подключения к SMSC. Они предоставляются i-Digital и указываются в настройках SMPP-клиента.

ВАЖНО:

• рекомендуемая скорость передачи - не более 100 PDU/сек;
• максимальное время ожидания ответного пакета (время ожидания пакета ENQUIRE_LINK_RESP) - 30 сек;
• таймаут в случае неудачного подключения - 60 cек;
• длина имени отправителя не должна превышать 11 символов;
• номер абонента (destination_addr) передаётся в формате E.164 без указания «+» в начале;
• номера операторов РФ должны начинаться с цифры 7 (например, 79111234567); использование символа «8» вместо «7» в начале номера недопустимо.

Поддерживаемые типы подключения

Поддерживаютcя следующие типы подключений:

• TRANSCEIVER - универсальный тип подключения, при котором можно как передавать, так и принимать пакеты. Рекомендуется к использованию;
• TRANSMITTER - тип подключения, при котором можно только отправлять пакеты на сервер, но не принимать их.

ВАЖНО:

Если вам нужно получать отчёты о доставке, используйте подключение типа TRANSCEIVER.

Поддерживаемые типы пакетов

В SMSC поддерживаются следующие типы пакетов:

• BIND_TRANSCEIVER;
• BIND_TRANSMITTER;
• UNBIND;
• SUBMIT_SM;
• DELIVER_SM
• ENQUIRE_LINK.

Настройки кодировки

Сообщения, отправляемые через SMSC, могут состоять из латинских и кириллических букв, а также включать спецсимволы (русские и латинские буквы с диакритическими знаками, буквы греческого и других алфавитов, специфические знаки препинания, а также непечатные символы). При передаче сообщений рекомендуется использовать настройки, указанные в таблице ниже.

ВАЖНО:

Будьте внимательны при использовании в SMS следующих символов:

£,¥,è,é,ù,ì,ò,Ç,Ø,ø,Å,å,Δ,Φ,Γ,Λ,Ω,Π,Ψ,Σ,Θ,Ξ,Æ,æ,ß,É,¤,¡,Ä,Ö,Ñ,Ü,§ ¿,ä,ö,ñ,ü,à,
NUL,SOH,STX,ETX,EOT,ENQ,ACK,BEL,BS,TAB,VT,SO,SI,DLE,DC1,DC2,DC3,DC4,
NAK,SYN,ETB,CAN,EM,SUB,FS,GS,RS,US,`,DEL. 

Операторы (в зависимости от особенностей их платформы и спецификации) могут не поддерживать эти символы или конвертировать сообщения в Unicode, тем самым увеличивая количество тарифицируемых частей сообщения.

Отправка многосоставных SMS

Согласно спецификации протокола SMPP максимальная длина одного отправляемого SMS составляет:

• для сообщений латиницей - 160 символов;
• для сообщений кириллицей - 70 символов.

SMS, длина которых превышает установленный максимум, называются многосоставными и обычно делятся на части при отправке. Размер одной части составляет:

• для сообщений латиницей - 153 символа;
• для сообщений кириллицей - 67 символов.

Для отправки многосоставных SMS используется одна из следующих трёх технологий:

• UDH (user data header) - специальный заголовок, расположенный в начале текста SMS-сообщения;
• SAR - аналог UDH-заголовка; благодаря расположению в TLV-полях не уменьшает размер одной части SMS;
• message_payload - TLV-поле, в котором размещается всё содержимое сообщения.

С подробной информацией об этих технологиях можно ознакомиться в спецификации протокола SMPP.

ВАЖНО:

В каждой части многосоставного SMS должны совпадать значения следующих полей:

• service_type;
• source_addr_ton;
• source_addr_npi;
• source_addr;
• dest_addr_ton;
• dest_addr_npi;
• destination_addr;
• esm_class;
• protocol_id;
• priority_flag;
• validity_period;
• registered_delivery;
• data_coding .

Сообщение не будет доставлено, пока не будут получены все его части.

Время ожидания всех частей многосоставного сообщения составляет 10 минут. Если по истечении этого периода части не будут получены, сообщение не будет отправлено.

Получение статусов доставки сообщений

Чтобы запросить отчёт о доставке, для пакета SUBMIT_SM нужно установить флаг registered_delivery=0x01. В ответ SMSC отправляет пакет DELIVER_SM, содержащий поле short_message c отчётом о доставке.

Пример отчёта о доставке

(sm: enc: ASCII msg: id:50c66532df sub:001 dlvrd:001 submit date:191001000004 done date:191001000005 stat:UNDELIV err:000 text:<r:FINAL>)

Подробное описание параметров, входящих в отчёт, приведено в таблице ниже.

Параметры доставки SMS

Получение статусов многосоставных сообщений

При отправке многосоставного сообщения SMSC сразу возвращает статусы доставки на все части, кроме последней. При этом в поле short_message для каждой из частей, кроме последней, передаётся:

text:<r:PROGRESS>

Реальный статус доставки многосоставного сообщения передаётся на последнюю полученную часть. Для неё в после short_message передаётся

text:<r:FINAL>

Зарезервированные коды ошибок

В таблице ниже перечислены коды ошибок, которые SMSC возвращает в ответ на пакеты BIND и SUBMIT_SM.