SMPP
Vi støtter SMPP versjon 3.4, bransjestandardprotokollen for SMS-kommunikasjon. Oppsettet vårt tilbyr redundant tilkobling med ett endepunkt som peker mot to separate lokasjoner.
Koble til
For å koble til trenger du følgende:
Parameter
Verdi
system_id
Individuell per konto
password
Individuell per konto
hosts
smpp-dk1.inmobile.com
smpp-dk2.inmobile.com
port
2775 (SSL er påkrevd for alle tilkoblinger – ingen støtte for ikke-SSL)
ConnectionMode
Individuell per konto
Kontakt oss på support@inMobile.com for å få en SMPP-system-ID.
Kryptering via SSL/TLS
Som tidligere nevnt må all kommunikasjon foregå via krypterte forbindelser. For å oppnå dette må applikasjonen hente og bruke sertifikatet fra https://app.inmobile.com (dette er et wildcard-sertifikat for *.inmobile.com).
Støttede meldingstyper
- 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 (big endian byte-rekkefølge)
UCS2 Class 0
0x18
UTF-16 (big endian byte-rekkefølge)
Datakodinger mappes til binære kodinger i henhold til tabellen ovenfor. For eksempel: når du bruker datakodingen UCS2, må de binære dataene være UTF-16-kodet. I noen programmeringsspråk, som C#, kalles dette "Big endian unicode". UCS2 er en delmengde av UTF-16, så det fungerer også fint å bruke UCS2 spesifikt på klientsiden.
Leveringsrapportering
Feilkoden i dette eksempelet (005) er den absolutte verdien av meldingsstatuskoden «-5», som definert her:
Eksempel på vår leveringsrapportering:
id:ble50673-f8b8-41e8-a143-07a43bb8c86b sub:001 dlvrd:000 submit date:1911121314 done date:1911121314 stat:EXPIRED err:005
Statuskode
Beskrivelse
001
Kan ikke leveres
002
MSISDN svartelistet av operatør
003
Ugyldig mobilnummer
004
Land ikke tilgjengelig
005
Levering tidsavbrutt
006
Ikke levert fjernet fra gateway
008
Utilstrekkelige midler
009
Autorisering mislyktes
010
Capture mislyktes
011
Overcharge: donasjonsgrense overskredet
012
Overcharge-type ikke aktivert
013
Overcharge-innstillinger er ikke gyldige
014
Avsendernavn blokkert
015
Rute ikke tilgjengelig
016
Refusjon ikke tilgjengelig
017
Refusjon ikke mulig for melding
018
Refusjon feilet
019
Refusjon ikke mulig for ventende melding
020
Refusjon ikke mulig for mislykket melding
021
Refusjon feilet, allerede refundert
022
Leveringstid utløpt før sending
023
Meldingskø full hos operatør
080
Importert fra annet system
099
Submit mislyktes
100
Kommunikasjonsfeil
101
Ukjent ID
102
Avbrutt
103
Ukjent feil ved behandling av melding
104
Ukjent ID hos operatør
105
MSISDN svartelistet på kontoen
106
Mobilnummer i cooldown
201
Suspicious sms content
202
Account deactivated
300
Pdu sequence incomplete
301
Pdu sequence invalid
Innkommende meldinger
For å motta "deliver_sm" eller innkommende meldinger via SMPP, logg inn på inMobile-kontoen din og konfigurer PDU-videresending til ditt "system_id".
Kontakt support for ytterligere hjelp med oppsettet.
Begrensninger
Parameteren "source_addr" har en maksimal lengde på 15 tegn. Hvis "source_addr"-parameteren overskrider denne lengden, vil alt etter det 15. tegnet bli ignorert.
Planlagt eller forsinket levering støttes ikke. Meldingen vil derfor bli sendt umiddelbart.
Vedlikehold
SMPP er en asynkron protokoll, noe som betyr at flere forespørsler og svar kan overføres samtidig. For å forhindre tap av data under vedlikehold eller oppdateringer av SMPP-serveren vår har vi iverksatt tiltak for å sikre en kontrollert nedstengning og omstart.
Når en SMPP-server startes på nytt, vil alle nye submitSm-meldinger bli avvist med ESME_RSUBMITFAIL-svaret, og klientene vil motta en unbind-melding. Tilkoblingen avbrytes umiddelbart etterpå. Hvis en klient forsøker å koble til igjen akkurat idet serveren starter på nytt, vil forsøket bli avvist med et generisk ESME_RBINDFAIL-svar.
En typisk omstart av SMPP-serveren tar noen få minutter.