רוצים לחבר מערכת חיצונית או כלי AI לרב מסר? ממשק ה-API שלנו מאפשר למערכות שלכם – כגון אתרי מסחר, מערכות CRM, מנועי אוטומציה או מודלי בינה מלאכותית (כמו Claude) – לתקשר בצורה ישירה ומאובטחת עם החשבון שלכם. החיבור מאפשר להריץ מגוון פעולות אוטומטיות ללא מגע יד אדם: הוספת נמענים לרשימות תפוצה, עדכון שדות מותאמים אישית, ניהול תגיות ושליפת נתונים בזמן אמת.

רגע לפני שאתם ניגשים לכתיבת קוד: כדאי לבדוק אם המערכת שאתם רוצים להתממשק אליה כבר כוללת חיבור מובנה לרב מסר. עבור מערכות פופולריות רבות קיימות אינטגרציות מוכנות מראש, שיכולות לחסוך לכם את כל תהליך הפיתוח ולהתחיל לסנכרן נתונים באופן מיידי. לסקירת הרשימה המלאה גשו לדף "חיבורים חיצוניים (API)" במערכת כפי שמוסבר פה.

שלב 1: השגת מפתחות הזיהוי (User Token & Credentials)

כדי שהמערכת החיצונית תוכל לגשת לחשבון שלכם, עליכם להפיק אסימון משתמש ומפתחות גישה ייעודיים. פעולה זו מתבצעת פעם אחת מתוך ממשק המשתמש של רב מסר:

1. התחברו לחשבון שלכם במערכת רב מסר.

2. נווטו אל הגדרות החשבון על ידי לחיצה על סימלון גלגל השיניים (הגדרות) בפינה השמאלית עליונה של המסך

3. היכנסו ללשונית "חיבורים חיצוניים (API)".

4. בראש הדף, אתרו את החיבור "מפתח כללי לחשבון", העבירו אותו למצב פעיל, והעתיקו את הנתונים הבאים באמצעות כפתור ההעתקה:

   • Client ID

   • Client Secret

   • User Token
     
     
     
     

שלב 2: תהליך ההזדהות (Authentication & Access Token)

רב מסר משתמשת בפרוטוקול אימות מאובטח, לפיו יש להמיר את ה-User Token לאסימון גישה זמני (Access Token) המשמש לאישור הבקשות השונות במערכת.
כדי לקבל את ה-Access Token, עליכם לשלוח בקשת POST לשרת ההזדהות של רב מסר, יחד עם גוף הבקשה (Body) בפורמט JSON:

{
  "grant_type": "client_credentials",
  "scope": "*",
  "client_id": 238,
  "client_secret": "YOUR_CLIENT_SECRET_HERE",
  "user_token": "YOUR_USER_TOKEN_HERE"
}

Authorization: Bearer YOUR_ACCESS_TOKEN

 את רשימת הנתיבים (Endpoints) והפעולות האפשריות תוכלו למצוא בתיעוד ה-API הרשמי כאן.

תרחישי שימוש מרכזיים (Use Cases)

לאחר ביצוע תהליך ההזדהות וקבלת ה-Access Token, ה-API פותח דלת למגוון אינטגרציות ואוטומציות ללא מגע יד אדם:

1. סנכרון נתונים אוטומטי מול מערכות CRM

   • התרחיש: מזינים ליד חדש ב-CRM או מעדכנים סטטוס לקוח (למשל: מ"מתעניין" ל"לקוח משלם").

   • הפעולה ב-API: המערכת החיצונית שולחת קריאה לרב מסר להוספת הנמען לרשימת "לקוחות פעילים", הסרתו מרשימת "מתעניינים", ועדכון שדות מותאמים אישית (Custom Fields) כגון תאריך רכישה או איש קשר מטפל.

2. טריגרים ואוטומציות למסחר אלקטרוני (E-commerce)

   • התרחיש: לקוח מוסיף מוצרים לעגלת הקניות אך נוטש לפני התשלום, או משלים רכישה בהצלחה.

   • הפעולה ב-API: אתר הסחר מעביר קריאה להוספת תגית (Tag) ספציפית לנמען (כגון: נטש-עגלה או רכש-קורס-דיגיטלי), שמפעילה באופן מיידי סדרת מסרים אוטומטית שנבנתה ברב מסר.

3. ניהול הרשמות מאירועים ופלטפורמות וובינר

   • התרחיש: משתמש נרשם להדרכה אינטרנטית דרך מערכת חיצונית או טופס עצמאי.

   • הפעולה ב-API: פלטפורמת האירועים משדרת את פרטי הנרשם ל-API. הנמען נוצר במערכת ומשויך מיידית לרשימת הדיוור של האירוע לקבלת תזכורות אוטומטיות.
     
     

מחפשים דרך קלה יותר לנהל את החשבון ללא כתיבת קוד?
חיבור API מיועד לבעלי רקע בפיתוח. במידה ואתם מחפשים דרך לחבר את המערכות ללא צורך בכתיבת קוד – שרת ה-MCP שלנו הוא הפתרון עבורכם.

דגשים חשובים לפיתוח ותחזוקה

הבהרה חשובה: העבודה מול ה-API דורשת ידע בפיתוח ובניהול מערכות תוכנה, והיא מבוצעת באחריות המפתח והמשתמש בלבד. חלה עליכם החובה לוודא כי הקוד נכתב לפי אמות המידה הנדרשות, כי מפתחות הגישה שמורים בבטחה, וכי הקריאות נבדקו היטב כדי למנוע דריסה או אובדן של מידע בחשבון. כל פעולה המתבצעת בחשבון באמצעות ה-API היא באחריותכם המלאה.

1. תוקף הטוקן: ה-access_token שמתקבל הוא בעל תוקף זמני. בתכנון המערכת החיצונית שלכם, מומלץ להטמיע מנגנון המזהה שגיאות מסוג 401 Unauthorized ומבצע בקשת הזדהות מחדש באופן אוטומטי.
   
2. מבנה נתונים: ודאו כי כל בקשות ה-POST או ה-PUT שנשלחות ל-API מוגדרות עם ה-Header:
   Content-Type: application/json