SMPP
Vi stöder SMPP version 3.4, branschstandardprotokollet för SMS-kommunikation. Vår konfiguration erbjuder redundant anslutning med en enda slutpunkt som pekar mot två separata platser.
Anslut
För att ansluta behöver du följande:
Parameter
Värde
system_id
Individuell per konto
password
Individuell per konto
hosts
smpp-dk1.inmobile.com
smpp-dk2.inmobile.com
port
2775 (SSL krävs för alla anslutningar – inget stöd för icke-SSL)
ConnectionMode
Individuell per konto
Kontakta oss på support@inmobile.com för att få ett SMPP-system-ID.
Kryptering via SSL/TLS
Som tidigare nämnts ska all kommunikation ske via krypterade anslutningar. För att uppnå detta måste applikationen hämta och använda certifikatet från https://app.inmobile.com (detta är ett wildcard-certifikat för *.inmobile.com).
Meddelandetyper som stöds
- bind_transmitter
- bind_receiver
- bind_transceiver
- unbind
- submit_sm
- deliver_sm
- enquire_link
DataCodings
Data coding
Hex value
Binary encoding
Standard
0x0
GSM7
Standard Class 0
0x10
GSM7
UCS2
0x8
UTF-16 (stor endian byte-ordning)
UCS2 Class 0
0x18
UTF-16 (stor endian byte-ordning)
Datakodningar mappas till binära kodningar enligt tabellen ovan. Till exempel: vid användning av datakodning UCS2 måste de binära data vara UTF-16-kodade. I vissa programmeringsspråk, som C#, kallas detta "Big endian unicode". UCS2 är en delmängd av UTF-16, så det fungerar även bra att använda UCS2 specifikt på klientsidan.
Leveransrapportering
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
Kan ej 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
Capture misslyckades
011
Overcharge: donationsgräns överskriden
012
Overcharge-typ ej aktiverad
013
Overcharge-inställningar är 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
Submit misslyckades
100
Kommunikationsfel
101
Okänt id
102
Avbruten
103
Okänt fel vid bearbetning av meddelande
104
Okänt id hos operatören
105
Msisdn svartlistad på konto
106
Mobilnummer i cooldown
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 konfigurera PDU-vidarebefordran till ditt "system_id".
Kontakta vår support för ytterligare hjälp med konfigurationen.
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.
Schemalagd eller fördröjd leverans stöds inte. Meddelandet skickas därför omedelbart.
Underhåll
SMPP är ett asynkront protokoll, vilket innebär att flera förfrågningar och svar kan överföras 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 avvisas alla nya submitSm-meddelanden med svaret ESME_RSUBMITFAIL och klienterna tar emot ett unbind-meddelande. Anslutningen avbryts omedelbart därefter. Om en klient försöker återansluta precis när servern startar om avvisas återanslutningsförsöket med ett generiskt ESME_RBINDFAIL-svar.
En typisk omstart av en SMPP-server tar några minuter.