‫‪Web Service & API - Pulseem Newsletter‬‬
‫שימוש ב ‪ Web Service‬למערכת פולסים לשליחת סמס‬
‫שירותי ‪ Web Services‬מאפשרים לאפליקציות להתקשר ולשתף מידע דרך האינטרנט‪ ,‬ללא‬
‫התחשבות בסוג מערכת ההפעלה‪ ,‬ההתקן או שפת התכנות‪ .‬המידע מועבר על ידי שימוש ב ‪.XML -‬‬
‫אילו כלים נותנת שליחה ישירה‪.‬‬
‫שליחה ישירה הינו כלי המאפשר למערכות מרוחקות לשלוח סמס‪.‬‬
‫שליחה‬
‫מערכת שליחה שירה מאפשרת‪:‬‬
‫‪‬‬
‫‪‬‬
‫‪‬‬
‫‪‬‬
‫אפשרות שליחה של סמס באמצעות קריאה ל‪ Web Service‬ללא צורך בניהול ופיתוח מיוחד‪.‬‬
‫שליחה של כמות גדולה של סמסים בקריאה אחת ל‪.Web Service‬‬
‫מהירות שליחה אופטימלית‪.‬‬
‫קבלת דו"ח המכיל מידע על תוצאות השליחה‪.‬‬
‫פולסים ‪ Web Service‬בשליחה ישירה יושבת בכתובת‪:‬‬
‫‪http://www.pulseem.co.il/Pulseem/pulseemSendservices.asmx‬‬
‫לחיצה על לינק זה יציג לכם את הפונקציות הקימות ב ‪ Web Service‬של מערכת פולסים‪.‬‬
‫פונקציות קיימות‪:‬‬
‫‪SendSingleSMS‬‬
‫‪‬‬
‫‪SendSingleInternationalSMS‬‬
‫‪‬‬
‫‪SendMultipleSMS‬‬
‫‪‬‬
‫‪SendMultipleTextsSMS‬‬
‫‪‬‬
‫‪SendMulipleInternationalSMS‬‬
‫‪‬‬
‫‪GetSmsReport‬‬
‫‪‬‬
‫פרמטרים לפונקציות‪:‬‬
‫‪SendSingleSMS‬‬
‫‬‫תיאור‪ :‬מאפשר לשלוח סמס בודד ‪ .‬השליחה רק לנמענים בישראל ואין צורך בקידומת בינלאומית‪.‬‬
‫פרמטרים של הפונקציה‪:‬‬
‫פולסים דיוור אלקטרוני‬
‫מורשה | שדרות מסריק ‪ 31‬תל אביב טל ‪ 31-0423423‬פקס ‪ 31-0420243‬כל הזכויות שמורות‪.‬‬
‫)‪ -userID(string‬שם משתמש‬
‫)‪ -password(string‬סיסמה לשימוש ב‪ .web service‬אתם תקבלו סיסמה יחודית לשימוש ב ‪Web‬‬
‫‪Service‬‬
‫)‪ -fromNumber(string‬מספר הסלולרי (ניתן להשתמש גם במספר טלפון קווי) ממנו נשלח הסמס‬
‫)‪ -toNumber[] (string‬מספר הטלפון הסלולרי אליו ישלח הסמס‬
‫)‪ -externalRef (string‬משתנה שחוזר בדוחות לזיהוי הסמס על ידי הלקוח‬
‫)‪ -text(string‬תוכן טקסטואלי של הודעת הסמס‬
‫)‪ -delayDeliveryMinutes (int‬זמן השעייה בדקות עד לשליחת הסמס‬
‫פרמטר חוזר הינו ‪ "Success" – String‬אומר שהעברה הצליחה למערכת פולסים‪ .‬כל דבר אחר‬
‫מסמל על השגיאה‪.‬‬
‫‪SendSingleInternationalSMS‬‬
‫תיאור‪ :‬מאפשר לשלוח סמס אחד לכל העולם (כולל ישראל)‪ .‬המספר הסלולרי חייב להכיל קידומת‬
‫בין לאומית‪.‬‬
‫פרמטרים של הפונקציה‪:‬‬
‫)‪ -userID(string‬שם משתמש‬
‫)‪ -password(string‬סיסמה לשימוש ב‪ .web service‬אתם תקבלו סיסמה יחודית לשימוש ב ‪Web‬‬
‫‪Service‬‬
‫)‪ -fromNumber(string‬מספר הסלולרי (ניתן להשתמש גם במספר טלפון קווי) ממנו נשלח הסמס‬
‫)‪ -toNumber[] (string‬מספר הטלפון הסלולרי אליו ישלח הסמס‬
‫)‪ -externalRef (string‬משתנה שחוזר בדוחות לזיהוי הסמס על ידי הלקוח‬
‫)‪ -text(string‬תוכן טקסטואלי של הודעת הסמס‬
‫פרמטר חוזר הינו ‪ "Success" – String‬אומר שהעברה הצליחה למערכת פולסים‪ .‬כל דבר אחר מסמל על‬
‫השגיאה‪.‬‬
‫‪SendMultipleSMS‬‬
‫פרמטרים של הפונקציה‪:‬‬
‫תיאור‪ :‬שליחה של קבוצת טלפונים סלולרים בקיראה אחת‪ .‬השליחה רק לנמענים בישראל ואין צורך‬
‫בקידומת בינלאומית‪.‬‬
‫פולסים דיוור אלקטרוני‬
‫מורשה | שדרות מסריק ‪ 31‬תל אביב טל ‪ 31-0423423‬פקס ‪ 31-0420243‬כל הזכויות שמורות‪.‬‬
‫)‪ -userID(string‬שם משתמש‬
‫)‪ -password(string‬סיסמה לשימוש ב‪ .web service‬אתם תקבלו סיסמה יחודית לשימוש ב ‪Web‬‬
‫‪Service‬‬
‫)‪ -fromNumber(string‬מספר הסלולרי (ניתן להשתמש גם במספר טלפון קווי) ממנו נשלח הסמס‬
‫)‪ -toNumber[] (string‬מערך המספרי הטלפון הסלולרים אליהם ישלח הסמס‬
‫)‪ -externalRef[](string‬מערך משתנים שחוזרים בדוחות לזיהוי הסמס על ידי הלקוח‬
‫)‪ -text (string‬תוכן טקסטואלי של הודעת הסמס‬
‫)‪ -delayDeliveryMinutes (int‬זמן השעייה בדקות עד לשליחת הסמס‬
‫פרמטר חוזר הינו ‪ "Success" – String‬אומר שהעברה הצליחה למערכת פולסים‪ .‬כל דבר אחר‬
‫מסמל על השגיאה‪.‬‬
‫‪SendMultipleTextsSMS‬‬
‫פרמטרים של הפונקציה‪:‬‬
‫תיאור‪ :‬שליחה של קבוצת טלפונים סלולרים וקבוצת טקסטים בקיראה אחת‪ .‬השליחה רק לנמענים‬
‫בישראל ואין צורך בקידומת בינאלומית‪.‬‬
‫)‪ -userID(string‬שם משתמש‬
‫)‪ -password(string‬סיסמה לשימוש ב‪ .web service‬אתם תקבלו סיסמה יחודית לשימוש ב ‪Web‬‬
‫‪Service‬‬
‫)‪ -fromNumber(string‬מספר הסלולרי (ניתן להשתמש גם במספר טלפון קווי) ממנו נשלח הסמס‬
‫)‪ -toNumber[] (string‬מערך המספרי הטלפון הסלולרים אליהם ישלח הסמס‬
‫)‪ -externalRef[](string‬מערך משתנים שחוזרים בדוחות לזיהוי הסמס על ידי הלקוח‬
‫)‪ -text[](string‬מערך של תוכן ההודעות הסמס‬
‫)‪ -delayDeliveryMinutes (int‬זמן השעייה בדקות עד לשליחת הסמס‬
‫פרמטר חוזר הינו ‪ "Success" – String‬אומר שהעברה הצליחה למערכת פולסים‪ .‬כל דבר אחר‬
‫מסמל על השגיאה‪.‬‬
‫פולסים דיוור אלקטרוני‬
‫מורשה | שדרות מסריק ‪ 31‬תל אביב טל ‪ 31-0423423‬פקס ‪ 31-0420243‬כל הזכויות שמורות‪.‬‬
‫‪SendMulipleInternationalSMS‬‬
‫פרמטרים של הפונקציה‪:‬‬
‫תיאור‪ :‬שליחה לכל העולם של קבוצת טלפונים סלולרים בקיראה אחת(כולל ישראל)‪ .‬יש להוסיף‬
‫קידומת בינלואמית לכל מספר סלולרי כדי לזהות את ארץ היעד ‪.‬‬
‫)‪ -userID(string‬שם משתמש‬
‫)‪ -password(string‬סיסמה לשימוש ב‪ .web service‬אתם תקבלו סיסמה יחודית לשימוש ב ‪Web‬‬
‫‪Service‬‬
‫)‪ -fromNumber(string‬מספר הסלולרי (ניתן להשתמש גם במספר טלפון קווי) ממנו נשלח הסמס‬
‫)‪ -toNumber[] (string‬מערך המספרי הטלפון הסלולרים אליהם ישלח הסמס‬
‫)‪ -externalRef[](string‬מערך משתנים שחוזרים בדוחות לזיהוי הסמס על ידי הלקוח‬
‫)‪ -text(string‬תוכן טקסטואלי של הודעת הסמס‬
‫פרמטר חוזר הינו ‪ "Success" – String‬אומר שהעברה הצליחה למערכת פולסים‪ .‬כל דבר אחר‬
‫מסמל על השגיאה‪.‬‬
‫‪GetSmsReport‬‬
‫הערה‪ :‬המידע נשמר חודש ואז נמחק‪.‬‬
‫תיאור‪ :‬קבלת דוח שליחה של הסמסים‬
‫פרמטרים של הפונקציה‪:‬‬
‫)‪ -userID(string‬שם משתמש‬
‫)‪ -password(string‬סיסמה לשימוש ב‪ .web service‬אתם תקבלו סיסמה יחודית לשימוש ב ‪Web‬‬
‫‪Service‬‬
‫)‪ -startDateTime(DateTime‬החל מאיזה תאריך‬
‫)‪-endDateTime(DateTime‬עד איזה תאריך‬
‫פרמטרים חוזרים‪:‬‬
‫פולסים דיוור אלקטרוני‬
‫מורשה | שדרות מסריק ‪ 31‬תל אביב טל ‪ 31-0423423‬פקס ‪ 31-0420243‬כל הזכויות שמורות‪.‬‬
:‫פרמטרים חוזרים בשליחה מקומית רק לישראל‬
:)‫ שמחיל את המידע הבא לגבי שליחה מקומית (לישראל‬DataTable :‫פרמטר חוזר‬
-externalRef
‫משתנה חוזר‬
‫מספר טלפון‬
‫אליו נשלח‬
Success = 0,
‫הסמס‬
:‫ סטטוס הסמס‬-Status
-CreateDate
‫תאריך יצירה‬
UnKnown = 1,
NotActivated = 11,
ReachedCreditLimit = 12,
CreditCardExpired = 13,
ServiceUsageLimitForCurrentBillingP
eriod = 14,
AccountUsageLimitForCurrentBillingP
eriod = 15,
UnRateableMessage = 21,
MobileOff = 22,
UnSuitableFormatForDestNetwork =
23,
SMSNumberLengthIsInvalid = 24,
InvalidSubscriber = 25,
UnspecifiedError = 26,
:‫פרמטרים חוזרים בשליחה בינלאומית‬
. ‫ שמחיל את המידע הבא לגבי שליחה הבינלואמית‬DataTable :‫פרמטר חוזר‬
.‫ כל הזכויות שמורות‬31-0420243 ‫ פקס‬31-0423423 ‫ תל אביב טל‬31 ‫מורשה | שדרות מסריק‬
‫פולסים דיוור אלקטרוני‬
-externalRef
‫משתנה חוזר‬
‫מספר טלפון‬
‫אליו נשלח‬
‫הסמס‬
‫ סטטוס הסמס‬-Status
SUCCESS- 0
Message too long
3
Command length is invalid
4
Command ID is invalid or not supported
1
Incorrect bind status for given command
2
Already bound
0
Invalid Priority Flag
6
Invalid registered delivery flag
7
Message expired, reason unknown
8
Invalid source address
33
Invalid destination address
33
Message ID is invalid
34
Bind failed
31
Invalid password
32
Invalid System ID
30
Canceling message failed
37
Message replacement failed
32
Message queue full
43
Invalid service type
43
Invalid number of destinations
03
Invalid distribution list name
04
Invalid destination flag
62
Invalid submit with replace request
66
Invalid esm class set
67
Invalid submit to distribution list
68
Submitting message has failed
62
) Invalid source address type of number ( TON
74
) Invalid source address numbering plan ( NPI
71
) Invalid destination address type of number ( TON
83
.‫ כל הזכויות שמורות‬31-0420243 ‫ פקס‬31-0423423 ‫ תל אביב טל‬31 ‫מורשה | שדרות מסריק‬
‫פולסים דיוור אלקטרוני‬
CreateD
-ate
‫תאריך‬
‫יצירה‬
) Invalid destination address numbering plan ( NPI
83
Invalid system type
81
Invalid replace_if_present flag
82
Invalid number of messages
80
Throttling error
88
Invalid scheduled delivery time
27
Invalid Validity Period value
28
Predefined message not found
22
ESME Receiver temporary error
333
ESME Receiver permanent error
333
ESME Receiver reject message error
334
Message query request failed
331
Error in the optional part of the PDU body
324
TLV not allowed
321
Invalid parameter length
322
Expected TLV missing
320
Invalid TLV value
326
Transaction delivery failure
402
Unknown error
400
ESME not authorised to use specified servicetype
406
ESME prohibited from using specified operation
407
Specified servicetype is unavailable
408
Specified servicetype is denied
402
Invalid data coding scheme
463
Invalid source address subunit
463
Invalid destination address subunit
464
.‫ כל הזכויות שמורות‬31-0420243 ‫ פקס‬31-0423423 ‫ תל אביב טל‬31 ‫מורשה | שדרות מסריק‬
‫פולסים דיוור אלקטרוני‬