NAV Navbar

Getting started

You may send and receive SMS messages using SMPP. Generic uses SMPP v3.4, please visit smpp.org for general specifications. Details about our specific implementation follows.

In order to use our SMPP API you need to have an account with SMPP enabled, please get in touch with our friendly support team or your sales contact and you'll be up and running in no time!

Email: kund@genericmobile.se
Phone: 020-31 00 41
International: +46 86016666

Messages sent and received with SMPP will be visible in the SMS Web portal.

Connection

Host: smpp.genericmobile.se
Port: 2775
SystemId: Your username
Password: and password.

Please let us know when we setup your account if you'd like TLS (encrypted connection) enabled.

We recommend two binds and a maximum of 10 messages/bind. If you need higher throughput, please reach out to your sales contact.
Recommended window size is between 7 and 10.

When performing updates to our servers your TCP connection may go down. Your client should simply reconnect to end up on a redundant server and avoid down time. Please don't send ENQUIRE_LINK more often than every 10 seconds.

SMPP Outbound

Message ID

You'll get a UUID/GUID as the MessageID for every successful SubmitSM. Eg. de9dc248-d91c-42c4-979d-81dee0db1ea5.

Source Address

A phone number (MSISDN) should be given in international format (leading + sign is optional). Max length is 18. An alphanumeric sender may contain A-Ö, a-ö, 0-9 or any of the special characters "#%&'()*+-./?, max 11 characters. However, some operators are not able to handle Swedish characters and because of that we recommend you to only use A-Z, a-z, 0-9.

Sender TON (Type of Number) NPI (Numbering Plan Identification)
+46707659443 1: International 1: Telephone number (E163/164)
0046707659443 1: International 1: Telephone number (E163/164)
46707659443 1: International 1: Telephone number (E163/164)
Generic 5: Alphanumeric 0: Unknown

Destination Address

Receiver TON (Type of Number) NPI (Numbering Plan Identification)
+46707659443 1: International 1: Telephone number (E163/164)
0046707659443 1: International 1: Telephone number (E163/164)

DCS (Data Coding Scheme)

Max message length for a GSM 7 bit message is 160 characters, if longer you'd need to split it into segments of max 153 characters (accounting for the UDH).
Max length for UCS2 is 70 characters, 67 if split into segments.
Some operators/handsets can't handle Windows newlines (\r\n), we recommend using only Unix style (\n).

Supported DCS:

DCS (decimal) Character Set Message Class
0 GSM 7 bit Default
1 GSM 7 bit (IA5) Default
3 Latin-1 (ISO-8859-1) Default
8 UCS2 Default
16 GSM 7 bit Class 0 (Flash message)
17 GSM 7 bit Class 1
18 GSM 7 bit Class 2
24 UCS2 Class 0 (Flash message)
25 UCS2 Class 1
26 UCS2 Class 2
240 GSM 7 bit Class 0 (Flash message)
241 GSM 7 bit Class 1
242 GSM 7 bit Class 2

GSM 03.38 character set

Each character is encoded to 7 bits (0x00..0x7F)

0x 1x 2x 3x 4x 5x 6x 7x
x0 @ Δ SP 0 ¡ P ¿ p
x1 £ _ ! 1 A Q a q
x2 $ Φ " 2 B R b r
x3 ¥ Γ # 3 C S c s
x4 è Λ ¤ 4 D T d t
x5 é Ω % 5 E U e u
x6 ù Π & 6 F V f v
x7 ì Ψ ' 7 G W g w
x8 ò Σ ( 8 H X h x
x9 Ç Θ ) 9 I Y i y
xA LF Ξ * : J Z j z
xB Ø ESC + ; K Ä k ä
xC ø Æ , < L Ö l ö
xD CR æ - = M Ñ m ñ
xE Å ß . > N Ü n ü
xF å É / ? O § o à

UDH (User Data Header)

Only used to indicate if it's a concatinated message and what reference number the message parts should group on. Supported IEI (Information Element Identifier) shown below.

IEI Length Description
0 3 Concatenated short message, 8-bit reference number.
1 4 Concatenated short message, 16-bit reference number.

SMPP PDU

Supported SMPP PDUs Description
BIND / UNBIND All bind modes are supported; ESME Transmitter, Receiver, Transceiver.
ENQUIRE_LINK / ENQUIRE_LINK_RESP Issued from SMSC if connection is idle for 60 seconds. May be issued from ESME as well.
SUBMIT_SM Issued by the ESME to submit a Short Message to the SMSC.
DELIVER_SM_RESP Issued by the SMSC to send a message to an ESME, a special account setup is required.