Willkommen im Bereich der BSG-Entwicklerdokumentation

Wenn Sie unsere REST-API verwenden, Benachrichtigungen von Abfangjägern erhalten oder eine App für den Intercom Messenger erstellen möchten, sind Sie hier genau richtig

SMPP EINLEITUNG

Short Message Peer-to-Peer (SMPP) wird zum Senden und Empfangen von SMS-Verkehr zwischen verschiedenen Seiten verwendet. SMPP ist besonders beliebt bei aktiven SMS-Benutzern, einschließlich Aggregaten und Betreibern.

Der SMPP Server

HOST

PORT

smpp.bsg.world

2730

Bindungen und Durchsatz

Immer wenn ein SMPP-Konto für Sie eingerichtet wurde, erhalten Sie die maximale Anzahl an Bindungen, die Sie einrichten dürfen, sowie einen maximalen Durchsatz. In den meisten Fällen sind dies etwa 3 Bindungen und 50 Nachrichten pro Sekunde. HINWEIS: Der BSG SMPP-Server unterstützt bei Bedarf nur eine Verbindung über den Transceiver (TRX) oder mehrere Verbindungen über den Sender (TX) mit einer Verbindung über den Empfänger (RX).

Benutzername und Passwort

Ihr Benutzername (system_id) und Ihr Passwort (SMPP-Passwort) werden Ihnen von Ihrem Account Manager bei BSG mitgeteilt oder Sie können in Ihren Kontoeinstellungen ein SMPP-Passwort generieren.

Sicherheit

Für eine SMPP-Verbindung benötigt BSG eine Whitelist Ihrer Ursprungs-IP. Um darauf zuzugreifen, senden Sie bitte Ihren Benutzernamen und Ihre ursprüngliche IP an unser Kundendienstteam unter: support@bsg.hk.

Unterstützte PDUs

Der BSG-Server unterstützt die folgende Liste von PDU-Typen:

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

PDU binden

Eine SMPP-PDU-Anforderung bind_receiver, bind_transceiver oder bind_transmitter verfügt über einen festen Satz von Feldern. Die meisten Felder sind für uns irrelevant. Tatsächlich lesen wir nur die Felder system_id, password, system_type und interface_version und der Rest wird ignoriert.

Field name

Description

system_id

The username

password

SMPP-password

system_type

IGNORED if you want 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

Schnittstellenversion

Der BSG SMPP-Server unterstützt die SMPP-Protokollversionen 3.4 und 5.0. HINWEIS für SMPP 5.0! Falls der Befehl SUBMIT_SM_RESP einen Status mit einem Fehlercode enthält, beträgt die Länge der PDU 16 Oktette.

Data_Coding

Die Werte für das Feld data_coding sind in der SMPP-Spezifikation nicht fest deklariert, sodass jeder SMPP-Server mehr oder weniger eine eigene Definition angeben muss.

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

Bei 7-Bit-Zeichensätzen können maximal 160 Zeichen in eine SMS-Nachricht passen. Für 8-Bit-Zeichensätze beträgt das Limit 140 Zeichen. Für 16-Bit-Zeichensätze beträgt das Limit 70 Zeichen. Bei Mehrbyte-Zeichensätzen liegt die Grenze zwischen 70 und 140 Zeichen, je nachdem, aus welchen Zeichen der Text der Nachricht besteht. (Bei Mehrbyte-Zeichensätzen sind die meisten Zeichen 16 Bit; einige der gebräuchlichsten Zeichen sind acht Bit.)