מדריך למי ששולח מהשרת שלו: הכתובת והשדות, מה חובה ומה לא, למה HTTP 200 לא אומר שההודעה יצאה, ואיך הסרה של נמען משפיעה על שליחות טרנזקציוניות.
הפונקציה הזו שולחת הודעת דואר אחת לנמען אחד, ישירות מהמערכת שלכם. היא מיועדת למי שמנהל אצלו את הנמענים ואת התוכן ומשתמש במסר 10 כספק השליחה בלבד, למשל אישור הזמנה, קוד אימות או עדכון מצב. לשליחה לרשימות, לקמפיינים ולדוחות יש ממשק נפרד.
POST https://heb.mesereser.com/Services/JsonServices.aspx?f=SendSingleEMailMessage
Content-Type: application/json
User-Agent: YourApp/1.0
{
"ToEMail": "person@example.com",
"Subject": "נושא ההודעה",
"Body": "<p>תוכן HTML</p>",
"FromName": "שם תצוגה",
"ReplyToEMail": "reply@yourdomain.co.il",
"LinkClickCountType": ""
}אותו מפתח API ואותו חשבון שבהם אתם משתמשים למסרונים. האימות הוא ברמת החשבון, ולכן אין מפתח נפרד לדואר. המפתח נשלח בכותרת ולא ב-query string. הפירוט המלא נמצא בעמוד ההזדהות במפתח API.
| השדה | מה הוא | הערה |
|---|---|---|
ToEMail | כתובת הנמען | חובה. נמען אחד בכל קריאה. |
Subject | שורת הנושא | חובה. |
Body | גוף ההודעה | HTML. עברית עוברת כרגיל ב-UTF-8. |
FromName | שם תצוגה של השולח | שם בלבד. הפונקציה אינה מקבלת כתובת From, והכתובת נקבעת לפי הדומיין המאומת בחשבון. |
ReplyToEMail | כתובת לתשובה | בפועל חובה. השמטה מחזירה שגיאה עם קוד 3, גם אם בתיעוד ישן היא מופיעה כמחרוזת ריקה. |
LinkClickCountType | ספירת קליקים | אפשר להשאיר מחרוזת ריקה. |
תמיד מוחזר HTTP 200, גם כשהקריאה נכשלת. אל תסתמכו עליו. הקובע היחיד הוא ErrorCode.
| ErrorCode | המשמעות | מה לעשות |
|---|---|---|
| 0 | הצלחה | ההודעה התקבלה לשליחה. |
| 1 | המפתח שגוי, חסר או בוטל | בדקו את המפתח ואת החשבון. אל תחזרו על הקריאה בלולאה. |
| 3 | שגיאה אצלנו או payload שלא ניתן לעיבוד | לרוב שדה חובה חסר, ובראשם ReplyToEMail. |
| 4 | פרמטר חסר או לא תקין | בדקו שמות שדות וערכים. |
| 6 | שם פונקציה לא מוכר | בדקו את הערך של f בכתובת. |
שימו לב: ErrorCode מוחזר בחלק מהפונקציות כמספר ובחלק כמחרוזת, ולכן כדאי לנרמל לפני השוואה. השדה Result מכיל הודעה מילולית, בעברית ברוב המקרים.
כשנמען לוחץ על קישור ההסרה, הסטטוס שלו בחשבון משתנה למוסר, והמערכת מפסיקה לשלוח אליו מהחשבון הזה כולל הודעות טרנזקציונליות דרך ה-API. אין צורך שתבדקו סטטוס בעצמכם לפני כל שליחה.
בין הערוצים הכלל צר יותר ממה שנדמה: הסרה חוצה ערוצים רק כשהמייל והטלפון שמורים על אותה רשומה. אז הנמען ייחשב מוסר בשניהם ולא יקבל מכם לא מייל ולא מסרון.
אם אותו אדם קיים אצלכם כשתי רשומות נפרדות, למשל טלפון שהועלה לרשימה אחת ומייל שהועלה לרשימה אחרת, אין למערכת שום אינדיקציה שהן קשורות, ולכן הסרה במייל לא תסיר את הטלפון. אותו דבר בשליחה בודדת ב-API לנמען שאינו קיים ברשימות שבחשבון: יוסר רק המזהה שדרכו נשלחה ההודעה.
נקודה שנייה שכדאי לדעת לפני שבונים על זה: למסרון שנשלח דרך ה-API אין קישור הסרה מובנה, כי אותה פונקציה משמשת גם קודי אימות חד-פעמיים. במייל, לעומת זאת, קישור ההסרה קיים תמיד, וגם בקוד אימות שנשלח במייל. כל ההתנהגות של קישור ההסרה, לפי סוג שליחה.
שליחה מדומיין שאינו מאומת תגיע לספאם או לא תגיע בכלל. לפני הקריאה הראשונה יש להגדיר את רשומות ה-DNS של הדומיין ולוודא שהן נתפסות. המדריך המלא לאימות דומיין השולח.
מגבלת הקצב נגזרת מהחבילה של החשבון ואינה אחידה לכל הלקוחות. פנו לתמיכה עם מספר החשבון ותקבלו את המגבלה שחלה עליכם.
לא נפתר? support@meser10.co.il או 03-7440020, ראשון עד חמישי 9:00 עד 17:00. צרפו את שם הפונקציה, את מספר החשבון ואת ערך ErrorCode שחזר, ולעולם לא את המפתח עצמו.
שלחו לנו את מספר החשבון ונחזור עם המגבלה המדויקת ועם רשומות ה-DNS לדומיין שלכם.
לפנייה לתמיכה