דואר ת לשליח להתממשקות למערכת פולסים שימוש ב Web Service אלקטרוני

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 ‫מורשה | שדרות מסריק‬
‫פולסים דיוור אלקטרוני‬