Systemskiss
Utgående SMS (MT-SMS)
1. Vilka gränssnitt finns för uppkoppling mot iGATE 3.0?
HTTP/GET/POST
SMPP 3.4
2. Hur kommer jag igång med att skicka SMS?
Kontakta Imez för att få tillgång till ett konto på sales@imez.se
Du blir då tilldelad:
* användarnamn
* lösenord
* annan tjänsteinformation
3. Hur många tecken innehåller ett SMS?
70 characters - för 16 bit SMS
140 characters - för 8 bit SMS
160 characters - för 7 bit SMS
4. Finns det någon dokumentation för vilka svar/parametrar man får tillbaka från webrequesten?
Se dokumentationen för det protokoll som används.
De viktigaste parametrarna är
destAddr : Destination
origAddr : Avsändare
message : Meddelande
irpId: Id för att matcha ihop utsänt SMS med mottaget SMS
deliveryReportFlag : Leveransrapporter: FINAL_ONLY eller INTERMEDIATE
Svar i anropet
id : Unikt Id för meddelandet
destAddr: destinationsadress
5. Finns det någon maxlängd på "irpId" ?
Nej.
Kontrollera med IMEZ att ni har tjänsten IRP.
6. Finns det någon maxlängd på "groupId" ?
Ja, 32 tecken.
7. Hur används parametrarna ”id” och ”state”? Vad är ”id” och ”state” samt finns dessa parametrar alltid med?
När man skickar MT SMS får man ett id tillbaka som svar.
Detta id används senare för att koppla ihop leveransrapporten som innehåller state parametern.
Exempel
Skickar ett SMS till 46708319111 https://igate.imez.se/api/url?destAddr=%2B46708319111&message=Hello+World&
deliveryReportFlag=FINAL_ONLY
Svaret på detta anrop innehåller id
id=f540a3c7-a01c-4df9-907f-8de00b860a23, destAddr=46708319111
När SMSet landat i telefonen POSTas en state till den URL som ni givit till Imez.
id=f540a3c7-a01c-4df9-907f-8de00b860a23&state=DELIVERED
8. Jag skickar ett SMS och som svar får jag följande:
id=56e548bd-5968-405b-a645-746fccaa94f1,destAddr=46708319111
Vad betyder det?
id - ett unikt id som fås för varje SMS. Detta kan användas för att koppla ihop det skickade SMS:et med leveransrapport samt vid felsökning av Imez.
destAddr - mottagaradress för det SMS:et som hör till id.
9. När man gör ett webrequest med flera mottagare, får man ett id för varje mottagare?
Det ska komma ett id för varje mottagare.
Tex:
https://igate.imez.se/api/url?destAddr=%2B46708xxxxxx&destAddr=%2B46708yyyyyy&message=Hello+World&deliveryReportFlag=INTERMEDIATE
Ger mig svaret
id=6ec4532a-3e4a-4223-9345-c86d416bf276, destAddr=46708xxxxxx
id=2d825b76-a94c-4642-af3c-155fa6b3c898, destAddr=46708yyyyyy
10. Om man gör ett webrequest med flera mottagare och en mottagare blir fel av någon anledning (fel mobilnr, en siffra för lite etc.), vad händer då?
När det tas emot sker några valideringar direkt. Om det finns ett helt felaktigt telefonnummer så ges ett felmeddelande för hela requesten.
Dvs inga SMS skickas.
Om operatören av någon anledning inte kan leverera p.g.a. felaktigt nummer så skickas en leveransrapport med state=UNDELIVERED till den URL ni angivit för Imez.
11. Kan jag använda webRequest.Credentials= new NetworkCredential(username, password);
istället för string usernamePassword = username + ":" +password;
webRequest.Headers.Add("Authorization", "Basic " +Convert.ToBase64String(new ASCIIEncoding().GetBytes(usernamePassword)));
Vi rekommenderar inte att använda WebRequest.Credentials. Detta för att det kräver ytterligare ett http-anrop till servern.webRequest.Credentials skickar inte direkt med rätt header utan väntar
tills den får ett HTTP 401 svar.
För att effektivisera kommunikationen är det bättre att skicka med headern direkt.
http://en.wikipedia.org/wiki/Basic_access_authentication#Example
Leveransrapporter
12. Hur kommer jag igång med att ta emot SMS/Leveransrapporter?
Kontakta Imez och få tillgång till ett virtuellt nummer (VN) eller utökat virtuelltnummer (EVN).
Med SMPP 3.4-uppkoppling får du alla SMS som skickas till dina VN/EVN samt dina leveransrapporter.
Push. IGATE skickar SMS/Leveransrapporter till en angiven url. För detta krävs en webserver som tar emot HTTP/GET-anrop. Ge Imez URL till webserver så kommer alla SMS till VN/EVN att skickas till denna URL.
13. För leveransrapporter så är parametrarna ”destAddr” och ”message” null. Varför det?
För leveransrapporter sätts endast parameterarna "id" och "state".
Id: unikt meddelande-id
State: status meddelandet har: SENT, UNSENT, DELIVERED,UNDELIVERED, BUFFERED eller BLOCKED
14. Hur ser informationen ut som man får i leveransrapporter?
T ex: skickas det en liknande sträng som den jag skickar in till (nedan) så att jag enkelt kan plocka ur ”message”, ”addr” och ”tid för leverans”? https://user:password@igate.imez.se/api/url?message=H%e4r+%e4r+%e5n+%f6n&origAddr=test&destAddr=%2B46708319111
Om man vid utskicket satt att man vill ha alla statusrapporter, dvs deliveryReportFlag=INTERMEDIATE
får man in en request med id på det meddelande som skickades samt SENT för att operatör tagit emot SMS:et.
http://your-domain/your-url/?id=7b91cf0c-25a0-4ce9-9001-ff48d103588e&state=SENT
Om man har satt deliveryReportFlag=FINAL_ONLY ellerdeliveryReportFlag=INTERMEDIATE kommer den slutgiltiga rapporten in som en request.
http://your-domain/your-url/?id=7b91cf0c-25a0-4ce9-9001-ff48d103588e&state=DELIVERED
15. Vilka statustyper kan iGATE returnera?
Följande statustyper finns i systemet:
SENT
UNSENT
DELIVERED
UNDELIVERED
BUFFERED
BLOCKED
Inkommande SMS (MO-SMS)
16. Hur fungerar MO-SMS för HTTP/GET?
När du har fått ett VN eller EVN från Imez.
Push. iGATE skickar SMS/leveransrapporter till en angiven url. För detta krävs en webserver som tar emot HTTP/GET-anrop. Ge Imez URL till din webserver så kommer alla SMS till Virtual Number (VN) respektive Extended Virtual Number (EVN)att skickas till denna URL.
17. Hur ser ett MO-SMS ut när det kommer in?
För MO-SMS kommer följande request in:
id: unikt id som kan spåras av Imez.
destAddr: det nummer som SMS skickades till
message: meddelandet
origAddr: avsändarens telefonnummer
encoding: vilken encoding som SMS har
irpId: om man vid utskicket satt irpid så kommer detta tillbaka med denna parametern
Ex. http://your-domain/your-url/?id=93dd20a2-429d-49c0-9d05-43e9ab6b060e&destAddr=467301210610001&message=Test&origAddr=46708319105&irpId=123&encoding=7BIT
18. Har testat att svara på SMS och kollat om svaret kommer till vår URL. Det kommer att svar men det känns som att det saknas data, får bara data i parametrarna ”destAddr”, ”origAddr”, ”encoding” och ”message”. Jag skulle vilja ha data i parametrarna ”irpId” och ”groupId” också för inkommande svar så att jag kan koppla ihop det med ett utgående SMS. Hur gör jag för att få det?
IrpId är ett id som sätts på MT SMS (till telefon) för att koppla ihop ett svar på detta SMS.
Dvs för att få in irpId måste detta först ha satts på ett ugående SMS. GroupId används endast för MT SMS. Detta för att få specificerad räkning.
Dvs groupId kommer aldrig in för MO SMS (från telefon).