המערכת שלכם שולחת קוד חד-פעמי לתיבת המייל של המשתמש בקריאת API אחת. כשהשליחה המהירה מופעלת בחשבון, המייל יוצא כבר בתוך הקריאה עצמה.
קוד אימות במייל מוכיח שהמשתמש באמת מחזיק בתיבת הדואר שהוא מסר: בהרשמה, באיפוס סיסמה, בכניסה לחשבון ממכשיר חדש או לפני פעולה רגישה. הוא חייב להגיע מהר, כי המשתמש עומד מול המסך ומחכה. בשביל זה יש במסר 10 מסלול שליחה מהיר למייל טרנזקציוני: כשהוא מופעל בחשבון, מייל בודד שנשלח דרך ה-JSON API יוצא כבר בתוך הקריאה, והתשובה חוזרת אליכם אחרי שהמייל נמסר לשרת השליחה.
קוד ב-SMS מוכיח שהטלפון בידי המשתמש, וקוד במייל מוכיח גישה לתיבת הדואר. מייל מתאים במיוחד למי שמתחבר מהמחשב, למשתמשים בחו"ל, ולשירותים שבהם כתובת המייל היא שם המשתמש. במייל אין צורך באישור שם שולח מול משרד התקשורת כמו ב-SMS, רק בכתובת שולח מאומתת בחשבון. הרבה שירותים משלבים: SMS כברירת מחדל ומייל כחלופה, או להפך. הרחבנו על זה במאמר קוד אימות ב-SMS או במייל? מתי כל אחד מתאים.
קריאת POST אחת, עם מפתח ה-API בכותרת ApiKey. השדה ReplyToEMail הוא חובה בפועל, ובלעדיו הקריאה מחזירה ErrorCode 3. הקריאה מחזירה תמיד HTTP 200, כך שההצלחה נקבעת רק לפי ErrorCode בתשובה. ErrorCode 1 פירושו מפתח API שגוי, ובמקרה כזה לא שולחים שוב, כי ניסיונות חוזרים חוסמים את כתובת ה-IP השולחת לכמה שעות. נמען שהסיר את עצמו מהדיוור בחשבון לא יקבל כברירת מחדל גם מייל בודד דרך ה-API. אם קודי אימות צריכים להגיע גם אליו, התמיכה מפעילה בחשבון שליחת הודעות בודדות גם לנמענים שהוסרו. התיעוד המלא נמצא במדריך שליחת מייל דרך ה-API.
curl -sS -X POST "https://heb.mesereser.com/Services/JsonServices.aspx?f=SendSingleEMailMessage" \
-H "ApiKey: $MESER10_API_KEY" \
-H "Content-Type: application/json; charset=utf-8" \
-H "User-Agent: my-app/1.0" \
-d '{"ToEMail":"dana@example.com",
"Subject":"קוד האימות שלך: 481902",
"Body":"<p>קוד האימות שלך הוא <b>481902</b>. הקוד תקף ל-5 דקות.</p>",
"FromName":"MyShop",
"ReplyToEMail":"support@myshop.co.il",
"LinkClickCountType":"NoCount"}'
{"ErrorCode":0,"Result":"Call successful"}
// Node 18+
const res = await fetch(
'https://heb.mesereser.com/Services/JsonServices.aspx?f=SendSingleEMailMessage',
{
method: 'POST',
headers: {
ApiKey: process.env.MESER10_API_KEY,
'Content-Type': 'application/json; charset=utf-8',
'User-Agent': 'my-app/1.0',
},
body: JSON.stringify({
ToEMail: email,
Subject: `קוד האימות שלך: ${code}`,
Body: `<p>קוד האימות שלך הוא <b>${code}</b>. הקוד תקף ל-5 דקות.</p>`,
FromName: 'MyShop',
ReplyToEMail: 'support@myshop.co.il',
LinkClickCountType: 'NoCount',
}),
},
);
const body = await res.json();
const ok = String(body.ErrorCode) === '0';
כשהשליחה המהירה מופעלת בחשבון, המייל נשלח ישירות בתוך קריאת ה-API עצמה. בבדיקות שלנו הוא הגיע לתיבה תוך שניות ספורות מרגע הקריאה. זמן ההגעה הסופי תלוי גם בספק הדואר של הנמען.
פונים לתמיכה ומבקשים להפעיל בחשבון שליחה מהירה של מייל טרנזקציוני. מרגע ההפעלה, מיילים בודדים בלי קובץ מצורף שנשלחים דרך SendSingleEMailMessage יוצאים ישירות בתוך הקריאה.
כן. אותו חשבון ואותו מפתח API. ב-SMS הקריאה היא SendSingleSmsMessage ונדרש שם שולח מאושר. אתרים רבים שולחים קוד ב-SMS כברירת מחדל ומציעים את המייל כחלופה.
המערכת שלכם מייצרת את הקוד, שומרת אותו עם תוקף קצר ובודקת אותו כשהמשתמש מקליד. מסר 10 שולחת את המייל ומחזירה ErrorCode בכל קריאה. דוגמאות לייצור ולשמירה של קוד נמצאות במדריך OTP למפתחים.
שולחים מכתובת שולח מאומתת בדומיין שלכם, עם SPF, DKIM ו-DMARC מוגדרים, ושומרים על מייל קצר: הקוד בנושא ובגוף, בלי קישורים ובלי תמונות. את מוכנות הדומיין אפשר לבדוק בכלי החינמי שלנו לבדיקת דומיין.
כן. פותחים חשבון חינם ומקבלים מתנה חד-פעמית של 250 מיילים ו-50 מסרונים, כך שאפשר לבדוק את החיבור ל-API לפני שמשלמים. להפעלת השליחה המהירה בחשבון פונים לתמיכה.
פתחו חשבון חינם, הנפיקו מפתח API בהגדרות, ובקשו מהתמיכה להפעיל שליחה מהירה.
פתחו חשבון חינםעוד על הדרך שבה אנחנו עובדים: פלטפורמת דיוור לא מייצרים בלחיצה.