SMPP
Vi stöder SMPP version 3.4, branschstandardprotokollet för SMS-kommunikation. Vår installation erbjuder redundant anslutning med en slutpunkt som pekar mot två olika platser.
Anslut
För att ansluta behöver du följande:
Parameter
Värde
system_id
Individuell per konto
Lösenord
Individuell per konto
värdar
smpp-dk1.inmobile.dk smpp-dk2.inmobile.dk
hamnen
2775 (ssl krävs för alla anslutningar - inget stöd för icke-ssl)
Anslutningsläge
Individuell per konto
Kontakta oss på [email protected] för att få ett SMPP-system-ID.
Kryptering via SSL/TLS
Som tidigare nämnts ska all kommunikation ske via krypterade förbindelser. För att uppnå detta är det nödvändigt att applikationerna hämtar och använder det certifikat som används på https://mm.inmobile.dk (detta är ett wildcard-certifikat för *.inmobile.dk).
Meddelandetyper som stöds
- bind_transmitter
- binda_mottagare
- bind_transceiver
- lösgöra
- skicka_sm
- leverera_sm
- fråga_länk
DataKodningar
Kodning av data
Hex-värde
Binär kodning
Standard
0x0
GSM7
Standard Klass 0
0x10
GSM7
UCS2
0x8
UTF-16 (stor endian byte-ordning)
UCS2 Klass 0
0x18
UTF-16 (stor endian byte-ordning)
Datakodningar mappas till binära kodningar enligt tabellen ovan, t.ex. vid användning av datakodning UCS2 måste de binära data vara UTF-16-kodade. I vissa programmeringsspråk, t.ex. C#, kallas detta för "Big endian unicode". UCS2 är en delmängd av UTF-16, så att använda UCS2 specifikt på klientsidan kommer också att fungera bra.
Rapportering av leveranser
Felkoden i detta exempel (005) är det absoluta värdet av statuskoden för meddelandet "-5" som definieras här:
Exempel på vår leveransrapportering:
id:ble50673-f8b8-41e8-a143-07a43bb8c86b sub:001 dlvrd:000 submit date:1911121314 done date:1911121314 stat:EXPIRED err:005
Statuskod
Beskrivning
001
Meddelande som inte kan levereras
002
Msisdn svartlistad av operatör
003
Ogiltigt mobilnummer
004
Land ej tillgängligt
005
Timeout för leverans
006
Ej levererad borttagen från gateway
008
Otillräckliga medel
009
Auktorisering misslyckades
010
Fångsten misslyckades
011
Gränsen för överladdningsdonation överskriden
012
Överladdningstyp ej aktiverad
013
Inställningar för överladdning inte giltiga
014
Avsändarens namn blockerat
015
Rutten är inte tillgänglig
016
Återbetalning ej tillgänglig
017
Återbetalning ej möjlig för meddelande
018
Återbetalning misslyckades
019
Återbetalning ej möjlig för väntande meddelande
020
Återbetalning ej möjlig för misslyckat meddelande
021
Återbetalning misslyckad redan återbetald
022
Tidsgräns för leverans innan sändning
023
Full meddelandekö hos operatören
080
Importerad från annat system
099
Skicka misslyckades
100
Kommunikationsfel
101
Okänt id
102
Avbruten
103
Meddelande om bearbetning av okänt fel
104
Okänt id hos operatören
105
Msisdn svartlistad på konto
106
Nedkylning av mobilnummer
201
Misstänkt innehåll i sms
202
Konto avaktiverat
300
Pdu-sekvensen ofullständig
301
Pdu-sekvens ogiltig
Inkommande meddelanden
För att ta emot "deliver_sm" eller inkommande meddelanden via SMPP, logga in på ditt inMobile-konto och ställ in PDU-vidarebefordran till ditt "system_id".
Kontakta support för ytterligare hjälp med installationen.
Begränsningar
Parametern "source_addr" har en maximal längd på 15 tecken. Om parametern "source_addr" överskrider denna längd ignoreras allt efter det 15:e tecknet.
Stöd för tidsförskjuten eller fördröjd leverans är inte tillgängligt och meddelandet kommer därför att behandlas som ett direktmeddelande.
Underhåll
SMPP är ett asynkront protokoll, vilket innebär att flera förfrågningar och svar kan sändas samtidigt. För att förhindra dataförlust vid underhåll eller uppdateringar av vår SMPP-server har vi vidtagit åtgärder för att säkerställa en kontrollerad avstängning och omstart.
Vid en systemomstart av en SMPP-server kommer alla nya submitSm-meddelanden att avvisas med svaret ESME_RSUBMITFAIL och klienterna kommer att få ett unbind-meddelande. Omedelbart därefter kommer anslutningen att avbrytas. Om en klient försöker återansluta precis när servern är på väg att starta om kommer återanslutningsförsöket att avvisas med ett generiskt ESME_RBINDFAIL-svar.
En typisk omstart av en SMPP-server tar några minuter.