כשהמסרון צריך לצאת מתוך מערכת אחרת, אתר, CRM, חנות או שרת, שולחים אותו בקריאת HTTP אחת ומקבלים בחזרה דוח מסירה. כולל קודי אימות בזמן אמת.
מסרון שיוצא מתוך מערכת קיימת הוא מקרה אחר משליחה ידנית: הוא צריך לצאת ברגע שמשהו קרה, בלי שאיש ילחץ, ולהחזיר תשובה שאפשר לשמור. למסר 10 שני ממשקים לזה, והם עובדים על אותו חשבון ואותן רשימות של המערכת עצמה.
מסר 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.
פותחים חשבון, מנפיקים מפתח בהגדרות המתקדמות, ושולחים קריאת בדיקה אחת למספר שלכם. אם משהו לא ברור, התיעוד המלא נמצא בעמוד ה-API, ובעמוד SMS API למתכנתים יש את התמונה מצד המפתח.
צוות התמיכה בישראל, ראשון עד חמישי 9:00 עד 17:00: 03-7440020 או support@meser10.co.il.
פתחו חשבון ניסיון חינם במסר 10, ופנו לתמיכה לקבלת פרטי החיבור לטופס שלכם.
פתחו חשבון ניסיון חינם