docדואר ת לשליח להתממשקות למערכת פולסים שימוש ב Web Service אלקטרוני
download 
Report Transcription
דואר ת לשליח להתממשקות למערכת פולסים שימוש ב Web Service אלקטרוני
שימוש ב Web Serviceלהתממשקות למערכת פולסים לשליחת דואר
אלקטרוני
שירותי Web Servicesמאפשרים לאפליקציות להתקשר ולשתף מידע דרך האינטרנט ,ללא
התחשבות בסוג מערכת ההפעלה ,ההתקן או שפת התכנות .המידע מועבר על ידי שימוש ב .XML -
אילו כלים נותנת שליחה ישירה.
שליחה ישירה הינו כלי המאפשר למערכות מרוחקות לשלוח דיוורים בכמויות ללא
צורך בניהול שרתי דואר וחסימות.
שליחה
מערכת שליחה ישירה מאפשרת:
אפשרות שליחה של מיילים באמצעות קריאה ל Web Serviceללא צורך בשרת דואר.
אפשרות לקבל דוחות של מי ביקש להסיר את עצמו מהדיוור.
אפשרות לקבל דוח של איזה מיילים לא הגיעו ליעדם (כגון מיילים שגויים ,שגיאה זמנית וכו')
אפשרות לקבל דוחות סטטיסטים -מי לחץ על לינקים ,מי פתח את המייל ,כמה פעמיים וכו'.
שליחה של כמות גדולה של מיילים בקריאה אחת ל.Web Service
מהירות שליחה אופטימלית.
עבירות אופטימלית לכל שרתי הדואר בעולם( .כניסה ל)INBOX
הערות:
מנגנון השליחה הישירה מוסיף לינק הסרה בתחתית הדיוור .כל נמען שלחץ על הלינק
מעודכן אצלנו כנעמן מוסר כדי שהלקוח יוכל לשלוף את המידע באמצעות הפונקציה
GetEmailReportכדי לסמן אצלו את הנמען כמוסר.
ניתן להוריד את לינק ההסרה במידה והלקוח רוצה להוסיף את הלינק בעצמו ולנהל אותו.
.
פולסים Web Serviceבשליחה ישירה יושבת בכתובת:
http://www.pulseem.co.il/Pulseem/pulseemSendservices.asmx
לחיצה על לינק זה יציג לכם את הפונקציות הקימות ב Web Serviceשל מערכת פולסים.
פונקציות קיימות:
פולסים דיוור אלקטרוני
SendEmail
SendEmailToGroup
SendEmailsToGroup
GetEmailReport
GetEmailReportStat
מורשה | שדרות מסריק 31תל אביב טל 31-0423423פקס 31-0420243כל הזכויות שמורות.
GetRemovedClients
GetEmailReportCountByStatus
SendEmailToGroupWithAttachments
SendEmailsToGroupWithAttachments
פרמטרים לפונקציות:
-SendEmail
תיאור :מאפשר לשלוח מייל בודד
פרמטרים של הפונקציה:
) -userID(stringשם משתמש
) -password(stringסיסמה לשימוש ב .web serviceאתם תקבלו סיסמה יחודית לשימוש ב Web
Service
) -toEmail(stringדואר אלקטרוני של יעד השליחה
) -toName (stringשם הנמען
) -fromEmail(stringכתובת דואר האלקטרוני של השולח (חשוב לדייק)
) -fromName (stringשם השולח של המייל
) -subject (stringנושא המייל
) -HTML(stringקוד ה HTMLשהוא למעשה יכיל את תוכן המייל
) -languageCode(intשפת הקידוד של ה HTMLבשליחה
3
עברית
3
אנגלית
2
הונגרית
10
סלובקית
צרפתית
4
33
1
ספרדית
2
גרמניה
0
רוסית
6
יפנית
7
רומנית
8
ערבית
פורטוגזית
-3עברית -3אנגלית -4צרפתית -1ספרדית -2 -גרמני -0רוסית -6יפנית -7רומנית -8ערבית -2הונגרית
פולסים דיוור אלקטרוני
מורשה | שדרות מסריק 31תל אביב טל 31-0423423פקס 31-0420243כל הזכויות שמורות.
) -externalRef(stringמשתנה שתוכל לקבל בחזרה בדוחות בשביל זיהוי.
פרמטר חוזר הינו "Success" – Stringאומר שהעברה הצליחה למערכת פולסים .כל דבר אחר
מסמל על השגיאה.
SendEmailToGroup
תיאור :מאפשר לשלוח קבוצת נמענים עם HTMLאחד.
פרמטרים של הפונקציה:
) -userID(stringשם משתמש
) -password(stringסיסמה לשימוש ב .web serviceאתם תקבלו סיסמה יחודית לשימוש ב Web
Service
) -toEmails[](stringמערך של מיילים לשליחה
) -toName[] (stringמערך של שמות
) -fromEmail(stringכתובת דואר האלקטרוני של השולח (חשוב לדייק)
) -fromName (stringשם השולח של המייל
) -subject (stringנושא המייל
) -HTML(stringקוד ה HTMLשהוא למעשה יכיל את תוכן המייל.
) -languageCode(intשפת הקידוד של ה HTMLבשליחה
3
עברית
3
אנגלית
2
הונגרית
10
סלובקית
צרפתית
4
33
1
ספרדית
2
גרמניה
0
רוסית
6
יפנית
7
רומנית
8
ערבית
פורטוגזית
) -externalRef[](stringמשתנים שחוזרים בדוחות לזיהוי המייל על ידי הלקוח
פרמטר חוזר הינו "Success" – Stringאומר שהעברה הצליחה למערכת פולסים .כל דבר אחר
מסמל על השגיאה.
SendEmailsToGroup
תיאור :מאפשר לשלוח קבוצת נמענים עם HTMLיחודי לכל אחד.
פרמטרים של הפונקציה:
) -userID(stringשם משתמש
פולסים דיוור אלקטרוני
מורשה | שדרות מסריק 31תל אביב טל 31-0423423פקס 31-0420243כל הזכויות שמורות.
) -password(stringסיסמה לשימוש ב .web serviceאתם תקבלו סיסמה יחודית לשימוש ב Web
Service
) -toEmails[](stringמערך של מיילים לשליחה
) -toName[] (stringמערך של שמות
) -fromEmail(stringכתובת דואר האלקטרוני של השולח (חשוב לדייק)
) -fromName (stringשם השולח של המייל
) -subject (stringנושא המייל
) -HTML[](stringמערך קוד ה HTMLשהוא למעשה יכיל את תוכן המייל
) -languageCode(intשפת הקידוד של ה HTMLבשליחה
3
עברית
3
אנגלית
2
הונגרית
10
סלובקית
צרפתית
4
33
1
ספרדית
2
גרמניה
0
רוסית
6
יפנית
7
רומנית
8
ערבית
פורטוגזית
) -externalRef[](stringמערך משתנים שחוזרים בדוחות לזיהוי המייל על ידי הלקוח
פרמטר חוזר הינו "Success" – Stringאומר שהעברה הצליחה למערכת פולסים .כל דבר אחר
מסמל על השגיאה.
SendEmailToGroupWithAttachments
תיאור :מאפשר לשלוח קבוצת נמענים עם HTMLאחד כולל קובצים מצורפים (יש עלות נוספת לפי
נפח הקובץ ב)KB
פרמטרים של הפונקציה:
) -userID(stringשם משתמש
) -password(stringסיסמה לשימוש ב .web serviceאתם תקבלו סיסמה יחודית לשימוש ב Web
Service
) -toEmails[](stringמערך של מיילים לשליחה
) -toName[] (stringמערך של שמות
) -AttchmentUrl(stringהוספת לינקים לקבצים של הקובץ אותו תרצו לצרף .ניתן לצרף כמה קבצים
באמצעות הפרדה של הלינקים על ידי התווים ##
) -fromEmail(stringכתובת דואר האלקטרוני של השולח (חשוב לדייק)
פולסים דיוור אלקטרוני
מורשה | שדרות מסריק 31תל אביב טל 31-0423423פקס 31-0420243כל הזכויות שמורות.
) -fromName (stringשם השולח של המייל
) -subject (stringנושא המייל
) -HTML-(stringקוד ה HTMLשהוא למעשה יכיל את תוכן המייל.
) -languageCode(intשפת הקידוד של ה HTMLבשליחה
3
עברית
3
אנגלית
2
הונגרית
10
סלובקית
צרפתית
4
33
1
ספרדית
2
גרמניה
0
רוסית
6
יפנית
7
רומנית
8
ערבית
פורטוגזית
) -externalRef[](stringמערך משתנים שחוזרים בדוחות לזיהוי המייל על ידי הלקוח
פרמטר חוזר הינו "Success" – Stringאומר שהעברה הצליחה למערכת פולסים .כל דבר אחר
מסמל על השגיאה.
SendEmailsToGroupWithAttachments
תיאור :תיאור :מאפשר לשלוח קבוצת נמענים עם HTMLיחודי לכל אחד כולל קבצים מצורפים(יש
עלות נוספת לפי נפח הקובץ ב)KB
פרמטרים של הפונקציה:
) -userID(stringשם משתמש
) -password(stringסיסמה לשימוש ב .web serviceאתם תקבלו סיסמה יחודית לשימוש ב Web
Service
) -toEmails[](stringמערך של מיילים לשליחה
) -toName[] (stringמערך של שמות
) -AttchmentUrl(stringהוספת לינקים לקבצים של הקובץ אותו תרצו לצרף .ניתן לצרף כמה קבצים
באמצעות הפרדה של הלינקים על ידי התווים ##
) -fromEmail(stringכתובת דואר האלקטרוני של השולח (חשוב לדייק)
) -fromName (stringשם השולח של המייל
) -subject (stringנושא המייל
) -HTML[](stringמערך קוד ה HTMLשהוא למעשה יכיל את תוכן המייל
פולסים דיוור אלקטרוני
מורשה | שדרות מסריק 31תל אביב טל 31-0423423פקס 31-0420243כל הזכויות שמורות.
) -languageCode(intשפת הקידוד של ה HTMLבשליחה
3
עברית
3
אנגלית
2
הונגרית
10
סלובקית
צרפתית
4
33
1
ספרדית
2
גרמניה
0
רוסית
6
יפנית
7
רומנית
8
ערבית
פורטוגזית
) -externalRef[](stringמערך משתנים שחוזרים בדוחות לזיהוי המייל על ידי הלקוח
פרמטר חוזר הינו "Success" – Stringאומר שהעברה הצליחה למערכת פולסים .כל דבר אחר
מסמל על השגיאה.
הערה על מבנה HTMLנכון לשליחת מיילים:
HTMLהנשלח בשפה העברית צריך להתחיל בצורה הבאה בלבד ללא שום תוספת:
><html
><head
><meta http-equiv="Content-Type" content="text/html; charset=windows-1255" /
></head
>"<body dir="rtl
תוכן הדיוור בHTML
></body
></html
HTMLהנשלח בשפה אחרת (לא עברית) צריך להתחיל בצורה הבאה בלבד ללא שום תוספת:
(הערה :בערבית יש צורך לרשום ” dir=”rtlב)BODY
><html
><head
><meta http-equiv="Content-Type" content="text/html; charset=utf-8" /
></head
>"<body dir="ltr
תוכן הדיוור בHTML
></body
></html
הערה :במידה ושפת הדיוור צריכה ENCODINGשונה יש לשנות את שורת ה METAשמגדירה את
ה.ENCODING
GetEmailReport
פולסים דיוור אלקטרוני
מורשה | שדרות מסריק 31תל אביב טל 31-0423423פקס 31-0420243כל הזכויות שמורות.
הערה :המידע נשמר כחודש ואז נמחק.
תיאור :קבלת דוח שליחה
פרמטרים של הפונקציה:
) -userID(stringשם משתמש
) -password(stringסיסמה לשימוש ב .web serviceאתם תקבלו סיסמה יחודית לשימוש ב Web
Service
) -startDateTime(DateTimeהחל מאיזה תאריך
)-endDateTime(DateTimeעד איזה תאריך
פרמטר חוזר DataTable :שמחיל את המידע הבא:
-CreateDate
תאריך יצירה
-Statusסטטוס
המייל:
מספר
סטטוס
תיאור
3
נשלח
בהצלחה
5
ממתין
לשליחה
חוזרת
8
-externalRef
משתנה חוזר
שגוי (מייל
לא קיים)
שגיאה
9
בינונית(בדרך
כלל -תיבת
דואר מלאה)
01
שגיאה
זמנית
00
לקוח הסיר
עצמו
מהרשימה
GetEmailReportStat
הערה :המידע נשמר כחודש ואז נמחק.
פולסים דיוור אלקטרוני
מורשה | שדרות מסריק 31תל אביב טל 31-0423423פקס 31-0420243כל הזכויות שמורות.
תיאור :קבלת דוח שליחה כולל סטטיסטיקה( .יש צורך לבקש הפעלה של מנגנון הסטטיסטיקה)
פרמטרים של הפונקציה:
) -userID(stringשם משתמש
) -password(stringסיסמה לשימוש ב .web serviceאתם תקבלו סיסמה יחודית לשימוש ב Web
Service
) -startDateTime(DateTimeהחל מאיזה תאריך
)-endDateTime(DateTimeעד איזה תאריך
פרמטר חוזר DataTable :שמחיל את המידע הבא:
-CreateDate
תאריך יצירה
-Statusסטטוס
המייל:
מספר
סטטוס
תיאור
3
נשלח
בהצלחה
5
ממתין
לשליחה
חוזרת
8
9
-externalRef
משתנה חוזר
Open Count
Click Count
כמות פתיחות
של הדיוור
כמות לחיצות
על הלינקים
בדיוור
שגוי (מייל
לא קיים)
שגיאה
בינונית(בדרך
כלל -תיבת
דואר מלאה)
01
שגיאה
זמנית
00
לקוח הסיר
עצמו
מהרשימה
הערה חשובה:
חשוב מאוד להסיר לקוחות שביקשו להסיר עצמם מהרשימה (סטטוס .)00
פולסים דיוור אלקטרוני
מורשה | שדרות מסריק 31תל אביב טל 31-0423423פקס 31-0420243כל הזכויות שמורות.
)8 כמו כן להסיר שגויים (סטטוס
GetEmailReportStat אוGetEmailReport את הסטטוסים השונים מקבלים באמצעות הפונקציה
GetRemovedClients
. קבלת רשימת לקוחות מוסרים:תיאור
:פרמטרים של הפונקציה
שם משתמש-userID(string)
Web אתם תקבלו סיסמה יחודית לשימוש ב.web service סיסמה לשימוש ב-password(string)
Service
.) המכילה את רשימת הנמענים המוסריםDATATABLE( טבלה:פרמטר חוזר
עדיין לא בשימוש-GetEmailReportCountByStatus
ASP.net C# באמצעותWeb Serviceדוגמה לשימוש ב
SendEmailToGroupהדוגמה משתמשת ב
using System;
using System.Configuration;
using System.Data;
using System.Linq;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.HtmlControls;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
. כל הזכויות שמורות31-0420243 פקס31-0423423 תל אביב טל31 מורשה | שדרות מסריק
פולסים דיוור אלקטרוני
using System.Xml.Linq;
using localhostPulseemServices;
public partial class _Default : System.Web.UI.Page
{
////define a Web service proxy object.
private localhostPulseemServices.PulseemSendServices proxy;
////This executes when a button is pressed in the asp.net forum
protected void btnAddClient_Click(object sender, EventArgs e)
{
proxy = new localhostPulseemServices.PulseemSendServices();
string[] emails = new string[] { "yuval@gmail.com", "yuval@tochberg.net" };
string[] names = new string[] { "yuval tochberg", "yuval2" };
string[] externalRef = new string[] { "Ref1", "Ref2" };
////This string of array is for the SendEmailsToGroup
// string[] htmls = new string[] { "Hi 1", "Hi 2" };
string html="<html><body> <br> <p>Hello, how are you</p> </body> </html>";
string result= proxy.SendEmailToGroup( "yuval", 1044585112, emails, names,
"Dror@pulseem.com", "Drorrr", "Testing", html, 0, externalRef)
////Example for multiply Htmls
// string result= proxy.SendEmailsToGroup( "yuval", 1044585112, emails, names,
"Dror@pulseem.com", "Drorrr", "Testing", htmls, 0, externalRef);
////Example for getting reports
//DataTable dataTable = proxy.GetReport("yuval", 1044585112,
1), DateTime.Now);
DateTime.Now.AddDays(-
}
}
. כל הזכויות שמורות31-0420243 פקס31-0423423 תל אביב טל31 מורשה | שדרות מסריק
פולסים דיוור אלקטרוני
