SMPP
Vi understøtter SMPP version 3.4, branchens standardprotokol for sms-kommunikation. Vores opsætning tilbyder redundante tilslutningsmuligheder med et endpoint, der peger på to forskellige lokationer.
Forbind
For at oprette forbindelse har du brug for følgende:
Parameter
Value
system_id
Individual per account
password
Individual per account
hosts
smpp-dk1.inmobile.dk
smpp-dk2.inmobile.dk
port
2775 (ssl is required for all connections - no support for non-ssl)
ConnectionMode
Individual per account
Kontakt os venligt på [email protected] for at få et SMPP system id.
Kryptering via SSL/TLS
Som det tidligere er blevet nævnt, skal al kommunikation foregå via krypterede forbindelser. For at opnå dette, er det nødvendigt, at applikationerne henter og bruger det certifikat, som anvendes på https://mm.inmobile.dk (Det er et wildcard-certifikat for *.inmobile.dk).
Understøttede beskedtyper
- bind_transmitter
- bind_receiver
- bind_transceiver
- unbind
- submit_sm
- deliver_sm
- enquire_link
DataCodings
Data coding
Hex value
Binary encoding
Default
0x0
GSM7
Default Class 0
0x10
GSM7
UCS2
0x8
UTF-16 (big endian byte order)
UCS2 Class 0
0x18
UTF-16 (big endian byte order)
Datakodninger er mappet til binære kodninger i henhold til tabellen ovenfor, f.eks. når man bruger datakodning UCS2, skal de binære data være UTF-16 kodet. I nogle programmeringssprog, f.eks. C#, er dette kendt som "Big endian unicode". UCS2 er et subset af UTF-16, så det at bruge UCS2 specifikt på klient-siden vil også fungere fint.
Leveringsrapportering
Fejlkoden i dette eksempel (005) er den absolutte værdi af beskedens statuskode "-5" defineret her:
Eksempel på vores leveringsrapportering:
id:ble50673-f8b8-41e8-a143-07a43bb8c86b sub:001 dlvrd:000 submit date:1911121314 done date:1911121314 stat:EXPIRED err:005
Statuskode
Beskrivelse
001
Undeliverable message
002
Msisdn blacklisted by operator
003
Invalid mobile number
004
Country not available
005
Delivery timeout
006
Not delivered removed from gateway
008
Insufficient funds
009
Authorize failed
010
Capture failed
011
Overcharge donation limit exceeded
012
Overcharge type not activated
013
Overcharge settings not valid
014
Sender name blocked
015
Route not available
016
Refund not available
017
Refund not possible for message
018
Refund failed
019
Refund not possible for pending message
020
Refund not possible for failed message
021
Refund failed already refunded
022
Delivery timeout before sent
023
Message queue full at operator
080
Imported from other system
099
Submit failed
100
Communication error
101
Unknown id
102
Cancelled
103
Unknown error processing message
104
Unknown id at operator
105
Msisdn blacklisted on account
106
Mobile number cooldown
201
Suspicious sms content
202
Account deactivated
300
Pdu sequence incomplete
301
Pdu sequence invalid
Indgående beskeder
For at modtage "deliver_sm" eller indgående beskeder via SMPP, skal du logge ind på din inMobile-konto og opsætte PDU-videresendelse til dit "system_id".
Kontakt supporten for yderligere hjælp til opsætningen.
Begrænsninger
Parametret "source_addr" har en maksimal længde på 15 tegn. Hvis "source_addr"-parameteret overstiger denne længde, vil alt efter det 15. tegn blive ignoreret.
Understøttelse af tidsforskudt eller forsinket levering er ikke tilgængelig, og beskeden vil derfor blive behandlet som en øjeblikkelig besked.
Vedligehold
SMPP er en asynkron protokol, hvilket indebærer, at flere forespørgsler og svar kan overføres samtidigt. For at forhindre tab af data under vedligeholdelse eller opdatering af vores SMPP-server, har vi implementeret tiltag, der sikrer en kontrolleret nedlukning og genstart.
Ved en systemgenstart af en SMPP-server vil enhver ny submitSm-besked blive afvist med svaret ESME_RSUBMITFAIL, og klienterne vil modtage en unbind-besked. Umiddelbart efter vil forbindelsen blive afbrudt. Hvis en klient forsøger at genetablere forbindelsen præcis når serveren er ved at genstarte, vil genetableringsforsøget blive afvist med et generisk ESME_RBINDFAIL-svar.
En typisk genstart af en SMPP-server varer nogle få minutter.