מסרון שיוצא מתוך מערכת קיימת הוא מקרה אחר משליחה ידנית: הוא צריך לצאת ברגע שמשהו קרה, בלי שאיש ילחץ, ולהחזיר תשובה שאפשר לשמור. למסר 10 שני ממשקים לזה, והם עובדים על אותו חשבון ואותן רשימות של המערכת עצמה.
שני הממשקים
| JSON REST | SOAP |
|---|
| למי | כל שפת תכנות, אינטגרציה חדשה | מערכות ארגוניות ו-legacy |
| הקריאה | HTTP POST עם גוף JSON | מעטפת SOAP מול WSDL |
| תיעוד | ממשק JSON | תיעוד ה-API |
POST https://heb.mesereser.com/Services/JsonServices.aspx?f=SendSms
Content-Type: application/json
ApiKey: <המפתח שלכם>
{
"phones": "050XXXXXXX",
"msg": "קוד האימות שלך: 4821"
}
שימו לב: קוד תגובה 200 אינו אומר שההודעה נשלחה. ההצלחה יושבת בשדה התוצאה בגוף התשובה, והפלטפורמה מחזירה 200 גם על כישלון. זו הנקודה שהכי הרבה אינטגרציות נופלות בה.
מה אפשר לעשות
שליחת מסרון בודד
הודעה אחת למספר אחד, בקריאה אחת. זה מה שמאחורי אישור הזמנה, תזכורת לתור או עדכון משלוח.
קודי אימות ו-OTP בזמן אמת
מסלול מהיר שמיועד להודעות שחייבות להגיע מיד. הקוד נוצר אצלכם, והמסרון יוצא ברגע הקריאה.
שליחת קמפיין לרשימה
אפשר להפעיל קמפיין שכבר נבנה במערכת, או לשלוח לרשימה לפי שמה.
ניהול אנשי קשר ורשימות
יצירה ועדכון של אנשי קשר, הוספה לרשימה והסרה ממנה, הכל מתוך המערכת שלכם.
משיכת דוחות מסירה
מי קיבל, מי לא ולמה, לפי מזהה. כך הסטטוס מתעדכן אצלכם בלי להיכנס לממשק.
מסרונים נכנסים
בכיוון ההפוך: מסרון שנשלח למספר שלכם מועבר לכתובת שתגדירו.
הזדהות ואבטחה
ההזדהות היא במפתח API אישי שמונפק בחשבון, תחת החשבון שלי, הגדרות מתקדמות, הגדרות API. המפתח מחליף שם משתמש וסיסמה בפניות, ולכן אין צורך לשמור סיסמה בקוד.
באותו מסך אפשר גם להגביל את פניות ה-API לכתובות IP מורשות. אם אתם פונים משרת עם כתובת קבועה, זו ההגנה הזולה ביותר מפני מפתח שדלף: פנייה מכתובת אחרת פשוט תידחה.
ושני כללים שחוסכים קריאות לתמיכה: אף פעם לא לשים מפתח בקוד צד לקוח או בקובץ משותף, ולעולם לא לנסות שוב אוטומטית אחרי כישלון הזדהות. ניסיונות חוזרים גורמים לחסימה זמנית של הכתובת שממנה פונים, והיא מדווחת כאילו המפתח שגוי.
ולמי שעובד עם כלי AI
מעבר לשני הממשקים יש גם שרת MCP בקוד פתוח, שמחבר את החשבון לקלוד או לסוכן שבניתם ומתרגם את פעולות ה-API לכלים שמודל יודע להפעיל. הוא עולה במצב קריאה בלבד, וכלים ששולחים אינם מוצגים עד שפותחים אותם במפורש.
איך מתחילים
פותחים חשבון, מנפיקים מפתח בהגדרות המתקדמות, ושולחים קריאת בדיקה אחת למספר שלכם. אם משהו לא ברור, התיעוד המלא נמצא בעמוד ה-API, ובעמוד SMS API למתכנתים יש את התמונה מצד המפתח.
שאלות נפוצות
איזה ממשק לבחור, JSON או SOAP?
JSON למי שמתחיל היום: קריאת HTTP POST פשוטה שעובדת מכל שפת תכנות. SOAP למערכות ארגוניות ומערכות legacy שכבר יודעות לעבוד מול WSDL.
איפה מוצאים את מפתח ה-API?
בממשק מסר 10: החשבון שלי, ואז הגדרות מתקדמות, ושם תחת הגדרות API. המפתח מחליף הזדהות בשם משתמש וסיסמה. אם הוא נחשף במקום כלשהו, מנפיקים חדש באותו מסך.
אפשר להגביל מי יכול לפנות ל-API?
כן, ומומלץ. באותו מסך אפשר להגביל את פניות ה-API לכתובות IP שאתם מאשרים, וכל פנייה מכתובת אחרת תידחה. שווה במיוחד אם אתם פונים משרת עם כתובת קבועה.
קוד תגובה 200 אומר שההודעה נשלחה?
לא, וזו הטעות הנפוצה ביותר. הפלטפורמה מחזירה 200 גם על כישלון, וההצלחה יושבת בשדה התוצאה שבגוף התשובה. כל אינטגרציה חייבת לקרוא את השדה הזה ולא להסתמך על קוד ה-HTTP.
מה עושים כשמפתח שעבד מפסיק לעבוד?
אחרי כמה ניסיונות הזדהות כושלים ברצף המערכת חוסמת זמנית את הכתובת שממנה פונים. החסימה אינה על המפתח, ולכן הנפקת מפתח חדש לא תפתור. מפסיקים לפנות, מוודאים שאין בקוד לולאה שמנסה שוב ושוב אחרי כישלון, ופונים לתמיכה.
איך מקבלים דוחות מסירה אוטומטית?
יש פעולות ייעודיות למשיכת סטטוס המסירה לפי מזהה הקמפיין או ההודעה, כך שאפשר לעדכן את הסטטוס בתוך המערכת שלכם בלי להיכנס לממשק.
יש הגבלת קצב?
לא מוגדרת מגבלה מוצהרת כרגע. עם זאת, מומלץ לא לשגר סדרות ארוכות של קריאות במקביל, ולעולם לא לנסות שוב אוטומטית אחרי כישלון הזדהות.
אפשר גם לקבל מסרונים נכנסים?
כן, בכיוון ההפוך. מסרון שנשלח למספר שלכם מועבר לכתובת שתגדירו, ומשם המערכת שלכם מטפלת בו.
תמיכה
צוות התמיכה בישראל, ראשון עד חמישי 9:00 עד 17:00: 03-7440020 או support@meser10.co.il.