Протокол SMPP v.3.4 для рассылки Viber

Набор символов для сообщений, формирование склеенных сообщений

Default Alphabet (GSM 3.38), 7-bit characters - maximum of 160 characters;

• Latin 1 (ISO-8859-1), 8-bit characters - limit is 140 characters;

• Unicode (UTF16/USC-2), 16-bit characters - limit is 70 characters;

Кодировка для сообщений на латинице: GSM 03.38, длина одного сообщения 160 символов. Запрещенные символы: ^,{,},\,[,],~,|,€

Кодировка для сообщений на кириллице: UTF16, длина одного SMS сообщения составляет 70 символов:

Примечание: Для корректного отображения текста, необходимо указание - Data coding: 0x08 - SMPP Data Coding Scheme: UCS2 (ISO/IEC-10646) (0x08), а также формирование текста в UTF-16ВE (big endian)

Отправка длинных (склеенных) сообщений возможна с использованием UDH или message_payload (рекомендовано);

Примечание: Message_payload – один из опциональных SMPP 3.4 TLV (tag-length-value) параметров, поддерживаемых SMPP сервером. Применяется, например, при отправке сообщений более 254 октетов; ‘Message length: 0’; Optional parameter: message_payload (0x0424);

Параметры system_type, interface_version, addr_ton, addr_npi, address_range не анализируются

Дополнительные параметры

Для поддержания соединения в периоды отсутствия трафика используются PDU enquire_link

Таймаут: 1 минута;

Задержка в случае неудачного переподключения: 1 минута;

Верификация соединения (enquire_link PDU): 60 сек.;

Примечание: Enquire_link'и обязательны. Если клиент подключается к нам transmitter'ом мы ожидаем от него enquire_link'и, при их отсутствии в течение 2 минут – связь считается нарушенной и принудительно рвется.

Номер абонента всегда должен начинаться с «7» для абонентов России, использование «8» для отправки по России недопустимо.

Скорость передачи SMS не более 50 Viber в секунду.

Указание адреса, происходит в международном формате, использование специальных символов, таких как «+», ведущих нулей – недопустимо.

Обмен сообщениями

Для передачи сообщений между сервером и клиентом используются пакеты submit_sm, deliver_sm и соответствующие им ответные пакеты submit_sm_resp и deliver_sm_resp

SMPP-интерфейс предоставляет Партнерам техническую возможность по отправке в адрес абонентов Viber-сообщений следующего содержания:

• только текст (до 1000 символов)

• только изображение

• текст (до 1000 символов) и гиперссылку в виде кнопки

• текст (до 1000 символов), изображение, гиперссылку в виде кнопки

Для отправки Абоненту Viber-сообщения Партнер передает пакет submit_sm используя стандартные для протокола SMPP 3.4 параметры, а информация об изображении, кнопке, ссылке кнопки передается в TLV-параметрах.

Для передачи текста сообщения следует использовать кодировку UCS2 (data_coding = 8). Для передачи сообщений в латинице возможно использование data_coding = 0, что соответствует кодировке GSM DEFAULT ALPHABET.

Длина текста передаваемого МТ сообщения составляет 1000 символов (ограничение на стороне Viber).

Длинные (многосегментные с точки зрения SMS/SMPP) текстовые сообщения рекомендуется передавать одной PDU, отправляя текст в TLV-параметре message_payload, id = 0x424.

Помимо основных параметров можно использовать опциональные TLV-параметры, специфичные для отправки сообщения в Viber:

Получение конечных статусов

В submit_sm PDU – необходимо выставить флаг registered_delivery = 0x01 (в SMPP по умолчанию 0x01), тогда будут приходить Deliver_ sm PDU c информацией о доставке.

В таких пакетах (в отличие от обычных Deliver_sm) поле esm_class будет выставлено в 0x3c.

В поле receipted_message_id будет выставлено то значение, которое вы получили в submit_sm_resp от нашей платформы. В поле receipted_message_state будет выставлен статус доставки по протоколу smpp.

Таким образом, deliver_sm PDU – содержит следующую информацию:

Operation: Deliver_sm (0x00000005)

Message type: 0x0f

Здесь в Optional parameters указывается - Message state: DELIVERED (2)

SMSC identifier: напр.: 23456789

В поле Message, присутствуют значения submit date и done date

message_state значение «2» - «Message is delivered to destination»

Примечание: При создании нескольких подключений по SMPP к одному логину, стаусы некоторых смс сообщений, отправленных от одного подключения, могут возвращаться на другое подключение.

Формат DR соответствует формату:

Статусы SMS сообщений (по информации от SMS центров)

Список SMPP ошибок