Добро пожаловать в раздел документации для разработчиков BSG.

Если вы хотите использовать наши REST API, получать уведомления от перехватчиков или создать приложение для Intercom Messenger, вы оказались в нужном месте.

SMPP Введение

SMPP — (Short Message Peer-to-Peer) короткие сообщения одноранговой сети. Является открытым стандартом в телекоммуникационной отрасли, который разработан специально, чтобы обеспечить гибкий интерфейс для передачи коротких сообщений между внешними сущностями (устройства, приложения) коротких сообщений (ESME), маршрутизаторами и центров сообщений (SMSC).

Сервер SMPP

HOST

PORT

smpp.bsg.world

2730

Привязки и пропускная способность

Всякий раз, настраивая учетную запись SMPP, вы получите максимальное количество привязок, которое разрешено установить. В большинстве случаев это 3 привязки, с пропускной способностью 50 сообщений в секунду. Сервер BSG SMPP поддерживает только одно подключение через трансивер (TRX) или несколько соединений через передатчик (TX) с одним подключенным приемником (RX).

Имя пользователя и пароль

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

Безопасность

Для соединения SMPP BSG требует внести в white list ваш исходный IP-адрес. Чтобы получить доступ, отправьте свое имя пользователя и исходный IP-адрес в нашу службу поддержки support@bsg.hk.

Поддерживаемые PDUs

Сервер BSG поддержиет следующие PDU файлы:

PDU name

command_id

bind_receiver

0x00000001

bind_receiver_resp

0x80000001

bind_transmitter

0x00000002

bind_transmitter_resp

0x80000002

bind_transceiver

0x00000009

bind_transceiver_resp

0x80000009

deliver_sm

0x00000005

deliver_sm_resp

0x80000005

enquire_link

0x00000015

enquire_link_resp

0x80000015

submit_sm

0x00000004

submit_sm_resp

0x80000004

unbind

0x00000006

unbind_resp

0x80000006

Bind PDU

SMPP bind_receiver, bind_transceiver или bind_transmitter PDU имеет фиксированный набор полей. Большинство полей не имеют к нам никакого отношения. Мы читаем только system_id, password, system_type and interface_version поля. Остальное игнорируется.

Имя поля

Описание

system_id

The username

password

SMPP-password

system_type

IGNORED if you want to use default tariff or set tariff-x, where x is the code of tariff name

interface_version

The SMPP protocol version you want to talk

addr_ton

IGNORED

addr_npi

IGNORED

address_range

IGNORED

Interface_Version

BSG SMPP сервер поддерживает SMPP протокол версии 3.4 and 5.0. Обратите внимение, что в SMPP 5.0. команда SUBMIT_SM_RESP содержит статус кода ошибки, длина PDU составляет 16 oктет.

Data_Coding

The values for the data_coding field are not solidly declared in the SMPP spec, so each SMPP server is more or less required to give its own definition.

Value

Encoding

Default Alphabet (GSM 3.38), 7-bit characters

IA5/ASCII, 7-bit characters

ISO-8859-1 (LATIN1), 8-bit characters

Japanese (JIS), multi-byte characters

Cyrillic (ISO-8859-5), 8-bit characters

Latin/Hebrew (ISO-8859-8), 8-bit characters

Unicode (USC-2), 16-bit characters

Korean (KS C 5601), multi-byte characters

Для 7-битных наборов символов в одно SMS-сообщение может поместиться максимум 160 символов; для 8-битных наборов символов ограничение составляет 140 символов; для 16-битных наборов символов ограничение составляет 70 символов; для многобайтовых наборов символов ограничение составляет от 70 до 140 символов, в зависимости от того, из каких символов был составлен текст сообщения. (Для многобайтовых наборов символов большинство символов имеют размер 16 бит; некоторые из наиболее распространенных символов состоят из восьми бит.)