כשהמסרון צריך לצאת מתוך מערכת אחרת, אתר, CRM, חנות או שרת, שולחים אותו בקריאת HTTP אחת ומקבלים בחזרה דוח מסירה. כולל קודי אימות (OTP) במסלול מהיר.
מסרון שיוצא מתוך מערכת קיימת הוא מקרה אחר משליחה ידנית: הוא צריך לצאת ברגע שמשהו קרה, בלי שאיש ילחץ, ולהחזיר תשובה שאפשר לשמור. למסר 10 שני ממשקים לזה, והם עובדים על אותו חשבון ואותן רשימות של המערכת עצמה.
קוד אימות צריך להגיע בזמן שהמשתמש מחכה מול המסך. לכן קודי OTP יוצאים אצלנו במסלול מהיר, וספריות הקוד הפתוח שלנו כבר יוצרות את הקוד, שולחות אותו ובודקות את מה שהמשתמש הקליד:
npm install @meser10/otp
await otp.sendCode('054-123-4567');
await otp.verifyCode('054-123-4567', userInput); // trueאותה התנהגות ב-Python וב-PHP, במדריך למפתחים. אתר בוורדפרס? תוסף Meser10 OTP מוסיף קוד בהרשמה, בקופה של WooCommerce ובכניסה לאתר, בלי לכתוב קוד.
מסר 10 היא חברה ישראלית שמפעילה מערכת דיוור ומסרונים מאז 2009. מי שבוחר ספק SMS API בישראל בודק בדרך כלל מחיר למסרון, עלויות קבועות, סוג הממשק, קודי אימות ותמיכה בעברית. כך זה נראה אצלנו:
| מחיר למסרון | בין 0.014 ₪ ל-0.045 ₪ למסרון לפי גודל החבילה, לפני מע"מ. המחירון המלא |
|---|---|
| עלות חודשית והקמה | אין. משלמים רק על חבילת מסרונים, והיא בתוקף ללא הגבלת זמן |
| ממשקים | JSON REST ו-SOAP, עם מפרט OpenAPI 3.1 ואוסף Postman |
| קודי אימות (OTP) | מסלול מהיר להודעות שחייבות לצאת מיד. קוד לדוגמה בארבע שפות |
| שם השולח | שם טקסטואלי או מספר טלפון מאומת, כך שהנמען יודע ממי ההודעה |
| מסרונים נכנסים | מסרון שנשלח למספר שלכם מועבר לכתובת שתגדירו. איך זה עובד |
| אבטחה | מפתח API אישי והגבלת פניות לכתובות IP מורשות |
| חשבון | אותו חשבון ואותה חבילת מסרונים כמו בשליחה מהממשק, בלי חשבון מפתחים נפרד |
| תמיכה | בעברית, בטלפון 03-7440020 ובמייל |
| JSON REST | SOAP | |
|---|---|---|
| למי | כל שפת תכנות, אינטגרציה חדשה | מערכות ארגוניות ו-legacy |
| הקריאה | HTTP POST עם גוף JSON | מעטפת SOAP מול WSDL |
| תיעוד | ממשק JSON | תיעוד ה-API |
ההזדהות היא במפתח API אישי שמונפק בחשבון, תחת החשבון שלי, הגדרות מתקדמות, הגדרות API. המפתח מחליף שם משתמש וסיסמה בפניות, ולכן אין צורך לשמור סיסמה בקוד.
באותו מסך אפשר גם להגביל את פניות ה-API לכתובות IP מורשות. אם אתם פונים משרת עם כתובת קבועה, זו ההגנה הזולה ביותר מפני מפתח שדלף: פנייה מכתובת אחרת פשוט תידחה.
מעבר לשני הממשקים יש גם שרת MCP בקוד פתוח, שמחבר את החשבון לקלוד או לסוכן שבניתם ומתרגם את פעולות ה-API לכלים שמודל יודע להפעיל. הוא עולה במצב קריאה בלבד, וכלים ששולחים אינם מוצגים עד שפותחים אותם במפורש.
בלי להתקין ספרייה ובלי לכתוב שורת קוד. הפקודה הראשונה מוכיחה שהמפתח תקין, והיא אינה יוצרת דבר ואינה מחייבת דבר, כי הכתובת שהיא שואלת עליה אינה קיימת באף חשבון:
curl -sS "https://heb.mesereser.com/Services/JsonServices.aspx?f=GetContactStatus&email=nobody.probe@example.invalid" \
-H "ApiKey: $MESER10_API_KEY" \
-H "User-Agent: my-app/1.0"
{"ErrorCode":0,"Result":"Call successful","StatusID":0}השנייה שולחת מסרון אמיתי לנמען אמיתי ומחייבת את החשבון:
curl -sS -X POST "https://heb.mesereser.com/Services/JsonServices.aspx?f=SendSingleSmsMessage" \
-H "ApiKey: $MESER10_API_KEY" \
-H "Content-Type: application/json; charset=utf-8" \
-H "User-Agent: my-app/1.0" \
-d '{"ToPhone":"0501234567","MessageBody":"Your code is 481902.","FromName":"MyShop"}'
{"ErrorCode":0,"Result":"","MessageID":0}קוראים את ErrorCode, לא את קוד ה-HTTP. כל קריאה חוזרת ב-200 גם כשהיא נכשלה, כולל מפתח שנדחה, ו-ErrorCode מוחזר כמספר בחלק מהפונקציות וכמחרוזת באחרות, ולכן צריך לנרמל לפני השוואה. את הקוד 1 יש לטפל כסופי ולעצור: הפקודה הראשונה למעלה היא מה שמריצים כשחושדים בבעיית מפתח, במקום לנסות שוב את הקריאה שנכשלה.
כותרת ה-User-Agent בשתי הפקודות אינה קוסמטית. השרתים יושבים מאחורי Cloudflare Browser Integrity Check, שקוראת את הכותרת וחוסמת חתימות ברירת מחדל של ספריות HTTP: Java/1.8.0_241 מקבל 403 ו-Python-urllib/3.x מקבל שגיאה 1010. כל ערך מותאם עובר, והערך עצמו לא משנה. התסמין מופיע לסירוגין, כי למערכת יש לרוב שני מסלולי קוד לאותה נקודת קצה ורק אחד מהם שולח את הכותרת.
חמש הפונקציות מתועדות גם כמפרט OpenAPI 3.1 וגם כאוסף Postman מוכן להרצה, כך שאפשר להפיק קליינט בשפה שלכם או לייבא לכלי הפיתוח. הפירוט המלא נמצא בעמוד ה-API. ולשליחת קוד אימות חד-פעמי יש עמוד משלו, עם קוד לדוגמה בארבע שפות: OTP: קוד אימות ב-SMS.
MESER10_API_KEY ולא בקוד.אותה שליחה מתוך הקוד, ב-Node.js וב-PHP, בלי ספרייה חיצונית:
// Node.js 18+ (fetch is built in)
const res = await fetch("https://heb.mesereser.com/Services/JsonServices.aspx?f=SendSingleSmsMessage", {
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({ ToPhone: "0501234567", MessageBody: "Your code is 481902.", FromName: "MyShop" })
});
const data = await res.json();
if (String(data.ErrorCode) !== "0") throw new Error("SMS failed: " + data.ErrorCode + " " + data.Result);
<?php
// PHP 7.4+ with the curl extension
$ch = curl_init("https://heb.mesereser.com/Services/JsonServices.aspx?f=SendSingleSmsMessage");
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 15,
CURLOPT_HTTPHEADER => [
"ApiKey: " . getenv("MESER10_API_KEY"),
"Content-Type: application/json; charset=utf-8",
"User-Agent: my-app/1.0",
],
CURLOPT_POSTFIELDS => json_encode([
"ToPhone" => "0501234567",
"MessageBody" => "Your code is 481902.",
"FromName" => "MyShop",
]),
]);
$data = json_decode((string) curl_exec($ch), true);
curl_close($ch);
if ((string) ($data["ErrorCode"] ?? "") !== "0") {
throw new RuntimeException("SMS failed: " . ($data["Result"] ?? "no response"));
}
באתר WordPress אפשר לדלג על הקוד: התוסף Meser10 OTP שולח קוד ב-SMS בהרשמה, בקופה של WooCommerce ובכניסה לאתר, ומתחבר עם אותו מפתח. ל-Node.js, Python ו-PHP יש גם חבילות OTP מוכנות, במדריך OTP למפתחים. ומי שלא רוצה לייצר ולבדוק את הקוד בעצמו יכול להשתמש ב-Meser 10 Verify: שתי קריאות, שליחה ובדיקה, עם הגבלת ניסיונות מובנית.
אם משהו לא ברור, התיעוד המלא נמצא בעמוד ה-API, ובעמוד SMS API למתכנתים יש את התמונה מצד המפתח.
צוות התמיכה בישראל, ראשון עד חמישי 9:00 עד 17:00: 03-7440020 או support@meser10.co.il.
פתחו חשבון ניסיון חינם במסר 10, ופנו לתמיכה לקבלת פרטי החיבור לטופס שלכם.
פתחו חשבון ניסיון חינם