SOAP API לשליחת מסרונים ודיוור אלקטרוני – תיעוד מלא
מסר 10 מציעה ממשק SOAP API עשיר לשליחת מסרונים ודיוור אלקטרוני, המתאים במיוחד לאינטגרציות ארגוניות, מערכות .NET וסביבות שדורשות תקשורת מובנית ומאומתת.
מסר 10 מציעה ממשק SOAP API עשיר לשליחת מסרונים ודיוור אלקטרוני, המתאים במיוחד לאינטגרציות ארגוניות, מערכות .NET וסביבות שדורשות תקשורת מובנית ומאומתת. ה-SOAP API חושף עשרות פעולות לניהול קמפיינים, אנשי קשר ושליחות.
כתובת השירות (Endpoint)
https://ns.mesereser.com/Services/Services.asmx
קובץ ה-WSDL (תיאור השירות) זמין בכתובת:
https://ns.mesereser.com/Services/Services.asmx?WSDL
אימות: רוב הפעולות מקבלות אובייקט CLoginInfo עם שם משתמש וסיסמה, או UserID שניתן לקבל דרך LoginUser.
פעולות עיקריות לשליחת SMS
SendSingleSmsMessage – מסרון בודד
שולח מסרון SMS בודד לנמען יחיד. מתאים לאימות OTP, התראות מיידיות ועדכוני מצב.
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<SendSingleSmsMessage xmlns="http://messagingsystem.co.il/">
<oLogin>
<UserName>your_username</UserName>
<Password>your_password</Password>
</oLogin>
<sFromName>שם השולח</sFromName>
<sBody>תוכן המסרון שלך</sBody>
<sToPhone>0501234567</sToPhone>
</SendSingleSmsMessage>
</soap:Body>
</soap:Envelope>
CreateAndSendSMSCampaign – קמפיין SMS
יוצר ושולח קמפיין SMS לקבוצת נמענים שלמה. אידיאלי לשיווק, הודעות שירות ומבצעים.
<CreateAndSendSMSCampaign xmlns="http://messagingsystem.co.il/">
<oLogin>
<UserName>your_username</UserName>
<Password>your_password</Password>
</oLogin>
<iUserID>12345</iUserID>
<sCampaignName>שם הקמפיין</sCampaignName>
<sFromName>שם השולח</sFromName>
<sBody>תוכן המסרון</sBody>
<sGroupName>שם הקבוצה</sGroupName>
</CreateAndSendSMSCampaign>
ניהול אנשי קשר
ה-SOAP API כולל מגוון רחב של פעולות לניהול מאגר הנמענים:
| פעולה | תיאור |
|---|---|
CreateContact | יצירת איש קשר חדש |
AddContactToGroup_BasicInfo | הוספת איש קשר לקבוצה לפי מידע בסיסי |
AddContactToGroup_FullInfo | הוספת איש קשר לקבוצה עם מידע מלא |
AddContactsToGroupBasicInfo | הוספת מספר אנשי קשר בבת-אחת |
ChangeContactStatus | שינוי סטטוס: Active / Unsubscribed / Bounced |
ChangeContactPhone | עדכון מספר טלפון |
ChangeContactEMail | עדכון כתובת אימייל |
DeleteContact | מחיקת איש קשר |
RemoveContactFromGroup | הסרה מקבוצה ספציפית |
פעולות דיוור אלקטרוני (Email)
ה-API תומך גם בניהול מלא של קמפיינים בדוא"ל:
- CreateAndSendEMail – יצירה ושליחת אימייל בודד
- CreateEMailCampaignEx – יצירת קמפיין אימייל עם הגדרות מתקדמות
- SendEMail – שליחת אימייל לנמען ספציפי
- CreateAndSendEMailCampaignWithAttachments – קמפיין עם קבצים מצורפים
- GetCampaignResultSummary – נתוני ביצועים של קמפיין
- GetCampaignLinkClicks – ספירת קליקים על קישורים
SOAP vs JSON – מתי להשתמש בכל אחד?
| תרחיש | SOAP API | JSON REST API |
|---|---|---|
| שליחת מסרון בודד (OTP) | ✓ | ✓ מומלץ |
| קמפיין SMS לרשימה גדולה | ✓ מומלץ | – |
| אינטגרציה .NET / C# ארגונית | ✓ מומלץ | ✓ |
| שילוב מהיר מאפליקציית Web | ✓ | ✓ מומלץ |
| ניהול אנשי קשר בכמות גדולה | ✓ מומלץ | ✓ |
לתיעוד מלא של ה-JSON REST API ודוגמאות קוד נוספות, ראו את המדריך המלא שלנו.
מוכנים להתחבר?
הרשמו עכשיו למסר 10 וקבלו גישה מיידית ל-SOAP API ול-JSON API, יחד עם ממשק ניהול מלא לקמפיינים ודיוור.