מסר 10 מציעה ממשק REST API מבוסס JSON המאפשר שילוב מהיר ופשוט עם כל מערכת חיצונית — אפליקציות, אתרים, מערכות CRM ועוד. ה-API תומך בשליחת מסרונים, יצירת אנשי קשר ועדכון סטטוסים בכמה שורות קוד.

כתובת הבסיס ואימות

כל בקשה נשלחת לכתובת הבאה, כאשר מחליפים את FunctionName בשם הפונקציה הרצויה:

https://heb.mesereser.com/Services/JsonServices.aspx?f=FunctionName

אימות: כל בקשה חייבת לכלול Header בשם ApiKey עם ערך מפתח ה-API שלך. את המפתח ניתן לאחזר מהגדרות המשתמש בממשק מסר 10.

מבנה התגובה הסטנדרטי

כל תגובה מה-API כוללת את השדות ErrorCode ו-Result. ערך 0 ב-ErrorCode מציין הצלחה; כל ערך אחר מציין שגיאה עם תיאור ב-Result:

{
  "ErrorCode": 0,
  "Result": "Call successful"
}

פונקציות ה-API הזמינות

SendSingleSmsMessage – שליחת מסרון בודד

שולח מסרון SMS בודד למספר טלפון ספציפי. מתאים לאימות OTP, התראות ועדכונים בזמן אמת.

POST /JsonServices.aspx?f=SendSingleSmsMessage
Header: ApiKey: YOUR_API_KEY
Content-Type: application/json

{
  "FromName": "שם השולח",
  "MessageBody": "תוכן המסרון",
  "ToPhone": "0501234567"
}

תגובה:
{
  "ErrorCode": 0,
  "Result": "",
  "MessageID": 12345
}

CreateContact – יצירת איש קשר חדש

מוסיף איש קשר חדש למאגר הרשימות שלך, כולל שדות מותאמים אישית.

POST /JsonServices.aspx?f=CreateContact
Header: ApiKey: YOUR_API_KEY

{
  "FirstName": "ישראל",
  "LastName": "ישראלי",
  "EMail": "israel@example.com",
  "PhoneNo": "0501234567",
  "ContactListName": "שם הרשימה",
  "Address": "",
  "City": "",
  "Zipcode": "",
  "CustomField1": "",
  "CustomField2": "",
  "CustomField3": "",
  "CustomField4": "",
  "CustomField5": ""
}

ChangeContactStatus – שינוי סטטוס איש קשר

מעדכן את סטטוס איש קשר לפי כתובת אימייל או מספר טלפון. הסטטוסות הזמינים: Active, Unsubscribed, Bounced.

POST /JsonServices.aspx?f=ChangeContactStatus

{
  "EMail": "israel@example.com",
  "PhoneNo": "",
  "Status": "Unsubscribed"
}

SendSingleEMailMessage – שליחת אימייל בודד

שולח אימייל בודד לנמען ספציפי עם גוף HTML מותאם אישית.

POST /JsonServices.aspx?f=SendSingleEMailMessage

{
  "FromName": "שם השולח",
  "ReplyToEMail": "reply@example.com",
  "ToEMail": "customer@example.com",
  "Subject": "נושא האימייל",
  "Body": "
שלום!
תוכן האימייל...
",
  "LinkClickCountType": ""
}

תגובה:
{
  "ErrorCode": 0,
  "Result": "",
  "MessageID": 67890
}

טיפים לשימוש נכון ב-API

• שמרו את ה-ApiKey בסביבה מאובטחת (משתנה סביבה, לא בקוד)
• בדקו תמיד את ErrorCode בתגובה לפני שמשתמשים בתוצאה
• לשליחת מסרונים בכמות גדולה — השתמשו ב-SOAP API לקמפיינים
• מספר הטלפון צריך להיות בפורמט ישראלי: 05XXXXXXXX או +9725XXXXXXXX

מוכנים להתחיל?

הרשמו עכשיו למסר 10 וקבלו גישה מיידית ל-API, לממשק שליחת המסרונים ולכלי הדיוור המתקדמים שלנו.